Skip to content

/AWS1/IF_CBO=>CREMICROSOFTTEAMSCHANNELCONF()

About CreateMicrosoftTeamsChannelConfiguration

Creates an AWS Chatbot configuration for Microsoft Teams.

Method Signature

METHODS /AWS1/IF_CBO~CREMICROSOFTTEAMSCHANNELCONF
  IMPORTING
    !IV_CHANNELID TYPE /AWS1/CBOTEAMSCHANNELID OPTIONAL
    !IV_CHANNELNAME TYPE /AWS1/CBOTEAMSCHANNELNAME OPTIONAL
    !IV_TEAMID TYPE /AWS1/CBOUUID OPTIONAL
    !IV_TEAMNAME TYPE /AWS1/CBOTEAMNAME OPTIONAL
    !IV_TENANTID TYPE /AWS1/CBOUUID OPTIONAL
    !IT_SNSTOPICARNS TYPE /AWS1/CL_CBOSNSTOPICARNLIST_W=>TT_SNSTOPICARNLIST OPTIONAL
    !IV_IAMROLEARN TYPE /AWS1/CBOARN OPTIONAL
    !IV_CONFIGURATIONNAME TYPE /AWS1/CBOCONFIGURATIONNAME OPTIONAL
    !IV_LOGGINGLEVEL TYPE /AWS1/CBOCUSTOMERCWLOGLEVEL OPTIONAL
    !IT_GUARDRAILPOLICYARNS TYPE /AWS1/CL_CBOGUARDRAILPLYARNL00=>TT_GUARDRAILPOLICYARNLIST OPTIONAL
    !IV_USERAUTHORIZATIONREQUIRED TYPE /AWS1/CBOBLNACCOUNTPREFERENCE OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_CBOTAG=>TT_TAGS OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_cbocreteamschannelc01
  RAISING
    /AWS1/CX_CBOCONFLICTEXCEPTION
    /AWS1/CX_CBOCRETEAMSCHANNELC00
    /AWS1/CX_CBOINVALIDPARAMETEREX
    /AWS1/CX_CBOINVALIDREQUESTEX
    /AWS1/CX_CBOLIMITEXCEEDEDEX
    /AWS1/CX_CBOCLIENTEXC
    /AWS1/CX_CBOSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_channelid TYPE /AWS1/CBOTEAMSCHANNELID /AWS1/CBOTEAMSCHANNELID

The ID of the Microsoft Teams channel.

iv_teamid TYPE /AWS1/CBOUUID /AWS1/CBOUUID

The ID of the Microsoft Teams authorized with AWS Chatbot.

To get the team ID, you must perform the initial authorization flow with Microsoft Teams in the AWS Chatbot console. Then you can copy and paste the team ID from the console. For more information, see Step 1: Configure a Microsoft Teams client in the AWS Chatbot Administrator Guide.

iv_tenantid TYPE /AWS1/CBOUUID /AWS1/CBOUUID

The ID of the Microsoft Teams tenant.

iv_iamrolearn TYPE /AWS1/CBOARN /AWS1/CBOARN

A user-defined role that AWS Chatbot assumes. This is not the service-linked role.

For more information, see IAM policies for AWS Chatbot in the AWS Chatbot Administrator Guide.

iv_configurationname TYPE /AWS1/CBOCONFIGURATIONNAME /AWS1/CBOCONFIGURATIONNAME

The name of the configuration.

Optional arguments:

iv_channelname TYPE /AWS1/CBOTEAMSCHANNELNAME /AWS1/CBOTEAMSCHANNELNAME

The name of the Microsoft Teams channel.

iv_teamname TYPE /AWS1/CBOTEAMNAME /AWS1/CBOTEAMNAME

The name of the Microsoft Teams Team.

it_snstopicarns TYPE /AWS1/CL_CBOSNSTOPICARNLIST_W=>TT_SNSTOPICARNLIST TT_SNSTOPICARNLIST

The Amazon Resource Names (ARNs) of the SNS topics that deliver notifications to AWS Chatbot.

iv_logginglevel TYPE /AWS1/CBOCUSTOMERCWLOGLEVEL /AWS1/CBOCUSTOMERCWLOGLEVEL

