Workiva サポートセンター

Workiva コネクターを使用すると、チェーンでコマンド を使用して、他の Wdata 機能、スプレッドシート、GraphDB を含む Workiva プラットフォームと対話することができます。例えば、このコネクターを使えば、次のことができる：

• テーブル、クエリ、ビューの作成と管理
• テーブルのデータセットやインポートエラーをリストアップする。
• スプレッドシートまたはそのシートの作成と管理
• 記録とレポートの管理

要件

Workiva プラットフォームと対話するために、コネクターはWorkiva REST API を使用します。コネクターの設定には、以下のものが必要だ：

• OAuth2グラントを持つ専用のWorkiva統合ユーザー。

  メモ：この統合ユーザーには、コネクタが実行するコマンド（操作対象のスプレッドシートやワークスペースのオーナーなど）に対する適切な権限が必要です。

• 統合ユーザーのOAuth2グラントIDとシークレット。
• テスト環境でチェーンを実行するために、APIのホストとベースパスを上書きする RL。

メモ： ワークスペースの所有者は、コネクターを使用するチェーンにアクセスすることができますが、コネクター自体のコマンドを実行するには、専用の統合ユーザーが必要です。共同作業者のユーザーアカウントではなく、統合専用のユーザーを使用することで、コネクターのアクティビティを追跡し、コマンドの実行に必要なアクセスのみに制限することができます。

Workivaコネクターの設定

1. チェーンビルダーから、左側のサイドバーでcompare_arrows接続をクリックし、右上のcompare_arrows作成をクリックします。
2. 接続を作成 で、Workiva とデフォルトCloudRunnerを選択します。
   
3. 基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。

4. リソースで、この接続に関連付けるリソースを選択します。
   このセクションでは、認証や環境要件など、コネクタが機能するために必要なファイル（スクリプト、セキュリティトークン、証明書など）を安全に保管する場所を提供します。接続を保存すると、これらのファイルは自動的にAES-256で暗号化されます。詳細については、サポートページのWorkivaチェーンビルダーのセキュリティアーキテクチャを参照してください。

   利点：

   • 安全な保管：これらのファイルは保存時に暗号化され、接続レベルで保存されるため、チェーン自体にハードコーディングすべきではない機密性の高い静的な構成データに最適です。
   • 移植性：チェーンを「テスト」ワークスペースから「本番」ワークスペースに移動しても、リソースは接続設定に紐付けられたままであるため、チェーンノードのファイルパスを書き直す必要はありません。
   • アクセシビリティ：ここにファイルを保存することで、ランナーの物理ホストマシンに手動でファイルを配置しなくても、ランナー（タスクを実行するエージェント）がファイルを利用できるようになります。

   欠点：

   • 暗号化されているため、直接編集することはできません。ファイルを削除して、変更したバージョンをアップロードする必要があります。

5. [プロパティ]で、接続の詳細を入力します。
   

   プロパティ	詳細
   ID	統合ユーザーのOAuth付与IDを入力します。
   シークレット	ID プロパティのシークレットを入力する。
   脳型ホストオーバーライド	Wdataエンドポイント のURLホストとベースパスをオーバーライドするには、テスト環境のように、代わりに使用するURLを入力してください。
   スプレッドシートホストのオーバーライド	テスト環境など、the Spreadsheets endpointsのURLホストとベースパスを上書きする場合は、代わりに使用するURLを入力してください。
   IAMホストのオーバーライド	テスト環境など、Identify and Access Management (IAM) endpointsの URL ホストとベースパスをオーバーライドするには、代わりに使用する URL を入力します。
   管理者ホストのオーバーライド	管理者エンドポイント の URL ホストとベースパスをオーバーライドするには、テスト環境などで、代わりに使用する URL を入力します。
   GraphDBホストのオーバーライド	テスト環境など、GraphDBエンドポイントのURLホストとベースパスを上書きするには、代わりに使用するURLを入力します。
   プラットフォームAPIホストのオーバーライド	Workiva プラットフォームエンドポイント の URL ホストとベースパスを上書きするには、テスト環境の場合など、代わりに使用する URL を入力します。

   メモ：すべての機密性の高い認証情報は、自動的にAES-256暗号化を使用して暗号化され、保存されます。

6. 接続を使用する環境を選択して、保存をクリックします。
7. 接続をテストするには、コネクターのリストファイルコマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。

URLオーバーライド

本番環境の地域によっては、オーバーライドURLが適用される場合があります。Wdeskにログインするために使用されるURLと比較することで確認できます。URL に.apac、.ca、または.euが含まれている場合は、上書きが必要です。

メモ：USリージョン情報は参照のため記載。

トラブルシューティング

Workiva プラットフォームへの接続に失敗した場合：

• コネクタのアプリケーションOAuth認証情報が存在し、正しく、有効であることを確認します。OAuth証明書には有効期限が定められており、証明書の有効期限が切れている可能性があります。この場合、新規証明書を作成し、Connector に新規クライアントシークレットを入力する必要がある。 
• 統合ユーザーが、実行するコマンドに対して適切な権限を持っていることを確認する。
• ホストの上書きを使用している場合は、コネクタに入力された URL が正しいことを確認します。

• 操作対象のWorkivaファイル（テーブル、クエリ、スプレッドシートなど）の ID が正しいことを確認します。

  メモ：Workivaで開くと、ファイルのIDがURLに表示される。例えば、スプレッドシートのIDは、URLのspreadsheet/の後に表示される。テーブルのIDは、tables/の後に表示される。