Workiva サポートセンター

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

注： ワークスペース所有者またはチェーン所有者のみがチェーンビルダーにアクセスすることができます。Wdata からチェーン をクリックし、チェーンビルダーを開く をクリックする。

表で開始やクエリで開始という練習で、財務レポートで使用されるようなテーブルやクエリを作成します。この演習では、クエリを実行し、その結果をスプレッドシートにエクスポートするチェーンを作成してみましょう。 

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

まだの方は、サンプルデータをダウンロードし、チェーンでクエリを使用することから、表で開始する、クエリで開始するの練習をしてください。クエリのIDをメモしてください。これは、チェーン内でクエリを識別する方法です。

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

クエリのフィルターを固定値ではなくパラメータで作成した場合は、パラメータの名称もメモしてください。例：

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

ステップ2.スプレッドシートの作成

チェーンを作成する前に、スプレッドシートを作成します。

スプレッドシートの誤用を避けるため、その名称に教育目的を明確に規定しておきます。

スプレッドシートの作成後、URLをメモします: クエリ結果のエクスポート先を特定するために使用します。 

ステップ3.チェーンの作成

いよいよチェーンを作る時間だ！最後に、クエリを実行し、最新の結果をスプレッドシートにエクスポートするコマンドを含みます。

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

コネクターの設定が完了したら、チェーンビルダー でチェーンを追加することができる：

1. Wdata で、チェーン 、チェーンビルダー をクリックする。
2. Build,Chainsをクリックし、右下のAdd,Create Chainをクリックします。
   

3. チェーンを識別するためのユニークな名称と説明を入力します。

   注： チェーンは、チェーンビルダー 、ワークスペース内の全員に表示されます。メンバーにその意図が明確に伝わるよう、名前を付けてください。リーディング・プラクティス を参照：チェーンとそのオブジェクトの命名規則 を参照。

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

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

チェーンがコマンドに必要な変数を要求して開始するようにするには、 ランタイム入力トリガ―イベントを追加します。

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

1. Trigger events play_for_work, moveRuntime inputs touch_app toStart, and clickEdit create をクリックします。
2. 基本情報 の下に、イベントを識別するための一意の名称と説明を入力する。
   

3. 変数の下に、変数を追加します：

   • クエリID
   • 任意のクエリパラメータ値
   • スプレッドシートのURL

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

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

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

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

1. Available Connectors で、Workiva を選択し、Run query をキャンバスにドラッグします。

2. Start からRun query へリンクをドラッグし、コマンドのEdit をクリックする。

   メモ： 必ずコマンドをStart にリンクし、ランタイム入力を使用できるようにしてください。

   

3. 基本情報 の下に、コマンドを識別するための一意の名称と説明を入力する。
4. コマンドプロパティ で、Workiva コネクターを選択し、コマンドを実行する。
5. クエリID については、トリガー でクエリIDの実行時入力を選択する。

6. クエリのフィルターがパラメータ値を使用する場合は、Add (+) の下のParameters をクリックし、キーと値のペアを入力します：

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

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

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

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

1. 利用可能なコネクターでWorkivaを選択し、クエリ結果をエクスポートをキャンバスにドラッグします。
2. クエリの実行 からクエリ結果のエクスポート へリンクをドラッグし、後者については編集をクリックする。
   
3. 基本情報 の下に、コマンドを識別するための一意の名称と説明を入力する。
4. コマンドプロパティで、クエリ実行と同じWorkivaコネクタークエリ実行を選択します。
5. クエリ結果ID向けに、クエリを実行の下でクエリ結果のIDを選択します。
6. スプレッドシートのURL向けに、トリガーの下でスプレッドシートのURL向けのランタイム入力を選択します。
7. [保存]をクリックします。

ステップ7. チェーンを実行

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

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

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