はじめに
近年、企業におけるデータ活用がますます重要になっています。
その中で注目されているのが、Microsoft社が提供するクラウド型データプラットフォーム「Microsoft Dataverse」と「Sharepoint」です。
今回は、これらMicrosoftのクラウド型データプラットフォームと日々のデータをHULFT Squareを利用して、自動連携してみましょう。
例えば、HULFT Squareは、以下の業務において、更新データの受信からMicrosoftのデータ管理サービスへのデータ更新までの一連の手作業を自動化して、業務効率の向上に寄与出来ます。
1.部門担当者は、人事担当者あてに人事データの更新ファイルメール送信
2.人事担当者は、ファイルをマージしてシステム担当者にメール送信
3.システム担当者は、データベースへ登録
今回はHULFT SquareとMicrosoft Dataverseを連携させることによって業務の自動化につながる仕組みを構築していきます、
HULFT Squareとは、様々なシステムやサービスを連携してデジタル技術のポテンシャルを引き出すためのまとめ役となります。
HULFT Squareの紹介ページ
Microsoft Dataverseとは、Microsoftが提供しているDynamics 365、Power Platformのデータ保管に使用されているデータベースです
Microsoft Dataverse紹介ページ
今回やること
HULFT SquareとMicrosoft Dataverseを連携させることにより、ストレージへのファイル受信後の⇒Microsoft Dataverseにレコード追加までを自動化します。
ファイルイベントジョブでデータベース更新用のファイル受信を検知し、Dataverse更新スクリプトを実行
検証手順
Microsoft Dataverse連携用のコネクション作成
連携用コネクションを作成するには、下記の3点の作業が必要です。
(1) HULFT SquareのREST APIのコネクション設定
(2) HULFT SquareのOAuth認証用のコネクション設定
(3) MicrosoftのPower Platform管理センターの設定
今回Microsoft Dataverseへの認証はOAuth認証を使用します。
OAuth認証はID・パスワードベースとは異なるトークンベースの認証です。
認証のためにID・パスワードベースを毎回入力する必要がなく、またトークンには有効期限が設定されているためID・パスワードよりもセキュアな認証方法であると言えます。
1.HULFT SquareのREST APIのコネクション設定
まず、HULFT SquareでREST APIのコネクションを設定していきます。
［コネクション］ より、［新規追加］ をクリックします。
検索窓にRESTと入力いただき、［種類］ に表示されるREST接続を選択いただき ［次へ］ ボタンをクリックします。
任意の ［名前］、今回はREST接続_Dataverseと入力いただき、［次へ］ ボタンをクリックします。
ここでPower AppsのWebAPIエンドポイントを取得する
URLに上記で取得したPower AppsのWebAPIエンドポイントを入力する
接続テストを実行し、成功を確認後、[次へ]ボタンを押下する
任意のプロファイルを選択
内容確認後、［完了］ ボタンをクリックください。これでHULFT SquareのREST接続のコネクション設定は完了となります。
2.OAuth認証のコネクション設定（Entra ID側）
HULFT SquareからMicrosoft DataverseへOAuth認証で連携するためには、OAuth認証コネクション設定が必要になります。
OAuth認証のコネクション設定を行うにあたり、Entra ID(旧Azure AD)側に ［アプリの登録］ を行う必要があります。先に、アプリの登録を行います。
Azureのポータルサイトに接続し設定を実施していきます。
Azureポータル
［アプリの登録］ をクリックします。
［新規登録］ をクリックします。
任意の ［名前］、今回はHSQ_Microsoft Dataverse と入力いただき、
リダイレクトURL https://app.square.hulft.com/connections/oauth2/callback を入力し、［登録］ をクリックします。
HULFT SquareへのリダイレクトURLは固定となります。このまま設定してください。
数秒後、アプリが作成されます。以下の画面で認証に必要な値を取得していきます。
① ［概要］ ページで表示される ［アプリケーション (クライアント) ID］ の値を取得します。
②、③ ［エンドポイント］ タブで ［OAuth 2.0 承認エンドポイント (v2)］ 、［OAuth 2.0 トークン エンドポイント (v2)］ の値を取得します。
④ ［クライアントシークレット］ の値を取得します。
［証明書とシークレット］ ページで ［新しいクライアントシークレット］ をクリックします。
任意の ［名前］、今回はHULFT SquareからDataverseへ接続 を入力して、［追加］ をクリックします。
必ず値を控えておいて下さい、一度しか表示されません。
次にAPIのアクセス許可設定を実施していきます。
まず、「マニフェスト」よりallowPublicClientをtrueに変更して「保存」します。
「APIのアクセス許可」 より 「アクセス許可の追加」 を行います。
「所属する組織で使用しているAPI」 より 「Dataverse」 を選択します。
「委任されたアクセス許可」を選択して、オプションにチェックを付けたら「アクセス許可の追加」を選択します。
3.OAuth認証のコネクション設定（HULFT Square側）
続いてHULFT SquareでOAuth認証用のコネクションを設定していきます。
［コネクション］ より、［新規追加］ をクリックします。
検索窓にoauthと入力いただき、［種類］ に表示されるOAuth2.0認証を選択いただき ［次へ］ ボタンをクリックします。
任意の ［名前］、今回はOAuthDataverse入力いただき、［次へ］ ボタンをクリックします。
［2.OAuth認証のコネクション設定（Entra ID側）］ で取得した値を設定して、リフレッシュトークンを発行します
［スコープ］ ：Offline_accessとhttps://orgxxxxxxxx.api.xxxx.dynamics.com/user_impersonationを設定します。
※ドメインは、Power Appsの「WebAPIエンドポイント」のドメインをご指定下さい。
下記画面に遷移後、［承諾］ ボタンをクリックすると、リフレッシュトークンが発行されます。
［次へ］ ボタンをクリックします。
［完了］ ボタンをクリックします。これでOAuth認証用のコネクション設定は終了です。
Power Appsの管理センターにアクセスする
Microsoft Entra ID アプリケーションが Dataverse データにアクセスできるように、この環境内のユーザーを作成します。
https://admin.powerplatform.microsoft.com/home
対象のDataverseの環境を選択する
「ユーザーとアクセス許可」より「アプリケーションユーザー」を選択します。
「アプリの追加」よりP.5-6で作成したアプリケーションを選択して、追加を押下します。
以上で、HULFT SquareとDataverseの連携に必要な接続情報の設定は完了です。
スクリプト作成
今回は「Microsoftデータベース連携」プロジェクトを作成して、その配下にDataverse_postスクリプトを作成しています・
[HULFT Square Designer] を起動し、スクリプトを作成していきます。
[ツールパレット] より [ネットワーク＞REST＞POST実行] アイコンを選択しドラッグ＆ドロップしてスクリプトキャンバスへ配置します。
[必須設定] タブを設定します。
[接続先] 作成したREST接続_Dataverseコネクションを選択
[パス] 対象のデータベースを指定
次に [認証] タブを設定します。
[認証］ Authコネクションを利用を選択
[接続先] 作成したOAuth 2.0認証_Dataverseコネクションを選択
下記のように [start] から [END] までドラッグ＆ドロップでプロセスフローの矢印を繋ぐとデータアンロード用スクリプトの完成です。
ファイルイベントジョブ設定
Dataverse_postスクリプトを実行するファイルイベントジョブを設定します。
今回は 監視対象ディレクトリー [SE_HSQブログ用/MSEOTEST] へファイルが作成された場合、Dataverse_postスクリプトが実行されます。
検証結果確認
監視対象ディレクトリーにファイルが作成された直後、ファイルイベントジョブが起動され、Dataverseにデータ更新することが確認できました。
終わりに
いかがだったでしょうか。HULFT SquareとMicrosoft Dataverseをつないで、データベース(Dataverse)への自動更新機能を作成してみました。
当記事が、iPaaSとクラウドベースのメールサービスの連携を用いての業務改善の一助になれば幸いです。それではまた！