Documentation Oracle Cloud Infrastructure

Créer une extension simple

Le moyen le plus simple de configurer VB Studio afin que d'autres utilisateurs puissent configurer les pages Oracle Cloud Applications est de créer une extension simple vous-même. Cela vous permet de vous assurer que tout fonctionne correctement.

Avant de commencer, décidez de la façon dont vous souhaitez configurer les projets de votre équipe :
  • En général, il est plus facile d'utiliser un seul projet VB Studio pour tous vos travaux d'extension, avec un référentiel Git différent pour chaque pilier (comme HCM, SCM, etc.). L'utilisation d'un seul projet permet de garder tout ensemble au même endroit, limite le nombre de droits d'accès requis par chaque utilisateur et a généralement un sens si votre équipe est plus petite. C'est ainsi que VB Studio fait les choses par défaut, donc si cela fonctionne pour votre équipe, vous pouvez passer directement à l'étape 1 et commencer.
  • Si, d'autre part, vous avez des utilisateurs qui doivent être isolés du travail de l'autre, par exemple, différentes organisations de consultants effectuant des travaux d'implémentation pour différents piliers, ou une plus grande équipe qui utilise une famille d'environnements d'application Oracle Cloud commune pour développer, tester et héberger des extensions à partir de plusieurs piliers. Vous pouvez choisir de séparer votre travail en créant un projet pour chaque pilier. Si cette direction a le plus de sens pour vous, accédez à la page Organisation de VB Studio et commencez à créer des projets en utilisant Créer un projet pour vous guider. Lorsque vous avez terminé, passez à l'étape 1 ci-dessous.
  1. Accédez à une page de votre application Oracle Cloud.
  2. Cliquez sur votre nom utilisateur dans l'angle supérieur droit pour ouvrir le menu Paramètres et actions, puis sélectionnez Modifier la page dans Visual Builder Studio :
    Description de l'image fa-edit-page-link.png
    Description de l'image fa-edit-page-link.png

  3. Dans la boîte de dialogue Nouveau projet d'extension d'application, entrez un nom unique pour le projet, ainsi que certains membres ou groupes d'équipe qui, selon vous, pourraient utiliser ce projet pour étendre cette application Oracle Cloud :
    Description de l'image newappextproj.png
    Description de l'image newappextproj.png

    Remarque

    Une fois cette procédure terminée, assurez-vous que les membres de l'équipe que vous avez ajoutés disposent des rôles appropriés, en suivant les étapes de la section Configuration des utilisateurs VB Studio.

    VB Studio affiche une boîte de dialogue de statut qui vous permet de suivre chaque création de ressource :
    Description de l'image projprogress.png
    Description de l'illustration projprogress.png

    Si vous souhaitez en savoir plus sur ces ressources, reportez-vous à Quels sont les artefacts de projet créés ?.

    Par défaut, VB Studio crée un projet privé repérable, ce qui signifie que les utilisateurs que vous n'avez pas ajoutés explicitement au projet seront autorisés à choisir le projet lorsqu'ils cliquent sur Modifier la page dans Visual Builder Studio à partir de l'application Oracle Cloud associée. N'oubliez pas qu'il est préférable de conserver tout le travail d'une application Oracle Cloud donnée dans le même projet. VB Studio placera donc un badge "Recommandé" en regard du nom du projet pour encourager les utilisateurs à le sélectionner.

    Remarque

    Le nom d'espace de travail par défaut généré lorsque vous passez à VB Studio utilise généralement le pilier de la page que vous essayez d'étendre, au format Workspace PILLAR, par exemple, Workspace HCM. Si ce nom existe déjà, un nombre est ajouté au nom et incrémenté selon les besoins, par exemple, Workspace HCM 1, Workspace HCM 2, etc.
  4. VB Studio ouvre la page que vous venez de voir, dans le Designer. Lorsque vous survolez un composant extensible sur le canevas, il est présenté en bleu, comme suit :
    Description de l'image extendableareasingreen.png
    Description de l'image extendableareasingreen.png

  5. Apportez un petit changement à la page, juste à des fins de test. Vous pouvez faire glisser un composant d'en-tête sur la page, par exemple, ou ajouter ou supprimer un champ dans un formulaire dynamique. VB Studio enregistre implicitement vos modifications lorsque vous travaillez.
  6. Dans l'en-tête du concepteur, cliquez sur Publier :
    Description de l'image publish-button-header.png
    Description de l'image publish-button-header.png

  7. Etant donné qu'il s'agit simplement d'un test, acceptez les valeurs par défaut dans la boîte de dialogue Publier et cliquez sur Publier.
    Par défaut, les sources de votre extension sont fusionnées vers la branche par défaut (main) du référentiel Git de l'espace de travail, puis créées et déployées immédiatement vers l'instance Oracle Cloud Applications dans votre environnement DEV.
    Remarque

    Si vous préférez, vous pouvez modifier la valeur par défaut et déployer vos modifications à la place via un pipeline d'intégration et de livraison continues (CI/CD). Les pipelines d'intégration continue et de déploiement continu vous donnent la possibilité de déployer une extension vers plusieurs environnements, ainsi que d'automatiser certaines opérations de cycle de vie. Pour plus d'informations, reportez-vous à Utilisation de pipelines CI/CD pour le déploiement.
  8. Cliquez maintenant sur le lien dans la boîte de dialogue Publier pour afficher vos modifications publiées :
    Description de l'image publish-pipelinedisabled.png
    Description de l'image publish-pipelinedisabled.png

    Remarque

    Veillez à copier et coller l'URL de déploiement dans le presse-papiers avant de cliquer sur Fermer. Vous n'aurez pas accès à l'URL après la fermeture de la boîte de dialogue Publier.

    En outre, les utilisateurs de votre application Oracle Cloud devront se déconnecter de l'application, puis se reconnecter pour être sûrs de voir la dernière version.