ConnectCases / Client / search_related_items

search_related_items

ConnectCases.Client.search_related_items(**kwargs)

Searches for related items that are associated with a case.

Note

If no filters are provided, this returns all related items associated with a case.

See also: AWS API Documentation

Request Syntax

response = client.search_related_items(
    caseId='string',
    domainId='string',
    filters=[
        {
            'comment': {}
            ,
            'contact': {
                'channel': [
                    'string',
                ],
                'contactArn': 'string'
            },
            'file': {
                'fileArn': 'string'
            }
        },
    ],
    maxResults=123,
    nextToken='string'
)

Parameters:

• caseId (string) –

  [REQUIRED]

  A unique identifier of the case.

• domainId (string) –

  [REQUIRED]

  The unique identifier of the Cases domain.

• filters (list) –

  The list of types of related items and their parameters to use for filtering.

  • (dict) –

    The list of types of related items and their parameters to use for filtering.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: comment, contact, file.

    • comment (dict) –

      A filter for related items of type Comment.

    • contact (dict) –

      A filter for related items of type Contact.

      • channel (list) –

        A list of channels to filter on for related items of type Contact.

        • (string) –

      • contactArn (string) –

        A unique identifier of a contact in Amazon Connect.

    • file (dict) –

      A filter for related items of this type of File.

      • fileArn (string) –

        The Amazon Resource Name (ARN) of the file.

• maxResults (integer) – The maximum number of results to return per page.

• nextToken (string) – 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.

Return type:

dict

Returns:

Response Syntax

{
    'nextToken': 'string',
    'relatedItems': [
        {
            'associationTime': datetime(2015, 1, 1),
            'content': {
                'comment': {
                    'body': 'string',
                    'contentType': 'Text/Plain'
                },
                'contact': {
                    'channel': 'string',
                    'connectedToSystemTime': datetime(2015, 1, 1),
                    'contactArn': 'string'
                },
                'file': {
                    'fileArn': 'string'
                }
            },
            'performedBy': {
                'userArn': 'string'
            },
            'relatedItemId': 'string',
            'tags': {
                'string': 'string'
            },
            'type': 'Contact'|'Comment'|'File'
        },
    ]
}

Response Structure

• (dict) –

  • nextToken (string) –

    The token for the next set of results. This is null if there are no more results to return.

  • relatedItems (list) –

    A list of items related to a case.

    • (dict) –

      A list of items that represent RelatedItems.

      • associationTime (datetime) –

        Time at which a related item was associated with a case.

      • content (dict) –

        Represents the content of a particular type of related item.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: comment, contact, file. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        

        • comment (dict) –

          Represents the content of a comment to be returned to agents.

          • body (string) –

            Text in the body of a Comment on a case.

          • contentType (string) –

            Type of the text in the box of a Comment on a case.

        • contact (dict) –

          Represents the content of a contact to be returned to agents.

          • channel (string) –

            A list of channels to filter on for related items of type Contact.

          • connectedToSystemTime (datetime) –

            The difference between the InitiationTimestamp and the DisconnectTimestamp of the contact.

          • contactArn (string) –

            A unique identifier of a contact in Amazon Connect.

        • file (dict) –

          Represents the content of a File to be returned to agents.

          • fileArn (string) –

            The Amazon Resource Name (ARN) of a File in Amazon Connect.

      • performedBy (dict) –

        Represents the creator of the related item.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: userArn. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        

        • userArn (string) –

          Represents the Amazon Connect ARN of the user.

      • relatedItemId (string) –

        Unique identifier of a related item.

      • tags (dict) –

        A map of of key-value pairs that represent tags on a resource. Tags are used to organize, track, or control access for this resource.

        • (string) –

          • (string) –

      • type (string) –

        Type of a related item.

Exceptions

• ConnectCases.Client.exceptions.InternalServerException

• ConnectCases.Client.exceptions.ResourceNotFoundException

• ConnectCases.Client.exceptions.ValidationException

• ConnectCases.Client.exceptions.ThrottlingException

• ConnectCases.Client.exceptions.AccessDeniedException