Workiva サポートセンター

のOneStreamとWorkivaの統合ソリューション「 」により、組織はOneStream Cloudからのデータの抽出、変換、およびWorkivaプラットフォームへの配信を自動化することができます。この統合は、のAPIを直接利用した接続（ ）をWorkiva ChainsおよびHTTPコネクタを通じて実装するか、あるいはOneStream Smart Integration Connector（SIC）を使用したのファイルベースのSFTPワークフロー（ ）を通じて実装することができます。

どちらの統合方法も、下流の連携されたレポート作成プロセスに向けて、Workivaへのデータ取り込みをサポートしています。

API連携

API接続の要件

• OneStream クラウド環境： API 統合のアプローチは、OneStream が一般に公開されているクラウド環境内でホストされている場合にのみサポートされます。
• 専用サービスアカウント： セキュリティ、監査、および運用の安定性を確保するため、OneStream内に、この統合専用となる非対話型のサービスアカウントを作成してください。
• 必要な最小限の権限： サービスアカウントには、関連するキューブビューおよび関連データにアクセスするために必要な権限のみを割り当ててください。
• パーソナルアクセストークン（PAT）： サービスアカウントの認証情報を使用してPATを生成し、生成後すぐにトークンを安全に保管してください。一度生成されると、後で取得できなくなる可能性があります。
• ネットワークおよびファイアウォールのアクセス設定： Workivaの静的IPアドレス（） が許可リストに登録されていることを確認し、OneStream APIエンドポイントへのHTTPS（ポート443）によるアウトバウンド通信を許可してください。

API連携の設定

このAPI統合では、の「GetCubeView」（ ）またはの「GetAdoDataSetForCubeViewCommand」（ ）エンドポイントを利用して、OneStreamからキューブビューのデータを取得します。

Workiva Chains では、OneStream に対する認証を行い、API リクエストを実行し、返された JSON ペイロードを変換した上で、その結果得られたデータセットを Wdata テーブルに読み込み、レポート作成や下流処理に活用することができます。

Workivaの設定手順

1. PATを安全に保管する： Chain Builder内で「」ワークスペース変数 （例：onestream_api_pat ）を作成し、その変数を「」シークレット としてマークして、値を暗号化し、権限のないユーザーによる閲覧を防止します。
2. 必要なコネクタを有効にする： Workiva 環境内で、HTTP コネクタ、JSON 変換コネクタ、および表形式変換コネクタが有効になっており、適切に構成されていることを確認してください。
3. 宛先Wdataテーブルを作成します： OneStreamからサンプルキューブビューをCSVファイルとしてエクスポートし、それをのWdataテーブルスキーマのテンプレートとして使用します 。チェーン設定内で使用するために、テーブルIDを記録しておいてください。
4. データの変換とマッピング： 必要に応じて、JSONレスポンス を表形式に変換し、OneStreamのフィールド名を対応するWorkivaのテーブルの列およびデータ型にマッピングします。
5. チェーンの自動化の設定： チェーンのトリガーメカニズムを設定して、オプションの実行タイミングを制御します。実行方法には、定義されたスケジュール に基づく実行、オンデマンド（手動実行）、のより大規模なオーケストレーションワークフロー 内のステップとしての実行、またはコントロールシート によるトリガーなどがあります。

必須のAPIパラメータ

SFTP 連携

SFTP ベースの統合では、OneStream は Smart Integration Connector を使用して、データファイル（通常は CSV 形式）を中間 SFTP 保存先にエクスポートします。その後、Workiva ChainsはのSFTPコネクタ（ ）を使用してファイルを取得し、データを処理してWdataテーブルに読み込みます。

このアプローチは、APIへの直接アクセスができない組織や、CubeViewsの作成や使用を避けたい組織で一般的に採用されています。

その他のリソース

• 管理シート
• 表形式変換/トランスフォーメーション・コネクター
• HTTPコネクタ