/AWS1/IF_SMC=>CREATECONTACT()

About CreateContact

Contacts are either the contacts that Incident Manager engages during an incident or the escalation plans that Incident Manager uses to engage contacts in phases during an incident.

Method Signature

METHODS /AWS1/IF_SMC~CREATECONTACT
  IMPORTING
    !IV_ALIAS TYPE /AWS1/SMCCONTACTALIAS OPTIONAL
    !IV_DISPLAYNAME TYPE /AWS1/SMCCONTACTNAME OPTIONAL
    !IV_TYPE TYPE /AWS1/SMCCONTACTTYPE OPTIONAL
    !IO_PLAN TYPE REF TO /AWS1/CL_SMCPLAN OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_SMCTAG=>TT_TAGSLIST OPTIONAL
    !IV_IDEMPOTENCYTOKEN TYPE /AWS1/SMCIDEMPOTENCYTOKEN OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_smccreatecontactrslt
  RAISING
    /AWS1/CX_SMCACCESSDENIEDEX
    /AWS1/CX_SMCCONFLICTEXCEPTION
    /AWS1/CX_SMCDATAENCEXCEPTION
    /AWS1/CX_SMCINTERNALSERVEREX
    /AWS1/CX_SMCSERVICEQUOTAEXCDEX
    /AWS1/CX_SMCTHROTTLINGEX
    /AWS1/CX_SMCVALIDATIONEX
    /AWS1/CX_SMCCLIENTEXC
    /AWS1/CX_SMCSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_alias TYPE /AWS1/SMCCONTACTALIAS /AWS1/SMCCONTACTALIAS

The short name to quickly identify a contact or escalation plan. The contact alias must be unique and identifiable.

iv_type TYPE /AWS1/SMCCONTACTTYPE /AWS1/SMCCONTACTTYPE

The type of contact to create.

• PERSONAL: A single, individual contact.

• ESCALATION: An escalation plan.

• ONCALL_SCHEDULE: An on-call schedule.

io_plan TYPE REF TO /AWS1/CL_SMCPLAN /AWS1/CL_SMCPLAN

A list of stages. A contact has an engagement plan with stages that contact specified contact channels. An escalation plan uses stages that contact specified contacts.

Optional arguments:

iv_displayname TYPE /AWS1/SMCCONTACTNAME /AWS1/SMCCONTACTNAME

The full name of the contact or escalation plan.

it_tags TYPE /AWS1/CL_SMCTAG=>TT_TAGSLIST TT_TAGSLIST

Adds a tag to the target. You can only tag resources created in the first Region of your replication set.

iv_idempotencytoken TYPE /AWS1/SMCIDEMPOTENCYTOKEN /AWS1/SMCIDEMPOTENCYTOKEN

A token ensuring that the operation is called only once with the specified details.

RETURNING

oo_output TYPE REF TO /aws1/cl_smccreatecontactrslt /AWS1/CL_SMCCREATECONTACTRSLT

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->createcontact(
  io_plan = new /aws1/cl_smcplan(
    it_rotationids = VALUE /aws1/cl_smcssmcontactsarnls00=>tt_ssmcontactsarnlist(
      ( new /aws1/cl_smcssmcontactsarnls00( |string| ) )
    )
    it_stages = VALUE /aws1/cl_smcstage=>tt_stageslist(
      (
        new /aws1/cl_smcstage(
          it_targets = VALUE /aws1/cl_smctarget=>tt_targetslist(
            (
              new /aws1/cl_smctarget(
                io_channeltargetinfo = new /aws1/cl_smcchanneltargetinfo(
                  iv_contactchannelid = |string|
                  iv_retryintervalinminutes = 123
                )
                io_contacttargetinfo = new /aws1/cl_smccontacttargetinfo(
                  iv_contactid = |string|
                  iv_isessential = ABAP_TRUE
                )
              )
            )
          )
          iv_durationinminutes = 123
        )
      )
    )
  )
  it_tags = VALUE /aws1/cl_smctag=>tt_tagslist(
    (
      new /aws1/cl_smctag(
        iv_key = |string|
        iv_value = |string|
      )
    )
  )
  iv_alias = |string|
  iv_displayname = |string|
  iv_idempotencytoken = |string|
  iv_type = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_ssmcontactsarn = lo_result->get_contactarn( ).
ENDIF.