スプレッドシートとシートの作成テンプレートは、既存のスプレッドシート内に新規スプレッドシートまたはシートを作成します。実行前に既存のシートやスプレッドシートをチェックし、実行後に適切なIDを元のチェーンに返却します。この機能は、ワークスペース、環境、チェーンの詳細をドキュメントするシートの作成によく使われる。
要件
- 、OAuth2グラントを通じてクライアントIDとクライアントシークレットにアクセスする必要があります。
- 以下のコネクターをワークスペースに構成する必要があります:
チェーンの構築
Create Spreadsheet and Sheet テンプレートは、Templates 画面の Workiva チェーンセクションにあります。
検索方法はこうだ:
- チェーンビルダーで、テンプレート タブに移動します。
- 上部のメニューからWorkiva チェーン を選択。
- 右上のCreate Spreadsheet and Sheet を検索し、テンプレートを開く。
テンプレートが見つかったら、以下の変数とランタイム入力を使ってワークスペース用に構成する。
メモ: テンプレートからチェーンを作成する詳細な手順については、チェーンの作成と管理 の記事を参照のこと。
変数
| 変数タイプ | 変数名称 | 説明 |
| ダイナミックチェーン | dvシートID | チェーンを実行して作成されるシートのID。 |
| ダイナミックチェーン | dv-Spreadsheet-Id | チェーンを実行して作成されるスプレッドシートのID。 |
| ワークスペース | wsv-ClientID | Workiva コネクターの OAuth2 Grant から生成された ID。 |
| ワークスペース | wsv-ClientSecret | Workiva コネクターの OAuth2 Grant から生成されたシークレットトークン。 |
| ワークスペース | wsv-BaseURL-IAM |
適切なURLをこちらで検索してください。 |
| ワークスペース | wsv-BaseURL-Platform | 適切なURLをこちらで検索してください。 |
ランタイム入力
| 入力タイプ | 名称 | 説明 |
| グループ・フィールド | スプレッドシート-オプション | グループフィールドを以下のスプレッドシートで入力します。 |
| スプレッドシートオプショングループフィールド内でテキストボックスを開く | スプレッドシート名 | 作成される、またはすでに存在するスプレッドシートの名称。 |
| スプレッドシートオプショングループフィールド内でテキストボックスを開く | スプレッドシートID | すべての情報が作成されるシートを含むスプレッドシートID。 |
| グループ・フィールド | シートオプション | グループ・フィールドとシート・インプットを以下に示します。 |
| シートオプショングループフィールド内のテキストボックスを開く | シートID | データが書き込まれる、または既に存在するシートのID。 |
| シートオプショングループフィールド内のテキストボックスを開く | シート名称 | 作成されるシート、または既に存在するシートの名称。 |
| シートオプショングループフィールド内のテキストボックスを開く | シート・インデックス | 親シート、または親シートが存在しない場合はスプレッドシートに対するシートの整数インデックス。シートを兄弟の最後に配置するには、特別値-1を使用します。 |
| シートオプショングループフィールド内のテキストボックスを開く | シート親ID | 作成される、または既に存在する親シートのID。 |
ランチェーンイベントとの併用
また、Run Chainイベントを使って、他のチェーンからこのチェーンを実行することもできる。
メモ: このチェーンを実行する前に、OAuth2 Grants およびWorkspace Variables を作成する必要があります。
トラブルシューティング
チェーンがエラーを引き起こしたり、正しいデータの更新に失敗したりした場合は、以下が真であることを確認してください:
- ユーザーには、作成したスプレッドシートを表示する権限があります。
- Client ID、Secret 、Base URLs は正しい。