View a markdown version of this page

Données relatives aux cas dans le lac de données d'analyse Connect Customer - Client Amazon Connect

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Données relatives aux cas dans le lac de données d'analyse Connect Customer

Cette rubrique détaille le contenu des tableaux de cas relatifs aux lacs de données Connect Customer. Les tables répertorient la colonne, le type et la description du contenu.

Il existe deux manières d’accéder au lac de données d’analytique et de configurer les données à partager :

Si vous ne parvenez pas à accéder aux tables de planification à l’aide de l’option 1, essayez d’utiliser l’option 2.

Événements liés à l'affaire

Nom de la table : case_events

Description : enregistre les événements du cycle de vie des dossiers (créés, mis à jour, supprimés), y compris les métadonnées des dossiers, les modifications de statut, les informations du modèle et les valeurs de champs personnalisés pour Connect Cases.

Clé primaire : instance_id, event_id

Clé de partition : event_timestamp (tous les jours)

Clés de jointure :

  • instance_id— Joint à toutes les tables

  • case_id— Se joint à case_related_item_events (as) associated_case_id

Colonne Type Nullable Description
instance_id chaîne Non L'ID de l'instance Connect Customer.
aws_account_id chaîne Oui ID du AWS compte propriétaire du dossier.
event_id chaîne Non L'identifiant unique de l'événement du dossier.
case_id chaîne Oui L'identifiant de l'étui.
event_timestamp Horodatage Oui L'horodatage auquel l'événement s'est produit, en UTC.
ids_de_champ_modifiés array(string) Oui La liste des ID de champs qui ont été modifiés lors de cet événement.
event_type chaîne Oui Type d’événement. Valeurs valides : CASE.CREATED, CASE.UPDATED, CASE.DELETED.
interprété par iam_principal chaîne Oui L'ARN principal IAM de l'entité qui a déclenché l'événement.
effectuée_par_user_arn chaîne Oui L'ARN de l'utilisateur qui a effectué l'action.
effectué_par_entité_personnalisée chaîne Oui L'entité personnalisée qui a effectué l'action.
cases_domain_arn chaîne Oui L'ARN du domaine Connect Customer Cases.
identifiant du modèle chaîne Oui L'ID du modèle de dossier utilisé pour créer le dossier.
nom_modèle chaîne Oui Le nom du modèle de dossier. Cette valeur est vide si le modèle a été supprimé.
last_updated_user chaîne Oui Le dernier utilisateur à avoir mis à jour le dossier. Cela fait référence à la valeur last_updated_user du champ système.
reference_number chaîne Oui Le numéro de référence lisible par l'homme du boîtier. Cela fait référence à la valeur reference_number du champ système.
status chaîne Oui L'état de l'affaire. Cela fait référence à la valeur status du champ système.
assigned_user chaîne Oui L'ARN de l'utilisateur assigné au dossier. Cela fait référence à la valeur assigned_user du champ système.
assigned_queue chaîne Oui L'ARN de la file d'attente attribuée au dossier. Cela fait référence à la valeur assigned_queue du champ système.
case_reason chaîne Oui La raison de l'ouverture du dossier. Cela fait référence à la valeur case_reason du champ système.
titre_du dossier chaîne Oui Titre de l'affaire. Cela fait référence à la valeur title du champ système.
récapitulatif de l'affaire chaîne Oui Le résumé de l'affaire. Cela fait référence à la valeur summary du champ système.
profil_client_arn chaîne Oui L'ARN du profil client associé au dossier. Cela fait référence à la valeur customer_id du champ système.
created_timestamp Horodatage Oui Horodatage de création du dossier, en UTC. Cela fait référence à la valeur created_datetime du champ système.
last_updated_timestamp Horodatage Oui Horodatage de la dernière mise à jour du dossier, en UTC. Cela fait référence à la valeur last_updated_datetime du champ système.
next_sla_breach_timestamp Horodatage Oui Horodatage de la prochaine date limite de violation des SLA, en UTC. Cela fait référence à la valeur next_sla_breach_datetime du champ système.
horodatage_last_closed_ Horodatage Oui Horodatage de la dernière clôture du dossier, en UTC. Cela fait référence à la valeur last_closed_datetime du champ système.
horodatage_last_reopened_timestamp Horodatage Oui Horodatage de la dernière réouverture du dossier, en UTC. Cela fait référence à la valeur last_reopened_datetime du champ système.
custom_fields tableau (structure) Oui Tableau d'objets contenant des données de champs personnalisés associées au dossier. Chaque objet inclut l'identifiant du champ, field_name et un champ de valeur spécifique au type (string_value, double_value, boolean_value ou timestamp_value).
data_lake_last_processed_timestamp Horodatage Oui Date et heure indiquant la dernière fois que le lac de données a traité l’enregistrement. Cela peut inclure la transformation et le remplissage. Ce champ ne peut pas être utilisé de manière fiable pour déterminer la fraîcheur des données.

