アドオンを Google Sheetsにインストールして設定する

Oracle Autonomous DatabaseのGoogleスプレッドシート用アドオンをインストールする前に、Database ActionsインスタンスからoracleGoogleAddin zipファイルをダウンロードします。

  • Database Actionsの起動パッドを開きます。
  • 「ダウンロード」タブで、「MICROSOFT EXCEL/GOOGLE SHEETS ADD-INのダウンロード」ペインを選択します。
    download-add.pngの説明が続きます

  • 「ダウンロード」画面が開き、「Microsoft Excel」タブと「Googleスプレッドシート」タブが表示されます。「Googleスプレッドシート」タブをクリックし、「アドインのダウンロード」を選択します。
    download-add-google-sheet.pngの説明が続きます

これで、システムの「ダウンロード」フォルダにzipファイルを表示できます。zipファイルの内容をシステムに抽出します。

Oracle Autonomous DatabaseのGoogle Sheets用アドオンを設定するには、oracleGoogleAddinフォルダ内のファイルをGoogle Apps Scriptにインポートします。
ノート

ファイルのインポートは1回かぎりのアクティビティであり、通常は管理者が行います。

Google Apps Scriptにファイルをインポートまたはアップロードした後、次のステップを実行します: Oracle Autonomous DatabaseのGoogleスプレッドシート用のアドオンの設定:

claspを使用したGoogle Apps ScriptへのoracleGoogleAddinのファイルのアップロード

oracleGoogleAddinフォルダにあるすべてのファイルをアップロードするには、Command Line Apps Script Project (clasp)を使用する必要があります。

Claspは、端末からGoogle Apps Scriptプロジェクトを開発および管理するためのオープンソース・ツールです。
ノート

クラスプは、Node.jsで記述され、ノード・パッケージ・マネージャ(NPM)ツールを介して配布されます。claspを使用するには、Node.jsバージョン4.7.4以降をインストールする必要があります。
  1. Webブラウザのアドレス・バーにsheet.newと入力して、Google Sheetsを開きます。必ずGoogleアカウントでログインしてください。
  2. 「拡張」メニューから「アプリケーション・スクリプト」を選択します。「アプリケーション・スクリプト」エディタ・ウィンドウを表示できます。
    apps-script-window.pngの説明が続きます

  3. Apps Scriptエディタ・ウィンドウで、デフォルトですでに存在するCode.gsファイルを選択します。Code.gsファイルの横にある縦に並んだドットをクリックします。「Delete」を選択して、既存のCode.gsファイルを削除します。
  4. Node.jsをインストールした後、コマンド・プロンプトに次のnpmコマンドを入力してclaspをインストールします。このコマンドは、oracleGoogleAddinフォルダをダウンロードして抽出した場所で入力する必要があります。
    C:\Users\username\Desktop\oracleGoogleAddin>npm install @google/clasp -g

    UNIXおよびLinuxベースのシステムの管理者としてコマンドを実行するには、次のコマンドを入力します:

    sudo npm install @google/clasp -g

    Claspをインストールすると、このコマンドはコンピュータ上のどのディレクトリからでも使用できます。

  5. 次のコマンドを入力してログインし、GoogleアカウントのApps Scriptプロジェクトの管理を認可します。
    clasp login
    このコマンドを実行すると、デフォルトのブラウザが起動し、Google Apps Scriptプロジェクトが格納されるGoogleアカウントにサインインするよう求められます。claspでGoogleアカウントにアクセスするには、「Allow」を選択します。
    ノート

    Google Apps ScriptでApps Script APIを有効にしていない場合、前述のコマンドは成功しません。サイトhttps://script.google.com/home/usersettingsにアクセスし、サイトを許可して、「On」ボタンをクリックしてGoogle Apps Script APIを有効にします。
  6. 既存のGoogle Apps Scriptプロジェクトで、左側のペインの「Project Settings」をクリックします。「ID」で、スクリプトIDをコピーするには、「コピー先クリップボード」をクリックします。
  7. コマンド・プロンプトに戻り、次のイメージに示すように、前のステップでコピーしたスクリプトIDを指定して次のコマンドを入力します:
    clasp clone <Script ID>
  8. 次のコマンドを指定して、すべてのファイルをフォルダからGoogle Apps Scriptファイルにプッシュします。
    clasp push

    このコマンドは、スクリプト・プロジェクトのすべてのファイルをコンピュータからGoogle Apps Scriptファイルにアップロードします。

  9. 新しく作成したGoogle Sheetに移動し、「拡張」メニューをクリックして「アプリケーション・スクリプト」を選択します。「Files」で、oracleGoogleAddinフォルダ内のすべてのファイルを表示できます。
  10. ファイルをGoogle Apps Scriptにインポートまたはアップロードした後、次のステップに従ってOracle Autonomous DatabaseのGoogle Sheets用アドオンの設定を完了します:

