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.
# Configurez l’exportation groupée pour toutes vos données de Profils des clients unifiées
**Note**
Pour suivre les étapes décrites dans cette rubrique, vous devez avoir des compétences de développeur et une expérience de l'utilisation d' AWS KMS Amazon S3.
Lorsque Profils des clients Amazon Connect crée un profil client unifié, il améliore, affine et améliore les données et informations brutes pour obtenir un profil plus précis en combinant des données provenant de sources internes et tierces. La fonctionnalité Profils des clients améliore également la qualité des jeux de données grâce à l’ajout de nouvelles données. Vous pouvez utiliser les jeux de données améliorés pour d’autres cas d’utilisation, par exemple pour formuler des stratégies de marketing, de vente et de service client plus informées et ciblées. Par exemple, vous pouvez tirer parti du profil client unifié pour :
+ Auditer les données clients dont vous disposez dans l’ensemble d’un domaine.
+ Effectuer des analyses internes, par exemple pour les rapports de vente et de marketing.
+ Exporter les données dans vos propres outils ou dans des produits tiers, afin de personnaliser les publicités et de cibler les clients.
Pour exploiter les données de profil client unifiées pour d’autres cas d’utilisation, vous pouvez les exporter en masse vers Amazon S3. Cette rubrique explique comment procéder.
**Topics**
+ [Étape 1 : configurer une clé KMS et le compartiment S3](#enable-cpbulk-export)
+ [Étape 2 : créer une tâche d’exportation groupée](#create-bulk-export-job)
+ [Étape 3 : vérifier le statut d’une tâche d’exportation en bloc](#check-status-bulk-cp-export)
+ [Étape 4 : afficher les données exportées dans S3](#view-bulk-cp-export)
+ [Mise à jour de la tâche d’exportation en bloc](#update-bulk-cp-export)
+ [Suppression ou annulation de la tâche d’exportation en bloc - non prise en charge](#delete-bulk-cp-export)
## Étape 1 : configurer une clé KMS et le compartiment S3
Pour activer l’exportation groupée pour votre domaine, vous devez configurer les ressources suivantes :
+ [Une clé KMS avec une politique de ressources spécifique](#cp-kms)
+ [Un compartiment S3 de destination avec une politique de ressources spécifique](#cp-s3-bulk). Ne configurez pas de [listes de contrôle d'accès (ACLs)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acls.html) sur le compartiment.
Ces étapes sont expliquées ci-dessous.
### Création d’une nouvelle clé KMS ou réutilisation d’une clé KMS existante
Pour configurer une clé KMS pour l'exportation en masse, vous devez créer ou réutiliser une clé KMS existante qui se trouve dans la même AWS région que le compartiment Amazon S3 que vous prévoyez de configurer comme destination d'exportation en bloc. Vous devez autoriser le AppIntegrations service Amazon Connect à effectuer des actions KMS pour la clé.
Ajoutez la déclaration suivante à la **stratégie de clé**.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "{{Enable AppIntegrations access to KMS key}}",
"Effect": "Allow",
"Principal": {
"AWS": [
"{{arn:aws:iam::{{111122223333}}:root}}"
],
"Service": [
"{{app-integrations.amazonaws.com}}"
]
},
"Action": [
"kms:Encrypt*",
"kms:Describe*",
"kms:Decrypt*",
"kms:GenerateDataKey*"
],
"Resource": "*"
}
]
}
```
------
### Configuration d’un compartiment Amazon S3
Vous devez configurer un compartiment nouveau ou existant dans la même AWS région que la clé KMS, et configurer une politique de ressources sur le compartiment S3.
Lors de la configuration du compartiment, assurez-vous de sélectionner **Chiffrement avec SSE-KMS** et d’utiliser la même clé KMS que lors de la procédure précédente. En outre, ne l'activez pas ACLs sur le compartiment S3.
Voici un exemple de stratégie de ressources.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "{{Allow AppIntegrations to write data to destination bucket}}",
"Effect": "Allow",
"Principal": {
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"s3:GetObject",
"s3:ListBucket",
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": [
"arn:aws:s3:::{{{{amzn-s3-demo-bucket1}}}}",
"arn:aws:s3:::{{{{amzn-s3-demo-bucket2}}}}/*"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{AwsAccountId}}"
},
"ArnEquals": {
"aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*"
}
}
}
]
}
```
------
## Étape 2 : créer une tâche d’exportation groupée
Pour créer une tâche d'exportation groupée, vous devez appeler l'Amazon Connect suivant AppIntegrations APIs :
1. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html): Cette API crée une intégration avec la source de données (par exemple, les profils clients).
1. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html): cette API écrit les données vers la destination (par exemple, un compartiment S3) en utilisant la source de données.
Vous trouverez ci-dessous plus d'informations sur la façon de les appeler APIs.
### Création d’une intégration des données
Une intégration de données représente la *source de données* de vos données. Vous pouvez appeler l'[CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API ou exécuter la commande [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI pour créer une intégration de données. Vous devez fournir un *type d’objet* Customer Profiles et un *domaine* Customer Profiles.
Si vous souhaitez exporter plusieurs types d’objets, vous devez créer une intégration de données distincte pour chacun d’entre eux. Par exemple, si vous souhaitez exporter les objets `_profile` et `_asset`, il est nécessaire de créer deux intégrations de données distinctes.
**Note**
Les données ingérées au cours des 30 dernières minutes peuvent ne pas être incluses dans l’exportation.
L'exemple de code suivant montre comment exécuter la commande [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI.
```
aws appintegrations create-data-integration \
--region "us-west-2" \
--name "{{bulk-export-job-01}}" \
--description "{{Data integration for _profile objects}}" \
--kms-key "{{arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012}}" \
--source-uri "{{AmazonConnect://AppIntegrations}}" \
--object-configuration '{{{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}}}'
```
L'exemple de code suivant montre comment appeler l'[CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API.
```
{
"Description": "{{Data integration for _profile objects}}",
"KmsKey": "{{arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012}}",
"Name": "{{unique-data-integration-name-01}}",
"SourceURI": "AmazonConnect://AppIntegrations",
"ObjectConfiguration": {
"CustomerProfiles": {
"domainName": [
"{{my-domain-pdx}}"
],
"objectType": [
"_profile"
]
}
}
}
```
### Création d’une association d’intégration de données
Une association d’intégration de données représente la destination vers laquelle vous souhaitez exporter vos données et une plage de temps permettant de sélectionner les données à exporter. Vous pouvez appeler l'[CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API ou exécuter la commande [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI pour créer une intégration de données. Vous pouvez configurer l’intervalle de temps à l’aide des propriétés `StartTime` et `EndTime`. Cette plage horaire correspond à la date de dernière mise à jour des objets dans Profils des clients.
Le compartiment S3 de destination que vous spécifiez peut être simplement le nom du compartiment, ou il peut inclure un cas supplémentaire ou un préfixe S3 dans lequel vous souhaitez que les données soient exportées.
**Note**
Pour le quota pour les **tâches d’exportation en bloc simultanées**, consultez [Connect Customer Quotas de service relatifs aux profils clients](amazon-connect-service-limits.md#customer-profiles-quotas). Une fois qu’une tâche d’exportation en bloc est terminée ou échoue, elle n’est plus prise en compte dans le quota de simultanéité.
L'exemple de code suivant montre comment exécuter la commande [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI.
```
aws appintegrations create-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "{{unique-data-integration-name-01}}" \
--destination-uri "{{s3://{{amzn-s3-demo-bucket1}}}}" \
--execution-configuration '{{{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}}}'
```
L'exemple de code suivant montre comment appeler l'[CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API.
```
{
"DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012",
"DestinationURI": "s3://amzn-s3-demo-bucket1",
"ExecutionConfiguration": {
"ExecutionMode": "ON_DEMAND",
"OnDemandConfiguration": {
"StartTime": "1713565000004",
"EndTime": "1713565000005"
}
}
}
```
## Étape 3 : vérifier le statut d’une tâche d’exportation en bloc
Pour consulter l'état de votre tâche d'exportation en bloc, vous pouvez appeler l'[ListDataIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_ListDataIntegrationAssociations.html)API ou exécuter la commande [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
L'exemple de code suivant montre comment exécuter la commande [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
```
aws appintegrations list-data-integration-associations \
--region "us-west-2" \
--data-integration-identifier "{{unique-data-integration-name-01}}"
```
## Étape 4 : afficher les données exportées dans S3
Lorsque l’association d’intégration des données est sur `IN_PROGRESS`, vous commencerez à voir les données copiées dans votre compartiment S3.
Les données exportées sont écrites selon la structure de chemin suivante :
+ {BucketNameAndFolderName}
+ {AwsAccountId}
+ {DomainName}
+ {RequestTimestamp}
+ {lStartTime}-{EndTime}
+ {ObjectTypeName}
+
Voici un exemple de chemin :
`amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012`
## Mise à jour de la tâche d’exportation en bloc
Une fois le travail terminé, vous pouvez mettre à jour l’association d’intégration des données avec une heure de début et une heure de fin d’extraction des données différentes. Cela crée une nouvelle tâche d’exportation en masse. Cela peut être utile si vous avez déjà effectué une exportation en bloc et que vous souhaitez exporter uniquement les données mises à jour depuis l’exportation précédente. Par exemple, si votre dernière tâche d’exportation en masse remonte à trois mois, vous pouvez mettre à jour votre association d’intégration de données sur une période allant d’il y a 3 mois à aujourd’hui.
Vous pouvez appeler l'[UpdateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_UpdateDataIntegrationAssociation.html)API ou exécuter la commande [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI pour mettre à jour la tâche d'exportation.
L'exemple de code suivant montre comment exécuter la commande [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI.
```
aws appintegrations update-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "{{unique-data-integration-name-01}}" \
--data-integration-association-identifier "{{arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012}}" \
--execution-configuration '{{{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}}}'
```
## Suppression ou annulation de la tâche d’exportation en bloc - non prise en charge
Vous ne pouvez pas supprimer ou annuler l’exportation groupée. Une fois qu’une tâche d’exportation est terminée, elle n’est plus prise en compte dans votre quota d’exportation.