Export et import de schéma

Vue d'ensemble (Overview)

Un schéma représente les métadonnées de chaque entité et ensemble de choix, contenant des informations telles que le type de données des champs d'entité ou les relations entre les champs d'entité.

En exportant et en important un schéma, vous êtes en mesure de mettre en œuvre les meilleures pratiques de gestion du cycle de vie d'une application (développement, test, déploiement) en tenant compte de fonctionnalités telles que la copie de schéma entre locataires ou le suivi des modifications de schéma via un outil de contrôle de code source de votre choix.

L'exportation du schéma télécharge un fichier JSON contenant les métadonnées de l'entité sur votre machine locale. Vous pouvez partager le fichier à importer par différents développeurs dans leurs locataires, et vous pouvez vous-même importer des schémas développés par la communauté.

Autorisations

Les autorisations administratives suivantes doivent être définies pour que les utilisateurs puissent exporter et importer le schéma :

Opération (Operation)	Permission
Exporter le schéma	Afficher le schéma
Importer le schéma	Personnaliser le schéma Afficher le schéma

Pour savoir comment définir les autorisations requises, consultez la page Gestion de l'accès ( Managing Access ).

Exportation du schéma

Remarque :

• Seuls les utilisateurs disposant des autorisations adéquates peuvent exporter le schéma.
• Toutes les entités présentes dans le locataire sont exportées.
• Les entités créées par le système et les champs système correspondants sont exclues de l'exportation.

Pour exporter le schéma actuel :

1. Accédez au locataire souhaité dans Data Service.
2. Cliquez sur Importer/Exporter (Import/Export).
3. Sélectionnez Exporter le schéma (Export Schema). Un message contextuel vous invite à confirmer l'exportation.
4. Cliquez sur Confirmer (Confirm) pour déclencher l'exportation. Un fichier .JSON contenant le schéma est téléchargé sur votre machine.

Importation du schéma

Remarque :

• Seuls les utilisateurs disposant des autorisations adéquates peuvent importer le schéma.
• Le fichier de schéma importé doit être :
  • valide
  • au format JSON
  • d'une taille inférieure à 30 Mo
• Les champs Créé par (Created by) et Modifié par (Modified by) du schéma importé sont remplis avec le nom de l'utilisateur qui a effectué l'importation.
• Les champs d'heure de création et de dernière modification sont remplis avec l'horodatage de l'importation.
• Une fois démarré, le processus d'importation ne peut pas être arrêté.

Pour importer un schéma dans votre locataire :

1. Accédez au locataire souhaité dans Data Service.
2. Cliquez sur Importer/Exporter (Import/Export).

3. Sélectionnez Importer le schéma (Import Schema). Une fenêtre s'affiche, vous permettant de rechercher le fichier de schéma et de le sélectionner.

   Remarque: Le fichier de schéma doit être au format JSON et valide.
4. Si aucun doublon n'est détecté, les entités sont importées dans le locataire cible. En cas de doublons, la fenêtre Importation d'entités (Entities Import) s'affiche, vous permettant soit d'ajouter des champs en double aux entités existantes, soit de ne pas importer les doublons.

Gestion des doublons

Le processus d'importation d'un schéma compare les entités, les champs ou les ensembles de choix existants dans le locataire à ceux du schéma importé.

Pour chaque doublon identifié dans le schéma importé, les options suivantes s'affichent :

Ajouter à l'entité existante (option par défaut)

• Les champs d'entité et les ensembles de choix qui n'existent pas dans le locataire cible sont importés.
• Les entités contenant des champs et des ensembles de choix avec des propriétés différentes (telles que le nom ou le type de données) sont ignorées lors de l'importation.

Ne pas importer

• L'entité n'est pas importée dans le locataire cible.