【ノーコード】Power Apps データフローを使ってGong のデータをDataverse に連携する方法
Power Apps はMicrosoft のローコードアプリ開発ツールです。Power Apps には、Power Apps 上で使えるデータベースライクなDataverse（旧CDS）というサービスがあるのですが、このサービスに連携するためのデータフローというデータインテグレーション機能が存在します。
Access やSharePoint リストを元に、Dataverse のエンティティ（テーブルのようなもの）を自動生成し、定期的にデータを同期させてくれるという便利な機能です！デフォルトでも30種類くらいのサービスに接続できるようになっているのですが、CData のPower BI Connectors と組み合わせればGong を含む270種類以上のデータソースに接続できます。 ここでは、汎用ODBC データプロバイダーとしてGong に接続し、Power Apps オンプレミスデータゲートウェイからGong のデータを連携利用する手順を説明します。
Gong のデータに接続するDSN を設定
まずは、右側のサイドバーからPower BI Connector for API をダウンロードします。30日間無料で全機能が利用できるので、お気軽にご利用ください。インストールが完了すると、以下のように接続設定画面が表示されるので、 DSN を設定します。 DSN 設定の詳細については、ドキュメントを参照してください。
Gong DSN の設定方法
Gong への認証では、Gong の API Key と API Secret を使った API キー認証を利用できます。
認証
Gong への認証では、Gong の API Key と API Secret、およびテナントの Domain を指定する必要があります。これらの認証情報は結合され、Base64 エンコードされて、すべての API リクエストで使われる Basic 認証ヘッダーを形成します。
API キー認証の設定
API キーで認証するには、Gong のアカウント設定から API Key と API Secret を取得します。
取得したら、AuthScheme を APIKey に設定し、認証情報を指定して接続します：
- AuthScheme：APIKey に設定します。
- APIKey：Gong の API Key に設定します。
- APISecret：Gong の API Secret に設定します。
- Domain：Gong のテナントドメインに設定します（例：us-36533.api.gong.io）。
接続文字列の例
Profile=C:\profiles\Gong.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key;APISecret=your_api_secret;Domain=your-tenant.api.gong.io';
オンプレミスデータゲートウェイで Gong コネクタを認識させる
次にオンプレミスデータゲートウェイにインストールしたGong コネクターを認識させます。もしデータゲートウェイのインストールがまだであれば、
- Power Apps の環境では、モデル駆動アプリで利用できるDataverse にデータを連携するので、Dataverse の環境を予め構成しておいてください。
- オンプレミスデータゲートウェイを立ち上げて「コネクタ」のタブに移動し、フォルダパスから「C:\Program Files\CData\CData Power BI Connector for API」を選択します。
- カスタムデータコネクタが識別されれば、設定完了です。
- Power Apps の画面から「データフロー」を選択し、「データフローを作成する」をクリックします。
- 任意の名称を入力し、「作成」をクリック
- データソース一覧の中から「ODBC」を選択します。
- 接続設定画面では、先程設定した接続情報を使うので接続文字列のところに「DSN=接続名称（今回の場合はDSN=CData PBI Gong ）」と入力します。オンプレミスデータゲートウェイからは接続先のゲートウェイが表示されるので、それを選択。現在のPower Apps データフローの仕様上ODBC 接続では認証が必須のようなので、認証の種類として「Basic」を選択し、適当な文字列を入力しておきます（この文字列は使われないので、特に気にしなくて大丈夫です）。
- 次の画面に進むと、対象のテーブル・もしくはビュー選択画面に移動します。テーブルを選択すると、プレビューが表示され、正常にコネクターとゲートウェイ経由でGong のデータが参照できていることがおわかりいただけると思います。テーブルを選択して、次へ進みます。
- クエリの編集画面では、特にカラムの変換など必要ない場合は、変更する必要はありません。そのまま次へ進んでも大丈夫です。
- 重要なエンティティマップです。ここで、Dataverse にエンティティを構成するための各種設定を実施します。今回は新しくエンティティを構成してしまうので、「新しいエンティティを読み込む」にチェックを入れます。デフォルトでは、対象フィールドのタイプが複数行テキストになってしまうので、これらを「テキスト」のタイプに変更し、最後にプライマリフィールドを選択テーブルへ設定すればOKです。
また、もしデータの差分をDataverse 側に残しておきたい場合は、「クエリ出力に存在しない行を削除します」にチェックを入れておきましょう。 - 最後にデータの更新方法を選択します。せっかくなので、自動的に更新にしてみましょう。以下のように1時間ごとに更新というように設定しておけば、1時間毎に随時登録されたデータが吸い上げられ、最新のデータがDataverse 上に登録されていきます。
- 設定後、「作成」をクリックすると、エンティティの作成と初期のデータ同期が開始されます。「完了済み」になればOKです。
- データタブの「エンティティ」を選択すると、自動的に生成されたエンティティが一覧に含まれていることがわかります。
データフローの接続を構成する
それでは Power Apps の画面に移動して、データフローを作成してみましょう。
おわりに
このように、Power Apps から簡単にGong のデータに接続して利用することができました。CData のPower BI Connector は、Gong 以外にも270種類以上のデータソースに対応しています。30日間の無償トライアルがありますので、ぜひお試しください。