Workiva サポートセンター

Workiva Scripting は、Workiva プラットフォーム上で Python コードを実行するための、柔軟かつ安全な環境を提供します。この記事では、スクリプトの作成中に遭遇する可能性のある、より一般的なシナリオについて説明します。

Workiva Scripting は「Customize Workiva」に含まれています。スクリプティング機能を使用するには、ワークスペースで「Workivaのカスタマイズ/スクリプティング」が有効になっている必要があり、ユーザーには適切なスクリプティングロールとファイルへのアクセス権限が必要です。

ここで取り上げられていない問題については、や、その他の Workiva スクリプティングに関する記事 をご覧いただくか、の Workiva API コミュニティおよびの Workiva スクリプティング コミュニティをご覧ください。

管理者と権限の問題

スクリプトの実行アクションが自動化に表示されない

「スクリプトの実行」アクションは、適切な「スクリプティング」ロール を割り当てられたユーザーのみが利用できます。必要なロールを割り当てるには、ワークスペース管理者に連絡してください。その役割がすでに割り当てられているにもかかわらず、そのアクションが依然として利用できない場合は、Workivaサポートまでお問い合わせください。

Workivaスクリプトコネクターはチェーンでは使用できません。

これは、Workiva スクリプト コネクタがワークスペースで有効になっていないことを示します。この機能を有効にするべきだとお考えで、まだ有効になっていない場合は、Workivaのアカウント担当チームまでご連絡ください。

ワークスペース管理者にはスクリプト役割が見えない

これは、スクリプト機能がワークスペースで有効になっていないことを示します。この機能を有効にするべきだとお考えで、まだ有効になっていない場合は、Workivaのアカウント担当チームまでご連絡ください。

Workiva スクリプトコネクターとコマンドの問題（チェーン）

コマンドの実行は開始されるが、スクリプトの実行は開始されない

ワークスペースでスクリプト機能が有効になっていることを確認します。この機能を有効にするべきだとお考えで、まだ有効になっていない場合は、Workivaのアカウント担当チームまでご連絡ください。

スクリプトが有効になっていることを確認した場合、Workiva Scripting コネクター の統合ユーザーに必要な役割が割り当てられていない可能性があります。ワークスペース管理者に連絡して、適切なスクリプト役割 を割り当ててください。統合ユーザーが、コマンドによって起動されたスクリプトにアクセスする権限を持っていることも確認する必要があります。

コマンドの実行は進行中ですが、スクリプトの実行が予期せず停止しました。

スクリプトが停止した後もチェーンコマンドの実行が継続している場合は、以下を確認してください：

• レースが中止になったかどうかを確認してください： 

  実行履歴は、スクリプトエディタのプロパティパネル、およびGET /scripts/{scriptId}/runs またはGET /scripts/{scriptId}/runs/{runId} から確認できます。APIリクエストには、スクリプトの「script:read 」スコープが必要であり、X-Version: 2026-01-01 を必ず含める必要があります。 

  API グラントの作成または更新方法については、「Workiva API の設定」 を参照してください。

  

• スクリプトがリソース制限を超過していないか確認してください：

  メモリ、CPU、ディスク、および実行時の使用状況は、スクリプトの実行ログおよびAPIから返されるスクリプト実行データに自動的に記録されます。

  詳細については、「Workiva Scripting におけるリソース制限の取り扱い」 および「Workiva Scripting の制限」 を参照してください。

• スクリプトが最大実行時間に達していないか確認してください：

  もしそうである場合は、1回の実行で処理する作業量を減らすか、作業をより小さな処理に分割してください。の「Workiva スクリプトの制限事項」を参照してください。 。

• Pythonプロセスを明示的に停止させる関数がないか確認してください：

  スクリプトが以下の関数を呼び出していないことを確認してください：

  quit() exit() sys.exit() os._exit()

  quit() 、exit() 、およびsys.exit() raiseSystemExit 。os._exit() は、通常のクリーンアップハンドラを実行せずに、プロセスを直ちに停止します。

スクリプティング API の操作に関する詳細については、『スクリプティング API ガイド』（ ）を参照してください。

コマンドとスクリプトの実行が同期しない

これは、コマンドが完了してもスクリプトの実行が移動し続けている場合、またはその逆の場合に発生します。

コマンドがスクリプトの実行よりも先に完了してしまう場合は、コマンドのタイムアウト設定（ ）が、スクリプトの実行時間よりも長くなっていることを確認してください（スクリプトの実行時間の上限については、Workivaスクリプトの制限事項 を参照してください）。

スクリプトの実行がコマンドのわずか数秒前に完了した場合、これはスクリプトの実行が完了した後にスクリプト・システムが情報をプロセスするために生じる遅延である可能性があります。コマンドが完了をレポートするのは、プロセス全体が終了してからである。

スクリプト編集者

ライブラリのインポートがうまくいかない

Workiva Scripting は、Python の標準ライブラリ をすぐにサポートするほか、Python Package Index から利用可能なコンポーネントもサポートしています（詳細は、Supported Workiva Scripting libraries and dependencies を参照）。追加インストールが必要なPyPIコンポーネントはサポートされない場合があります。

インポートしようとしているライブラリがPythonの標準ライブラリまたはPython Package Indexの一部であることを確認してください。後者のコンポーネントの場合は、追加インストールが必要ないことを確認する。