ConnectCases / Paginator / SearchRelatedItems

SearchRelatedItems¶

class ConnectCases.Paginator.SearchRelatedItems¶

paginator = client.get_paginator('search_related_items')

paginate(**kwargs)¶

Creates an iterator that will paginate through responses from ConnectCases.Client.search_related_items().

Request Syntax

response_iterator = paginator.paginate(
    caseId='string',
    domainId='string',
    filters=[
        {
            'comment': {}
            ,
            'contact': {
                'channel': [
                    'string',
                ],
                'contactArn': 'string'
            },
            'file': {
                'fileArn': 'string'
            },
            'sla': {
                'name': 'string',
                'status': 'Active'|'Overdue'|'Met'|'NotMet'
            }
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': '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, sla.
  - 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.
  - sla (dict) –
    
    Filter for related items of type SLA.
    - name (string) –
      
      Name of an SLA.
    - status (string) –
      
      Status of an SLA.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
- MaxItems (integer) –
  
  The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
- PageSize (integer) –
  
  The size of each page.
- StartingToken (string) –
  
  A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    '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'
                },
                'sla': {
                    'slaConfiguration': {
                        'completionTime': datetime(2015, 1, 1),
                        'fieldId': 'string',
                        'name': 'string',
                        'status': 'Active'|'Overdue'|'Met'|'NotMet',
                        'targetFieldValues': [
                            {
                                'booleanValue': True|False,
                                'doubleValue': 123.0,
                                'emptyValue': {},
                                'stringValue': 'string',
                                'userArnValue': 'string'
                            },
                        ],
                        'targetTime': datetime(2015, 1, 1),
                        'type': 'CaseField'
                    }
                }
            },
            'performedBy': {
                'userArn': 'string'
            },
            'relatedItemId': 'string',
            'tags': {
                'string': 'string'
            },
            'type': 'Contact'|'Comment'|'File'|'Sla'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- 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, sla. 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.
      - sla (dict) –
        
        Represents the content of an SLA to be returned to agents.
        
        slaConfiguration (dict) –
        
        Represents an SLA configuration.
        
        completionTime (datetime) –
        
        Time at which an SLA was completed.
        
        fieldId (string) –
        
        Unique identifier of a field.
        
        name (string) –
        
        Name of an SLA.
        
        status (string) –
        
        Status of an SLA.
        
        targetFieldValues (list) –
        
        Represents a list of target field values for the fieldId specified in SlaConfiguration.
        
        (dict) –
        
        Object to store union of Field values.
        
        Note
        The Summary system field accepts 3000 characters while all other fields accept 500 characters.
        
        Note
        This is a Tagged Union structure. Only one of the following top level keys will be set: booleanValue, doubleValue, emptyValue, stringValue, userArnValue. 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'}
        
        booleanValue (boolean) –
        
        Can be either null, or have a Boolean value type. Only one value can be provided.
        
        doubleValue (float) –
        
        Can be either null, or have a Double number value type. Only one value can be provided.
        
        emptyValue (dict) –
        
        An empty value.
        
        stringValue (string) –
        
        String value type.
        
        userArnValue (string) –
        
        Represents the user that performed the audit.
        
        targetTime (datetime) –
        
        Target time by which an SLA should be completed.
        
        type (string) –
        
        Type of SLA.
    - 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.
- NextToken (string) –
  
  A token to resume pagination.