Étapes préliminaires

Dans ce tutoriel, vous apprendrez à installer le compagnon Oracle Visual Builder Add-in for Excel, à créer un classeur Microsoft Excel qui extrait des données d'un service REST et à publier le classeur afin que les utilisateurs professionnels puissent effectuer des tâches d'entrée de données. Il dure environ 10 minutes.

Contexte

Le compagnon Oracle Visual Builder Add-in for Excel vous aide à télécharger des données d'un service REST vers un tableau d'un classeur Excel, où les utilisateurs peuvent modifier, créer ou supprimer des données avant de renvoyer ces modifications au service. Une fois le compagnon installé, vous entrez le point d'extrémité du service pour télécharger les données du service dans le classeur Excel. Vous verrez également un nouvel onglet du ruban Oracle Visual Builder avec des commandes pour vous aider à gérer les données téléchargées.

Ce dont vous avez besoin

• Un système d'exploitation Windows 10 ou 11 avec une installation de Microsoft Excel 365 ou d'une autre version prise en charge

  (Voir Plate-formes prises en charge dans Développement de feuilles de calcul intégrées à l'aide du compagnon Oracle Visual Builder Add-in for Excel.)

• Accès à votre instance Oracle Visual Builder

  Note : Vous pouvez peut-être terminer le tutoriel à l'aide d'un service REST de votre choix. Assurez-vous d'avoir les métadonnées du service OpenAPI pour le service cible (certains services Oracle fournissent une telle description en ajoutant /describe à l'URL). Si vous suivez cette route, certaines étapes de ce tutoriel peuvent être différentes pour votre service.

  Par exemple, vous pouvez sauter les sous-étapes 1 à 6 de l'étape 1, mais vous devrez quand même terminer les sous-étapes 7 et 8 pour installer le compagnon. Téléchargez le programme d'installation à partir de la page Téléchargements avant de commencer.

Installer le compagnon Oracle Visual Builder Add-in for Excel pour Excel

1. Cliquez avec le bouton droit de la souris sur ce fichier et téléchargez-le sur votre ordinateur.

   Le fichier Personnel_Manager.zip contient une application visuelle avec un objet d'affaires Employees et des données-échantillons.

2. Dans votre navigateur Web, connectez-vous à Oracle Visual Builder.
3. Dans la page Applications visuelles, cliquez sur Importer, puis sélectionnez Application à partir d'un fichier et naviguez jusqu'au fichier Personnel_Manager.zip . Cliquez sur Importer.
4. Dans la page Applications visuelles, cliquez sur Gestionnaire de personnel dans la colonne Nom.
5. Cliquez sur Objets d'affaires , puis cliquez sur Menu et sélectionnez Gestionnaire de données.

   

6. Dans la page Gestionnaire de données, cliquez sur Modifier les données dans Excel pour télécharger le programme d'installation.

   Conseil : Recherchez une version plus récente dans la page Téléchargements.

7. Quittez Excel avant d'exécuter le programme d'installation.
8. Cliquez deux fois sur le fichier d'installation téléchargé pour lancer l'installation, cliquez sur Suivant, puis sur Fermer une fois le compagnon installé. Voir Installer le compagnon Oracle Visual Builder Add-in for Excel dans Développement de feuilles de calcul intégrées à l'aide du compagnon Oracle Visual Builder Add-in for Excel.

   Une installation réussie active le compagnon dans Excel, et un nouvel onglet Oracle Visual Builder s'affiche lorsque vous démarrez Excel.

   

Configurer un classeur Excel pour télécharger des données à partir d'un service REST

Au cours de cette étape, vous allez créer une table dans un classeur Excel qui télécharge les données d'employé à partir du service REST associé à l'application visuelle que vous venez d'importer.

1. Dans l'onglet Objets d'affaires d'Oracle Visual Builder, cliquez sur Employés, puis sur Points d'extrémité.
2. Développez API de ressources, puis cliquez sur l'icône du presse-papiers pour copier l'URL complète de l'API de ressources de métadonnées :

   

