/AWS1/IF_DSD=>CREATEUSER()

About CreateUser

Creates a new user.

Method Signature

METHODS /AWS1/IF_DSD~CREATEUSER
  IMPORTING
    !IV_DIRECTORYID TYPE /AWS1/DSDDIRECTORYID OPTIONAL
    !IV_SAMACCOUNTNAME TYPE /AWS1/DSDUSERNAME OPTIONAL
    !IV_EMAILADDRESS TYPE /AWS1/DSDEMAILADDRESS OPTIONAL
    !IV_GIVENNAME TYPE /AWS1/DSDGIVENNAME OPTIONAL
    !IV_SURNAME TYPE /AWS1/DSDSURNAME OPTIONAL
    !IT_OTHERATTRIBUTES TYPE /AWS1/CL_DSDATTRIBUTEVALUE=>TT_ATTRIBUTES OPTIONAL
    !IV_CLIENTTOKEN TYPE /AWS1/DSDCLIENTTOKEN OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_dsdcreateuserresult
  RAISING
    /AWS1/CX_DSDACCESSDENIEDEX
    /AWS1/CX_DSDCONFLICTEXCEPTION
    /AWS1/CX_DSDDIRECTORYUNAVAILEX
    /AWS1/CX_DSDINTERNALSERVEREX
    /AWS1/CX_DSDTHROTTLINGEX
    /AWS1/CX_DSDVALIDATIONEX
    /AWS1/CX_DSDCLIENTEXC
    /AWS1/CX_DSDSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_directoryid TYPE /AWS1/DSDDIRECTORYID /AWS1/DSDDIRECTORYID

The identifier (ID) of the directory that’s associated with the user.

iv_samaccountname TYPE /AWS1/DSDUSERNAME /AWS1/DSDUSERNAME

The name of the user.

Optional arguments:

iv_emailaddress TYPE /AWS1/DSDEMAILADDRESS /AWS1/DSDEMAILADDRESS

The email address of the user.

iv_givenname TYPE /AWS1/DSDGIVENNAME /AWS1/DSDGIVENNAME

The first name of the user.

iv_surname TYPE /AWS1/DSDSURNAME /AWS1/DSDSURNAME

The last name of the user.

it_otherattributes TYPE /AWS1/CL_DSDATTRIBUTEVALUE=>TT_ATTRIBUTES TT_ATTRIBUTES

An expression that defines one or more attribute names with the data type and value of each attribute. A key is an attribute name, and the value is a list of maps. For a list of supported attributes, see Directory Service Data Attributes.

Attribute names are case insensitive.

iv_clienttoken TYPE /AWS1/DSDCLIENTTOKEN /AWS1/DSDCLIENTTOKEN

A unique and case-sensitive identifier that you provide to make sure the idempotency of the request, so multiple identical calls have the same effect as one single call.

A client token is valid for 8 hours after the first request that uses it completes. After 8 hours, any request with the same client token is treated as a new request. If the request succeeds, any future uses of that token will be idempotent for another 8 hours.

If you submit a request with the same client token but change one of the other parameters within the 8-hour idempotency window, Directory Service Data returns an ConflictException.

This parameter is optional when using the CLI or SDK.

RETURNING

oo_output TYPE REF TO /aws1/cl_dsdcreateuserresult /AWS1/CL_DSDCREATEUSERRESULT

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->createuser(
  it_otherattributes = VALUE /aws1/cl_dsdattributevalue=>tt_attributes(
    (
      VALUE /aws1/cl_dsdattributevalue=>ts_attributes_maprow(
        value = new /aws1/cl_dsdattributevalue(
          it_ss = VALUE /aws1/cl_dsdstrsetattrvalue_w=>tt_stringsetattributevalue(
            ( new /aws1/cl_dsdstrsetattrvalue_w( |string| ) )
          )
          iv_bool = ABAP_TRUE
          iv_n = 123
          iv_s = |string|
        )
        key = |string|
      )
    )
  )
  iv_clienttoken = |string|
  iv_directoryid = |string|
  iv_emailaddress = |string|
  iv_givenname = |string|
  iv_samaccountname = |string|
  iv_surname = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_directoryid = lo_result->get_directoryid( ).
  lv_sid = lo_result->get_sid( ).
  lv_username = lo_result->get_samaccountname( ).
ENDIF.

To create a new user in the directory

The following command

DATA(lo_result) = lo_client->createuser(
  it_otherattributes = VALUE /aws1/cl_dsdattributevalue=>tt_attributes(
    (
      VALUE /aws1/cl_dsdattributevalue=>ts_attributes_maprow(
        value = new /aws1/cl_dsdattributevalue( iv_s = |HR| )
        key = |department|
      )
    )
    (
      VALUE /aws1/cl_dsdattributevalue=>ts_attributes_maprow(
        value = new /aws1/cl_dsdattributevalue( iv_s = |212-555-0100| )
        key = |homePhone|
      )
    )
  )
  iv_clienttoken = |550e8400-e29b-41d4-a716-446655440000|
  iv_directoryid = |d-12233abcde|
  iv_emailaddress = |pcandella@exampledomain.com|
  iv_givenname = |Pat Candella|
  iv_samaccountname = |pcandella|
  iv_surname = |Candella|
).