WebアプリケーションとしてのGoogleスクリプトのデプロイ

oracleGoogleAddinフォルダのすべてのファイルがGoogle Apps Scriptのファイルにインポートまたはアップロードされたら、GoogleスクリプトをWebアプリケーションとしてデプロイする必要があります。

GoogleスクリプトをWebアプリケーションとしてデプロイするには:
  1. 作業しているGoogle Sheetで「Extensions」メニューをクリックし、「Apps Script」を選択します。ウィンドウを開きます。
  2. 右上の「デプロイ」ボタンをクリックして、「新規デプロイメント」を選択します。「New deployment」ウィンドウが開きます。
  3. 「タイプの選択」の横にある「設定」アイコンをクリックし、「Webアプリケーション」を選択します。
  4. 「構成」で、「説明」フィールドにデプロイメントの説明を指定します。たとえば、Web app deploymentとします。
  5. 「Webアプリケーション」で、「次として実行」ドロップダウンから、ログインに使用したGoogleアカウントを選択します。オプションで、このデプロイメントにアクセスできるユーザーを選択できます。
  6. 「デプロイ」を選択します。
    ノート

    • アクセスの認可を求めるウィンドウが表示された場合は、それを選択します。Gmailアカウントを選択する必要があるGoogleアカウント・ページにリダイレクトされます。
    • 「詳細」をクリックし、「無題のプロジェクトに移動(安全でない)」リンクを選択します。
    • リンクを選択すると、アプリケーションを信頼することを確認します。「Allow」をクリックして続行します。

    この段階でアクセスを認可する場合、「Autonomous Databaseを使用するためのGoogle Sheetsの認可」のステップ2から4を実行する必要はありません。

  7. 「完了」をクリックして「新規デプロイメント」ウィンドウを閉じます。
  8. 右上の「デプロイ」ボタンをクリックして、「デプロイメントの管理」を選択します。
  9. 「デプロイメントの管理」ページで、WebアプリケーションURLを表示できます。WebアプリのURLをコピーするには、「クリップボードにコピー」を使用します。たとえば、WebアプリケーションURL "https://script.google.com/macros/s/AKfycbwFITvtYvGDSsrun22g7TrbrfV-bUVoWKs7OrA_3rtRAlmcGFe8bejNprZML7gFPzQ/exec"のサンプルを次に示します。これがWebアプリケーション・デプロイメントURLです。
  10. このURLを保存します。このURLは、後でデータベース・アクションから接続ファイルをダウンロードするとき、またはGoogleシートからAutonomous Databaseへの接続を手動で作成するときに、「GoogleシートのリダイレクトURL」フィールドで使用します。

    「レスポンス・タイプ」の選択の詳細は、「接続ファイルのダウンロード」を参照してください。

  11. 「Apps Script」ブラウザ・タブを閉じ、Google Sheetsブラウザ・タブにナビゲートできます。これで、Autonomous Databaseへの接続を作成する準備ができました。
  12. Apps Scriptにすべてのファイルをアップロードした後に、必ずワークシートを保存します。すべてのファイルをアップロードしたら、「Refresh」ボタンをクリックします。Google Sheetsに新しいOracle Autonomous Databaseメニューが表示されるようになりました。
    ask-oracle-menu.pngの説明が続きます

    ノート

    OAuthクライアントIDおよびOAuthクライアント・シークレットのフィールドをUIを使用して生成します。