Workiva スクリプト・コネクターは、Workiva プラットフォーム内で Python スクリプトを実行する簡単な方法を提供します。これはスクリプトの完全なエクスペリエンスとは独立した関数であり、技術的なバックグラウンドを持たないユーザーでも、ソースコードを読み込むことなくスクリプトを実行することができます。
互換性のあるコマンドの完全なリストについては、Workiva スクリプトコマンド の記事を参照してください。
スクリプト機能は現在、アーリー・アダプター・プログラムの一部としてのみ利用できる。ワークスペースにスクリプトを追加することに興味がある場合は、カスタマー・サクセス・マネージャーに連絡して、プログラム参加についてご相談ください。
スクリプトに関する要件の詳細については、 をご覧ください。
要件
Workiva コネクターを使用する前に:
- 組織のセキュリティ管理者は、構成画面を通じて Workiva スクリプトコネクター を有効にする必要があります。
- テスト環境でチェーンを実行するには、APIのhostsとベースパスをオーバーライドするURLが必要だ。
なぜHTTPリクエストでWorkivaスクリプトコネクターを使用する必要があるのですか?
HTTP Request コネクターには、ベアラートークンを更新し、スクリプトのステータスをポーリングするための追加ロジックが必要です。これらの要件は、Workiva スクリプト・コネクターを使用することで解消されます。
さらに、Workiva スクリプト・コネクターは、コマンド出力(標準出力や記録など)をチェーンの他の場所で使用する機能などの追加機能を提供します。
接続セットアップ
Workiva スクリプト・コネクターを設定します:
- チェーンビルダー( )を開きます。
- 左側のナビゲーションエリアにある「」→「Connections」 をクリックし、ページの右上にある「」→「Create」 をクリックします。
- 「コネクタの接続」 において、「Workiva Scripting」 およびデフォルトのCloudRunnerを選択します。
-
基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。
-
「のプロパティ」 で、接続の詳細を入力します。
プロパティ 詳細 クライアントID 統合ユーザーのOAuth付与IDを入力します。
これはランダムに生成される。クライアントの秘密 ID プロパティの秘密を入力します。
これはランダムに生成される。スクリプトサーバーAPI (オプション)スクリプトサーバーAPIのデフォルトURLホストとベースパスに置換するURLを入力します。 IAMホストのオーバーライド (オプション)Identify and Access Management (IAM) エンドポイントのデフォルト URL ホストとベースパスを置換する URL を入力します 。 スクリプトAPIバージョン 使用するAPIのバージョンを選択します。
V1がデフォルト設定であり、ほとんどのユーザーに推奨されます。
V0は近い将来削除される。 - 接続を使用する環境を選択して、保存をクリックします。
URLオーバーライド
本番環境の地域によっては、オーバーライド URL が適用される場合があります。Wdeskにログインするために使用されるURLと比較することで確認できます。URL にEU またはAPAC を含む場合は、オーバーライドが必要です。
注: の米国リージョンの情報は、参考として記載されています。この地域にお住まいの場合は、特別な設定を行う必要はありません。
| フィールド | 値 |
|---|---|
| セレブレイン・ホスト・オーバーライド | https://h.app.wdesk.com/s/cerebral |
| スプレッドシートホストのオーバーライド | https://api.app.wdesk.com/spreadsheets/v1/ |
| IAMホストのオーバーライド | https://api.app.wdesk.com/iam/v1/oauth2/token |
| 管理者ホストのオーバーライド | https://api.app.wdesk.com/admin/v1 |
| グラフDBホストのオーバーライド | https://api.app.wdesk.com/graphdb/v1/ |
| プラットフォームAPIホストのオーバーライド | https://api.app.wdesk.com/platform/v1 |
| スクリプトサーバー API のオーバーライド | https://h.app.wdesk.com/s/scripting |
| フィールド | 値 |
|---|---|
| セレブレイン・ホスト・オーバーライド | https://h.apac.wdesk.com/s/cerebral |
| スプレッドシートホストのオーバーライド | https://api.apac.wdesk.com/spreadsheets/v1/ |
| IAMホストのオーバーライド | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| 管理者ホストのオーバーライド | https://api.apac.wdesk.com/admin/v1 |
| グラフDBホストのオーバーライド | https://api.apac.wdesk.com/graphdb/v1 |
| プラットフォームAPIホストのオーバーライド | https://api.apac.wdesk.com/platform/v1 |
| スクリプトサーバー API のオーバーライド | https://h.apac.wdesk.com/s/scripting |
| フィールド | 値 |
|---|---|
| セレブレイン・ホスト・オーバーライド | https://h.ca.wdesk.com/s/cerebral |
| スプレッドシートホストのオーバーライド | https://api.ca.wdesk.com/spreadsheets/v1/ |
| IAMホストのオーバーライド | https://api.ca.wdesk.com/iam/v1/oauth2/token |
| 管理者ホストのオーバーライド | https://api.ca.wdesk.com/admin/v1 |
| グラフDBホストのオーバーライド | https://api.ca.wdesk.com/graphdb/v1/ |
| プラットフォームAPIホストのオーバーライド | https://api.ca.wdesk.com/platform/v1 |
| スクリプトサーバー API のオーバーライド | https://h.ca.wdesk.com/s/scripting |
| フィールド | 値 |
|---|---|
| セレブレイン・ホスト・オーバーライド | https://h.eu.wdesk.com/s/cerebral |
| スプレッドシートホストのオーバーライド | https://api.eu.wdesk.com/spreadsheets/v1/ |
| IAMホストのオーバーライド | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| 管理者ホストのオーバーライド | https://api.eu.wdesk.com/admin/v1 |
| グラフDBホストのオーバーライド | https://api.eu.wdesk.com/graphdb/v1/ |
| プラットフォームAPIホストのオーバーライド | https://api.eu.wdesk.com/platform/v1 |
| スクリプトサーバー API のオーバーライド | https://h.eu.wdesk.com/s/scripting |