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

次の Dynamics 365 アプリに適用:
人的資源

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

ビジネスシナリオ

Microsoft Dynamics 365統合の一般的なビジネスシナリオの 1 つでは、定期的なスケジュールでダウンストリームシステムにデータをエクスポートする必要があります。このチュートリアルでは、Microsoft Human Resourcesからすべての worker レコードをエクスポートし、OneDrive フォルダーに worker の一覧を保存する方法について説明します。

Tip

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

使用されるテクノロジ

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

Human Resources – エクスポートするワーカーのマスターデータソース。
Azure Logic Apps – 定期的なエクスポートのオーケストレーションとスケジュールを提供するテクノロジ。
- コネクタ – ロジックアプリを必要なエンドポイントに接続するテクノロジ。
  - Microsoft Entra ID を伴う HTTP コネクタ
  - OneDrive コネクタ
DMF パッケージ REST API – エクスポートをトリガーし、その進行状況を監視するテクノロジ。
OneDrive – エクスポートされたワーカーの宛先。

Prerequisites

このチュートリアルの演習を開始する前に、次の項目があることを確認してください。

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

演習

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

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

完成したロジックアプリの概要のスクリーンショット。

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

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

$[Export Workers data]$ワーカーのエクスポート$ データプロジェクトのスクリーンショット。$

Important

データエクスポートプロジェクトの名前を記憶します。これは、次の手順でロジックアプリを作成するときに必要になります。

ステップ 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
  Note
  
  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 を呼び出します。
  - 方式： 投稿
  - 要求のUrl:https://<hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.ExportToPackage
  - B要求の本文:
```
{
    "definitionGroupId":"Export Workers",
    "packageName":"talent_package.zip",
    "executionId":"",
    "reExecute":false,
    "legalEntityId":"USMF"
}
```
Tip

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

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

ロジックアプリをテストするには、デザイナーで [実行 ] を選択します。ロジックアプリの手順の実行が開始されることがわかります。 30 秒から 40 秒後にロジックアプリの実行が完了し、OneDrive フォルダーにエクスポートされた worker を含む新しいパッケージファイルが含まれます。

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

次の図は、ロジックアプリのすべての手順が正常に実行されたときの Logic Apps デザイナーの外観を示しています。

ロジックアプリの実行が成功したスクリーンショット。

まとめ

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

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-05-20

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

ビジネス シナリオ

使用されるテクノロジ

Prerequisites

演習

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

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

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

まとめ