3. Créez un classeur Excel nommé employees-source.xlsx dans un répertoire de votre ordinateur et ouvrez-le.
4. Cliquez sur la cellule dans laquelle vous souhaitez localiser la table de données.
5. Dans l'onglet Oracle Visual Builder du classeur Excel, cliquez sur Concepteur pour lancer l'Assistant Configuration de la nouvelle disposition.
6. Dans le premier écran de l'assistant, entrez l'URL que vous avez copiée précédemment dans le champ Adresse Web, puis cliquez sur Suivant.

   

   Laissez le paramètre d'authentification réglé à "Par défaut".

   Note : Si vous utilisez un autre service REST, entrez l'URL de ce service et ajoutez /describe à l'URL.

7. Dans la boîte de dialogue de connexion, entrez le nom d'utilisateur et le mot de passe que vous utilisez pour accéder à Oracle Visual Builder, puis cliquez sur Connexion.

   Le compagnon se connecte à votre instance Oracle Visual Builder et extrait les métadonnées du service. Les résultats de l'opération sont affichés dans l'assistant.

8. Cliquez sur Suivant pour continuer.
9. Dans l'écran suivant, sélectionnez Employés, puis cliquez sur Suivant.

   

   L'écran suivant vous invite à choisir le type de disposition que vous souhaitez créer : Table ou Form-over-Table.

   

10. Sélectionnez Disposition de table, puis cliquez sur Suivant.

    L'écran suivant vous invite à choisir des objets d'affaires supplémentaires pour une ou plusieurs dispositions dépendantes.

    

11. Laissez cet écran vide et cliquez sur Suivant pour continuer.
12. Dans l'écran final, confirmez les détails de la nouvelle disposition et cliquez sur Terminer.

    Une nouvelle table s'affiche dans votre classeur Excel. Les en-têtes de colonne sont affichés, avec une rangée de données fictives sous les en-têtes. Le concepteur de disposition s'affiche également à droite.

    

    Note : Si la cellule d'origine de la disposition se trouve dans les 10 premières rangées, la rangée d'en-tête est gelée de sorte que vous voyez toujours les en-têtes de colonne lorsque vous faites défiler vers le haut et vers le bas dans la feuille de calcul.

13. Cliquez sur Télécharger les données pour télécharger les données auxquelles l'objet d'affaires Employé fait référence.

    

Personnaliser le tableau dans le classeur Excel avant la publication

Vous pouvez personnaliser la table créée par le compagnon dans le classeur Excel avant de la publier et de la distribuer aux utilisateurs pour l'entrée de données. Par exemple, vous pouvez modifier l'ordre des colonnes afin que la colonne Courriel apparaisse avant le prénom de l'employé. Vous pouvez également ajouter une interrogation de recherche pour filtrer les données téléchargées à partir du service. Par exemple, vous pouvez ajouter le champ Salaire à partir de l'objet d'affaires Employés en tant que champ de recherche pour permettre aux utilisateurs d'entrer des critères de recherche qui leur permettent de télécharger uniquement les enregistrements des employés qui correspondent à ces critères.

1. Dans l'onglet Oracle Visual Builder, cliquez sur Concepteur si nécessaire. Cliquez ensuite sur l'onglet Colonnes dans le concepteur de disposition.
2. Reclassez les colonnes en faisant glisser et en déposant l'icône qui s'affiche à gauche de l'entrée Courriel, comme illustré ici :

   Conseil : Cliquez avec le bouton droit de la souris sur une colonne pour voir d'autres options de réapprovisionnement.

   

   Note : Les colonnes Modification, Statut et Clé sont générées automatiquement. Vous ne pouvez pas personnaliser ni supprimer ces colonnes.

3. Cliquez sur l'onglet Télécharger pour ajouter une interrogation de recherche.
4. Cliquez sur l'icône Edit en regard de Search.

   

