Salesforce Docs Portal

Microsoft Dynamics 365 Connector - はじめに

Microsoft Dynamics 365 Connector v2.3.1

Microsoft Dynamics 365 用 Anypoint Connector (Microsoft Dynamics 365 Connector) を使用すると、Microsoft Dynamics 365 Cloud API とのインテグレーションが可能になります。

このコネクタでは、次の操作を実行できます。

  • サーバーアクセスの承認または承認の取り消しを行う

  • エンティティを作成、更新、削除する

  • 単一エンティティの取得または複数エンティティのクエリを行う

  • エンティティの関連付けまたは関連付けの解除を行う

  • アクションを実行する

リリースノート: Microsoft Dynamics 365 Connector リリースノート​
Exchange: Microsoft Dynamics 365 Connector

対象者

  • 初心者ユーザー: Mule アプリケーションを作成するには、​「Studio 設定」​を参照してください。​「例」​トピックには、コネクタを使用するための 1 つ以上のユースケースがあります。

  • パワーユーザー: 「XML および Maven サポート」​トピックと​「例」​トピックを参照してください。

始める前に

アプリケーションを作成する前に、Microsoft Dynamics 365 の対象リソースおよび Anypoint Platform へのアクセス権を持っている必要があります。Anypoint Studio を使用して Mule アプリケーションを作成する方法を理解しておく必要もあります。

Microsoft Azure Active Directory ポータル (portal.azure.com) にログインして、アプリケーションのクライアント ID とシークレットを取得します。

開始前:

Microsoft Dynamics 365 インスタンスへのアクセス権が必要です。Azure Active Directory がアプリケーションへのアクセスを可能にする ID プロバイダーになります。

OAuth 種別

Microsoft Dynamics 365 Connector では次がサポートされます。

  • 認証とトークンアクセスを処理するサーバーへの接続による OAuth

  • OAuth のユーザー名とパスワード

入力元 (トリガー)

Microsoft Dynamics 365 for Operations 用 Anypoint Connector では、次の入力元を使用してアプリケーションを開始できます。

  • On New Object: オブジェクトが作成されたときにアプリケーションを開始する。

  • On Modified Object: オブジェクトが変更されたときにアプリケーションを開始する。

または、HTTP を使用して入力をリスンするか、スケジューラーを使用してアプリケーションを実行するタイミングを選択できます。

トリガーの必須項目

On New Object と On Modified Object には同じ必須項目名があります。

  • Entity Type (エンティティ種別)

    Microsoft Dynamics 365 インスタンスによって定義されたビジネスデータ。 account​ や ​contact​ など。

  • Connection (接続)

    OAuth 接続種別。認証とトークンアクセスを処理するサーバーに URL 経由で接続するには ​Connection​、ユーザー名とパスワードを指定して接続するには ​OAuth Username Password​ を使用できます。

接続の必須項目

  • リソース
    Microsoft Dynamics 365 インスタンスにアクセスするリソース URL。

  • Consumer Key (コンシューマーキー)
    サービスプロバイダーに登録されている OAuth コンシューマーキー。

  • Consumer Secret (コンシューマーシークレット)
    サービスプロバイダーに登録されている OAuth コンシューマーシークレット。

  • リスナー設定
    アクセストークンコールバックエンドポイントをキャッチするリスナーへの参照。

  • Callback Path (コールバックパス)
    アクセストークンコールバックエンドポイントのパス。

  • Authorize Path (認証パス)
    OAuth ダンスをトリガーするローカル HTTP エンドポイントのパス。

OAuth ユーザー名/パスワードの必須項目

  • Username (ユーザー名)
    セッションの初期化に使用するユーザー名。

  • Password (パスワード)
    プロキシに対する認証に使用するパスワード。

  • リソース
    Web API のセキュアなリソースのアプリケーション ID URI。

  • Client ID (クライアント ID)
    アプリケーションを Azure AD に登録したときに割り当てられたアプリケーション ID。この ID は Azure Portal で確認できます。

  • Client Secret (クライアントシークレット)
    アプリケーション登録ポータルでアプリケーション用に作成したアプリケーションシークレット。クライアントシークレットは信頼のおける方法でデバイスに保存できないため、ネイティブアプリケーションで使用しないでください。この情報は Web アプリケーションと Web API で必要です (クライアントシークレットをサーバー側で安全に保存できます)。

  • Token Request Endpoint (トークン要求エンドポイント)
    OAuth トークン要求サーバーの URL。

用語

アクション

データの変更など副次的な影響を可能にする操作。非確定的な動作を回避するためにさらなる構成はできません。

復号型

一連のプロパティからなるキーのない構造化型。複合型は一般に、モデルエンティティのプロパティ値、あるいは操作のパラメーターや戻り値として使用されます。

Entities (エンティティ)

エンティティ種別 (account、opportunity など) のインスタンス。

エンティティセット

エンティティのコレクション (たとえば、account は account エンティティを含むエンティティセットです)。エンティティのキーでエンティティセット内のエンティティを一意に識別します。

エンティティ種別

キーのある構造化型。エンティティ種別は、エンティティのプロパティとリレーションを定義し、1 つの継承によって他のエンティティ種別から派生させることができます。

列挙型または Enum 型

基本的な整数値を定数とするプリミティブ型。

関数

副作用を発生させず、他の検索条件操作、関数、またはアクションなどと組み合わせて使用できる操作。

一般的なユースケース

次のユースケースは、​「例」​トピックで説明されています。

  • 属性を使用して取引先を作成し、取引先を取引先責任者に関連付ける

  • 空の取引先責任者エンティティを作成する

  • 空の商談エンティティを作成する

  • 1 つのバッチ要求で同じ種別のエンティティを複数作成する

  • 種別でエンティティを削除する

  • ID に基づいてキーの関連付けを解除する

  • 種別でエンティティを取得する

  • URL 要求を使用して複数のエンティティを取得する

  • DataSense クエリ言語を使用して複数のエンティティを取得する

  • 属性を使用して取引先を更新する

  • 1 つのバッチ要求で同じ種別のエンティティを複数更新する

次のステップ

前提条件を満たし、テンプレートおよび例を試したら、​Anypoint Studio​ でアプリケーションを作成できます。

関連情報