Avant de commencer 

Dans ce tutoriel, vous apprenez à installer le module d'extension 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 puissent effectuer des tâches de saisie de données. Ce tutoriel prend environ 10 minutes.

Contexte

Oracle Visual Builder Add-in for Excel vous aide à télécharger des données à partir d'un service REST vers une table dans 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 module d'extension installé, vous entrez le point de terminaison du service pour télécharger les données du service vers le classeur Excel. Vous verrez également un nouvel onglet de ruban Oracle Visual Builder avec des commandes pour vous aider à gérer les données téléchargées.

De quoi avez-vous besoin ?

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

  (Reportez-vous à Plateformes prises en charge dans Développement de feuilles de calcul intégrées à l'aide d'Oracle Visual Builder Add-in for Excel.)

• Accès à votre instance Oracle Visual Builder

  Remarque : vous pouvez exécuter le tutoriel à l'aide du service REST de votre choix. Assurez-vous que vous disposez des 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 cet itinéraire, certaines étapes de ce tutoriel peuvent être différentes pour votre service.

  Par exemple, vous pouvez ignorer 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 complément. Téléchargez le programme d'installation à partir de la page Téléchargements avant de commencer.

Installation d'Oracle Visual Builder Add-in for Excel

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

   Le fichier Personnel_Manager.zip contient une application visuelle avec un objet métier Employés et des exemples de données.

2. Dans votre navigateur Web, connectez-vous à Oracle Visual Builder.
3. Sur la page Applications visuelles, cliquez sur Importer, puis sélectionnez Application à partir du fichier et recherchez le fichier Personnel_Manager.zip . Conseil : par défaut, le portlet Jeu de transport - Services d'import est situé dans l'onglet Portail de l'onglet Administrer de la page Portal Builder.
4. Sur la page Applications visuelles, cliquez sur Gestionnaire de personnel dans la colonne Nom.
5. Cliquez sur Objets métier , puis sur Menu et sélectionnez Gestionnaire de données.

   

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

   A savoir : Recherchez une version plus récente sur 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 commencer l'installation, cliquez sur Suivant, puis sur Fermer une fois le module d'extension installé. Reportez-vous à Installation d'Oracle Visual Builder Add-in for Excel dans Développement de feuilles de calcul intégrées à l'aide d'Oracle Visual Builder Add-in for Excel.

   Une installation réussie active le module d'extension dans Excel et un nouvel onglet Oracle Visual Builder apparaît lorsque vous démarrez Excel.

   

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

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

1. Dans l'onglet Objets métier d'Oracle Visual Builder, cliquez sur Employés, puis sur Adresses.
2. Développez API de ressource, puis cliquez sur l'icône Presse-papiers pour copier l'URL complète de l'API de ressource 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 présentation.
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 défini sur "Default".

   Remarque : 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 utilisateur et le mot de passe que vous utilisez pour accéder à Oracle Visual Builder, puis cliquez sur Connexion.

   Le module d'extension se connecte à votre instance Oracle Visual Builder et extrait les métadonnées de 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 présentation que vous souhaitez créer : Table ou Form-over-Table.

   

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

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

    

11. Laissez cet écran vide et cliquez sur Next pour continuer.
12. Dans l'écran final, confirmez les détails de votre nouvelle présentation, puis cliquez sur Terminer.

    Un nouveau tableau apparaît dans votre classeur Excel. Les en-têtes de colonne sont affichés, avec une ligne de données d'espace réservé sous les en-têtes. Vous verrez également le concepteur de mise en page à droite.

    

    Remarque : si la cellule d'origine de la présentation se trouve dans les 10 premières lignes, la ligne d'en-tête est gelée afin que vous puissiez toujours voir les en-têtes de colonne lorsque vous faites défiler la feuille de calcul vers le haut ou vers le bas.

13. Cliquez sur Télécharger les données pour télécharger les données référencées par l'objet métier Employé.

    

Personnaliser la table dans le classeur Excel avant la publication

