Intégrer une vue à un site
Montrez une vue d’un schéma, à jour et en lecture seule, sur votre site, votre intranet ou votre documentation, par une iframe ou par oEmbed.
Sur cette page
Le code d’intégration est une iframe qui montre une vue d’un schéma : en lecture seule, dessinée par iyedy à partir du schéma enregistré, avec déplacement, zoom et le titre de la vue. Utilisez-le sur le site de documentation de votre produit, votre intranet, ou toute page qui accepte du HTML.
Avant de commencer
- Vous êtes éditeur du schéma, ou son propriétaire, et le schéma est enregistré dans votre bibliothèque.
- La classification du schéma reste sous le plafond des intégrations, Interne par défaut. Les schémas Restreints ne sont jamais intégrés.
- Un propriétaire ou un administrateur de la sécurité peut ajouter votre site aux sites autorisés à afficher les intégrations.
Intégrer une vue
- Autoriser votre site
Depuis la palette de commandes (Ctrl K), ouvrez Réglages des intégrations (intégrations, Jira)…. Sous Sites autorisés à afficher les intégrations, ajoutez l’adresse de votre site, comme
https://docs.claims.example, ouhttps://*.claims.examplepour tous ses sous-domaines (schéma et hôte seulement). Choisissez Enregistrer. - Créer le lien d’intégration
Ouvrez le schéma, choisissez Partager…, puis ouvrez Intégrer ailleurs. Choisissez la Vue, la Durée de vie du lien et le Papier, puis choisissez Créer un lien d’intégration.
- Copier le code d’intégration
Le code n’est montré qu’une fois : choisissez Copier le code d’intégration. C’est une iframe dont l’adresse est le lien d’intégration.
- Le coller dans votre page
Collez le code là où la vue doit apparaître, dans le HTML de votre page ou dans le bloc HTML de votre outil de site. Réglez la largeur et la hauteur du cadre selon votre mise en page.
Votre page montre la vue de Claims Platform ; vous pouvez vous y déplacer et zoomer.
oEmbed
Le lien d’intégration répond aussi à oEmbed, pour les outils qui transforment un lien collé en cadre intégré. Interrogez l’hôte de partage avec le lien d’intégration dans url :
GET /oembed?url=https%3A%2F%2Fshare.iyedy.com%2Fe%2F…&format=json&maxwidth=800&maxheight=600 HTTP/1.1
Host: share.iyedy.com
La réponse est une réponse oEmbed de type rich dont le html est le cadre. Seul format=json est proposé ; xml répond 501. oEmbed ne répond que pour les liens d’intégration d’iyedy.
Ce que fait la page intégrée, et ce qu’elle ne fait pas
- Elle montre un dessin, jamais le modèle. La vue est dessinée par iyedy ; la définition du schéma n’est pas dans la page.
- Elle ne pose aucun cookie et n’est pas indexée par les moteurs de recherche, et elle n’envoie pas de référent quand un lecteur suit un lien vers l’extérieur.
- Elle ne s’affiche que sur les sites autorisés. Dans tout autre site, les navigateurs refusent de la montrer. Ouvert seul, le lien fonctionne pour quiconque le détient jusqu’à son expiration ou sa révocation.
- Les membres peuvent ouvrir le schéma. Un membre de l’espace de travail a un lien Ouvrir vers le schéma dans iyedy.
- Free. Sur un compte personnel Free, la feuille porte la marque d’export en dessous.
- Elle a une limite de débit : 300 requêtes par minute par adresse de lecteur.
Si cela ne fonctionne pas
Le cadre reste vide ou le navigateur le refuse
Votre site ne figure pas parmi les sites autorisés à afficher les intégrations, ou son adresse diffère (http au lieu de https, un autre sous-domaine). Ajoutez l’hôte exact à l’étape 1, puis rechargez votre page.
La vue fonctionnait, puis a disparu
Le lien d’intégration a expiré ou a été révoqué. Créez-en un nouveau et remplacez le code dans votre page.
D’autres symptômes, les mêmes pour toute intégration : Afficher un schéma dans Confluence.
Cette page vous a-t-elle aidé ?Réponse anonyme, comptée seulement si vous avez accepté la mesure.
Qu’est-ce qui n’a pas marché ?
N’écrivez pas de données personnelles.