Data Factory for Microsoft Fabric の Office 365 Outlook アクティビティを使用すると、Office 365 アカウントを使用してメールを送信できます。 動的な式を使用してメッセージをカスタマイズできます。
Prerequisites
次の内容が含まれていることを確認します。
- アクティブなサブスクリプションを持つテナント アカウント。 無料でサインアップします。
- 作成されたワークスペース。
Office 365 Outlook アクティビティをパイプラインに追加する
パイプラインで Office 365 Outlook アクティビティを使用するには、次の手順に従います。
ワークスペースに新しいパイプラインを作成します。
パイプライン の [アクティビティ] ウィンドウで "Office 365 Outlook" を検索し、それを選択してパイプライン キャンバスに追加します。 ブラウザーウィンドウの幅によっては、アクティビティリストを展開するか、ラベルのない Outlook アイコンを探す必要があります。
キャンバス上の新しい Outlook アクティビティがまだ選択されていない場合は選択します。
[ 全般 設定 ] タブを構成するには、[ 全般 設定] ガイドを参照してください。
Tip
失敗を監視するアクティビティごとに個別の Outlook アクティビティを使用します。
Outlook アクティビティに複数のアクティビティをアタッチする場合は、接続されているすべての状態を満たしてトリガーする必要があります。 たとえば、2 つのコピー アクティビティが "失敗時" にトリガーされるように Outlook アクティビティ セットに接続されている場合、両方のアクティビティが Outlook アクティビティのアクティブ化に失敗する必要があります。 失敗したのが 1 つだけの場合、Outlook アクティビティはトリガーされません。
Office 365 Outlook アクティビティを構成する
Office 365 Outlook アクティビティを設定するには:
設定の上部にある Outlook アクティビティへの接続を追加します。 新しい接続を作成することも、既存の接続を使用することもできます。
注
- ユーザー認証を使用し、Outlook または Teams アクティビティを含むパイプラインを別のワークスペースに展開している場合、新しいユーザー認証接続を作成するまで、アクティビティはターゲット ワークスペースで非アクティブになります。
- Outlook アクティビティで使用されている接続にアクセスできない場合、初期展開は失敗します。 トラブルシューティングを行うには、ターゲット パイプラインを編集して承認を変更するか、アクティビティを非アクティブに設定します。
- メールから送信されるコンテンツは、アカウントから送信されます。
受信者、件名、本文など、メールの詳細を指定します。 カスタムの "差出人" アドレス、CC と BCC の受信者、秘密度、カスタムの返信先アドレスなどの詳細を追加することもできます。 すべてのフィールドで 動的な式がサポートされます。
Office 365 Outlookアクティビティで電子メール機能を共有および再利用する
Office 365 電子メール アクティビティを使用すると、パイプラインは認証された接続を使用して通知と自動メッセージを送信できます。
共同開発シナリオでは、チームは複数のパイプラインとユーザー間で電子メール ロジックを再利用することが必要になる場合があります。 ただし、現在、電子メール接続は個々のユーザーにスコープが設定されており、作成者間で直接共有するようには設計されていません。
再利用と一貫性をサポートするために、電子メール機能を一元化するパイプライン ベースの構成パターンを採用できます。 パイプライン間で電子メール構成を複製する代わりに、 電子メールの送信を担当する専用のパイプラインを作成し、他のパイプラインから呼び出します。
再利用可能な電子メール パイプラインを作成する
すべての電子メール関連の動作をカプセル化するパイプラインを定義します。
- Office 365 電子メール アクティビティを構成する
- 必要な接続を確立する
- パイプラインを個別に検証する
このパイプラインは、電子メール配信の再利用可能なサービスとして機能します。
パイプライン接続を介して共有アクセスを有効にする
複数のユーザーがFabricの Manage Connections and Gateways ポータルを介して電子メール パイプラインを呼び出すために使用できるパイプライン接続を作成して構成します。
- メールを送信する必要がある開発者またはチームにアクセス権を付与する
- アクセス許可が組織のセキュリティ ポリシーと一致していることを確認する
他のパイプラインから電子メール パイプラインを呼び出す
ダウンストリーム パイプラインの場合:
- 呼び出しパイプライン アクティビティを追加する
- 共有接続を選択する
- 再利用可能な電子メール パイプラインを参照する
これにより、パイプラインは、独自の接続を管理せずに電子メール送信をトリガーできます。
柔軟性のためにパラメーター化する
さまざまなユース ケースをサポートするには、電子メール パイプラインで次のようなパラメーターを定義します。
- サブジェクト
- メッセージ本文
- 受取人
- 動的コンテンツ入力
実行時にパラメーターを渡すと、カスタマイズを維持しながら再利用できます。
認証のサポート
Office 365 Outlookアクティビティは以下の認証方法をサポートしています:
- ユーザー認証(OAuth)
- ワークスペース・アイデンティティ(WI)
- サービス プリンシパル (SPN)
Workspace IdentityとService Principalのサポートを活用することで、非ユーザーIDを使ってメール通知を実行できます。 このアプローチは個々のユーザーアカウントへの依存を減らし、本番環境レベルの自動化シナリオをサポートします。
Workspace IdentityやService Principal認証を使用する場合、希望するメールボックスに代わってメールを送信するために、適切なMicrosoft Entra IDおよびMicrosoft Graphの権限を設定する必要があります。 組織の要件によっては、追加のExchange Onlineメールボックス制限やガバナンスポリシーを設定する必要があるかもしれません。
WIやSPNの設定についての詳細は、 Data FactoryのWorkspace IDサポート または Data FactoryのService principal supportをご覧ください。
既知の制限事項
- Outlookのアクティビティはセンシティブラベルをサポートしていません。 活動を通じて送信されたメールにはMicrosoft Purviewのセンシティブラベルを適用できません。