Vous pouvez personnaliser la table que le module d'extension crée dans le classeur Excel avant de la publier et de la distribuer aux utilisateurs pour la saisie de données. Par exemple, vous pouvez modifier l'ordre des colonnes afin que la colonne E-mail apparaisse avant le prénom de l'employé. Vous pouvez également ajouter une requête de recherche pour filtrer les données téléchargées à partir du service. Par exemple, vous pouvez ajouter le champ Salaire de l'objet fonctionnel Employés en tant que champ de recherche pour permettre aux utilisateurs de saisir 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 présentations.
2. Réorganisez les colonnes en faisant glisser et en déposant l'icône qui apparaît à gauche de l'entrée Courriel, comme illustré ici :

   A savoir : Cliquez avec le bouton droit de la souris sur une colonne pour afficher d'autres options de réorganisation.

   

   Remarque : les colonnes Modification, Statut et Clé sont générées automatiquement. Vous ne pouvez pas personnaliser ou enlever ces colonnes.

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

   

5. Sélectionnez Salaire dans l'éditeur de champ Objets fonctionnels 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 Editeur activé lors du téléchargement pour vous assurer que les contrôles de l'éditeur de recherche dans l'invite de recherche sont désactivés lors du 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 complément 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 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 souhaitez créer une copie de votre classeur que vous pouvez distribuer à d'autres utilisateurs pour la saisie de données. Il vous permet également de supprimer les outils de conception (Concepteur, Supprimer la présentation et Publier) et d'activer la protection des feuilles 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 classeur. Lorsque le nom du classeur d'origine se termine par -source (comme dans notre exemple, employees-source.xlsx), le module d'extension offre le même nom sans -source.

   

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

   Une confirmation s'affiche dans le volet Status.

   

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

   Vous pouvez désormais distribuer le classeur publié à d'autres utilisateurs pour la saisie de données. Chaque utilisateur doit disposer d'un nom d'utilisateur et d'un mot de passe permettant d'accéder au service REST que vous avez saisi lors de la création du classeur Excel.

   L'étape suivante de ce tutoriel montre comment les utilisateurs effectuent les tâches de saisie 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 module d'extension 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 module d'extension 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, empêchant ainsi les utilisateurs d'un classeur publié d'accéder aux commandes Concepteur, Supprimer la présentation et Publier auxquelles vous pouvez accéder en tant que développeur de classeur. Le tableau affiche les en-têtes de colonne, mais pas de données, car vous avez choisi d'effacer toutes les présentations 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 utilisateur et un mot de passe dans la boîte de dialogue de connexion, puis cliquez sur OK.
4. Etant donné que vous configurez une requête de recherche pour limiter les téléchargements de données en fonction du salaire de l'employé, vous êtes invité à saisir une valeur pour la requête. Laissez la valeur vide et cliquez sur OK.

   Le module d'extension télécharge toutes les données des employés.

   

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

     Remarque : Une autre façon d'ajouter de nouvelles lignes dans la table consiste à sélectionner la ligne immédiatement sous la dernière ligne téléchargée dans la table, puis à cliquer sur Modifications de ligne de table et sur Insérer des lignes. Le module d'extension crée une ligne dans la table, que vous pouvez ensuite modifier.

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

     Une fois ces modifications effectuées, votre tableau est similaire à celui illustré dans l'image suivante. En d'autres termes, un message Update, Delete ou Create apparaît dans la colonne Modifié pour chaque ligne sur laquelle vous avez effectué une modification.

     

6. Dans l'onglet Oracle Visual Builder, cliquez sur Télécharger les modifications.

   Lorsque vous êtes invité à indiquer que la table comporte des suppressions en attente, cliquez sur Oui pour confirmer. Une fois le téléchargement terminé, la table actualise la colonne Statut pour décrire la modification de chaque ligne modifiée chargée.

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

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

   

   Remarque : toutes les données sont validées avant d'être téléchargées vers le service REST. Si vous rencontrez des erreurs, vous pouvez toujours les corriger et charger à nouveau vos modifications. Si vous rencontrez des erreurs partielles, par exemple, si la mise à jour et la suppression de lignes ont réussi mais que la création de lignes a échoué, vous n'aurez qu'à corriger les données de la ligne en échec.

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

   

Pour en savoir plus ?

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