5. Sélectionnez Salaire dans l'éditeur de champ Objets d'affaires disponibles et cliquez sur OK.
6. Dans l'éditeur de recherche, sélectionnez supérieur à dans la liste des comparateurs et laissez la valeur vide.
7. Désélectionnez Editor enabled at download (Modificateur activé au téléchargement) pour vous assurer que les contrôles de l'éditeur de recherche dans l'invite de recherche sont désactivés au téléchargement.
8. Cliquez sur OK pour enregistrer les paramètres de recherche et fermer l'éditeur de recherche.
9. Cliquez sur Télécharger les données.
10. Dans la boîte de dialogue Rechercher, entrez 10000 et cliquez sur OK.

    Le compagnon télécharge uniquement les enregistrements des employés dont le salaire dépasse 10 000.

    

Publier et distribuer le classeur Excel aux utilisateurs

Maintenant que vous avez créé le classeur Excel et que vous l'avez configuré pour télécharger des données à partir de votre service REST, vous pouvez le publier. Cette étape facultative est utile si vous voulez créer une copie de votre classeur que vous pouvez distribuer à d'autres utilisateurs pour l'entrée de données. Il vous permet également de supprimer les outils de conception (Concepteur, Supprimer la disposition et Publier) et d'activer la protection de la feuille de calcul. Cela dit, vous pouvez distribuer le classeur Excel source sans le publier.

1. Dans l'onglet Oracle Visual Builder, cliquez sur Publier.

   

2. Dans la fenêtre Publier le classeur, acceptez l'emplacement et le nom du fichier du classeur. Lorsque le nom du classeur initial se termine par -source (comme dans notre exemple, employees-source.xlsx), le compagnon offre le même nom sans -source.

   

3. Désélectionnez la case Supprimer l'hôte du service de chaque catalogue, mais laissez les autres options de publication inchangées.
4. Cliquez sur Publier. Voir Publier un classeur Excel intégré dans Développement de feuilles de calcul intégrées à l'aide du compagnon Oracle Visual Builder Add-in for Excel.

   Une confirmation est affichée dans le volet Statut.

   

5. Enregistrez et fermez le classeur Excel source que vous avez utilisé pour publier le classeur Excel.

   Désormais, vous pouvez distribuer le classeur publié à d'autres utilisateurs pour l'entrée de données. Chaque utilisateur doit avoir un nom d'utilisateur et un mot de passe qui permettent d'accéder au service REST que vous avez entré lors de la création du classeur Excel.

   L'étape suivante de ce tutoriel montre comment les utilisateurs effectuent des tâches d'entrée de données à l'aide du classeur Excel que vous venez de publier.

Créer, lire, mettre à jour et supprimer des données dans un classeur Excel publié

