Outil Sandbox
Vous devez disposer des deux autorisations de contrôle d’accès en fonction du rôle suivantes pour utiliser la fonctionnalité d’outil Sandbox :
-
manage-sandbox ou view-sandbox-
manage-packageAméliorez la précision de la configuration entre les sandbox et exportez et importez facilement des configurations de sandbox entre les sandbox grâce à la fonctionnalité d’outils de sandbox. Utilisez l’outil Sandbox pour réduire le délai d’évaluation du processus d’implémentation et déplacer les configurations réussies entre les sandbox.
Vous pouvez utiliser la fonction d’outils sandbox pour sélectionner différents objets et les exporter dans un package. Un package peut se composer d’un ou de plusieurs objets. Tous les objets inclus dans un package doivent provenir du même sandbox.
Objets pris en charge pour l’outil Sandbox supported-objects
La fonction d’outil Sandbox vous permet d’exporter des objets Adobe Real-Time Customer Data Platform et Adobe Journey Optimizer dans un package.
Objets Real-time Customer Data Platform real-time-cdp-objects
Le tableau ci-dessous répertorie Adobe Real-Time Customer Data Platform objets actuellement pris en charge pour l’outil Sandbox :
Les objets suivants sont importés mais ont le statut brouillon ou désactivé :
Objets Adobe Journey Optimizer abobe-journey-optimizer-objects
Le tableau ci-dessous répertorie Adobe Journey Optimizer objets actuellement pris en charge pour les limites et les outils Sandbox :
Les objets suivants utilisés dans le parcours sont copiés en tant qu’objets dépendants. Au cours du workflow d’importation, vous pouvez sélectionner Créer ou Utiliser existant pour chacun des éléments suivants :
- Audiences
- Schémas
- Actions personnalisées
- Événements
- Fragments
- Modèles de contenu
- Détails de la zone de travail
- Actions personnalisées : lorsque vous sélectionnez Utiliser existant pendant le processus d’importation lors de la copie d’un parcours dans un autre sandbox, les actions personnalisées que vous sélectionnez doivent être identiques à l’action personnalisée source. S’ils ne sont pas identiques, le nouveau parcours contiendra des erreurs impossibles à résoudre.
- Les événements et les détails des événements utilisés dans le parcours sont copiés. Il crée toujours une nouvelle version dans le sandbox cible.
L’action de mise à jour de profil utilisée dans le parcours peut être copiée. Les actions personnalisées peuvent être ajoutées indépendamment à un package. Les détails des actions utilisées dans le parcours sont également copiés. Il crée toujours une nouvelle version dans le sandbox cible.
Les actions personnalisées peuvent être ajoutées indépendamment à un package. Une fois qu’une action personnalisée est affectée à un parcours, elle ne peut plus être modifiée. Pour mettre à jour les actions personnalisées, vous devez :
- déplacer les actions personnalisées avant de migrer un parcours
- mettez à jour les configurations (telles que les en-têtes de requête, les paramètres de requête et l’authentification) pour les actions personnalisées après la migration
- migrez les objets de parcours avec les actions personnalisées que vous avez ajoutées lors de la première étape
Les objets suivants utilisés dans la campagne sont copiés en tant qu’objets dépendants :
- Campagnes
- Audiences
- Schémas
- Modèles de contenu
- Fragments
- Message/Contenu
- Configuration des canaux
- Objets de décision unifiés
- Paramètres d’expérience/variantes
- Les campagnes peuvent être copiées avec tous les éléments liés au profil, à l’audience, au schéma, aux messages intégrés et aux objets dépendants. Certains éléments ne sont pas copiés, tels que les libellés d’utilisation des données et les paramètres de langue. Pour obtenir la liste complète des objets qui ne peuvent pas être copiés, reportez-vous au guide exportation d’objets vers un autre sandbox.
- Le système détecte automatiquement et réutilise un objet de configuration de canal existant dans le sandbox cible s’il existe une configuration identique. Si aucune configuration correspondante n’est trouvée, la configuration du canal est ignorée lors de l’importation et les utilisateurs doivent mettre à jour manuellement les paramètres du canal dans le sandbox cible pour ce parcours.
- Les utilisateurs peuvent réutiliser des expériences et des audiences existantes dans le sandbox cible en tant qu’objets dépendants des campagnes sélectionnées.
Les surfaces (par exemple, les paramètres prédéfinis) ne sont pas copiées. Le système sélectionne automatiquement la correspondance la plus proche possible sur le sandbox de destination en fonction du type de message et du nom de la surface. Si aucune surface n’est trouvée sur le sandbox cible, la copie de surface échoue, ce qui entraîne l’échec de la copie du message, car un message nécessite qu’une surface soit disponible pour la configuration. Dans ce cas, au moins une surface doit être créée pour le bon canal du message afin que la copie fonctionne.
Les types d’identité personnalisés ne sont pas pris en charge en tant qu’objets dépendants lors de l’exportation d’un parcours.
Exporter des objets dans un package export-objects
Cet exemple illustre le processus d’exportation d’un schéma et de son ajout à un package. Vous pouvez utiliser le même processus pour exporter d’autres objets, par exemple des jeux de données, des parcours, etc.
Ajouter un objet à un nouveau package add-object-to-new-package
Sélectionnez Schémas dans le volet de navigation de gauche, puis sélectionnez l’onglet Parcourir qui répertorie les schémas disponibles. Sélectionnez ensuite les points de suspension (...) à côté du schéma sélectionné pour afficher les contrôles dans une liste déroulante. Sélectionnez Ajouter au package dans la liste déroulante.
Dans la boîte de dialogue Ajouter au package, sélectionnez l’option Créer un package. Indiquez un Nom pour votre package et un Description facultatif, puis sélectionnez Ajouter.
Vous revenez alors à l’environnement Schémas. Vous pouvez maintenant ajouter des objets supplémentaires au package que vous avez créé en suivant les étapes suivantes répertoriées ci-dessous.
Ajouter un objet à un package existant et le publier add-object-to-existing-package
Pour afficher la liste des schémas disponibles, sélectionnez Schémas dans le volet de navigation de gauche, puis sélectionnez l’onglet Parcourir. Sélectionnez ensuite les points de suspension (...) à côté du schéma sélectionné pour afficher les options de contrôle dans un menu déroulant. Sélectionnez Ajouter au package dans la liste déroulante.
La boîte de dialogue Ajouter au package s’affiche. Sélectionnez l’option Package existant, puis sélectionnez le menu déroulant Nom du package et sélectionnez le package requis. Enfin, sélectionnez Ajouter pour confirmer vos choix.
Boîte de dialogue
La liste des objets ajoutés au package est répertoriée. Pour publier le package et le rendre disponible pour importation dans des sandbox, sélectionnez Publier.
Sélectionnez Publier pour confirmer la publication du package.
Vous revenez sur l’onglet Packages dans l’environnement Sandbox, où vous pouvez voir le nouveau package publié.
Importer un package dans un sandbox cible import-package-to-target-sandbox
Pour importer le package dans un sandbox cible, accédez à l’onglet Sandbox Parcourir et sélectionnez l’option plus (+) à côté du nom du sandbox.
Dans le menu déroulant, sélectionnez le nom du package à importer dans le sandbox ciblé. Ajoutez un Nom de la tâche, qui sera utilisé pour la surveillance ultérieure. Par défaut, le profil unifié est désactivé lorsque les schémas du package sont importés. Activez le bouton (bascule) Activer les schémas pour le profil pour l’activer, puis sélectionnez Suivant.
La page Objet et dépendances du package fournit une liste de toutes les ressources incluses dans ce package. Le système détecte automatiquement les objets dépendants requis pour réussir l'importation des objets parents sélectionnés. Tous les attributs manquants s’affichent en haut de la page. Sélectionnez Afficher les détails pour une répartition plus détaillée.
Pour utiliser un objet existant, sélectionnez l’icône en forme de crayon en regard de l’objet dépendant.
La page [Objet et dépendances du package]
Les options permettant d’en créer de nouvelles ou d’utiliser des existantes s’affichent. Sélectionnez Utiliser existant.
La boîte de dialogue Groupe de champs affiche une liste des groupes de champs disponibles pour l’objet . Sélectionnez les groupes de champs requis, puis sélectionnez Enregistrer.
Vous revenez à la page Objet et dépendances du package. À partir de là, sélectionnez Terminer pour terminer l’importation du package.
Exporter et importer un sandbox entier
Vous pouvez exporter tous les types d’objet pris en charge dans un package sandbox complet, puis importer le package dans différents sandbox pour répliquer les configurations d’objet. Par exemple, cette fonctionnalité vous permet d’effectuer les opérations suivantes :
- Réimportez un sandbox pour reproduire toutes les configurations de l’objet si vous devez réinitialiser le sandbox
- Importez le package dans d’autres sandbox et utilisez-le comme sandbox de plan directeur pour accélérer le processus de développement.
Exporter un sandbox entier export-entire-sandbox
Pour exporter un sandbox entier, accédez à l’onglet Sandbox Packages et sélectionnez Créer un package.
Sélectionnez Sandbox entier pour le Type de package dans la boîte de dialogue Créer un package. Indiquez un Nom du package pour votre nouveau package et sélectionnez le Sandbox dans la liste déroulante. Enfin, sélectionnez Créer pour confirmer vos entrées.
Le package a été créé avec succès. Sélectionnez Publier pour publier le package.
Vous revenez sur l’onglet Packages dans l’environnement Sandbox, où vous pouvez voir le nouveau package publié.
Importer le package sandbox entier import-entire-sandbox-package
Pour importer le package dans un sandbox cible, accédez à l’onglet Sandbox Parcourir et sélectionnez l’option plus (+) à côté du nom du sandbox.
Dans le menu déroulant, sélectionnez le sandbox complet à l’aide du menu déroulant Nom du package. Ajoutez un Nom de la tâche, qui sera utilisé pour la surveillance future et un Description de la tâche facultatif, puis sélectionnez Suivant.
Vous accédez à la page Objets et dépendances de package qui indique le nombre d’objets et de dépendances importés et exclus. À partir de là, sélectionnez Importer pour terminer l’importation du package.
La page
Patientez quelques instants le temps que l’importation se termine. Le délai d’exécution peut varier en fonction du nombre d’objets dans le package. Vous pouvez surveiller la tâche d’importation à partir de l’onglet Sandbox Tâches.
Surveiller les détails de l’importation view-import-details
Pour afficher les détails importés, accédez à l’onglet Sandbox Tâches et sélectionnez le package dans la liste. Vous pouvez également utiliser la barre de recherche pour rechercher le package.
Sélectionnez Afficher le résumé de l’importation dans le volet de détails droit de l’onglet Tâches de l’environnement Sandbox.
La boîte de dialogue Résumé des imports affiche une répartition des imports avec une progression en pourcentage.
Une fois l’importation terminée, une notification est reçue dans l’interface utilisateur d’Experience Platform. Vous pouvez accéder à ces notifications à partir de l’icône des alertes. À partir de là, vous pouvez accéder à la résolution des problèmes si une tâche échoue.
Transfert des mises à jour de configurations d’objet itératives dans les sandbox via l’outil sandbox move-configs
Vous pouvez utiliser l’outil sandbox pour transférer des configurations d’objet entre différents sandbox. Auparavant, les mises à jour de configuration apportées à vos objets (tels que les schémas, les groupes de champs et les types de données) devaient être recréées ou réimportées manuellement pour être transférées vers d’autres sandbox. Grâce à cette fonctionnalité, vous pouvez utiliser l’outil sandbox pour accélérer vos workflows et réduire les erreurs potentielles en transférant facilement vos mises à jour de configuration entre différents sandbox.
- Les autorisations appropriées pour accéder aux outils Sandbox.
- Un objet nouvellement créé ou mis à jour (tel qu’un schéma) dans votre sandbox source.
Types d’objet pris en charge pour l’opération de mise à jour
Les types d’objet suivants sont pris en charge pour la mise à jour :
- Schémas
- Groupes de champs
- Types de données
- Ajout de nouveaux champs/groupes de champs à la ressource.
- Rendre un champ obligatoire facultatif.
- Introduction de nouveaux champs obligatoires.
- Présentation d’un nouveau champ de relation.
- Présentation d’un nouveau champ d’identité.
- Modification du nom d’affichage et de la description de la ressource.
- Suppression des champs précédemment définis.
- Redéfinition des champs existants lorsque le schéma est activé pour le profil client en temps réel.
- Suppression ou restriction des valeurs de champ précédemment prises en charge.
- Déplacement de champs existants vers un autre emplacement de l’arborescence du schéma : un nouveau champ sera créé dans le sandbox cible, mais le champ précédent ne sera pas supprimé.
- Activer ou désactiver le schéma pour qu’il participe au profil : cette opération sera ignorée dans la comparaison diff.
- Libellés de contrôle d’accès.
Suivez les étapes ci-dessous pour savoir comment utiliser l’outil sandbox afin de transférer les configurations d’objet entre différents sandbox.
Objets importés précédemment
Suivez ces étapes si votre cas d’utilisation implique des objets existants dans votre sandbox source qui nécessitent des mises à jour de configuration, après avoir déjà été compilés et importés dans d’autres sandbox.
Tout d’abord, mettez à jour l’objet dans votre sandbox source. Par exemple, accédez à l’espace de travail Schémas, sélectionnez votre schéma et ajoutez un nouveau groupe de champs.
Une fois que vous avez mis à jour votre schéma, accédez à Sandbox, sélectionnez Packages, puis recherchez votre package existant.
Utilisez l’interface des packages pour vérifier vos modifications. Sélectionnez Rechercher les mises à jour pour afficher les modifications apportées aux artefacts de votre package. Sélectionnez ensuite Afficher la comparaison pour recevoir un résumé détaillé de toutes les modifications apportées à vos artefacts.
L’interface Afficher la différence s’affiche. Reportez-vous à cet outil pour plus d'informations sur vos artefacts source et cible, ainsi que sur les modifications à leur appliquer.
Au cours de cette étape, vous pouvez également sélectionner Résumer avec l’IA pour obtenir un résumé détaillé de toutes les modifications.
Une fois prêt, sélectionnez Mettre à jour le package puis sélectionnez Confirmer dans la fenêtre pop-up qui s’affiche. Une fois la tâche terminée, vous pouvez actualiser la page et sélectionner Afficher l’historique pour vérifier la version de votre package.
Pour importer vos modifications, revenez au répertoire Packages et sélectionnez les points de suspension (...) à côté de votre package, puis sélectionnez Importer un package. Experience Platform sélectionne automatiquement Mettre à jour les objets existants. Vérifiez les modifications, puis sélectionnez Terminer.
Pour valider davantage votre processus d’importation, accédez à votre sandbox cible et affichez manuellement l’objet mis à jour à partir de ce sandbox.
Objets créés manuellement dans le sandbox cible
Suivez ces étapes si votre cas d’utilisation implique l’application de modifications de configuration à des objets créés manuellement dans des sandbox distincts.
Créez et publiez tout d’abord un nouveau package avec votre objet mis à jour.
Importez ensuite votre package dans le sandbox cible qui contient les objets que vous souhaitez également mettre à jour. Pendant le processus d’importation, sélectionnez Mettre à jour les objets existants puis utilisez le navigateur d’objets pour sélectionner manuellement les objets cibles auxquels appliquer vos mises à jour.
- Il est facultatif de sélectionner un mapping de ciblage dans un autre sandbox pour les objets dépendants. Si aucun n’est sélectionné, un nouvel élément est créé.
- Pour l’espace de noms d’identité, le système détecte automatiquement si une nouvelle identité doit être créée si une identité existante doit être réutilisée dans le sandbox cible.
Une fois que vous avez identifié les objets cibles à mettre à jour, sélectionnez Terminer.
Tutoriel vidéo
La vidéo suivante est destinée à vous aider à comprendre les outils Sandbox et explique comment créer un package, publier un package et importer un package.
Étapes suivantes
Ce document a montré comment utiliser la fonctionnalité d’outils Sandbox dans l’interface utilisateur d’Experience Platform. Pour plus d’informations sur les sandbox, consultez le guide d’utilisation des sandbox.
Pour obtenir des instructions sur l’exécution de différentes opérations à l’aide de l’API Sandbox, consultez le guide de développement des sandbox. Pour une présentation générale des sandbox dans Experience Platform, reportez-vous à la documentation de présentation.