Les modèles vous permettent de stocker des configurations d'application ou de dimension dans un fichier hors ligne afin de les utiliser dans d'autres environnements Oracle Enterprise Data Management Cloud. Servez-vous des modèles pour transférer des applications ou des dimensions et leurs objets de métadonnées entre les environnements (par exemple, d'un environnement de test à un environnement de production) ou pour mettre rapidement en place de nouvelles implémentations.
Pour utiliser un modèle, exportez d'abord une application ou une dimension ainsi que tous les objets de métadonnées liés dans l'environnement source vers un fichier .json, puis importez ce modèle dans l'environnement cible.
Les modèles contiennent seulement des métadonnées et n'incluent aucune donnée, aucune demande, ni aucun historique de transactions.
Meilleures pratiques
Si vous créez une application dans un environnement de test et que vous avez l'intention de la transférer vers un environnement de production existant, il est recommandé d'actualiser d'abord l'environnement de test à l'aide d'un instantané actuel de l'environnement de production, puis de créer l'application à transférer. Ainsi, vous vous assurez que les objets globaux tels que les propriétés et les vues ont le même ID dans les deux environnements.
Caution:
Les modèles sont conçus pour migrer des modifications d'un environnement vers un autre. De ce fait, il est important de désigner un système source, dans lequel toutes les modifications sont effectuées, et un système cible, vers lequel ces modifications sont migrées. N'effectuez pas vos modifications dans les deux environnements. Vous pouvez utiliser des instantanés de migration pour resynchroniser les environnements, si nécessaire. Reportez-vous aux
meilleures pratiques dans la section
Exemples de scénario de migration.
Remarques
- Vous devez être administrateur de service ou disposer du rôle d'application Migrations - Administrer (reportez-vous à la section Présentation des rôles et des autorisations d'application) pour importer des applications et des dimensions, et en exporter vers des modèles.
- Lorsqu'une application est transférée vers l'environnement cible :
- si le propriétaire de l'application dans l'environnement source existe également dans l'environnement cible, il est maintenu comme propriétaire de l'application dans l'environnement cible ;
- si le propriétaire de l'application dans l'environnement source n'existe pas dans l'environnement cible, un administrateur de service doit affecter un propriétaire à l'application dans l'environnement cible.
- Vous pouvez transférer de nouvelles applications ou dimensions de l'environnement source vers l'environnement cible, ou transférer celles qui existent déjà vers l'environnement cible. Le processus d'import de modèle met à jour les applications ou dimensions existantes dans l'environnement cible en créant des objets et en modifiant les objets existants pour l'application ou la dimension cible. Reportez-vous à la section Mise à jour d'une application ou d'une dimension existante à l'aide d'un modèle.
- Vous pouvez transférer uniquement des applications actives.
- Vous pouvez exclure des objets de chaîne de données archivés des imports de modèle si les objets archivés dans l'environnement source n'existent pas déjà dans l'environnement cible.
Note:
Les objets qui dépendent de l'objet archivé sont également exclus de l'import de modèle s'ils n'existent pas dans l'environnement cible. Si un objet dépendant est partiellement exclu, il apparaît dans l'import ou l'aperçu de modèle avec un message d'avertissement indiquant qu'il n'a pas pu être importé.
Par exemple, si vous excluez une dimension archivée lors de l'import et que la dimension n'existe pas déjà dans l'environnement cible, les objets tels que les liaisons de dimension, les types de noeud, les stratégies et les extractions sont également exclus de l'import de modèle s'ils n'existent pas non plus dans l'environnement cible.
- Vous pouvez transférer plusieurs applications dans un même fichier de modèle. Si le transfert est effectué au niveau de la dimension, vous ne pouvez pas transférer plusieurs dimensions dans un même fichier de modèle.
- Lorsque vous transférez une dimension, l'application qui contient la dimension doit exister dans l'environnement cible.
- Pour transférer une application ou une dimension entre des environnements, la version des deux environnements doit être identique.
- Lors de l'import d'un modèle, si un utilisateur ou un groupe existe dans l'environnement source et dans l'environnement cible, les références d'utilisateur et de groupe suivantes sont importées pour les objets associés :
- Autorisations
- Utilisateurs et groupes de stratégies
- Personnes affectées à l'abonnement
- Filtres de vue pour les utilisateurs et les groupes
Si un utilisateur ou un groupe de l'environnement source n'existe pas dans l'environnement cible, les références d'utilisateur ou de groupe associées ne sont pas transférées. Un message apparaît et indique les utilisateurs et les groupes manquants dans l'environnement cible, ainsi que les objets associés qui n'ont pas été importés.
- Les applications ou dimensions source et cible doivent exister toutes les deux dans l'environnement cible afin d'importer des convertisseurs de type de noeud et des abonnements. Transférez les applications source et cible dans le même fichier de modèle, ou veillez à importer l'application ou la dimension source pour les convertisseurs et les abonnements d'abord, afin que ces derniers soient créés lorsque vous importez l'application ou la dimension cible.
- Si vous transférez une dimension dont les propriétés utilisent un type de données de noeud pour référencer d'autres dimensions, ces dimensions source doivent déjà exister dans le système cible. Si ce n'est pas le cas, transférez d'abord ces dimensions source ou utilisez un modèle d'application pour transférer toutes les dimensions dans le même fichier de modèle.
- Lorsque vous importez les objets globaux énumérés ci-dessous, si l'objet existe déjà dans l'environnement cible avec le même nom mais un ID différent, l'objet source est renommé dans l'environnement cible afin de le rendre unique :
- Propriétés
- Vues
- Ensembles de consultations
- Connexions globales
- Après avoir exporté une application ou une dimension vers un modèle, vous pouvez passer en revue le contenu du fichier de modèle dans un visualiseur
.json.
Caution:
La modification manuelle du fichier de modèle n'est pas prise en charge.
Pour exporter des applications ou une dimension vers un modèle, procédez comme suit :
- Dans la mosaïque Outils, sélectionnez Modèles.
Note:
Seuls les administrateurs de service et les utilisateurs dotés du rôle d'application
Migrations - Administrer peuvent voir la mosaïque
Outils.
- Dans l'onglet Exporter, exécutez une action :
- Pour exporter des applications, sélectionnez-en une dans le panneau de gauche. Appuyez sur la touche Ctrl/Cmd et cliquez sur plusieurs applications pour les sélectionner. Les applications sélectionnées sont répertoriées dans la section Artefacts sélectionnés.
- Pour exporter une dimension, développez l'application dans le panneau de gauche et sélectionnez la dimension à exporter. Vous ne pouvez pas sélectionner plusieurs dimensions dans un même fichier de modèle.
Note:
Pour exporter une dimension d'attribut, sélectionnez la dimension de base de cette dernière.
- Dans Fichier de modèle, saisissez le nom du fichier avec l'extension
.json, puis cliquez sur Exporter.
Le modèle est créé et téléchargé sur votre système de fichiers local. Le statut de l'export est affiché.
Pour importer une application ou une dimension à partir d'un modèle, procédez comme suit :
- Dans la mosaïque Outils, sélectionnez Modèles.
Note:
Seuls les administrateurs de service et les utilisateurs dotés du rôle d'application
Migrations - Administrer peuvent voir les mosaïques
Outils et
Modèles.
- Dans l'onglet Importer, cliquez sur Choisir le fichier.
- A partir de votre système de fichiers local, sélectionnez un fichier doté de l'extension
.json, puis cliquez sur Ouvrir.
- (Facultatif) Choisissez des options d'import :
- Remplacer les autorisations : remplacez les autorisations existantes dans l'environnement cible par les autorisations du modèle source.
- Remplacer les groupes de stratégies : remplacez les groupes de stratégies existants dans l'environnement cible par les groupes de stratégies du modèle source.
- Exclure les objets archivés : empêchez les objets archivés d'un modèle d'un environnement source d'être importés dans l'environnement cible si les objets source n'existent pas dans l'environnement cible.
Note:
Les objets archivés d'un modèle source qui existent déjà dans l'environnement cible ne peuvent pas être exclus de l'import ou l'aperçu de modèle.
Reportez-vous à la section Objets et paramètres du modèle.
- Cliquez sur Aperçu pour identifier les objets dans le fichier de modèle et voir leur statut. Reportez-vous à la section Aperçu des imports de modèle et examen des résultats d'import.
- Cliquez sur Importer, puis sur Oui dans le message de confirmation.
Le modèle est importé et le statut de chaque objet dans le modèle est affiché. Reportez-vous à Aperçu des imports de modèle et examen des résultats d'import.