Les utilisateurs professionnels qui reçoivent une copie du classeur Excel que vous avez publié doivent installer le compagnon pour télécharger des données à partir du service REST. (Ils peuvent télécharger le programme d'installation directement à partir de la page Téléchargements). Une fois le compagnon installé, il peut créer, lire, mettre à jour et supprimer les données téléchargées dans le classeur avant de charger les modifications dans le service.

1. Ouvrez le classeur Excel publié à partir du répertoire dans lequel vous l'avez enregistré.

   

   La section Conception n'apparaît pas dans l'onglet Oracle Visual Builder, car vous avez désactivé les outils de conception, ce qui empêche les utilisateurs d'un classeur publié d'accéder aux commandes Concepteur, Supprimer la disposition et Publier auxquelles vous pouvez accéder en tant que développeur de classeur. Le tableau affiche les en-têtes de colonne, mais aucune donnée, car vous avez choisi d'effacer toutes les dispositions lorsque vous avez publié le classeur Excel.

2. Cliquez sur Télécharger les données pour télécharger les données que le classeur est configuré pour extraire.
3. Entrez un nom d'utilisateur et un mot de passe dans la boîte de dialogue de connexion, puis cliquez sur OK.
4. Étant donné que vous configurez une interrogation de recherche pour limiter les téléchargements de données en fonction du salaire de l'employé, vous serez invité à entrer une valeur pour l'interrogation. Laissez la valeur vide et cliquez sur OK.

   Le compagnon télécharge toutes les données sur les employés.

   

5. Effectuez les modifications suivantes :
   • À la rangée 1, remplacez Sophia par Sophie.
   • Cliquez sur la cellule G2 et sélectionnez Manager (Gestionnaire) dans la liste de valeurs pour modifier le titre d'emploi de Dave Brown.
   • Sélectionnez la ligne de John Sieve (Rangée 4) en cliquant, par exemple, sur son adresse de courriel. Dans l'onglet Oracle Visual Builder, cliquez sur Modifications de rangée de table, puis sur Marquer pour suppression.
   • Sélectionnez la rangée entière 5, cliquez avec le bouton droit de la souris et sélectionnez Insérer dans le menu contextuel. Entrez ces données pour la nouvelle rangée insérée : Courriel = jmcgahern@example.com, Prénom = John, Nom = McGahern, Date d'embauche = 2018-01-30, Titre d'emploi = Accountant, Salaire = 19,000 et Service = Accounting.

     Note : Une autre façon d'ajouter de nouvelles rangées dans la table consiste à sélectionner la rangée immédiatement sous la dernière rangée téléchargée dans la table, cliquez sur Modifications de rangée de table et sur Insérer des rangées. Le compagnon crée un nouvel enregistrement dans la table, que vous pouvez ensuite modifier.

   • Sélectionnez la ligne de Ken Ster à l'extrémité de la table (rangée 102) en sélectionnant, par exemple, son adresse e-mail. Dans l'onglet Oracle Visual Builder, cliquez sur Modifications de rangée de table, puis sur Marquer pour suppression.

     Une fois ces modifications effectuées, votre table est similaire à celle présentée dans l'image suivante. Autrement dit, un message Update, Delete ou Create s'affiche dans la colonne Modifié pour chaque rangée où vous avez effectué une modification.

     

6. Dans l'onglet Oracle Visual Builder, cliquez sur Charger les modifications.

   À l'invite d'un message indiquant que la table comporte des suppressions en attente, cliquez sur Oui pour confirmer. Une fois le chargement terminé, la table actualise la colonne Statut pour décrire la modification apportée à chaque rangée modifiée qui a été chargée.

   La nouvelle rangée que vous avez créée entraîne la création d'un nouvel enregistrement pour John McGahern dans la collection.

   Les rangées que vous avez marquées pour suppression, les enregistrements pour John Sieve et Ken Ster, ne s'affichent plus car le service REST les a supprimées de sa collection.

   

   Note : Toutes les données sont validées avant d'être chargées dans le service REST. Si vous rencontrez des erreurs, vous pouvez toujours les corriger et les charger à nouveau. Si vous avez des erreurs partielles, par exemple, si la mise à jour et la suppression des rangées ont réussi mais que la création de rangées a échoué, vous n'aurez qu'à corriger les données de la rangée créée en échec.

   Pour vérifier que les modifications apportées à votre classeur Excel ont bien été chargées, allez à l'onglet Données de la page Objets d'affaires de votre application visuelle.

   

Vous voulez en savoir plus?

• Présentation du compagnon Oracle Visual Builder Add-in for Excel dans Développement de feuilles de calcul intégrées à l'aide du compagnon Oracle Visual Builder Add-in for Excel
• Configurer les options de recherche pour le téléchargement dans Développement de feuilles de calcul intégrées à l'aide du compagnon Oracle Visual Builder Add-in for Excel
• Gestion des données à l'aide du compagnon Oracle Visual Builder pour Excel. Ce guide aide vos utilisateurs professionnels à réussir à utiliser vos classeurs intégrés.