Skip to content

/AWS1/IF_PTS=>UPDATEENGAGEMENTCONTEXT()

About UpdateEngagementContext

Updates the context information for an existing engagement with new or modified data.

Method Signature

METHODS /AWS1/IF_PTS~UPDATEENGAGEMENTCONTEXT
  IMPORTING
    !IV_CATALOG TYPE /AWS1/PTSCATALOGIDENTIFIER OPTIONAL
    !IV_ENGAGEMENTIDENTIFIER TYPE /AWS1/PTSENGAGEMENTARNORID OPTIONAL
    !IV_CONTEXTIDENTIFIER TYPE /AWS1/PTSENGAGEMENTCONTEXTID OPTIONAL
    !IV_ENGAGEMENTLASTMODIFIEDAT TYPE /AWS1/PTSDATETIME OPTIONAL
    !IV_TYPE TYPE /AWS1/PTSENGAGEMENTCONTEXTTYPE OPTIONAL
    !IO_PAYLOAD TYPE REF TO /AWS1/CL_PTSUPENGAGEMENTCTXP00 OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_ptsupengagementctxrsp
  RAISING
    /AWS1/CX_PTSACCESSDENIEDEX
    /AWS1/CX_PTSCONFLICTEXCEPTION
    /AWS1/CX_PTSINTERNALSERVEREX
    /AWS1/CX_PTSRESOURCENOTFOUNDEX
    /AWS1/CX_PTSSERVICEQUOTAEXCDEX
    /AWS1/CX_PTSTHROTTLINGEX
    /AWS1/CX_PTSVALIDATIONEX
    /AWS1/CX_PTSCLIENTEXC
    /AWS1/CX_PTSSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_catalog TYPE /AWS1/PTSCATALOGIDENTIFIER /AWS1/PTSCATALOGIDENTIFIER

Specifies the catalog associated with the engagement context update request. This field takes a string value from a predefined list: AWS or Sandbox. The catalog determines which environment the engagement context is updated in.

iv_engagementidentifier TYPE /AWS1/PTSENGAGEMENTARNORID /AWS1/PTSENGAGEMENTARNORID

The unique identifier of the Engagement containing the context to be updated. This parameter ensures the context update is applied to the correct engagement.

iv_contextidentifier TYPE /AWS1/PTSENGAGEMENTCONTEXTID /AWS1/PTSENGAGEMENTCONTEXTID

The unique identifier of the specific engagement context to be updated. This ensures that the correct context within the engagement is modified.

iv_engagementlastmodifiedat TYPE /AWS1/PTSDATETIME /AWS1/PTSDATETIME

The timestamp when the engagement was last modified, used for optimistic concurrency control. This helps prevent conflicts when multiple users attempt to update the same engagement simultaneously.

iv_type TYPE /AWS1/PTSENGAGEMENTCONTEXTTYPE /AWS1/PTSENGAGEMENTCONTEXTTYPE

Specifies the type of context being updated within the engagement. This field determines the structure and content of the context payload being modified.

io_payload TYPE REF TO /AWS1/CL_PTSUPENGAGEMENTCTXP00 /AWS1/CL_PTSUPENGAGEMENTCTXP00

Contains the updated contextual information for the engagement. The structure of this payload varies based on the context type specified in the Type field.

RETURNING

oo_output TYPE REF TO /aws1/cl_ptsupengagementctxrsp /AWS1/CL_PTSUPENGAGEMENTCTXRSP

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->updateengagementcontext(
  io_payload = new /aws1/cl_ptsupengagementctxp00(
    io_customerproject = new /aws1/cl_ptscusprojectscontext(
      io_customer = new /aws1/cl_ptsengagementcustomer(
        iv_companyname = |string|
        iv_countrycode = |string|
        iv_industry = |string|
        iv_websiteurl = |string|
      )
      io_project = new /aws1/cl_ptsengagementcuspro00(
        iv_businessproblem = |string|
        iv_targetcompletiondate = |string|
        iv_title = |string|
      )
    )
    io_lead = new /aws1/cl_ptsupdateleadcontext(
      io_customer = new /aws1/cl_ptsleadcustomer(
        io_address = new /aws1/cl_ptsaddresssummary(
          iv_city = |string|
          iv_countrycode = |string|
          iv_postalcode = |string|
          iv_stateorregion = |string|
        )
        iv_awsmaturity = |string|
        iv_companyname = |string|
        iv_industry = |string|
        iv_marketsegment = |string|
        iv_websiteurl = |string|
      )
      io_interaction = new /aws1/cl_ptsleadinteraction(
        io_contact = new /aws1/cl_ptsleadcontact(
          iv_businesstitle = |string|
          iv_email = |string|
          iv_firstname = |string|
          iv_lastname = |string|
          iv_phone = |string|
        )
        iv_businessproblem = |string|
        iv_customeraction = |string|
        iv_interactiondate = '20150101000000.0000000'
        iv_sourceid = |string|
        iv_sourcename = |string|
        iv_sourcetype = |string|
        iv_usecase = |string|
      )
      iv_qualificationstatus = |string|
    )
  )
  iv_catalog = |string|
  iv_contextidentifier = |string|
  iv_engagementidentifier = |string|
  iv_engagementlastmodifiedat = '20150101000000.0000000'
  iv_type = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_engagementidentifier = lo_result->get_engagementid( ).
  lv_engagementarn = lo_result->get_engagementarn( ).
  lv_datetime = lo_result->get_engagementlastmodifiedat( ).
  lv_engagementcontextidenti = lo_result->get_contextid( ).
ENDIF.