Composants affichés dans des cadres incorporés

Pour indiquer des composants affichés dans des cadres incorporés dans des pages Oracle Content Management, vous pouvez inscrire et ajouter des composants de serveurs externes (appelés composants distants) et vous pouvez également sélectionner l'option de cadre incorporé lors de la création d'un composant local. Ce type de composant peut étendre les fonctionnalités des sites, comme l'ajout d'un composant Social ou d'un composant de paiement de panier.

Pour un composant distant, vous devez indiquer l'URL endpoint. Pour un composant local affiché dans un cadre incorporé, les URL sont dérivées du nom du composant dans le catalogue de composants.

  • URL endpoint : le contenu du widget est extrait de cette URL et imbriqué dans un cadre incorporé.

  • URL des paramètres : cette URL est affichée dans un cadre incorporé pour configurer le composant une fois ce dernier déplacé vers la page.

Le composant peut afficher des visualisations de données statiques ou dynamiques ainsi qu'un formulaire ou une autre interface utilisateur interactive qui étend les fonctionnalités du site. Reportez-vous à Affichage des paramètres de composant.

Composants fournis par Oracle Content Management

Un ensemble de composants affichés dans des cadres incorporés sont fournis avec Oracle Content Management.

Nom Type ID

Liste des dossiers

scs-app

Liste des dossiers

Liste des fichiers

scs-app

Liste des fichiers

Gestionnaire de documents

scs-app

Gestionnaire de documents

Mention J'aime de Facebook

scs-app

Mention J'aime de Facebook

Abonnement à Twitter

scs-app

Abonnement à Twitter

Partage Twitter

scs-app

Partage Twitter

Recommandation de Facebook

scs-app

Recommandation de Facebook

Inscription de composant

Pour pouvoir utiliser un composant distant affiché dans un cadre incorporé sur un site, vous devez d'abord inscrire l'URL endpoint via HTTPS. Ces informations sont stockées dans le catalogue de composants. L'adresse doit permettre à l'URL d'afficher le composant dans un cadre incorporé. Ne définissez pas X-Frame-Options="sameorigin" dans l'en-tête. Pour un composant local, puisque les fichiers sont stockés sur le serveur Oracle Content Management, ce critère d'adresse est automatiquement satisfait.

Lorsqu'un composant affiché dans un cadre incorporé est inscrit, un GUID est généré pour représenter le composant. Si un tel composant est inscrit plusieurs fois dans une instance Oracle Content Management, il obtient plusieurs GUID car chaque GUID représente chaque inscription du composant. Lorsque le composant est inscrit, seule la description est stockée dans Oracle Content Management pour le GUID. Le composant continuera d'être exécuté à partir de l'adresse distante. Reportez-vous à Inscription d'un composant distant.

Une fois que le composant affiché dans un cadre incorporé est inscrit, un ID d'instance est également généré. L'ID d'instance représente un composant inscrit auprès d'un certain locataire Oracle Content Management. Si un même composant est inscrit plusieurs fois auprès du même locataire Oracle Content Management ou auprès d'un autre locataire Oracle Content Management, il possèdera différents ID d'instance.

Persistance des paramètres de composant distant

Lorsque l'URL des paramètres d'un composant affiché dans un cadre incorporé est affichée dans une boîte de dialogue de panneau des paramètres, l'ID d'instance et l'ID du composant sont fournis. Ainsi, le composant peut lui-même choisir de rendre des paramètres persistants sur son propre serveur, indexés par l'ID d'instance et l'ID du composant. Vous pouvez également utiliser le kit SDK Sites Oracle Content Management pour stocker jusqu'à 1,5 ko de données JSON dans le modèle de page du site pour l'ID de composant.

Rendre des paramètres persistants à l'aide du kit SDK Sites présente deux avantages pour les composants affichés dans des cadres incorporés :
  • Le composant peut facilement être inclus dans les versions de page, les mises à jour de page et le modèle de publication du site.

  • Le composant peut comporter des adresses HTML exécutées dans le navigateur, par opposition à une exécution dans le système back-end.

Reportez-vous à Kits SDK Oracle Content Management.