Installer et configurer le module complémentaire pour Google Sheets

Avant d'installer l'extension Oracle Autonomous Database pour Google Sheets, téléchargez le fichier ZIP oracleGoogleAddin à partir de votre instance Database Actions.

Vous pouvez maintenant afficher un fichier zip dans le dossier Downloads de votre système. Extrayez le contenu du fichier ZIP sur votre système.

Pour configurer l'extension Oracle Autonomous Database pour Google Sheets, importez les fichiers du dossier oracleGoogleAddin dans le script Google Apps.
Remarque

L'importation des fichiers est une activité ponctuelle, généralement effectuée par un administrateur.

Après avoir importé ou téléchargé les fichiers vers le script Google Apps, procédez comme suit pour terminer la configuration de l'extension Oracle Autonomous Database pour Google Sheets :

Télécharger des fichiers oracleGoogleAddin vers le script Google Apps à l'aide du fermoir

Pour télécharger tous les fichiers présents dans le dossier oracleGoogleAddin, vous devez utiliser le projet de script Applications de ligne de commande (clasp).

Clasp est un outil open source permettant de développer et de gérer les projets Google Apps Script à partir de votre terminal.
Remarque

Le fermoir est écrit dans Node.js et distribué via l'outil Gestionnaire de packages de noeuds (NPM). Il est nécessaire d'installer Node.js version 4.7.4 ou ultérieure pour utiliser le fermoir.
  1. Saisissez sheet.new dans la barre d'adresse du navigateur Web pour ouvrir Google Sheets. Assurez-vous d'être connecté avec votre compte Google.
  2. Sélectionnez Script d'applications dans le menu Extensions. Vous pouvez afficher la fenêtre de l'éditeur de script Apps.

  3. Sélectionnez le fichier Code.gs dans la fenêtre de l'éditeur de script Apps, qui existe déjà par défaut. Cliquez sur les points verticaux à côté du fichier Code.gs. Sélectionnez Supprimer pour supprimer le fichier Code.gs existant.
  4. Après avoir installé Node.js, entrez la commande npm suivante dans l'invite de commande pour installer le fermoir. Vous devez entrer cette commande à l'emplacement où vous avez téléchargé et extrait le dossier oracleGoogleAddin.
    C:\Users\username\Desktop\oracleGoogleAddin>npm install @google/clasp -g

    Pour exécuter la commande en tant qu'administrateur pour les systèmes UNIX et Linux, entrez la commande suivante :

    sudo npm install @google/clasp -g

    Après avoir installé Clasp, la commande est disponible à partir de n'importe quel répertoire de votre ordinateur.

  5. Entrez la commande suivante pour vous connecter et autoriser la gestion des projets Apps Script de votre compte Google.
    clasp login
    Une fois cette commande exécutée, le système lance le navigateur par défaut et vous demande de vous connecter à votre compte Google où votre projet Google Apps Script sera stocké. Sélectionnez Autoriser pour que le fermoir puisse accéder à votre compte Google.
    Remarque

    Si vous n'avez pas activé l'API de script Apps dans le script Google Apps, la commande ci-dessus échouera. Activez l'API en accédant au site https://script.google.com/home/usersettings, en autorisant le site et en activant l'API de script Google Apps en sélectionnant le bouton Activé.
  6. Dans votre projet de script Google Apps existant, cliquez sur Paramètres de projet dans le volet de gauche. Cliquez sur Copier vers le clavier pour copier l'ID de script sous les ID.
  7. Revenez à l'invite de commande et saisissez la commande suivante avec l'ID de script que vous avez copié à l'étape précédente, comme indiqué dans l'image ci-dessous :
    clasp clone <Script ID>
  8. Poussez tous les fichiers de votre dossier vers les fichiers de script Google Apps en spécifiant la commande suivante :
    clasp push

    Cette commande télécharge tous les fichiers du projet de script de votre ordinateur vers les fichiers de script Google Apps.

  9. Accédez à la feuille Google nouvellement créée, cliquez sur le menu Extensions et sélectionnez Script d'applications. Sous Fichiers, vous pouvez visualiser tous les fichiers du dossier oracleGoogleAddin.
  10. Après avoir importé ou téléchargé les fichiers vers le script Google Apps, procédez comme suit pour terminer la configuration de l'extension Oracle Autonomous Database pour Google Sheets :

