Oracle Cloud Infrastructure-Dokumentation

Installieren und Einrichten des Add-ons für Google Sheets

Bevor Sie das Oracle Autonomous Database-Add-on für Google Sheets installieren, laden Sie die ZIP-Datei oracleGoogleAddin aus der Database Actions-Instanz herunter.

Sie können nun eine ZIP-Datei im Ordner "Downloads" Ihres Systems anzeigen. Extrahieren Sie den Inhalt der ZIP-Datei auf das System.

Um das Oracle Autonomous Database-Add-on für Google Sheets einzurichten, importieren Sie die Dateien im Ordner oracleGoogleAddin in das Google Apps-Skript.
Hinweis

Das Importieren der Dateien ist eine einmalige Aktivität, die in der Regel von einem Administrator durchgeführt wird.

Nachdem Sie die Dateien in das Google Apps-Skript importiert oder hochgeladen haben, führen Sie die folgenden Schritte aus, um das Setup des Oracle Autonomous Database-Add-ons für Google Sheets abzuschließen:

Übergeordnetes Thema: Oracle Autonomous Database für Google Sheets

oracleGoogleAddin-Dateien mit Clasp in das Google Apps-Skript hochladen

Um alle im Ordner oracleGoogleAddin vorhandenen Dateien hochzuladen, müssen Sie das Befehlszeilen-Apps-Skriptprojekt (clasp) verwenden.

Clasp ist ein Open-Source-Tool zur Entwicklung und Verwaltung der Google Apps Script-Projekte von Ihrem Terminal aus.
Hinweis

Clasp wird in Node.js geschrieben und über das Node Package Manager-(NPM-)Tool verteilt. Sie müssen Node.js Version 4.7.4 oder höher installieren, um Schließe zu verwenden.
  1. Geben Sie sheet.new in die Adressleiste des Webbrowsers ein, um Google Sheets zu öffnen. Stellen Sie sicher, dass Sie mit Ihrem Google-Konto angemeldet sind.
  2. Wählen Sie im Menü Erweiterungen die Option Apps-Skript aus. Sie können das Fenster "Apps-Skripteditor" anzeigen.
    Beschreibung von apps-script-window.png folgt
    Beschreibung der Abbildung apps-script-window.png

  3. Wählen Sie die Datei Code.gs im Fenster "Apps-Skripteditor" aus, das standardmäßig bereits vorhanden ist. Klicken Sie auf die vertikalen Punkte neben der Datei Code.gs. Wählen Sie Löschen aus, um die vorhandene Code.gs-Datei zu löschen.
  4. Nachdem Sie Node.js installiert haben, geben Sie den folgenden npm-Befehl in die Eingabeaufforderung ein, um clasp zu installieren. Sie müssen diesen Befehl in dem Verzeichnis eingeben, in dem Sie den Ordner oracleGoogleAddin heruntergeladen und extrahiert haben.
    C:\Users\username\Desktop\oracleGoogleAddin>npm install @google/clasp -g

    Um den Befehl als Administrator für UNIX- und Linux-basierte Systeme auszuführen, geben Sie den folgenden Befehl ein:

    sudo npm install @google/clasp -g

    Nach der Installation von Clasp ist der Befehl in jedem Verzeichnis auf Ihrem Computer verfügbar.

  5. Geben Sie den folgenden Befehl ein, um sich anzumelden und die Verwaltung der Apps Script-Projekte Ihres Google-Kontos zu autorisieren.
    clasp login
    Sobald dieser Befehl ausgeführt wird, startet das System den Standardbrowser und fordert Sie auf, sich bei Ihrem Google-Konto anzumelden, in dem Ihr Google Apps Script-Projekt gespeichert wird. Wählen Sie Zulassen aus, damit Schließe auf Ihr Google-Konto zugreifen kann.
    Hinweis

    Wenn Sie die Apps-Skript-API im Google Apps-Skript nicht aktiviert haben, ist der oben genannte Befehl nicht erfolgreich. Aktivieren Sie die API, indem Sie die Site https://script.google.com/home/usersettings aufrufen, die Site zulassen und die Google Apps-Skript-API aktivieren, indem Sie auf die Schaltfläche Ein klicken.
  6. Klicken Sie im vorhandenen Google Apps Script-Projekt im linken Fensterbereich auf die Projekteinstellungen. Klicken Sie auf In Zwischenablage kopieren, um die Skript-ID unter "IDs" zu kopieren.
  7. Kehren Sie zur Eingabeaufforderung zurück, und geben Sie den folgenden Befehl mit der Skript-ID ein, die Sie im vorherigen Schritt kopiert haben, wie in der folgenden Abbildung angezeigt:
    clasp clone <Script ID>
  8. Übertragen Sie alle Dateien aus Ihrem Ordner in die Google Apps-Skriptdateien, indem Sie den folgenden Befehl angeben:
    clasp push

    Dieser Befehl lädt alle Dateien des Skriptprojekts von Ihrem Computer in Google Apps Script-Dateien hoch.

  9. Gehen Sie zum neu erstellten Google-Blatt, klicken Sie auf das Menü "Erweiterungen", und wählen Sie Apps-Skript aus. Unter "Dateien" können Sie alle Dateien im Ordner oracleGoogleAddin anzeigen.
  10. Nachdem Sie die Dateien in das Google Apps-Skript importiert oder hochgeladen haben, führen Sie die folgenden Schritte aus, um die Einrichtung des Oracle Autonomous Database-Add-ons für Google Sheets abzuschließen:

