/AWS1/IF_CNT=>SEARCHDATATABLES()

About SearchDataTables

Searches for data tables based on the table's ID, name, and description. In the future, this operation can support searching on attribute names and possibly primary values. Follows other search operations closely and supports both search criteria and filters.

Method Signature

METHODS /AWS1/IF_CNT~SEARCHDATATABLES
  IMPORTING
    !IV_INSTANCEID TYPE /AWS1/CNTINSTANCEID OPTIONAL
    !IV_NEXTTOKEN TYPE /AWS1/CNTNEXTTOKEN OPTIONAL
    !IV_MAXRESULTS TYPE /AWS1/CNTMAXRESULT1000 OPTIONAL
    !IO_SEARCHFILTER TYPE REF TO /AWS1/CL_CNTDATATABLESRCHFILT OPTIONAL
    !IO_SEARCHCRITERIA TYPE REF TO /AWS1/CL_CNTDATATABLESRCHCRIT OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_cntsrchdatatablesrsp
  RAISING
    /AWS1/CX_CNTINTERNALSERVICEEX
    /AWS1/CX_CNTINVALIDPARAMETEREX
    /AWS1/CX_CNTINVALIDREQUESTEX
    /AWS1/CX_CNTRESOURCENOTFOUNDEX
    /AWS1/CX_CNTTHROTTLINGEX
    /AWS1/CX_CNTCLIENTEXC
    /AWS1/CX_CNTSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_instanceid TYPE /AWS1/CNTINSTANCEID /AWS1/CNTINSTANCEID

The unique identifier for the Amazon Connect instance to search within.

Optional arguments:

iv_nexttoken TYPE /AWS1/CNTNEXTTOKEN /AWS1/CNTNEXTTOKEN

Specify the pagination token from a previous request to retrieve the next page of results.

iv_maxresults TYPE /AWS1/CNTMAXRESULT1000 /AWS1/CNTMAXRESULT1000

The maximum number of data tables to return in one page of results.

io_searchfilter TYPE REF TO /AWS1/CL_CNTDATATABLESRCHFILT /AWS1/CL_CNTDATATABLESRCHFILT

Optional filters to apply to the search results, such as tag-based filtering for attribute-based access control.

io_searchcriteria TYPE REF TO /AWS1/CL_CNTDATATABLESRCHCRIT /AWS1/CL_CNTDATATABLESRCHCRIT

Search criteria including string conditions for matching table names, descriptions, or resource IDs. Supports STARTS_WITH, CONTAINS, and EXACT comparison types.

RETURNING

oo_output TYPE REF TO /aws1/cl_cntsrchdatatablesrsp /AWS1/CL_CNTSRCHDATATABLESRSP

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->searchdatatables(
  io_searchcriteria = new /aws1/cl_cntdatatablesrchcrit(
    io_stringcondition = new /aws1/cl_cntstringcondition(
      iv_comparisontype = |string|
      iv_fieldname = |string|
      iv_value = |string|
    )
    it_andconditions = VALUE /aws1/cl_cntdatatablesrchcrit=>tt_datatablesearchcondlist(
      (
        new /aws1/cl_cntdatatablesrchcrit(
          io_stringcondition = new /aws1/cl_cntstringcondition(
            iv_comparisontype = |string|
            iv_fieldname = |string|
            iv_value = |string|
          )
          it_orconditions = VALUE /aws1/cl_cntdatatablesrchcrit=>tt_datatablesearchcondlist(
          )
        )
      )
    )
    it_orconditions = VALUE /aws1/cl_cntdatatablesrchcrit=>tt_datatablesearchcondlist(
      (
        new /aws1/cl_cntdatatablesrchcrit(
          io_stringcondition = new /aws1/cl_cntstringcondition(
            iv_comparisontype = |string|
            iv_fieldname = |string|
            iv_value = |string|
          )
          it_andconditions = VALUE /aws1/cl_cntdatatablesrchcrit=>tt_datatablesearchcondlist(
          )
        )
      )
    )
  )
  io_searchfilter = new /aws1/cl_cntdatatablesrchfilt(
    io_attributefilter = new /aws1/cl_cntctlplaneattrfilter(
      io_andcondition = new /aws1/cl_cntcommonattrandcond(
        it_tagconditions = VALUE /aws1/cl_cnttagcondition=>tt_tagandconditionlist(
          (
            new /aws1/cl_cnttagcondition(
              iv_tagkey = |string|
              iv_tagvalue = |string|
            )
          )
        )
      )
      io_tagcondition = new /aws1/cl_cnttagcondition(
        iv_tagkey = |string|
        iv_tagvalue = |string|
      )
      it_orconditions = VALUE /aws1/cl_cntcommonattrandcond=>tt_commonattrorconditionlist(
        (
          new /aws1/cl_cntcommonattrandcond(
            it_tagconditions = VALUE /aws1/cl_cnttagcondition=>tt_tagandconditionlist(
              (
                new /aws1/cl_cnttagcondition(
                  iv_tagkey = |string|
                  iv_tagvalue = |string|
                )
              )
            )
          )
        )
      )
    )
  )
  iv_instanceid = |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_datatables( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_datatablename = lo_row_1->get_name( ).
      lv_datatableid = lo_row_1->get_id( ).
      lv_arn = lo_row_1->get_arn( ).
      lv_timezone = lo_row_1->get_timezone( ).
      lv_datatabledescription = lo_row_1->get_description( ).
      lv_datatablelocklevel = lo_row_1->get_valuelocklevel( ).
      lo_datatablelockversion = lo_row_1->get_lockversion( ).
      IF lo_datatablelockversion IS NOT INITIAL.
        lv_string = lo_datatablelockversion->get_datatable( ).
        lv_string = lo_datatablelockversion->get_attribute( ).
        lv_string = lo_datatablelockversion->get_primaryvalues( ).
        lv_string = lo_datatablelockversion->get_value( ).
      ENDIF.
      lv_datatableversion = lo_row_1->get_version( ).
      lv_datatabledescription = lo_row_1->get_versiondescription( ).
      lv_datatablestatus = lo_row_1->get_status( ).
      lv_timestamp = lo_row_1->get_createdtime( ).
      lv_timestamp = lo_row_1->get_lastmodifiedtime( ).
      lv_regionname = lo_row_1->get_lastmodifiedregion( ).
      LOOP AT lo_row_1->get_tags( ) into ls_row_2.
        lv_key = ls_row_2-key.
        lo_value = ls_row_2-value.
        IF lo_value IS NOT INITIAL.
          lv_tagvalue = lo_value->get_value( ).
        ENDIF.
      ENDLOOP.
    ENDIF.
  ENDLOOP.
  lv_nexttoken = lo_result->get_nexttoken( ).
  lv_approximatetotalcount = lo_result->get_approximatetotalcount( ).
ENDIF.