サイト内のスクリプトは、自動化パネルのスクリプト実行アクションを使用して実行できます。これにより、ドキュメント、スプレッドシート、プレゼンテーションから手動でスクリプトを実行することができます。
注: スクリプトは現在カスタマイズWorkivaからのみ利用可能です。詳細はこちら
要件
- ワークスペースで Workiva スクリプトを有効にする必要があります。Workivaスクリプトの詳細はこちら。
- スクリプトは、ホストされている同じワークスペースでのみ実行できます。詳細はこちら。
- 自動化を作成できるのはファイルオーナーだけです。
- スクリプトの作成には、スクリプト編集者 の役割が必要です。
自動化の作成
所有するファイルから自動化を作成する：
- ホーム から、ドキュメント、プレゼンテーション、スプレッドシートを開きます。
- 画面の右端にあるパネルから、Automations を選択する。
-
+または作成をクリックして、新規自動化を追加します。
-
自動化トリガー ドロップダウンメニューから、マニュアル実行 を選択する。
-
実行の選択主体の下で、オプションで他のユーザーにこの自動化を手動実行する能力が提供されます。
-
アクションの詳細 で、スクリプトの実行 を選択する。
- スクリプトIDの下でに、スクリプトのURLの末尾にあるIDを入力します。
- スクリプトの入力を含むスプレッドシートとセクションを選択します。これはオプションである。
- 作成をクリックして終了します。
自動化の実行と管理
新規自動化が「Automations」パネルに「Active」と表示されます。ファイルのオーナーとして、ドロップダウンメニューからいくつかのアクションを実行できます：
- 実行 ：自動化のスクリプトをマニュアルで実行する。
- 編集:トリガー条件など、自動化に関する詳細を更新する。
- Disable/Activate ：自動化が実行可能かどうかを選択する。
- アクティビティを表示：自動化のアクティビティ記録を開きます。
- 削除 ：ファイルから自動化を永久に削除する。
メモ: 複製実行を防ぐため、実行 オプションは、クリックしてから 20 秒間は無効になります。
スクリプトが受け取る情報
自動化が実行されると、スクリプトが読み取る情報を環境変数として送信する：
- DOCUMENT_ID: 自動化が実行されるドキュメントのID。
- INPUT_SHEET_ID: 自動化の入力パラメータを管理するために使 用されるスプレッドシートの WURL。
- INPUT_RESOURCE_ID: 前述のスプレッドシートにおけるセクションのWURL。
- INPUT_SPREADSHEET_ID ：前述のスプレッドシートのID。
- INPUT_SPREADSHEET_SHEET_ID: 前述のスプレッドシートにおけるセクションのID。
WURLは、スプレッドシートやセクションのIDやその他の情報を含む、Workiva独自のURLです。
パラメータからIDを取得するには、以下のスクリプトを使用する：
# Welcome to Workiva Scripting import requests import json import os DOCUMENT_ID = os.getenv('DOCUMENT_ID') SPREADSHEET_ID = os.getenv('INPUT_SPREADSHEET_ID') SHEET_ID = os.getenv('INPUT_SPREADSHEET_SHEET_ID') print("RAW parameters:") print(os.environ) print("") print("Actual IDs:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) メモ: 自動化は現在、クライアント ID やシークレットなどの Workiva パブリック API クレデンシャルをスクリプトに送信しません。これらの認証情報をスクリプトに直接コード化する必要があるかもしれない。
FAQ|よくあるご質問
別のワークスペース、組織、環境（APAC、EU、US）でホストされているスクリプトを実行できますか？
Workiva の自動化機能 は、ファイルが置かれている同じワークスペース内でしかスクリプトを実行できません。ただし、Workiva Scripting コネクター またはWorkiva Scripting API を使用すると、別の場所でホストされているスクリプトを実行できます。
スクリプトAPIを使用する場合は、スクリプトAPIを呼び出し、セカンダリ・ワークスペースでスクリプトを実行することのみを目的としたスクリプトをメイン・ワークスペースで作成し、ホストする必要があります。
スクリプト実行時に実行時入力/パラメータを送信できますか？
現時点では、自動化機能では、スクリプトの実行時にスクリプトに送信される実行時入力を許可していません。
自動化からスクリプト実行に送信されるメタデータは何ですか？ ワークスペースIDは送信されていますか？
スクリプトが自動化から実行されるとき、送信される唯一のパラメータは、自動化が構成されているドキュメントのIDです。
スクリプトの実行から Workiva および Workiva 以外のシステムの認証情報にアクセスするにはどうすればよいですか？
スクリプトが自動化から実行される場合、唯一のオプションは、コード自体に認証情報をハードコードすることである。
同じスクリプトを2つ以上のファイルから同時に実行できますか？
はい、スクリプトは同じファイルからでも複数のファイルからでも同時に実行できます。