Déployer le script Google en tant qu'application Web

Une fois que tous les fichiers du dossier oracleGoogleAddin ont été importés ou téléchargés vers les fichiers de script Google Apps, vous devez déployer le script Google en tant qu'application Web.

Pour déployer le script Google en tant qu'application Web :
  1. Cliquez sur le menu Extensions de la feuille Google sur laquelle vous travaillez et sélectionnez Script d'applications. Ouvre la fenêtre.
  2. Cliquez sur le bouton Déployer en haut à droite et sélectionnez Nouveau déploiement. Une nouvelle fenêtre de déploiement s'ouvre.
  3. En regard de Sélectionner un type, cliquez sur l'icône Paramètres et sélectionnez Application Web.
  4. Sous Configuration, indiquez une description du déploiement dans le champ Description. Par exemple, Déploiement d'application Web.
  5. Sous Application Web, sélectionnez le compte Google que vous avez utilisé pour vous connecter dans la liste déroulante Exécuter en tant que. Vous pouvez éventuellement choisir toute personne ayant accès à ce déploiement.
  6. Sélectionnez Déployer.
    Remarque

    • Si vous recevez une fenêtre vous demandant d'autoriser l'accès, sélectionnez-la. Cela vous redirigera vers la page Comptes Google où vous devez sélectionner votre compte Gmail.
    • Cliquez sur Avancé et sélectionnez le lien Accéder au projet sans titre (non sécurisé).
    • La sélection du lien ouvre une nouvelle fenêtre pour vous assurer que vous faites confiance à l'application. Cliquez sur Autoriser pour continuer.

    Si vous autorisez l'accès à ce stade, vous n'avez pas besoin de suivre les étapes 2 à 4 dans Autorisation de Google Sheets pour utiliser Autonomous Database.

  7. Cliquez sur Terminé pour fermer la fenêtre Nouveau déploiement.
  8. Cliquez sur le bouton Déployer en haut à droite et sélectionnez Gérer les déploiements.
  9. Dans la page Manage Deployments, vous pouvez afficher l'URL d'une application Web. Utilisez Copier dans le presse-papiers pour copier l'URL de l'application Web. Par exemple, voici un exemple d'URL d'application Web "https://script.google.com/macros/s/abcdefghijk/exec". Il s'agit de l'URL de déploiement d'application Web.
  10. Enregistrez cette URL, que vous utiliserez ultérieurement dans le champ URL de redirection de feuille Google lors du téléchargement d'un fichier de connexion à partir de Database Actions ou lors de la création manuelle d'une connexion à partir de Google Sheet vers Autonomous Database.

    Pour plus d'informations sur la sélection du type de réponse, reportez-vous à Téléchargement du fichier de connexion.

  11. Vous pouvez fermer l'onglet du navigateur Apps Script et accéder à l'onglet du navigateur Google Sheets. Vous êtes maintenant prêt à créer une connexion à Autonomous Database.
  12. Veillez à enregistrer la feuille de calcul après avoir téléchargé tous les fichiers dans Apps Script. Cliquez sur le bouton Actualiser une fois que vous avez téléchargé tous les fichiers. Vous pouvez désormais afficher un nouveau menu Oracle Autonomous Database dans les feuilles de calcul Google.


    Description de l'image ask-oracle-menu.png
    Description de l'illustration ask-oracle-menu.png
    Remarque

    Générez les champs OAuth ID client et OAuth Clé secrète client à l'aide de l'interface utilisateur.