Search All Related Items

connectcases_search_all_related_items

R Documentation

Searches for related items across all cases within a domain

Description

Searches for related items across all cases within a domain. This is a global search operation that returns related items from multiple cases, unlike the case-specific search_related_items API.

Use cases

Following are common uses cases for this API:

• Find cases with similar issues across the domain. For example, search for all cases containing comments about "product defect" to identify patterns and existing solutions.

• Locate all cases associated with specific contacts or orders. For example, find all cases linked to a contactArn to understand the complete customer journey.

• Monitor SLA compliance across cases. For example, search for all cases with "Active" SLA status to prioritize remediation efforts.

Important things to know

• This API returns case identifiers, not complete case objects. To retrieve full case details, you must make additional calls to the get_case API for each returned case ID.

• This API searches across related items content, not case fields. Use the search_cases API to search within case field values.

Endpoints: See Amazon Connect endpoints and quotas.

Usage

connectcases_search_all_related_items(domainId, maxResults, nextToken,
  filters, sorts)

Arguments

domainId	[required] The unique identifier of the Cases domain.
maxResults	The maximum number of results to return per page.
nextToken	The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
filters	The list of types of related items and their parameters to use for filtering. The filters work as an OR condition: caller gets back related items that match any of the specified filter types.
sorts	A structured set of sort terms to specify the order in which related items should be returned. Supports sorting by association time or case ID. The sorts work in the order specified: first sort term takes precedence over subsequent terms.

Value

A list with the following syntax:

list(
  nextToken = "string",
  relatedItems = list(
    list(
      relatedItemId = "string",
      caseId = "string",
      type = "Contact"|"Comment"|"File"|"Sla"|"ConnectCase"|"Custom",
      associationTime = as.POSIXct(
        "2015-01-01"
      ),
      content = list(
        contact = list(
          contactArn = "string",
          channel = "string",
          connectedToSystemTime = as.POSIXct(
            "2015-01-01"
          )
        ),
        comment = list(
          body = "string",
          contentType = "Text/Plain"
        ),
        file = list(
          fileArn = "string"
        ),
        sla = list(
          slaConfiguration = list(
            name = "string",
            type = "CaseField",
            status = "Active"|"Overdue"|"Met"|"NotMet",
            fieldId = "string",
            targetFieldValues = list(
              list(
                stringValue = "string",
                doubleValue = 123.0,
                booleanValue = TRUE|FALSE,
                emptyValue = list(),
                userArnValue = "string"
              )
            ),
            targetTime = as.POSIXct(
              "2015-01-01"
            ),
            completionTime = as.POSIXct(
              "2015-01-01"
            )
          )
        ),
        connectCase = list(
          caseId = "string"
        ),
        custom = list(
          fields = list(
            list(
              id = "string",
              value = list(
                stringValue = "string",
                doubleValue = 123.0,
                booleanValue = TRUE|FALSE,
                emptyValue = list(),
                userArnValue = "string"
              )
            )
          )
        )
      ),
      performedBy = list(
        userArn = "string",
        customEntity = "string"
      ),
      tags = list(
        "string"
      )
    )
  )
)

Request syntax

svc$search_all_related_items(
  domainId = "string",
  maxResults = 123,
  nextToken = "string",
  filters = list(
    list(
      contact = list(
        channel = list(
          "string"
        ),
        contactArn = "string"
      ),
      comment = list(),
      file = list(
        fileArn = "string"
      ),
      sla = list(
        name = "string",
        status = "Active"|"Overdue"|"Met"|"NotMet"
      ),
      connectCase = list(
        caseId = "string"
      ),
      custom = list(
        fields = list(
          field = list(
            equalTo = list(
              id = "string",
              value = list(
                stringValue = "string",
                doubleValue = 123.0,
                booleanValue = TRUE|FALSE,
                emptyValue = list(),
                userArnValue = "string"
              )
            ),
            contains = list(
              id = "string",
              value = list(
                stringValue = "string",
                doubleValue = 123.0,
                booleanValue = TRUE|FALSE,
                emptyValue = list(),
                userArnValue = "string"
              )
            ),
            greaterThan = list(
              id = "string",
              value = list(
                stringValue = "string",
                doubleValue = 123.0,
                booleanValue = TRUE|FALSE,
                emptyValue = list(),
                userArnValue = "string"
              )
            ),
            greaterThanOrEqualTo = list(
              id = "string",
              value = list(
                stringValue = "string",
                doubleValue = 123.0,
                booleanValue = TRUE|FALSE,
                emptyValue = list(),
                userArnValue = "string"
              )
            ),
            lessThan = list(
              id = "string",
              value = list(
                stringValue = "string",
                doubleValue = 123.0,
                booleanValue = TRUE|FALSE,
                emptyValue = list(),
                userArnValue = "string"
              )
            ),
            lessThanOrEqualTo = list(
              id = "string",
              value = list(
                stringValue = "string",
                doubleValue = 123.0,
                booleanValue = TRUE|FALSE,
                emptyValue = list(),
                userArnValue = "string"
              )
            )
          ),
          not = list(),
          andAll = list(
            list()
          ),
          orAll = list(
            list()
          )
        )
      )
    )
  ),
  sorts = list(
    list(
      sortProperty = "AssociationTime"|"CaseId",
      sortOrder = "Asc"|"Desc"
    )
  )
)