Etape 1 : création d'un composant

Cette étape explique comment créer votre composant personnalisé dans Oracle Content Management.

Lorsque vous créez un composant personnalisé, vous devez l'inscrire pour qu'Oracle Content Management puisse l'utiliser. Pour informer Oracle Content Management de l'existence de votre composant, vous devez l'inscrire à l'aide de la page Composants dans le générateur de site.

Vous pouvez inscrire deux types de composant.

Composant local :
- Il s'agit d'un composant dont les fichiers sont stockés sur l'instance de serveur Oracle Content Management.
- Son principal avantage est que vous ne risquez pas de rencontrer des problèmes interdomaines ou interprotocoles car les fichiers sont stockés avec votre site.
- L'inconvénient est que vous ne pouvez pas exécuter de logique de niveau intermédiaire dans le serveur Oracle Content Management. Vous êtes obligé d'utiliser des API REST vers des serveurs distants qui prennent en charge CORS.
- Vous pouvez imbriquer ce type de composant directement dans la page ou vous pouvez l'afficher au moyen d'un cadre incorporé.
Composant distant :
- Il s'agit d'un composant dont les fichiers sont stockés sur un serveur distant. Vous avez alors seulement besoin d'inscrire les URL auprès du programme d'affichage et du panneau des paramètres du composant.
- Un composant distant est avantageux lorsque vous devez exécuter une logique côté serveur lors de la création du contenu de votre composant.
- La contrepartie est que vous devez veiller à résoudre tous les problèmes interdomaines et les problèmes de sécurité pour l'accès à ces URL.
- Les composants distants sont toujours affichés sur la page au moyen d'un cadre incorporé.

Pour créer et inscrire un composant local, procédez comme suit :

Sur la page d'accueil d'Oracle Content Management, cliquez sur Développeur.

La page Développeur apparaît.
Cliquez sur Afficher tous les composants.
Dans le menu, choisissez Créer un composant local.
Nommez le composant, par exemple A_Local_Component.
Saisissez une description (facultatif).
Cliquez sur Créer.

Une fois ces étapes terminées, un composant nommé A_Local_Component apparaît dans la liste des composants.

Vérification des résultats de l'étape 1

Maintenant que vous avez créé un composant, il devrait apparaître dans la palette Composant de tous les sites que vous créez. Effectuez les étapes suivantes pour confirmer la création de votre composant :

Créez un site nommé localComponentTest.
Sélectionnez le site et cliquez sur Ouvrir.
Cliquez sur Modifier.
Créez une mise à jour pour le site, nommez-la et saisissez éventuellement une description.
Sélectionnez une page sur le site.
Cliquez sur dans la palette latérale et sélectionnez Personnalisé pour afficher la liste des composants personnalisés.
Sélectionnez le composant A_Local_Component dans la liste des composants personnalisés, puis faites-le glisser sur la page.

Vous devez désormais voir un affichage par défaut pour le composant local que vous avez créé.
Sélectionnez dans la bannière du composant que vous venez de déposer sur la page.
Sélectionnez Paramètres.
Modifiez l'alignement et définissez le style du composant.
Fermez le panneau des paramètres.

Les étapes suivantes présentent la structure du composant personnalisé et expliquent comment le modifier en fonction de vos besoins. Passez à Etape 2 : examen de la structure de votre composant local.