Workiva スクリプト・コネクターは、Workiva プラットフォーム内で Python スクリプトを実行する簡単な方法を提供します。これはスクリプトの完全なエクスペリエンスとは独立した関数であり、技術的なバックグラウンドを持たないユーザーでも、ソースコードを読み込むことなくスクリプトを実行することができます。
互換性のあるコマンドの完全なリストについては、Workiva スクリプトコマンド の記事を参照してください。
スクリプト機能は現在、アーリー・アダプター・プログラムの一部としてのみ利用できる。ワークスペースにスクリプトを追加することに興味がある場合は、カスタマー・サクセス・マネージャーに連絡して、プログラム参加についてご相談ください。
スクリプト要件の詳細はこちら
要件
Workiva コネクターを使用する前に:
- 組織のセキュリティ管理者は、構成画面を通じて Workiva スクリプトコネクター を有効にする必要があります。
- テスト環境でチェーンを実行するには、APIのhostsとベースパスをオーバーライドするURLが必要だ。
なぜHTTPリクエストでWorkivaスクリプトコネクターを使用する必要があるのですか?
HTTP Request コネクターには、ベアラートークンを更新し、スクリプトのステータスをポーリングするための追加ロジックが必要です。これらの要件は、Workiva スクリプト・コネクターを使用することで解消されます。
さらに、Workiva スクリプト・コネクターは、コマンド出力(標準出力や記録など)をチェーンの他の場所で使用する機能などの追加機能を提供します。
接続セットアップ
Workiva スクリプト・コネクターを設定します:
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
- コネクター 接続 で、Workiva スクリプト とデフォルト 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 を含む場合は、オーバーライドが必要です。
メモ: USリージョン情報は参照のため記載。
| フィールド | 値 |
|---|---|
| セレブレイン・ホスト・オーバーライド | 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 |
| フィールド | 値 |
|---|---|
| セレブレイン・ホスト・オーバーライド | 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 |
| フィールド | 値 |
|---|---|
| セレブレイン・ホスト・オーバーライド | 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 |