CLP - 接続リストの更新 – サポートセンター

接続の更新を自動化することは、特に複数の接続が存在する場合に、データの一元化とWorkivaプラットフォームへの移動を合理化するために不可欠です。このConnected Learning Pathでは、スプレッドシートIDを使用して、WdataとWorkiva Platform間のコネクションのリストをリフレッシュするチェーンを作成する方法を学びます。このチェーンは、1つのスプレッドシートにコネクションのリストを生成し、それらのコネクションのIDリストを提供することで、スプレッドシート内の角接続を自動的にリフレッシュできるようにします。

プライマリビジネスユースケース	WorkivaとWdata間のデータ接続
プライマリ学習目標	チェーンを使用して接続リストを更新する方法を学ぶ
セカンダリ学習目標	グループ・イテレータのエッセンスを学ぶ
前提条件	Workiva Connectorの構成 CLP \| パラメータによる接続更新の完了関連する OAuth Grant ユーザーに対してスプレッドシートに権限を付与する。
サポートテンプレート	CLP｜接続リストの更新

ステップ1：チェーンの作成

新規チェーンを追加
- チェーンの名称：CLP｜接続リストの更新
チェーンの保存

ステップ2：ランタイム入力

ランタイム入力コマンドを使ってチェーンをスタートさせる。これにより、すべての接続を更新したいスプレッドシートを指定することができます。

Runtime Inputsチェーンイベントをチェーントリガイベント Chain Trigger Events から Start Node に追加
コマンドをダブルクリックして、ランタイム入力チェーンイベントを編集する。
- 種別: テキストフィールド
- 表示名称スプレッドシートID
- 必須チェック済み
コマンドの保存

ステップ3：接続のリストアップ

List Connectionsコマンドを使用して、スプレッドシートIDに関連する接続IDのリストを取得する。List Connectionsコマンドの出力は、スプレッドシートの各接続と、接続IDを含む接続に関する詳細からなるJSONファイルになります。

List ConnectionsコマンドをWorkiva Connectorからチェーンキャンバスに追加
ランタイム入力 コマンドをリスト接続 コマンドに接続する。
コマンドをダブルクリックして構成する。
- リンク先タイプ：スプレッドシート
- リンク先ID：Runtime InputsのSpreadsheet ID 変数を使用する。これにより、チェーン実行時に指定された値をRefresh Connectionsコマンドにプッシュすることができる。
  - リンク先IDフィールドをクリックする。
  - 左パネルで、Trigger ドロップダウンを展開する。
  - Runtime Inputs ドロップダウンを展開する。
  - スプレッドシートID 変数を選択する。
コマンドの保存

ステップ4：コマンドグループ

コマンドグループを使用し、各コネクションの反復を可能にする。グループイテレータは、スプレッドシート上の各接続を、以下のステップを経て、1つずつプッシュする。

コマンドグループ をチェーンキャンバスに追加する。
List Connections コマンドをコマンドグループのIn セクションに接続する。
コマンドをダブルクリックして構成する。
- グループの名称: 接続反復
- 反復タブにナビゲーション
  - 反復トグルを有効にし、反復フィールド
    をクリック
    - Select a Variable パネルで、下矢印をクリックしてList Connections を展開する。
    - 接続出力を選択する。
コマンドグループの保存

ステップ5：接続の更新

反復の接続IDを使用して接続を更新するには、接続の更新コマンドを使用します。

Refresh ConnectionコマンドをWorkiva Connectorからチェーンキャンバスに追加
Start セクションをグループ・イテレータからRefresh Connection コマンドに接続する。
コマンドをダブルクリックして構成する。
- 接続ID：グループ・イテレータの接続IDを使用 - 接続反復。これにより、現在の反復のIDを更新接続コマンドにプッシュすることができます。
  - 接続IDフィールドをクリックする。
  - 左のパネルで、Group Iterator ドロップダウンを展開する。
  - 接続反復ドロップダウンを展開
  - ConnectionId変数を選択
- 前へソースパラメータを使用する：チェックあり
  - これにより、ソースからに以前のパラメータ値を使用して接続を更新することができます。この場合、国パラメータを持つクエリは、フィルター値としてブラジルを使用して更新されます

ステップ9：エクササイズのテスト

チェーンが完成したので、結果をテストしてみよう。

チェーンを更新
Executeをクリックして、Run With Inputを選択
スプレッドシートIDの検索
- CLP従業員概要スプレッドシートにナビゲート
- URLで、"spreadsheet/"の後、"/sheet"の前にあるスプレッドシートIDを選択します。
  - 例えば、スプレッドシートIDは次のように太字で表示されます: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
チェーンビルダーに戻り、スプレッドシートIDをスプレッドシートIDフィールドに貼り付けます。
開始をクリック
チェーンが完了したら、スプレッドシートに戻り、両方の接続が正常に更新されたことを確認する！

反復2回でチェーン実行に成功：

接続更新に成功：

チェーンを使ってデータ収集を効率化する詳細は、Data Centralization Paths の続きをご覧ください！

サポート

コミュニティ

Workiva サポートセンター