Workiva接続ソリューションでは、Workivaスプレッドシートのデータを更新する方法がいくつかあります。 Wdataを使用する場合、受信接続 を作成し、Wdataクエリからスプレッドシートのデータを更新することができます。 この記事では、シートデータの書き込みとシートデータの上書きコマンドを使って、スプレッドシートのデータを更新する方法を紹介します。
共通コマンド入力
シートデータ書き込みコマンドとシートデータ上書きコマンドには、両コマンドに共通するいくつかの入力があります。
| 入力 | 目的 |
| スプレッドシート ID | ID データを書き込む Workiva スプレッドシートの ID。 |
| シートID/名称 |
データを書き込むスプレッドシート内のシートの名称またはID 。 名称は大文字と小文字を区別します 。 |
| データファイル |
シートに書き込む区切りデータを含むファイル。 CSVが最も一般的なファイル書式だが、他の区切り文字もサポートされている。 このコマンドを使用するには、JSONデータを区切り書式に変換する必要があります。 |
| 区切り記号 |
ファイルの区切り文字。 カンマ(,)が最も一般的ですが、セミコロン(;)、パイプ(|)、タブ( \t)を含むあらゆる区切り文字がサポートされています。 指定された区切り文字を含むデータを持つフィールドは、必ず二重引用符で囲むようにしてください。 例えば、カンマ区切りのファイルの場合： Workiva,"Ames, IA, USA",WK |
| 領域 (シートデータ書き込み) /開始セル (シートデータ上書き) |
データを書き込む開始セルアドレス。 有効な値についての追加情報は、以下の各コマンドのセクションでご覧になれます。 |
| 非同期を使う |
チェックすると、コマンドはシートの非同期更新を行います。 これは、チェーンが次へ進む一方で、シート更新がプラットフォーム内で実行されていることを意味する。 このオプションは大きなデータセットにお勧めしますが、その後のチェーン操作がシートの更新に依存しない場合に限ります。 |
| プラットフォームAPIを使用する |
チェックすると、コマンドはレガシーなスプレッドシートAPIではなく、プラットフォームAPIを使用して更新を実行します。 APIの中では新しいものであり、追加機能で強化され続けているため、Platform APIが推奨されます。 |
シートデータの書き込み
シートデータ書き込みコマンドは、シート内の他の領域のデータを保持したまま、シート内の特定の領域を更新する必要がある場合に最適です。 以下のテーブルは、指定された各領域書式設定のクリア動作のアウトラインである。
| 書式 | 例 | 効果 |
| シングルセルアドレス | B2 |
シート内の1つのセルを更新し、他のセルの値には影響を与えない。 この書式設定は、単一セルの値を書く場合を除き、お勧めしません。 データファイルが1つ以上のデータポイントを含む場合、この書式を使用するとコマンドは失敗する。 |
| 開始セルアドレス、終了セルまたは列なし | B2: |
開始セルのアドレスからシートを更新する。 開始セル・アドレスの左（列）及び上（行）のシート値は保存され、データ・ファイルにその行又は列のセル値が含まれていなくても、他のすべての値はクリアされる。 |
| 開始セルアドレス、終了行のない終了列 | B2:D |
開始セルのアドレスからシートを更新する。 開始セル・アドレスの左（列）及び上（行）のシート値は保存され、データ・ファイルにその行又は列のセル値が含まれていなくても、他のすべての値はクリアされる。 |
| 開始セルアドレス、終了セルアドレス | B2:D5 |
指定した範囲内のすべてのセルを置換する。 メモ: コマンドで指定された範囲が読み込み中のデータファイルより小さい（行や列が少ない）場合、コマンドは失敗します。 |
上書きシートデータ
シートデータ上書きコマンドは、シート内のブロック全体をクリアする必要がある場合に最適です。 以下のテーブルは、指定された各スターティング・セル書式設定のクリア動作のアウトラインである。
| 書式 | 例 | 効果 |
| シングルセルアドレス | B2 |
開始セルアドレスの左（列）と上（行）のシートの値は保存されます。シートの他の値はクリアされ、データファイルのデータは指定されたセルアドレスから書き込まれます。 |
| 開始セルアドレス、終了セルまたは列なし | B2: |
開始セルアドレスの左（列）と上（行）のシートの値は保存されます。シートの他の値はクリアされ、データファイルのデータは指定されたセルアドレスから書き込まれます。 |
| 開始セルアドレス、終了行のない終了列 | B2:D |
この書式はサポートされておらず、コマンド実行エラーとなります。 |
| 開始セルアドレス、終了セルアドレス | B2:D5 |
開始セルアドレスの左（列）と上（行）のシートの値は保存されます。シートの他の値はクリアされ、データファイルのデータは指定されたセルアドレスから書き込まれます。 データファイルの幅（列）と高さ（行）は関係ない。 |
試してみる
上記スタートセル/リージョン の各書式設定の結果を確認できるチェーンテンプレートとテストスプレッドシートが作成されている。 テスト中：
- このリンク (25 KB)からテスト用スプレッドシートをダウンロード (25 KB)し、それをワークスペースにインポートします。
- テストチェーンを作成するチェーンを使用して、Workiva スプレッドシートを更新する テンプレート 4.内を参照。Quick Start Guides -> Enablement & Usage Examples Templateフォルダ。
- スプレッドシート IDテンプレート変数を、チェーン変数としてマッピングすることを推奨します。
- ワークスペースでチェーンを実行する前に、スプレッドシート ID チェーン変数 を更新してください。
- Workiva チェーン接続のユーザーがfile:write スコープ を持っており、そのユーザーがインポート済みスプレッドシ ートに割り当てられていることを確認します。
- チェーンを実行し、結果をレビューする。 期待される結果は、インポート済みスプレッドシートの期待される結果 シートに概説されている。