定期的なデータエクスポートアプリの作成

[アーティクル]
12/11/2024

次の Dynamics 365 アプリに適用:
Human Resources

この記事では、定期的なスケジュールに基 Microsoft Azure データをエクスポートする Microsoft Dynamics 365 Human Resources 作成する方法について説明します。このチュートリアルでは Human Resources の DMF パッケージ REST アプリケーションプログラミングインターフェイス (API) を利用して、データをエクスポートします。データがエクスポートされた後、ロジックアプリはエクスポートされたデータパッケージを Microsoft OneDrive for Business のフォルダーに保存します。

ビジネスシナリオ

Microsoft Dynamics 365 統合のひとつの典型的なビジネスシナリオでは、データは定期的なスケジュールで下流システムにエクスポートされる必要があります。このチュートリアルでは、すべての作業者レコードをプロジェクトからエクスポートする方法と Microsoft Dynamics 365 Human Resources 作業員の一覧を [業務] フォルダに OneDrive 保存する方法を説明します。

ヒント

このチュートリアルでエクスポートされる特定のデータと、エクスポートされたデータの宛先は単なる例です。ビジネスのニーズに合わせてそれらを簡単に変更できます。

使用されるテクノロジ

このチュートリアルでは下記のテクノロジを使用します:

Dynamics 365 Human Resources []: エクスポートされるワーカーのマスタデータソース。
Azure Logic Apps : 反復するエクスポートのオーケストレーションとスケジューリングを提供するテクノロジ。
- コネクタ : 必要なエンドポイントにロジック接続接続するために使用されるテクノロジ。
  - IDを持つHTTP Microsoft Entra 接続者指定
  - OneDrive 業務用接続者
DMFパッケージREST API : エクスポートを監視し、そのトリガー監視するために使用されるテクノロジ。
OneDrive [業務 ] : エクスポートされるワーカーの出力先。

必要条件

このチュートリアルで手順を開始する前に、次の項目が必要です:

その環境で管理者レベルの権限を持つ Human Resources 環境
ロジックアプリをホストする Azure サブスクリプション

演習

この演習の最後には、Human Resources 環境と OneDrive for Business アカウントに接続されているロジックアプリを取得できます。ロジックアプリは Human Resources からデータパッケージをエクスポートし、そのエクスポートが完了するのを待ち、エクスポートされたデータパッケージをダウンロードして、指定した OneDrive for Business フォルダーにデータパッケージを保存します。

完成したロジックアプリは、次の図のようになります。

ロジックアプリの概要。

ステップ 1: Human Resources でデータエクスポートプロジェクトを作成する

Human Resources で、作業者をエクスポートするデータエクスポートプロジェクトを作成します。プロジェクトに 作業者のエクスポート という名前を付け、データパッケージの生成 オプションがはいに設定されていることを確認します。プロジェクトに単一のエンティティ (作業者) を追加して、エクスポートする形式を選択します。 (このチュートリアルは Microsoft Excel 形式を使用します。)

作業者データプロジェクトをエクスポート。

重要

データエクスポートプロジェクトの名前を記憶します。次のステップでロジックアプリを作成するときに必要です。

ステップ 2: ロジックアプリの作成

演習の大部分はロジックアプリの作成に関するものです。

Azure ポータルで、ロジックアプリを作成します。
Logic Apps Designer で、空白のロジックアプリから始めます。
24 時間ごとに (または選択したスケジュールに従って) ロジックアプリを実行するために定期スケジュールトリガーを追加します。
ExportToPackage DMF DMF REST API を呼び出して、データパッケージのエクスポートをスケジュールします。
1. Microsoft Entra コネクタで HTTP から HTTP 要求を呼び出す アクションを使用します。
  - 基本リソースURL: 人事管理グループのURL (パス/名前空間の環境は含めない)。)
  - Microsoft Entra リソースURI:http://hr.talent.dynamics.com
  メモ
  
  Human Resources 環境では、ExportToPackage などの DMF パッケージを構成するすべての API を公開するコネクタはまだ提供されていません。代わりに、Microsoft Entra コネクタで HTTP を経由して、未加工の HTTPS 要求を使用して API を呼び出す必要があります。このコネクターは Human Resources に対する認証および承認に Microsoft Entra ID を使用します。
2. Microsoft Entra コネクタの HTTP 経由で Human Resources 環境にサインインします。
3. HTTP POST 要求をセットアップして ExportToPackage DMF REST API を呼び出します。
  - 方法 : POST
  - 要求のURL: https://<ホスト名>/名前空間/<namespace_guid>/データ/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.ExportToPackage
  - 要求の本文。
```
{
    "definitionGroupId":"Export Workers",
    "packageName":"talent_package.zip",
    "executionId":"",
    "reExecute":false,
    "legalEntityId":"USMF"
}
```
ヒント

