チェーンで始めよう

Chains を使えば、複数の記録システムにまたがるデータの取得や送信を簡単に統合して、日常業務を自動化することができます。例えば、データソースから財務情報を自動的にテーブルに取り込み、そのデータを別のシステムにプッシュしてレポートを作成するチェーンを作成することができる。チェーンビルダー では、チェーンが実行すべきタスク（コマンド）を並べ、リンクさせる。

注: ワークスペース所有者またはチェーン所有者 のみがチェーンビルダー にアクセスできます。Wdata から、Chains をクリックし、Open Chain Builder をクリックする。

Get started with tables とGet started with queries の演習では、財務報告で使用するようなテーブルとクエリを作成します。この演習では、このクエリを実行し、その結果をスプレッドシートにエクスポートするチェーンを作成してみましょう。 

ステップ1.クエリのIDとパラメータを取得する

まだの方は、サンプルデータ をダウンロードし、Get started with tables とGet started with queries を実行してください。クエリーのIDに注意してください。これは、チェーン内でクエリーを識別する方法です。

注： Wdataでクエリを開くと、そのIDはURLの/queries/ の後に表示されます。

クエリのフィルタを静的な値ではなくパラメータで作成した場合は、パラメータの名前にも注意してください。例：

• PYまたは前年
• CYまたは現在の年
• 現在の期間

ステップ2.スプレッドシートを作成する

チェーンを作成する前に、、クエリー結果をエクスポートするためのスプレッドシート 。

表計算ソフトの誤用を避けるため、その名称に教育的意図を 明記する。

スプレッドシートを作成したら、そのURLを控えておいてください。このURLは、クエリ結果のエクスポート先を特定するために使用します。 

ステップ3.チェーンを作る

さて、いよいよチェーンを作る！最終的には、クエリを実行し、その最新の結果をスプレッドシートにエクスポートするコマンドを含むことになる。

チェーンを作成する前に、そのコマンドを実行するために使用するコア Workiva コネクタ を設定したことを確認してください。このチェーンでは1つのコネクターしか必要としないが、チェーンでは複数のコネクターを使用して、さまざまな記録システム間でデータを準備し、転送することができる。

コネクタをセットアップしたら、チェーンビルダー でチェーンを追加できます：

1. Wdata で、Chains 、Chain Builder をクリックする。
2. Build,Chains をクリックし、右下のAdd,Create Chainをクリックする。
   
3. チェーンの識別に役立つユニークな名前と説明を入力します。

   注： チェーンは、チェーンビルダー 、ワークスペース内の全員に表示されます。メンバーにその意図が明確に伝わるよう、名前を付けてください。

4. [保存]をクリックします。

ステップ4.Runtime Inputsトリガーイベントで開始する。

チェーンがコマンドに必要な変数を要求してスタートするようにするには、 Runtime Inputs trigger event を追加する。

ヒント： ランタイム入力に加え、チェーンまたはワークスペース用の変数を追加することができる 。変数を使えば、、特定のクエリやスプレッドシートだけでなく、 任意のクエリやスプレッドシートのように、チェーンの使用を拡張することができます。

1. Trigger eventsplay_for_work, moveRuntime inputstouch_app toStart, and clickEditcreate.
2. 基本情報 の下に、イベントを識別するのに役立つ一意の名前と説明を入力する。
   
3. 変数 の下に、変数を追加する：
   • クエリーID
   • 任意のクエリパラメータ値
   • スプレッドシートのURL

   ヒント 各変数について、Add Input をクリックし、TextField を選択し、名前、説明、デフォルト値を入力します。

4. [保存]をクリックします。

ステップ5.クエリを実行するコマンドを追加する

次に、Run query コマンドを追加し、チェーンが実行されるたびに最新の結果を取得するようにする。クエリのIDとパラメータ値を特定するために、実行時の入力を使用します。

1. Available BizApps の下で、Workiva を選択し、Run query をキャンバスにドラッグします。
2. Start からRun query にリンクをドラッグし、コマンドのEdit をクリックする。

   注： ランタイム入力を使用できるように、必ずコマンドをStart にリンクすること。

   
3. 基本情報 の下に、コマンドを識別するための一意の名前と説明を入力する。
4. Command properties で、Workiva コネクタを選択してコマンドを実行します。
5. クエリーID 、トリガー 、クエリーIDの実行時入力を選択する。
6. クエリのフィルタがパラメータ値を使用する場合は、Add (+) の下のParameters をクリックし、キーと値のペアを入力します：

   キー	値
   PYまたは前年	Trigger で、前年度のランタイム入力を選択する。
   CYまたは現在の年	Trigger で、現在の年のランタイム入力を選択する。
   現在の期間	Trigger で、現在の期間のランタイム入力を選択する。

7. [保存]をクリックします。

ステップ6.結果をエクスポートするコマンドを追加する

次に、クエリの結果をスプレッドシートにエクスポートするコマンドを追加します：

1. Available BizApps の下で、Workiva を選択し、Export query result をキャンバスにドラッグします。
2. Run query からExport query result へリンクをドラッグし、後者についてはEditをクリックする。
   
3. Basic info の下に、コマンドを識別するための一意の名前と説明を入力する。
4. Command properties で、Run query と同じWorkiva connector を選択する。
5. クエリ結果 ID に対して、クエリ結果 出力クエリ実行 の下にID を選択する。
6. Spreadsheet URL（スプレッドシートのURL） については、Trigger（トリガー） でスプレッドシートのURLのランタイム入力を選択する。
7. [保存]をクリックします。

ステップ7チェーンを動かす

チェーンを実行する手順は次の通りです。

1. Publish, Publish をクリックする。
2. Execute とRun with inputs をクリックする。
3. ランタイム入力の値を入力し、Start をクリックする。
4. チェーンが成功したことを確認するには、クエリー結果のスプレッドシートをチェックする。

チェインが失敗した場合は、実行履歴でコマンドをクリックし、エラーのトラブルシューティングに役立つメッセージのログを確認する。