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
<a name="data-lake-cases-data"></a>

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 : 
+ [Option 1 : utiliser la console Connect Customer](access-datalake.md#option1-configure-data-to-be-shared)
+ [Option 2 : utilisez la CLI ou CloudShell](access-datalake.md#option2-configure-data-to-be-shared)

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

**Topics**
+ [Événements liés à l'affaire](#data-lake-case-events)
+ [Événements liés à des objets liés à une affaire](#data-lake-case-related-item-events)

## Événements liés à l'affaire
<a name="data-lake-case-events"></a>

**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
<a name="data-lake-case-events-sample-queries"></a>

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;
```

## Événements liés à des objets liés à une affaire
<a name="data-lake-case-related-item-events"></a>

**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.  |