既定の名前より意味があるように各ステップの名前を変更したい場合は、HTTP 要求を呼び出します。たとえば、このステップの名前を ExportToPackage に変更できます。
変数を初期化します ExportToPackageまたは要求の 実行ステータス 格納します。
データエクスポートの実行状態が成功になるまで待ちます。
1. ExecutionStatus 変数が成功になるまで繰り返す Until ループを追加します。
2. エクスポートの現在の実行状態のポーリング前に 5 秒間待機する遅延アクションを追加します。
  
  メモ
  
  エクスポートが完了するまで最大 75 秒 (15 イテレーション × 5 秒) 待つには、制限カウントを 15 に設定します。さらにエクスポートに時間がかかる場合は、必要に応じて制限カウントを調整してください。
3. IHTTP 要求の呼び出し アクションを追加して GetExecutionSummaryStatus DMF REST API を呼び出し、ExecutionStatus 変数を GetExecutionSummaryStatus 応答の結果に設定します。
  
  このサンプルはエラーチェックを実行しません。 GetExecutionSummaryStatus API は成功しなかった端末状態 (つまり、"成功" 以外の状態) を返す可能性があります。詳細については API のドキュメントを参照してください。
  - 方法 : POST
  - 要求のURL: https://<ホスト名>/名前空間/<namespace_guid>/データ/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExecutionSummaryStatus
  - 要求の本文: ('Invoke_an_HTTP_request')?'値']
    
    メモ
    
    コードビューまたはデザイナーの機能エディターで 要求の本文 値を入力する必要がある場合があります。
  重要
  
  デザイナーが同じ方法で値を表示するとしても、変数の設定 アクション (body('Invoke_an_HTTP_request_2')?['value']) の値は HTTP request 2 の呼び出し 本文値の値とは異なります。
エクスポートしたパッケージのダウンロード URL を取得します。
- HTTP 要求の呼び出しアクションを追加して GetExportedPackageUrl DMF REST AP を呼び出します。
  - 方法 : POST
  - 要求のURL: https://<ホスト名>/名前空間/<namespace_guid>/データ/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExportedPackageGroups
  - 要求の本文: { "executionId": body ('GetExportedPackage 2013)?'値']}
エクスポートしたパッケージのダウンロード
- 前のステップで返された URL からパッケージをダウンロードするための HTTP GET 要求 (組み込み HTTP コネクタアクション) を追加します。
  - 方法 : GET
  - URI : ('Invoke_an_HTTP_request_3').値
    
    メモ
    
    コードビューまたはデザイナーの機能エディターで URI 値を入力する必要がある場合があります。
  メモ
  
  GetExportedPackageUrl API が返す URL には、ファイルをダウンロードするアクセスを許可する共有アクセス署名トークンが含まれているため、この要求は追加の認証を必要としません。
OneDrive for Business コネクタを使用してダウンロードしたパッケージを保存する。
- OneDrive for Business のファイルの作成アクションを追加します。
- 必要に応じて OneDrive for Business アカウントを接続します。
  - フォルダのパス: 選択したAフォルダ
  - ファイル名: worker_package.zip
  - ファイルの内容 : 前の説明の本文 (手順 (動的コンテンツ)

ステップ 3: ロジックアプリのテスト

ロジックアプリをテストするには、デザイナーで実行ボタンを選択します。ロジックアプリのステップが実行を開始することを確認します。 30 から 40 秒後、ロジックアプリの実行が終了し、OneDrive for Business フォルダにエクスポートされた作業者を含む新しいパッケージファイルが含まれるはずです。

どこかのステップで失敗が報告された場合、デザイナーから失敗したステップを選択し、その入力フィールドと出力フィールドを確認します。エラーを修正するため必要に応じてステップをデバッグおよび調整します。

次の図はロジックアプリのすべてのステップが正常に実行された場合の Logic Apps Designer の外観を示しています。

成功したロジックアプリの実行。

要約

このチュートリアルではロジックアプリを使用して Human Resources からデータをエクスポートして、そのエクスポートしたデータを OneDrive for Business フォルダーに保存する方法を学びました。ビジネスのニーズに合わせて、このチュートリアルの手順を必要に応じて変更できます。

次の方法で共有

定期的なデータエクスポートアプリの作成

ビジネスシナリオ

使用されるテクノロジ

必要条件

演習

ステップ 1: Human Resources でデータエクスポートプロジェクトを作成する

ステップ 2: ロジックアプリの作成

ステップ 3: ロジックアプリのテスト

要約

フィードバック

その他のリソース

次の方法で共有

定期的なデータ エクスポート アプリの作成

ビジネス シナリオ

使用されるテクノロジ

必要条件

演習

ステップ 1: Human Resources でデータ エクスポート プロジェクトを作成する

ステップ 2: ロジック アプリの作成

ステップ 3: ロジック アプリのテスト

要約

フィードバック

その他のリソース

定期的なデータエクスポートアプリの作成

ビジネスシナリオ

ステップ 1: Human Resources でデータエクスポートプロジェクトを作成する

ステップ 2: ロジックアプリの作成

ステップ 3: ロジックアプリのテスト