Skip to content

/AWS1/CL_DSR=>STARTSCHEMAEXTENSION()

About StartSchemaExtension

Applies a schema extension to a Microsoft AD directory.

Method Signature

IMPORTING

Required arguments:

iv_directoryid TYPE /AWS1/DSRDIRECTORYID /AWS1/DSRDIRECTORYID

The identifier of the directory for which the schema extension will be applied to.

iv_createsnapbfrschextension TYPE /AWS1/DSRCRESNAPBFRSCHEXTENS00 /AWS1/DSRCRESNAPBFRSCHEXTENS00

If true, creates a snapshot of the directory before applying the schema extension.

iv_ldifcontent TYPE /AWS1/DSRLDIFCONTENT /AWS1/DSRLDIFCONTENT

The LDIF file represented as a string. To construct the LdifContent string, precede each line as it would be formatted in an ldif file with \n. See the example request below for more details. The file size can be no larger than 1MB.

iv_description TYPE /AWS1/DSRDESCRIPTION /AWS1/DSRDESCRIPTION

A description of the schema extension.

RETURNING

oo_output TYPE REF TO /aws1/cl_dsrstrtschextensionrs /AWS1/CL_DSRSTRTSCHEXTENSIONRS

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->/aws1/if_dsr~startschemaextension(
  iv_createsnapbfrschextension = ABAP_TRUE
  iv_description = |string|
  iv_directoryid = |string|
  iv_ldifcontent = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_schemaextensionid = lo_result->get_schemaextensionid( ).
ENDIF.

To start a schema extension

The following example applies a schema extension to a specified Microsoft AD directory.

DATA(lo_result) = lo_client->/aws1/if_dsr~startschemaextension(
  iv_createsnapbfrschextension = ABAP_TRUE
  iv_description = |Adds maycontain attribute to user class. Precede each line as it would be formatted in an ldif file.|
  iv_directoryid = |d-92654abfed|
  iv_ldifcontent = |dn: CN=User,CN=Schema,CN=Configuration,DC=sales,DC=example,DC=com
  changetype: modify
  add: mayContain
  mayContain: drink
  -

  DN:
  changetype: modify
  replace: schemaupdatenow
  schemaupdatenow: 1
  -|
).