Exportation de schémas XDM dans l’interface utilisateur

Toutes les ressources de la bibliothèque de Schémas sont contenues dans un sandbox spécifique au sein d’une organisation IMS. Dans certains cas, vous pouvez partager des ressources de modèle de données d’expérience (XDM) entre des sandbox et des organisations IMS.

Pour répondre à ce besoin, l’espace de travail Schémas de l’interface utilisateur de Adobe Experience Platform vous permet de générer une charge utile d’exportation pour tout schéma de la bibliothèque de Schémas. Cette charge utile peut ensuite être utilisée dans un appel à l'API de registre de Schéma pour importer le schéma (et toutes les ressources dépendantes) dans un sandbox de cible et une organisation IMS.

REMARQUE

Vous pouvez également utiliser l'API Schéma Registry pour exporter d'autres ressources en plus des schémas, notamment des classes, des mixins et des types de données. Pour plus d'informations, consultez le guide des points de terminaison export/import.

Conditions préalables

Bien que l’interface utilisateur de la plate-forme vous permette d’exporter des ressources XDM, vous devez utiliser l’API Schéma Registry pour importer ces ressources dans d’autres sandbox ou des organisations IMS afin de terminer le processus. Pour obtenir des informations importantes sur les en-têtes d'authentification requis avant de suivre ce guide, reportez-vous au guide Prise en main de l'API de registre des Schémas.

Générer une charge utile d’exportation

Dans l’interface utilisateur de la plate-forme, sélectionnez Schémas dans le volet de navigation de gauche. Dans l'espace de travail Schémas, recherchez le schéma à exporter et ouvrez-le dans Schema Editor.

CONSEIL

Consultez le guide sur l'exploration des ressources XDM pour plus d'informations sur la manière de trouver la ressource XDM que vous recherchez.

Une fois le schéma ouvert, sélectionnez l’icône Copier JSON (Copier l’icône) dans le coin supérieur droit de la trame.

Cette opération copie une charge JSON dans le Presse-papiers, générée en fonction de la structure du schéma. Pour le schéma "Loyalty Members" illustré ci-dessus, le fichier JSON suivant est généré :

