BATCHRESETDEVICESFORUSER()`¶

About BatchResetDevicesForUser¶

Resets multiple devices for a specific user in a Wickr network. This operation forces the selected devices to log out and requires users to re-authenticate, which is useful for security purposes or when devices need to be revoked.

Method Signature¶

METHODS /AWS1/IF_WKR~BATCHRESETDEVICESFORUSER
  IMPORTING
    !IV_NETWORKID TYPE /AWS1/WKRNETWORKID OPTIONAL
    !IV_USERID TYPE /AWS1/WKRUSERID OPTIONAL
    !IT_APPIDS TYPE /AWS1/CL_WKRAPPIDS_W=>TT_APPIDS OPTIONAL
    !IV_CLIENTTOKEN TYPE /AWS1/WKRCLIENTTOKEN OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_wkrbtcresetdevfruse01
  RAISING
    /AWS1/CX_WKRBADREQUESTERROR
    /AWS1/CX_WKRFORBIDDENERROR
    /AWS1/CX_WKRINTSERVERERROR
    /AWS1/CX_WKRRATELIMITERROR
    /AWS1/CX_WKRRESNOTFOUNDERROR
    /AWS1/CX_WKRUNAUTHORIZEDERROR
    /AWS1/CX_WKRVALIDATIONERROR
    /AWS1/CX_WKRCLIENTEXC
    /AWS1/CX_WKRSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_networkid` `TYPE /AWS1/WKRNETWORKID` `/AWS1/WKRNETWORKID`¶

The ID of the Wickr network containing the user whose devices will be reset.

`iv_userid` `TYPE /AWS1/WKRUSERID` `/AWS1/WKRUSERID`¶

The ID of the user whose devices will be reset.

`it_appids` `TYPE /AWS1/CL_WKRAPPIDS_W=>TT_APPIDS` `TT_APPIDS`¶

A list of application IDs identifying the specific devices to be reset for the user. Maximum 50 devices per batch request.

Optional arguments:¶

`iv_clienttoken` `TYPE /AWS1/WKRCLIENTTOKEN` `/AWS1/WKRCLIENTTOKEN`¶

A unique identifier for this request to ensure idempotency.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_wkrbtcresetdevfruse01` `/AWS1/CL_WKRBTCRESETDEVFRUSE01`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->batchresetdevicesforuser(
  it_appids = VALUE /aws1/cl_wkrappids_w=>tt_appids(
    ( new /aws1/cl_wkrappids_w( |string| ) )
  )
  iv_clienttoken = |string|
  iv_networkid = |string|
  iv_userid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_genericstring = lo_result->get_message( ).
  LOOP AT lo_result->get_successful( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_genericstring = lo_row_1->get_appid( ).
    ENDIF.
  ENDLOOP.
  LOOP AT lo_result->get_failed( ) into lo_row_2.
    lo_row_3 = lo_row_2.
    IF lo_row_3 IS NOT INITIAL.
      lv_genericstring = lo_row_3->get_field( ).
      lv_genericstring = lo_row_3->get_reason( ).
      lv_genericstring = lo_row_3->get_appid( ).
    ENDIF.
  ENDLOOP.
ENDIF.

Successful device reset¶

Successful device reset

DATA(lo_result) = lo_client->batchresetdevicesforuser(
  it_appids = VALUE /aws1/cl_wkrappids_w=>tt_appids(
    ( new /aws1/cl_wkrappids_w( |d3135a42dcb6437780b16c3ca9581fe64e6822773cd6b965d25fc9929c89aca6| ) )
    ( new /aws1/cl_wkrappids_w( |e4246b53edc7548891c27d4da0692fe75f7933884de7c076e36gca030d90bdb7| ) )
  )
  iv_networkid = |12345678|
  iv_userid = |12345|
).

Partial failure device reset¶

Partial failure device reset

DATA(lo_result) = lo_client->batchresetdevicesforuser(
  it_appids = VALUE /aws1/cl_wkrappids_w=>tt_appids(
    ( new /aws1/cl_wkrappids_w( |d3135a42dcb6437780b16c3ca9581fe64e6822773cd6b965d25fc9929c89aca6| ) )
    ( new /aws1/cl_wkrappids_w( |invalid-app-id| ) )
  )
  iv_networkid = |12345678|
  iv_userid = |12345|
).

Invalid network ID error¶

Invalid network ID error

DATA(lo_result) = lo_client->batchresetdevicesforuser(
  it_appids = VALUE /aws1/cl_wkrappids_w=>tt_appids(
    ( new /aws1/cl_wkrappids_w( |d3135a42dcb6437780b16c3ca9581fe64e6822773cd6b965d25fc9929c89aca6| ) )
  )
  iv_networkid = |00000000|
  iv_userid = |12345|
).

/AWS1/IF_WKR=>BATCHRESETDEVICESFORUSER()¶