Partager ou intégrer des modèles
Ce chapitre donne un aperçu des fonctionnalités les plus importantes permettant de partager des modèles avec d'autres utilisateurs ou d'intégrer des modèles dans d'autres applications.
Partager des modèles, des objets et des analyses
Vous pouvez générer une URL basée sur des modèles, des objets et des analyses. De cette façon, vous pouvez par exemple partager facilement une analyse avec vos collègues par e-mail ou ajouter un modèle spécifique aux signets de votre navigateur.
Pour générer une URL :
Ouvrez le modèle ou l’analyse, ou ouvrez le Notebook de l’objet.
Cliquez sur le bouton Partager.
Maintenant, procédez comme suit :
Partagez l’URL par e-mail. Dans le champ Ajouter des personnes, commencez à taper le nom d'un utilisateur ou l’adresse e-mail d’un utilisateur, puis sélectionnez celui que vous voulez lorsque vous le voyez. Si le destinataire n’est pas un utilisateur ou n’a pas d’adresse e-mail associée, vous devez saisir l’adresse e-mail complète. Ajoutez des destinataires supplémentaires si nécessaire. Dans le champ Inclure un message, vous pouvez ajouter un message personnel si vous le souhaitez. Lorsque vous avez terminé, cliquez sur Partager et le message sera envoyé.
Collez l’URL là où vous en avez besoin. Cliquez sur Copier pour copier directement l’URL dans le Presse-papiers ou copiez l’URL manuellement depuis le champ Copier le lien.
Pour qu'ADOIT puisse envoyer des e-mails, les paramètres de l'e-mail doivent être définis correctement dans le Module d'administration.
Qui peut accéder à ces URL ?
Si un utilisateur utilise le portail Réferentiel d'Entreprise de manière anonyme (= sans fournir d’informations d’identification utilisateur) et génère une URL, n’importe qui peut accéder au contenu. Dans le cas contraire, l’accès à l’URL nécessite une connexion à ADOIT.
Langue et Circuit de validation
L’URL générée contient la langue actuelle en tant que paramètre. Lors de l’accès à l’URL, le contenu est ouvert dans la même langue que celle dans laquelle l’URL a été créée.
Exemple
Vous travaillez en anglais et avez généré une URL pour un modèle. L’URL générée renvoie automatiquement au modèle en anglais.
Lorsqu’un circuit de validation est utilisé, les URL générées sont automatiquement mises à jour pour utiliser la dernière version publiée d’objet.
Exemple
Vous avez généré une URL pour un Composant Applicatif (numéro de version interne « 1.00 »). Une nouvelle version de ce Composant Applicatif est publiée. L’URL générée vous montrera automatiquement le nouvel objet (numéro de version interne « 2.00 ») au lieu de la version précédente supprimée.
Cas particulier : Générer une URL pour le scénario d’application
Lorsque vous ouvrez une URL pour un scénario d’application, vous ignorez la page d'accueil d'ADOIT et vous accédez directement au scénario sélectionné. Afin de générer une telle URL :
« Cartographier & Documenter »
Ajoutez « ?scenarioID=ait_scenario_1_design_and_document » à l’URL à laquelle ADOIT est disponible.
« Relire & Valider »
Ajoutez « ?scenarioID=ait_scenario_3_control_and_release » à l’URL à laquelle ADOIT est disponible.
« Consulter & Explorer »
Ajoutez « ?scenarioID=ait_scenario_4_explore_and_contribute » à l’URL à laquelle ADOIT est disponible.
Exemple
ADOIT est disponible à l’URL http://server:8000/ADOIT16_0. Vous souhaitez créer une URL pour accéder directement au scénario « Cartographier & Documenter ».
L’URL doit ressembler à ceci :
http://server:8000/ADOIT16_0?scenarioID=ait_scenario_1_design_and_document
Intégrer ADOIT en tant qu’iFrame
L’élément HTML iFrame
vous permet d’intégrer ADOIT dans un site Web. Cela peut inclure, par
exemple, un blog ou le site Web de votre organisation. Une intégration ADOIT dans une autre
application Web est également possible.
Intégrer ADOIT dans un site Web
Insérez l’URL à laquelle ADOIT est disponible dans le code HTML suivant :
<iframe src="URL" width="800" height="800"/>
Insérez le code dans la page Web où vous souhaitez qu'ADOIT apparaisse. Ajustez la largeur (
largeur
) et la hauteur (hauteur
) pour s’adapter aux dimensions de votre site Web.
Intégrer un modèle spécifique dans un site Web
Générer une URL permettant de relier le modèle que vous souhaitez intégrer à votre site Web.
Insérez l’URL du modèle dans le code HTML suivant :
<iframe src="MODEL URL" width="800" height="800"/>
Insérez le code dans la page Web où vous souhaitez que le modèle apparaisse. Ajustez la largeur (
largeur
) et la hauteur (hauteur
) pour s’adapter aux dimensions de votre site Web.
Options supplémentaires
Lors de l’intégration d'ADOIT dans un site Web, vous pouvez personnaliser l’apparence et le comportement de l’iFrame en ajoutant différents paramètres d’URL :
Définir la langue
Définir la langue dans laquelle ADOIT s’affiche, ajoutez « &lang=<code de langue> » à l’URL. Selon la configuration du produit, les codes de langue possibles sont par exemple « en » pour l’anglais ou « fr » pour le français. Par défaut, ce paramètre est déjà inclus dans une URL de modèle.
Seul le premier paramètre est séparé de l’URL par un point d’interrogation (?). Pour transmettre plusieurs paramètres à la même URL, passez tous les paramètres après le premier paramètre à l’aide d’une esperluette (&).
Activer l’intégration d'ADOIT en tant qu’iFrame
Dans ADOIT, l’affichage du client Web dans un cadre n’est pas autorisé par défaut pour des raisons de sécurité. L’iFrame restera vide dans ce cas. Pour permettre l’intégration d'ADOIT en tant qu’iFrame :
Ouvrez le dossier « <Tomcat installation>/webapps » et ouvrez le fichier
ADOIT16_0.war
avec un archiveur de fichiers. Modifiez le fichieradoxx_web.properties
qui se trouve à l’intérieur.Définissez
security.src.frame-ancestors
en fonction des pages qui doivent être autorisées à intégrer ADOIT en tant qu’iFrame. Le paramètre 'self' vous permet d’intégrer ADOIT à partir de pages ayant la même origine que le serveur Web. En outre, une ou plusieurs URL de sites Web peuvent être spécifiées. Séparez les paramètres par un espace. Enregistrez les modifications par la suite.
Exemple
Si vous souhaitez autoriser l’intégration ADOIT en tant qu’iFrame de la même origine et https://example.com, vous pouvez utiliser :
security.src.frame-ancestors = 'self' https://example.com
Le serveur Web Apache Tomcat doit être redémarré pour que les modifications de configuration deviennent effectives.
Accéder à ADOIT via une REST API
ADOIT fournit une interface REST. Cette interface peut être utilisée pour accéder aux données d'ADOIT depuis d’autres applications.
Via l’API REST incluse dans ADOIT vous pouvez par exemple afficher un graphique de modèle ou d’autres données de modèle à partir d’une autre application.
Les instructions relatives à l'activation de l’accès à l’API REST sont décrites dans le chapitre API REST du Manuel d’administration.
Pour plus d’informations sur l’utilisation de l’API REST, consultez le Portail des développeurs ADOxx.
Si vous avez des questions, veuillez contacter votre consultant ADOIT.