View a markdown version of this page

Datos de casos en el lago de datos analíticos de Connect Customer - Amazon Connect Customer

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Datos de casos en el lago de datos analíticos de Connect Customer

En este tema se detalla el contenido de las tablas de casos del lago de datos de Connect Customer. Las tablas enumeran la columna, el tipo y la descripción del contenido.

Hay dos formas de acceder al lago de datos de análisis y configurar los datos que se van a compartir:

Si no puede acceder a las tablas de programación mediante la opción 1, intente utilizar la opción 2.

Casos y eventos

Nombre de la tabla: case_events

Descripción: registra los eventos del ciclo de vida de los casos (creados, actualizados y eliminados), incluidos los metadatos de los casos, los cambios de estado, la información de las plantillas y los valores de los campos personalizados para Connect Cases.

Clave principal: instance_id, event_id

Clave de partición: event_timestamp (diaria)

Teclas de unión:

  • instance_id— Se une a todas las tablas

  • case_id— Se une a case_related_item_events (como) associated_case_id

Columna Tipo Se puede anular Descripción
instance_id cadena No El ID de la instancia de Connect Customer.
aws_account_id cadena El ID de la AWS cuenta propietaria del caso.
event_id cadena No El identificador único del evento del caso.
case_id cadena El identificador del caso.
event_timestamp Timestamp La marca de tiempo en la que ocurrió el evento, en UTC.
changed_field_ids array(string) La lista de ID de campo que se modificaron en este evento.
event_type cadena El tipo de evento. Valores válidos: CASE.CREATED, CASE.UPDATED, CASE.DELETED.
performed_by_iam_principal cadena El ARN principal de IAM de la entidad que desencadenó el evento.
performed_by_user_arn cadena El ARN del usuario que realizó la acción.
performed_by_custom_entity cadena La entidad personalizada que realizó la acción.
cases_domain_arn cadena El ARN del dominio Connect Customer Cases.
template_id cadena El ID de la plantilla de caso utilizada para crear el caso.
template_name cadena El nombre de la plantilla de caso. Este valor está vacío si se ha eliminado la plantilla.
last_updated_user cadena El último usuario que actualizó el caso. Esto hace referencia al valor last_updated_user del campo del sistema.
reference_number cadena El número de referencia legible por humanos del caso. Esto hace referencia al valor reference_number del campo del sistema.
status cadena El estado del caso. Esto hace referencia al valor status del campo del sistema.
assigned_user cadena El ARN del usuario asignado al caso. Esto hace referencia al valor assigned_user del campo del sistema.
assigned_queue cadena El ARN de la cola asignada al caso. Esto hace referencia al valor del campo assigned_queue del sistema.
case_reason cadena El motivo de la apertura del caso. Esto hace referencia al valor case_reason del campo del sistema.
case_title cadena El título del caso. Esto hace referencia al valor title del campo del sistema.
case_summary cadena El resumen del caso. Esto hace referencia al valor summary del campo del sistema.
customer_profile_arn cadena El ARN del perfil del cliente asociado al caso. Esto hace referencia al valor customer_id del campo del sistema.
created_timestamp Timestamp La marca de tiempo en la que se creó el caso, en UTC. Esto hace referencia al valor del campo created_datetime del sistema.
last_updated_timestamp Timestamp La marca de tiempo en la que se actualizó el caso por última vez, en UTC. Esto hace referencia al valor del campo last_updated_datetime del sistema.
next_sla_breach_timestamp Timestamp La marca de tiempo de la próxima fecha límite de incumplimiento del SLA, en UTC. Esto hace referencia al valor del campo del next_sla_breach_datetime sistema.
last_closed_timestamp Timestamp La marca de tiempo en la que se cerró el caso por última vez, en UTC. Esto hace referencia al valor del campo last_closed_datetime del sistema.
last_reopened_timestamp Timestamp La marca de tiempo en la que se reabrió el caso por última vez, en UTC. Esto hace referencia al valor del campo del last_reopened_datetime sistema.
custom_fields matriz (estructura) Conjunto de objetos que contienen datos de campo personalizados asociados al caso. Cada objeto incluye el identificador del campo, el nombre_campo y un campo de valor específico para cada tipo (string_value, double_value, boolean_value o timestamp_value).
data_lake_last_processed_timestamp Timestamp Marca de tiempo que muestra la última vez que el lago de datos procesó el registro. Esto puede incluir la transformación y la reposición. Este campo no se puede utilizar de forma fiable para determinar la actualidad de los datos.

Consultas de ejemplo

El siguiente ejemplo de consulta en Athena crea una vista que aplana los campos personalizados de la tabla de eventos de casos:

CREATE VIEW case_events_flattened AS SELECT ce.event_id, ce.case_id, ce.event_timestamp, ce.event_type, ce.instance_id, -- ... other system fields -- Flattened custom fields cf.id AS custom_field_id, cf.field_name AS custom_field_name, CASE WHEN cf.string_value IS NOT NULL THEN 'string' WHEN cf.double_value IS NOT NULL THEN 'double' WHEN cf.timestamp_value IS NOT NULL THEN 'timestamp' WHEN cf.boolean_value IS NOT NULL THEN 'boolean' ELSE 'unknown' END AS custom_field_type, cf.string_value AS custom_field_string_value, cf.double_value AS custom_field_double_value, -- Cast milliseconds to timestamp CAST(from_unixtime(cf.timestamp_value / 1000.0) AS TIMESTAMP) AS custom_field_timestamp_value, cf.boolean_value AS custom_field_boolean_value FROM "case_events resource link table name" ce CROSS JOIN UNNEST(ce.custom_fields) AS t(cf)

El siguiente ejemplo crea una vista que devuelve el estado más reciente de cada caso:

CREATE OR REPLACE VIEW latest_case_state AS SELECT * FROM ( SELECT *, ROW_NUMBER() OVER ( PARTITION BY case_id, instance_id ORDER BY event_timestamp DESC ) AS rn FROM "case_events resource link table name" ) t WHERE rn = 1;

Nombre de la tabla: case_related_item_events

Descripción: registra los eventos relacionados con los casos, incluidos los comentarios, los contactos, los archivos adjuntos, el seguimiento de los SLA y los elementos relacionados personalizados.

Clave principal: instance_id, event_id

Clave de partición: event_timestamp (diaria)

Teclas de unión:

  • instance_id— Se une a todas las tablas

  • associated_case_id— Se une a case_events (as) case_id

  • contact_id— Se une al registro de contactos

Columna Tipo Se puede anular Descripción
instance_id cadena No El ID de la instancia de Connect Customer.
aws_account_id cadena El ID de la AWS cuenta propietaria del artículo relacionado.
event_id cadena No El identificador único del evento del artículo relacionado.
related_item_id cadena El ID del artículo relacionado.
event_timestamp Timestamp La marca de tiempo en la que ocurrió el evento, en UTC.
event_type cadena El tipo de evento. Valores válidos: CASE.RELATED _ITEM.CREATED, _ITEM.UPDATED, CASE.RELATED CASE.RELATED _. ITEM.DELETED
Realizado por iam_principal cadena El ARN principal de IAM de la entidad que desencadenó el evento.
performed_by_user_arn cadena El ARN del usuario que realizó la acción.
performed_by_custom_entity cadena El identificador de entidad personalizado que realizó la acción.
cases_domain_arn cadena El ARN del dominio Connect Customer Cases.
associated_case_id cadena El ID del caso al que está asociado este artículo relacionado.
related_item_type cadena El tipo de elemento relacionado. Valores válidos: comentario, archivo, acuerdo de nivel de servicio, conexión, contacto, personalizado.
created_timestamp Timestamp La marca de tiempo en la que se creó el elemento relacionado, en UTC.
comment_body cadena El cuerpo del texto del comentario.
comment_content_type cadena El tipo de contenido del cuerpo del comentario. Por ejemplo, Text/Plain.
related_case_id cadena El ID del caso relacionado.
contact_channel cadena El canal de comunicación del contacto. Por ejemplo, VOZ, CHAT, TAREA, CORREO ELECTRÓNICO.
contact_id cadena El ID del contacto.
file_arn cadena El ARN del archivo adjunto.
sla_name cadena El nombre del SLA.
sla_status cadena El estado actual del SLA. Por ejemplo, activo, atrasado, cumplido, no cumplido.
sla_target_timestamp Timestamp La marca de tiempo de la fecha límite prevista para el SLA, en UTC.
sla_type cadena El tipo de métrica de SLA que se está rastreando. Por ejemplo, CaseField.
sla_completion_timestamp Timestamp La marca de tiempo en la que se completó el SLA, en UTC.
sla_target_field_id cadena El ID del campo al que se dirige el SLA.
sla_target_field_values array(string) Los valores del campo objetivo del sla_target_field_id para completar el SLA.
custom_related_item_fields matriz (estructura) Matriz de objetos que contienen datos de campo personalizados asociados al elemento relacionado. Cada objeto incluye el identificador del campo, el nombre_campo y un campo de valor específico del tipo (string_value, double_value, boolean_value o timestamp_value).
data_lake_last_processed_timestamp Timestamp Marca de tiempo que muestra la última vez que el lago de datos procesó el registro. Esto puede incluir la transformación y la reposición. Este campo no se puede utilizar de forma fiable para determinar la actualidad de los datos.