[
  {
    "$id": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/mixins/9ecfd881d0053568d277b792e4d24c6b70ffa7782bd31265",
    "meta:altId": "_<XDM_TENANTID_PLACEHOLDER>.mixins.9ecfd881d0053568d277b792e4d24c6b70ffa7782bd31265",
    "meta:resourceType": "mixins",
    "version": "1.0",
    "title": "Loyalty details",
    "type": "object",
    "description": "",
    "definitions": {
      "customFields": {
        "type": "object",
        "properties": {
          "_<XDM_TENANTID_PLACEHOLDER>": {
            "type": "object",
            "properties": {
              "loyalty": {
                "title": "Loyalty",
                "description": "",
                "type": "object",
                "isRequired": false,
                "required": [
                  
                ],
                "properties": {
                  "loyaltyId": {
                    "title": "Loyalty ID",
                    "description": "",
                    "type": "string",
                    "isRequired": false,
                    "required": [
                      
                    ],
                    "meta:xdmType": "string"
                  },
                  "memberSince": {
                    "title": "Member Since",
                    "description": "",
                    "type": "string",
                    "isRequired": false,
                    "required": [
                      
                    ],
                    "format": "date",
                    "meta:xdmType": "date"
                  },
                  "points": {
                    "title": "Points",
                    "description": "",
                    "type": "integer",
                    "isRequired": false,
                    "required": [
                      
                    ],
                    "meta:xdmType": "int"
                  },
                  "loyaltyLevel": {
                    "title": "Loyalty Level",
                    "description": "",
                    "type": "string",
                    "isRequired": false,
                    "required": [
                      
                    ],
                    "enum": [
                      "platinum",
                      "gold",
                      "silver",
                      "bronze"
                    ],
                    "meta:enum": {
                      "platinum": "Platinum",
                      "gold": "Gold",
                      "silver": "Silver",
                      "bronze": "Bronze"
                    },
                    "meta:xdmType": "string"
                  }
                },
                "meta:xdmType": "object"
              }
            },
            "meta:xdmType": "object"
          }
        },
        "meta:xdmType": "object"
      }
    },
    "allOf": [
      {
        "$ref": "#/definitions/customFields",
        "type": "object",
        "meta:xdmType": "object"
      }
    ],
    "meta:extensible": true,
    "meta:abstract": true,
    "meta:intendedToExtend": [
      
    ],
    "meta:xdmType": "object",
    "meta:sandboxId": "1bd86660-c5da-11e9-93d4-6d5fc3a66a8e",
    "meta:sandboxType": "production"
  },
  {
    "$id": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/schemas/1e5a739ded8fd1d766a0e06e881a38031874dddd1c7020ad",
    "meta:altId": "_<XDM_TENANTID_PLACEHOLDER>.schemas.1e5a739ded8fd1d766a0e06e881a38031874dddd1c7020ad",
    "meta:resourceType": "schemas",
    "version": "1.4",
    "title": "Loyalty Members",
    "type": "object",
    "description": "Describes customers who are members of a loyalty program.",
    "allOf": [
      {
        "$ref": "https://ns.adobe.com/xdm/context/profile",
        "type": "object",
        "meta:xdmType": "object"
      },
      {
        "$ref": "https://ns.adobe.com/xdm/context/profile-person-details",
        "type": "object",
        "meta:xdmType": "object"
      },
      {
        "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details",
        "type": "object",
        "meta:xdmType": "object"
      },
      {
        "$ref": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/mixins/9ecfd881d0053568d277b792e4d24c6b70ffa7782bd31265",
        "type": "object",
        "meta:xdmType": "object"
      },
      {
        "$ref": "https://ns.adobe.com/xdm/mixins/profile-consents",
        "type": "object",
        "meta:xdmType": "object"
      }
    ],
    "meta:extensible": false,
    "meta:abstract": false,
    "meta:extends": [
      "https://ns.adobe.com/xdm/context/profile-person-details",
      "https://ns.adobe.com/xdm/context/profile-personal-details",
      "https://ns.adobe.com/xdm/common/auditable",
      "https://ns.adobe.com/xdm/data/record",
      "https://ns.adobe.com/xdm/context/profile",
      "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/mixins/9ecfd881d0053568d277b792e4d24c6b70ffa7782bd31265",
      "https://ns.adobe.com/xdm/mixins/profile-consents"
    ],
    "meta:xdmType": "object",
    "meta:class": "https://ns.adobe.com/xdm/context/profile",
    "meta:sandboxId": "1bd86660-c5da-11e9-93d4-6d5fc3a66a8e",
    "meta:sandboxType": "production",
    "meta:immutableTags": [
      
    ]
  }
]

La charge utile prend la forme d'un tableau, chaque élément de tableau étant un objet qui représente une ressource XDM personnalisée à exporter. Dans l’exemple ci-dessus, le mixin personnalisé "Loyalty details" et le schéma "Loyalty Members" sont inclus. Les ressources de base utilisées par le schéma ne sont pas incluses dans l'exportation, car elles sont disponibles dans tous les sandbox et les organismes IMS.

Notez que chaque instance de l’ID de client de votre organisation s’affiche sous la forme <XDM_TENANTID_PLACEHOLDER> dans la charge utile. Ces espaces réservés seront automatiquement remplacés par la valeur d'ID de locataire appropriée en fonction de l'endroit où vous importez le schéma à l'étape suivante.

Importer la ressource à l'aide de l'API

Une fois que vous avez copié le fichier JSON d’exportation pour le schéma, vous pouvez l’utiliser comme charge utile pour une demande de POST au point de terminaison /import de l’API de registre de Schéma. Voir la section sur l'importation d'une ressource XDM dans l'API pour plus d'informations sur la configuration de l'appel pour envoyer le schéma à l'organisation IMS et au sandbox de votre choix.

Étapes suivantes

En suivant ce guide, vous avez exporté un schéma XDM vers une autre organisation IMS ou un autre sandbox. Pour plus d'informations sur les fonctionnalités de l'interface utilisateur Schémas, consultez la section Schémas présentation de l'interface utilisateur.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now