Logging levels include ERROR, INFO, or NONE.

it_guardrailpolicyarns TYPE /AWS1/CL_CBOGUARDRAILPLYARNL00=>TT_GUARDRAILPOLICYARNLIST TT_GUARDRAILPOLICYARNLIST

The list of IAM policy ARNs that are applied as channel guardrails. The AWS managed AdministratorAccess policy is applied by default if this is not set.

iv_userauthorizationrequired TYPE /AWS1/CBOBLNACCOUNTPREFERENCE /AWS1/CBOBLNACCOUNTPREFERENCE

Enables use of a user role requirement in your chat configuration.

it_tags TYPE /AWS1/CL_CBOTAG=>TT_TAGS TT_TAGS

A map of tags assigned to a resource. A tag is a string-to-string map of key-value pairs.

RETURNING

oo_output TYPE REF TO /aws1/cl_cbocreteamschannelc01 /AWS1/CL_CBOCRETEAMSCHANNELC01

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->cremicrosoftteamschannelconf(
  it_guardrailpolicyarns = VALUE /aws1/cl_cboguardrailplyarnl00=>tt_guardrailpolicyarnlist(
    ( new /aws1/cl_cboguardrailplyarnl00( |string| ) )
  )
  it_snstopicarns = VALUE /aws1/cl_cbosnstopicarnlist_w=>tt_snstopicarnlist(
    ( new /aws1/cl_cbosnstopicarnlist_w( |string| ) )
  )
  it_tags = VALUE /aws1/cl_cbotag=>tt_tags(
    (
      new /aws1/cl_cbotag(
        iv_tagkey = |string|
        iv_tagvalue = |string|
      )
    )
  )
  iv_channelid = |string|
  iv_channelname = |string|
  iv_configurationname = |string|
  iv_iamrolearn = |string|
  iv_logginglevel = |string|
  iv_teamid = |string|
  iv_teamname = |string|
  iv_tenantid = |string|
  iv_userauthorizationrequired = ABAP_TRUE
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_teamschannelconfigurati = lo_result->get_channelconfiguration( ).
  IF lo_teamschannelconfigurati IS NOT INITIAL.
    lv_teamschannelid = lo_teamschannelconfigurati->get_channelid( ).
    lv_teamschannelname = lo_teamschannelconfigurati->get_channelname( ).
    lv_uuid = lo_teamschannelconfigurati->get_teamid( ).
    lv_teamname = lo_teamschannelconfigurati->get_teamname( ).
    lv_uuid = lo_teamschannelconfigurati->get_tenantid( ).
    lv_chatconfigurationarn = lo_teamschannelconfigurati->get_chatconfigurationarn( ).
    lv_arn = lo_teamschannelconfigurati->get_iamrolearn( ).
    LOOP AT lo_teamschannelconfigurati->get_snstopicarns( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_arn = lo_row_1->get_value( ).
      ENDIF.
    ENDLOOP.
    lv_configurationname = lo_teamschannelconfigurati->get_configurationname( ).
    lv_customercwloglevel = lo_teamschannelconfigurati->get_logginglevel( ).
    LOOP AT lo_teamschannelconfigurati->get_guardrailpolicyarns( ) into lo_row_2.
      lo_row_3 = lo_row_2.
      IF lo_row_3 IS NOT INITIAL.
        lv_guardrailpolicyarn = lo_row_3->get_value( ).
      ENDIF.
    ENDLOOP.
    lv_booleanaccountpreferenc = lo_teamschannelconfigurati->get_userauthrequired( ).
    LOOP AT lo_teamschannelconfigurati->get_tags( ) into lo_row_4.
      lo_row_5 = lo_row_4.
      IF lo_row_5 IS NOT INITIAL.
        lv_tagkey = lo_row_5->get_tagkey( ).
        lv_tagvalue = lo_row_5->get_tagvalue( ).
      ENDIF.
    ENDLOOP.
    lv_resourcestate = lo_teamschannelconfigurati->get_state( ).
    lv_string = lo_teamschannelconfigurati->get_statereason( ).
  ENDIF.
ENDIF.