Google-Skript als Web-App bereitstellen

Nachdem alle Dateien aus dem Ordner oracleGoogleAddin importiert oder in die Skriptdateien von Google Apps hochgeladen wurden, müssen Sie das Google-Skript als Webanwendung bereitstellen.

So stellen Sie das Google-Skript als Web-App bereit:
  1. Klicken Sie im Google-Blatt, das Sie bearbeiten, auf das Menü Erweiterungen, und wählen Sie Apps-Skript aus. Das Fenster wird geöffnet.
  2. Klicken Sie oben rechts auf die Schaltfläche Bereitstellen, und wählen Sie "Neues Deployment" aus. Ein neues Deployment-Fenster wird geöffnet.
  3. Klicken Sie neben Typ auswählen auf das Symbol Einstellungen, und wählen Sie Webanwendung aus.
  4. Geben Sie unter "Konfiguration" eine Beschreibung des Deployments im Feld Beschreibung an. Beispiel: Deployment von Webanwendungen.
  5. Wählen Sie unter Webanwendung in der Dropdown-Liste Ausführen als den Google-Account aus, mit dem Sie sich angemeldet haben. Optional können Sie jeden auswählen, der Zugriff auf dieses Deployment hat.
  6. Wählen Sie bereitstellen aus.
    Hinweis

    • Wenn Sie ein Fenster erhalten, in dem Sie aufgefordert werden, den Zugriff zu autorisieren, wählen Sie es aus. Dadurch werden Sie zur Seite "Google-Konten" weitergeleitet, auf der Sie Ihr Gmail-Konto auswählen müssen.
    • Klicken Sie auf Erweitert, und wählen Sie den Link Gehe zu Projekt ohne Titel (unsicher).
    • Wenn Sie den Link auswählen, wird ein neues Fenster geöffnet, in dem sichergestellt wird, dass Sie der Anwendung vertrauen. Klicken Sie auf Zulassen, um fortzufahren.

    Wenn Sie den Zugriff zu diesem Zeitpunkt autorisieren, müssen Sie die Schritte 2-4 in den Google Sheets für die Verwendung von Autonomous Database autorisieren nicht befolgen.

  7. Klicken Sie auf Fertig, um das Fenster "Neues Deployment" zu schließen.
  8. Klicken Sie oben rechts auf die Schaltfläche Bereitstellen, und wählen Sie Deployments verwalten aus.
  9. Auf der Seite "Deployments verwalten" können Sie eine Webanwendungs-URL anzeigen. Mit der Option In Zwischenablage kopieren können Sie die Webanwendungs-URL kopieren. Beispiel für die Webanwendungs-URL "https://script.google.com/macros/s/abcdefghijk/exec". Dies ist die Deployment-URL der Webanwendung.

  10. Speichern Sie diese URL, die Sie später im Feld Umleitungs-URL für Google-Blatt verwenden, wenn Sie eine Verbindungsdatei aus Database Actions herunterladen oder manuell eine Verbindung aus dem Google-Blatt in Autonomous Database erstellen.

    Details zur Auswahl von Antworttyp finden Sie unter Verbindungsdatei herunterladen.

  11. Sie können die Browserregisterkarte "Apps-Skript" schließen und zur Browserregisterkarte "Google Sheets" navigieren. Jetzt können Sie eine Verbindung zu Autonomous Database erstellen.
  12. Stellen Sie sicher, dass Sie das Arbeitsblatt speichern, nachdem Sie alle Dateien in das Apps-Skript hochgeladen haben. Klicken Sie auf die Schaltfläche Aktualisieren, nachdem Sie alle Dateien hochgeladen haben. Sie können jetzt ein neues Oracle Autonomous Database-Menü in den Google Sheets anzeigen.


    Beschreibung von ask-oracle-menu.png folgt
    Beschreibung der Abbildung ask-oracle-menu.png
    Hinweis

    Generieren Sie die Felder OAuth-Client-ID und OAuth-Client Secret, indem Sie mit der UI arbeiten.