Connectcases
This page documents function available when using the Connectcases
module, created with @service Connectcases
.
Index
Main.Connectcases.batch_get_field
Main.Connectcases.batch_put_field_options
Main.Connectcases.create_case
Main.Connectcases.create_domain
Main.Connectcases.create_field
Main.Connectcases.create_layout
Main.Connectcases.create_related_item
Main.Connectcases.create_template
Main.Connectcases.get_case
Main.Connectcases.get_case_event_configuration
Main.Connectcases.get_domain
Main.Connectcases.get_layout
Main.Connectcases.get_template
Main.Connectcases.list_cases_for_contact
Main.Connectcases.list_domains
Main.Connectcases.list_field_options
Main.Connectcases.list_fields
Main.Connectcases.list_layouts
Main.Connectcases.list_tags_for_resource
Main.Connectcases.list_templates
Main.Connectcases.put_case_event_configuration
Main.Connectcases.search_cases
Main.Connectcases.search_related_items
Main.Connectcases.tag_resource
Main.Connectcases.untag_resource
Main.Connectcases.update_case
Main.Connectcases.update_field
Main.Connectcases.update_layout
Main.Connectcases.update_template
Documentation
Main.Connectcases.batch_get_field
— Methodbatch_get_field(domain_id, fields)
batch_get_field(domain_id, fields, params::Dict{String,<:Any})
Returns the description for the list of fields in the request parameters.
Arguments
domain_id
: The unique identifier of the Cases domain.fields
: A list of unique field identifiers.
Main.Connectcases.batch_put_field_options
— Methodbatch_put_field_options(domain_id, field_id, options)
batch_put_field_options(domain_id, field_id, options, params::Dict{String,<:Any})
Creates and updates a set of field options for a single select field in a Cases domain.
Arguments
domain_id
: The unique identifier of the Cases domain.field_id
: The unique identifier of a field.options
: A list of FieldOption objects.
Main.Connectcases.create_case
— Methodcreate_case(domain_id, fields, template_id)
create_case(domain_id, fields, template_id, params::Dict{String,<:Any})
Creates a case in the specified Cases domain. Case system and custom fields are taken as an array id/value pairs with a declared data types. customer_id is a required field when creating a case.
Arguments
domain_id
: The unique identifier of the Cases domain.fields
: An array of objects with field ID (matching ListFields/DescribeField) and value union data.template_id
: A unique identifier of a template.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
Main.Connectcases.create_domain
— Methodcreate_domain(name)
create_domain(name, params::Dict{String,<:Any})
Creates a domain, which is a container for all case data, such as cases, fields, templates and layouts. Each Amazon Connect instance can be associated with only one Cases domain. This will not associate your connect instance to Cases domain. Instead, use the Amazon Connect CreateIntegrationAssociation API.
Arguments
name
: The name for your Cases domain. It must be unique for your Amazon Web Services account.
Main.Connectcases.create_field
— Methodcreate_field(domain_id, name, type)
create_field(domain_id, name, type, params::Dict{String,<:Any})
Creates a field in the Cases domain. This field is used to define the case object model (that is, defines what data can be captured on cases) in a Cases domain.
Arguments
domain_id
: The unique identifier of the Cases domain.name
: The name of the field.type
: Defines the data type, some system constraints, and default display of the field.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"description"
: The description of the field.
Main.Connectcases.create_layout
— Methodcreate_layout(content, domain_id, name)
create_layout(content, domain_id, name, params::Dict{String,<:Any})
Creates a layout in the Cases domain. Layouts define the following configuration in the top section and More Info tab of the Cases user interface: Fields to display to the users Field ordering Title and Status fields cannot be part of layouts since they are not configurable.
Arguments
content
: Information about which fields will be present in the layout, and information about the order of the fields.domain_id
: The unique identifier of the Cases domain.name
: The name of the layout. It must be unique for the Cases domain.
Main.Connectcases.create_related_item
— Methodcreate_related_item(case_id, content, domain_id, type)
create_related_item(case_id, content, domain_id, type, params::Dict{String,<:Any})
Creates a related item (comments, tasks, and contacts) and associates it with a case. A Related Item is a resource that is associated with a case. It may or may not have an external identifier linking it to an external resource (for example, a contactArn). All Related Items have their own internal identifier, the relatedItemArn. Examples of related items include comments and contacts.
Arguments
case_id
: A unique identifier of the case.content
: The content of a related item to be created.domain_id
: The unique identifier of the Cases domain.type
: The type of a related item.
Main.Connectcases.create_template
— Methodcreate_template(domain_id, name)
create_template(domain_id, name, params::Dict{String,<:Any})
Creates a template in the Cases domain. This template is used to define the case object model (that is, define what data can be captured on cases) in a Cases domain. A template must have a unique name within a domain, and it must reference existing field IDs and layout IDs. Additionally, multiple fields with same IDs are not allowed within the same Template.
Arguments
domain_id
: The unique identifier of the Cases domain.name
: A name for the template. It must be unique per domain.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"description"
: A brief description of the template."layoutConfiguration"
: Configuration of layouts associated to the template."requiredFields"
: A list of fields that must contain a value for a case to be successfully created with this template.
Main.Connectcases.get_case
— Methodget_case(case_id, domain_id, fields)
get_case(case_id, domain_id, fields, params::Dict{String,<:Any})
Returns information about a specific case if it exists.
Arguments
case_id
: A unique identifier of the case.domain_id
: The unique identifier of the Cases domain.fields
: A list of unique field identifiers.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"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.
Main.Connectcases.get_case_event_configuration
— Methodget_case_event_configuration(domain_id)
get_case_event_configuration(domain_id, params::Dict{String,<:Any})
Returns the case event publishing configuration.
Arguments
domain_id
: The unique identifier of the Cases domain.
Main.Connectcases.get_domain
— Methodget_domain(domain_id)
get_domain(domain_id, params::Dict{String,<:Any})
Returns information about a specific domain if it exists.
Arguments
domain_id
: The unique identifier of the Cases domain.
Main.Connectcases.get_layout
— Methodget_layout(domain_id, layout_id)
get_layout(domain_id, layout_id, params::Dict{String,<:Any})
Returns the details for the requested layout.
Arguments
domain_id
: The unique identifier of the Cases domain.layout_id
: The unique identifier of the layout.
Main.Connectcases.get_template
— Methodget_template(domain_id, template_id)
get_template(domain_id, template_id, params::Dict{String,<:Any})
Returns the details for the requested template.
Arguments
domain_id
: The unique identifier of the Cases domain.template_id
: A unique identifier of a template.
Main.Connectcases.list_cases_for_contact
— Methodlist_cases_for_contact(contact_arn, domain_id)
list_cases_for_contact(contact_arn, domain_id, params::Dict{String,<:Any})
Lists cases for a given contact.
Arguments
contact_arn
: A unique identifier of a contact in Amazon Connect.domain_id
: The unique identifier of the Cases domain.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"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.
Main.Connectcases.list_domains
— Methodlist_domains()
list_domains(params::Dict{String,<:Any})
Lists all cases domains in the Amazon Web Services account. Each list item is a condensed summary object of the domain.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"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.
Main.Connectcases.list_field_options
— Methodlist_field_options(domain_id, field_id)
list_field_options(domain_id, field_id, params::Dict{String,<:Any})
Lists all of the field options for a field identifier in the domain.
Arguments
domain_id
: The unique identifier of the Cases domain.field_id
: The unique identifier of a field.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"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."values"
: A list of FieldOption values to filter on for ListFieldOptions.
Main.Connectcases.list_fields
— Methodlist_fields(domain_id)
list_fields(domain_id, params::Dict{String,<:Any})
Lists all fields in a Cases domain.
Arguments
domain_id
: The unique identifier of the Cases domain.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"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.
Main.Connectcases.list_layouts
— Methodlist_layouts(domain_id)
list_layouts(domain_id, params::Dict{String,<:Any})
Lists all layouts in the given cases domain. Each list item is a condensed summary object of the layout.
Arguments
domain_id
: The unique identifier of the Cases domain.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"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.
Main.Connectcases.list_tags_for_resource
— Methodlist_tags_for_resource(arn)
list_tags_for_resource(arn, params::Dict{String,<:Any})
Lists tags for a resource.
Arguments
arn
: The Amazon Resource Name (ARN)
Main.Connectcases.list_templates
— Methodlist_templates(domain_id)
list_templates(domain_id, params::Dict{String,<:Any})
Lists all of the templates in a Cases domain. Each list item is a condensed summary object of the template.
Arguments
domain_id
: The unique identifier of the Cases domain.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"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.
Main.Connectcases.put_case_event_configuration
— Methodput_case_event_configuration(domain_id, event_bridge)
put_case_event_configuration(domain_id, event_bridge, params::Dict{String,<:Any})
API for adding case event publishing configuration
Arguments
domain_id
: The unique identifier of the Cases domain.event_bridge
: Configuration to enable EventBridge case event delivery and determine what data is delivered.
Main.Connectcases.search_cases
— Methodsearch_cases(domain_id)
search_cases(domain_id, params::Dict{String,<:Any})
Searches for cases within their associated Cases domain. Search results are returned as a paginated list of abridged case documents.
Arguments
domain_id
: The unique identifier of the Cases domain.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"fields"
: The list of field identifiers to be returned as part of the response."filter"
: A list of filter objects."maxResults"
: The maximum number of cases to return. The current maximum supported value is 25. This is also the default value when no other value is provided."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."searchTerm"
: A word or phrase used to perform a quick search."sorts"
: A list of sorts where each sort specifies a field and their sort order to be applied to the results.
Main.Connectcases.search_related_items
— Methodsearch_related_items(case_id, domain_id)
search_related_items(case_id, domain_id, params::Dict{String,<:Any})
Searches for related items that are associated with a case. If no filters are provided, this returns all related items associated with a case.
Arguments
case_id
: A unique identifier of the case.domain_id
: The unique identifier of the Cases domain.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"filters"
: The list of types of related items and their parameters to use for filtering."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.
Main.Connectcases.tag_resource
— Methodtag_resource(arn, tags)
tag_resource(arn, tags, params::Dict{String,<:Any})
Adds tags to a resource.
Arguments
arn
: The Amazon Resource Name (ARN)tags
: 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.
Main.Connectcases.untag_resource
— Methoduntag_resource(arn, tag_keys)
untag_resource(arn, tag_keys, params::Dict{String,<:Any})
Untags a resource.
Arguments
arn
: The Amazon Resource Name (ARN)tag_keys
: List of tag keys.
Main.Connectcases.update_case
— Methodupdate_case(case_id, domain_id, fields)
update_case(case_id, domain_id, fields, params::Dict{String,<:Any})
Updates the values of fields on a case. Fields to be updated are received as an array of id/value pairs identical to the CreateCase input . If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
Arguments
case_id
: A unique identifier of the case.domain_id
: The unique identifier of the Cases domain.fields
: An array of objects with fieldId (matching ListFields/DescribeField) and value union data, structured identical to CreateCase.
Main.Connectcases.update_field
— Methodupdate_field(domain_id, field_id)
update_field(domain_id, field_id, params::Dict{String,<:Any})
Updates the properties of an existing field.
Arguments
domain_id
: The unique identifier of the Cases domain.field_id
: The unique identifier of a field.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"description"
: The description of a field."name"
: The name of the field.
Main.Connectcases.update_layout
— Methodupdate_layout(domain_id, layout_id)
update_layout(domain_id, layout_id, params::Dict{String,<:Any})
Updates the attributes of an existing layout. If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body. A ValidationException is returned when you add non-existent fieldIds to a layout. Title and Status fields cannot be part of layouts because they are not configurable.
Arguments
domain_id
: The unique identifier of the Cases domain.layout_id
: The unique identifier of the layout.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"content"
: Information about which fields will be present in the layout, the order of the fields, and a read-only attribute of the field."name"
: The name of the layout. It must be unique per domain.
Main.Connectcases.update_template
— Methodupdate_template(domain_id, template_id)
update_template(domain_id, template_id, params::Dict{String,<:Any})
Updates the attributes of an existing template. The template attributes that can be modified include name, description, layouts, and requiredFields. At least one of these attributes must not be null. If a null value is provided for a given attribute, that attribute is ignored and its current value is preserved.
Arguments
domain_id
: The unique identifier of the Cases domain.template_id
: A unique identifier for the template.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"description"
: A brief description of the template."layoutConfiguration"
: Configuration of layouts associated to the template."name"
: The name of the template. It must be unique per domain."requiredFields"
: A list of fields that must contain a value for a case to be successfully created with this template.