Exemples de requêtes

L'exemple de requête suivant dans Athena crée une vue qui aplatit les champs personnalisés de la table des événements de cas :

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)

L'exemple suivant crée une vue qui renvoie l'état le plus récent pour chaque cas :

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;

Nom de la table : case_related_item_events

Description : enregistre les événements relatifs aux éléments liés aux dossiers, notamment les commentaires, les contacts, les pièces jointes, le suivi des SLA et les éléments associés personnalisés.

Clé primaire : instance_id, event_id

Clé de partition : event_timestamp (tous les jours)

Clés de jointure :

  • instance_id— Joint à toutes les tables

  • associated_case_id— Se joint à case_events (as) case_id

  • contact_id— Se connecte à Contact Record

Colonne Type Nullable Description
instance_id chaîne Non L'ID de l'instance Connect Customer.
aws_account_id chaîne Oui L'ID du AWS compte propriétaire de l'article associé.
event_id chaîne Non L'identifiant unique de l'événement lié à l'objet associé.
identifiant de l'article associé chaîne Oui L'ID de l'article associé.
event_timestamp Horodatage Oui Horodatage de l'événement, en UTC.
event_type chaîne Oui Type d’événement. Valeurs valides : CASE.RELATED _ITEM.CREATED, CASE.RELATED _ITEM.UPDATED, CASE.RELATED _ITEM.DELETED.
interprété par iam_principal chaîne Oui L'ARN principal IAM de l'entité qui a déclenché l'événement.
effectuée_par_user_arn chaîne Oui L'ARN de l'utilisateur qui a effectué l'action.
effectué_par_entité_personnalisée chaîne Oui Identifiant d'entité personnalisé qui a effectué l'action.
cases_domain_arn chaîne Oui L'ARN du domaine Connect Customer Cases.
identifiant_dossier associé chaîne Oui L'ID du dossier auquel cet article associé est associé.
type_d'article_associé chaîne Oui Type d'élément associé. Valeurs valides : comment, file, sla, connect, contact, custom.
created_timestamp Horodatage Oui Horodatage de création de l'élément associé, en UTC.
corps_du commentaire chaîne Oui Le corps du commentaire.
type de contenu_du commentaire chaîne Oui Type de contenu du corps du commentaire. Par exemple, Text/Plain.
identifiant_dossier associé chaîne Oui L'ID du dossier concerné.
canal_contact chaîne Oui Le canal de communication du contact. Par exemple, VOICE, CHAT, TASK, EMAIL.
contact_id chaîne Oui ID du contact.
file_arn chaîne Oui L'ARN de la pièce jointe.
nom_sla chaîne Oui Le nom du SLA.
status_SLA chaîne Oui L'état actuel du SLA. Par exemple, actif, en retard, satisfait, non satisfait.
sla_target_timestamp Horodatage Oui Horodatage de la date limite cible pour le SLA, en UTC.
type_SLA chaîne Oui Type de métrique SLA qui fait l'objet du suivi. Par exemple, CaseField.
sla_completion_timestamp Horodatage Oui L'horodatage auquel le SLA a été terminé, en UTC.
sla_target_field_id chaîne Oui L'ID du champ ciblé par le SLA.
valeurs_domaines_cibles sla_target_field_values array(string) Oui Les valeurs du champ cible pour le sla_target_field_id afin que le SLA soit terminé.
champs_lié_aux_articles personnalisés tableau (structure) Oui Tableau d'objets contenant des données de champs personnalisés associées à l'élément associé. Chaque objet inclut l'identifiant du champ, field_name et un champ de valeur spécifique au type (string_value, double_value, boolean_value ou timestamp_value).
data_lake_last_processed_timestamp Horodatage Oui Date et heure indiquant la dernière fois que le lac de données a traité l’enregistrement. Cela peut inclure la transformation et le remplissage. Ce champ ne peut pas être utilisé de manière fiable pour déterminer la fraîcheur des données.