View a markdown version of this page

Données de 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 de 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 du dossier (créés, mis à jour, supprimés), y compris les métadonnées du dossier, les modifications de statut, les informations du modèle et les valeurs des 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 ID de l'instance Connect Customer.
aws_account_id chaîne Oui L'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'affaire.
event_timestamp Horodatage Oui Horodatage auquel l'événement s'est produit, en UTC.
identifiant_de_champs modifiés array(string) Oui 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.
réalisé par iam_principal chaîne Oui L'ARN principal IAM de l'entité qui a déclenché l'événement.
exécuté par l'utilisateur_arn chaîne Oui L'ARN de l'utilisateur qui a effectué l'action.
réalisé par une entité personnalisée chaîne Oui 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 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 qui a 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 affecté 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 affecté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 boîtier. 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ésumé du cas chaîne Oui Le résumé de l'affaire. Cela fait référence à la valeur summary du champ système.
client_profil_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 du SLA, en UTC. Cela fait référence à la valeur next_sla_breach_datetime du champ système.
horodatage dernier_fermé 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 de la dernière réouverture 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 Un tableau d'objets contenant des données de champ personnalisées associées au dossier. Chaque objet inclut le champ id, field_name et un champ de valeur spécifique au type (string_value, double_value, boolean_value ou timestamp_value).

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 affaires, notamment les commentaires, les contacts, les pièces jointes, le suivi des SLA et les éléments connexes 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 joint à l'enregistrement des contacts

Colonne Type Nullable Description
instance_id chaîne Non 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 ID unique de l'événement lié à l'article.
identifiant_article associé chaîne Oui L'ID de l'article associé.
event_timestamp Horodatage Oui Horodatage auquel l'événement s'est produit, 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.
réalisé par iam_principal chaîne Oui L'ARN principal IAM de l'entité qui a déclenché l'événement.
exécuté par l'utilisateur_arn chaîne Oui L'ARN de l'utilisateur qui a effectué l'action.
réalisé par une 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_cas_associé chaîne Oui L'ID du dossier auquel cet élément associé est associé.
type_d'article connexe chaîne Oui Type d'article connexe. 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 texte du commentaire.
type_contenu_commentaire chaîne Oui Type de contenu du corps du commentaire. Par exemple, Text/Plain.
identifiant_cas_associé chaîne Oui L'identifiant du dossier concerné.
contact_channel 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 du contrat de service chaîne Oui État actuel du SLA. Par exemple, actif, en retard, atteint, non respecté.
horodatage sla_target_ Horodatage Oui Horodatage de la date limite cible pour le SLA, en UTC.
type de sla chaîne Oui Type de métrique SLA faisant l'objet du suivi. Par exemple, CaseField.
horodatage de fin de la session Horodatage Oui Horodatage de la fin du SLA, en UTC.
sla_target_field_id chaîne Oui L'ID du champ ciblé par le SLA.
sla_target_field_values array(string) Oui Les valeurs du champ cible pour le sla_target_field_id afin que le SLA soit complété.
champ_item_relatifs_personnalisés tableau (structure) Oui Tableau d'objets contenant des données de champ personnalisées associées à l'élément associé. Chaque objet inclut le champ id, field_name et un champ de valeur spécifique au type (string_value, double_value, boolean_value ou timestamp_value).