Workiva の内蔵プレミアムコネクター以外のサードパーティアプリケーションへの接続をお考えですか？HTTP Request Connector Commands を活用して REST API とやり取りすることで実現できます。
メモ: HTTP Request とラベル付けされていますが、 HTTPS (Secure HTTP) がサポートされています (推奨)。
この Connected Learning Path では、取得したいスプレッドシートを指定できる Runtime Inputs を使用するようにチェーンを更新します。
| プライマリビジネスユースケース | サードパーティシステムとの接続 |
| プライマリ学習目標 | Workiva の HTTP リクエストコネクタコマンドを使用して、事前に構築されたコネクタを超えるサードパーティアプリケーションの REST API と対話します。ランタイム入力を使用して、使用するスプレッドシートを指定するようにチェーンを更新します。 |
| 二次学習目標 | ランタイム入力の使用 |
| 前提条件 | |
| サポートテンプレート | CLP｜HTTPリクエスト 単一のスプレッドシートの取得 |
ステップ 1: チェーンのコピーと修正
- チェーンビルダーに移動し、チェーンCLP | HTTP Request List Spreadsheets を探します。
- 垂直の楕円をクリックして、 チェーンをコピーします。
- 鉛筆アイコンをクリックして、チェーンを編集します。
- 右上のチェーン設定 をクリックし、チェーンの名前を変更します：CLP | HTTP Request Get a Single Spreadsheet.
- (オプション)説明 を入力します："このチェーンは新規 Workiva API Access Token を生成します。以下の変数値に、前へ生成した API Grant の有効な Client ID と Client Secret を入力する必要があります。チェーンが実行されると、ユーザーにスプレッドシートIDの入力を促します。 チェーンがスプレッドシートを取得します。"
- チェーンを保存します。
ステップ2：ランタイム入力
Runtime Inputs Chain Event を使用してチェーンをキックオフします。
これにより、取得したいスプレッドシートのスプレッドシートIDを指定することができます。Runtime Inputsの詳細はこちら。
- POST - Retrieve a TokenCommand を開始ノードから移動します。
- Chain Trigger Events からRuntime Inputs Chain Event を開始ノードに追加します。
- Runtime Inputs をGet - List Spreadsheets Command に結合するリンクをダブルクリックし、 リンクを削除します。
- Runtime Inputs をPOST - Retrieve a Token Command に接続します。
-
POST - Retrieve a Token Command をGET - List Spreadsheets Command に接続します。
- Runtime Inputs Chain Event をダブルクリックして構成します。
-
Add Input をクリックし、以下を構成します：
- タイプ：テキスト・フィールド テキストフィールド
- 表示名称 スプレッドシート ID - ID の検索についてはこのドキュメント を参照してください。
- 必須 このチェックボックスをマークします。
- (オプション)説明 を入力します："このコマンドにより、ユーザーは必要なランタイム入力の値を指定できます。"
- コマンドを保存します。
ステップ 3: Get コマンドの更新
ワークスペース内のすべてのスプレッドシートを一覧表示する代わりに、単一のスプレッドシートの詳細を表示するように、HTTP Request Get コマンドを更新します。
-
Get - List of Spreadsheets コマンドをダブルクリックして構成します。
- コマンドの名称：Get - Retrieve a Single Spreadsheet.
-
URLフィールド内のRuntime Inputsの変数Spreadsheet ID を使用して、取得するスプレッドシートを指定します。
これを行うには、URL フィールドをクリックし、/spreadsheets の後に "/<>" を追加し、
<Spreadsheet> をRuntime Inputs の変数に置換します：- 左側のパネルで、Trigger ドロップダウンを展開します。
- Runtime Inputs ドロップダウンを展開します。
- Spreadsheet ID 変数を選択します。
- (オプション)説明を入力 ："このコマンドは1つのスプレッドシートを返却します。詳細については、https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/ の開発者向けドキュメントを参照してください。"
- コマンドを保存します。
ステップ 4: 練習問題のテスト
チェーンが完成したので、結果をテストしよう。
- チェーンを更新します。
- Execute をクリックし、Run with Inputs をクリックします。
- Workiva Platform のスプレッドシートにナビゲートして、スプレッドシート ID を検索します。 付与ユーザーにこのスプレッドシートの権限があることを確認してください。
- Start をクリックします。
- チェーンが実行を完了すると、スプレッドシートの詳細がOutputsタブ -Get コマンドのResponse Body 内に生成されたことがわかります。
To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).
-->