Skip to content

/AWS1/CL_PTS=>LSTENGAGEMENTFRMOPPORTUNIT00()

About ListEngagementFromOpportunityTasks

Lists all in-progress, completed, or failed EngagementFromOpportunity tasks that were initiated by the caller's account.

Method Signature

IMPORTING

Required arguments:

iv_catalog TYPE /AWS1/PTSCATALOGIDENTIFIER /AWS1/PTSCATALOGIDENTIFIER

Specifies the catalog related to the request. Valid values are:

  • AWS: Retrieves the request from the production AWS environment.

  • Sandbox: Retrieves the request from a sandbox environment used for testing or development purposes.

Optional arguments:

iv_maxresults TYPE /AWS1/PTSINTEGER /AWS1/PTSINTEGER

Specifies the maximum number of results to return in a single page of the response.Use this parameter to control the number of items returned in each request, which can be useful for performance tuning and managing large result sets.

iv_nexttoken TYPE /AWS1/PTSSTRING /AWS1/PTSSTRING

The token for requesting the next page of results. This value is obtained from the NextToken field in the response of a previous call to this API. Use this parameter for pagination when the result set spans multiple pages.

io_sort TYPE REF TO /AWS1/CL_PTSLISTTASKSSORTBASE /AWS1/CL_PTSLISTTASKSSORTBASE

Specifies the sorting criteria for the returned results. This allows you to order the tasks based on specific attributes.

it_taskstatus TYPE /AWS1/CL_PTSTASKSTATUSES_W=>TT_TASKSTATUSES TT_TASKSTATUSES

Filters the tasks based on their current status. This allows you to focus on tasks in specific states.

it_taskidentifier TYPE /AWS1/CL_PTSTASKIDENTIFIERS_W=>TT_TASKIDENTIFIERS TT_TASKIDENTIFIERS

Filters tasks by their unique identifiers. Use this when you want to retrieve information about specific tasks.

it_opportunityidentifier TYPE /AWS1/CL_PTSOPPORTUNITYIDS_W=>TT_OPPORTUNITYIDENTIFIERS TT_OPPORTUNITYIDENTIFIERS

The identifier of the original opportunity associated with this task.

it_engagementidentifier TYPE /AWS1/CL_PTSENGAGEMENTIDS_W=>TT_ENGAGEMENTIDENTIFIERS TT_ENGAGEMENTIDENTIFIERS

Filters tasks by the identifiers of the engagements they created or are associated with.

RETURNING

oo_output TYPE REF TO /aws1/cl_ptslstengagementfrm01 /AWS1/CL_PTSLSTENGAGEMENTFRM01

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_pts~lstengagementfrmopportunit00(
  io_sort = new /aws1/cl_ptslisttaskssortbase(
    iv_sortby = |string|
    iv_sortorder = |string|
  )
  it_engagementidentifier = VALUE /aws1/cl_ptsengagementids_w=>tt_engagementidentifiers(
    ( new /aws1/cl_ptsengagementids_w( |string| ) )
  )
  it_opportunityidentifier = VALUE /aws1/cl_ptsopportunityids_w=>tt_opportunityidentifiers(
    ( new /aws1/cl_ptsopportunityids_w( |string| ) )
  )
  it_taskidentifier = VALUE /aws1/cl_ptstaskidentifiers_w=>tt_taskidentifiers(
    ( new /aws1/cl_ptstaskidentifiers_w( |string| ) )
  )
  it_taskstatus = VALUE /aws1/cl_ptstaskstatuses_w=>tt_taskstatuses(
    ( new /aws1/cl_ptstaskstatuses_w( |string| ) )
  )
  iv_catalog = |string|
  iv_maxresults = 123
  iv_nexttoken = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  LOOP AT lo_result->get_tasksummaries( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_taskidentifier = lo_row_1->get_taskid( ).
      lv_taskarn = lo_row_1->get_taskarn( ).
      lv_datetime = lo_row_1->get_starttime( ).
      lv_taskstatus = lo_row_1->get_taskstatus( ).
      lv_string = lo_row_1->get_message( ).
      lv_reasoncode = lo_row_1->get_reasoncode( ).
      lv_opportunityidentifier = lo_row_1->get_opportunityid( ).
      lv_resourcesnapshotjobiden = lo_row_1->get_resourcesnapshotjobid( ).
      lv_engagementidentifier = lo_row_1->get_engagementid( ).
      lv_engagementinvitationide = lo_row_1->get_engagementinvitationid( ).
    ENDIF.
  ENDLOOP.
  lv_string = lo_result->get_nexttoken( ).
ENDIF.