Microsoft Dynamics 365 for Salesアダプターについてご紹介させていただきます。
このアダプターで使えるコンポーネントは次の通りです。
 |
D365SalesへSELECT文を発行して結果セットをストリームとして出力します。 |
 |
D365Salesのテーブルに対して更新を行います。 |
 |
任意のSQLを実行します。 |
今回は、Microsoft Dynamics 365 for Salesアダプターを使うための事前準備とコネクション作成方法について紹介したいと思います。
■事前準備
[Azure]
下記の手順に従って、Azure側の設定を行います。
- https://portal.azure.comにログインします。
- 左側のナビゲーションペインで[Azure Active Directory] > [アプリの登録]を選択して、[新しいアプリケーションの登録]ボタンをクリックします。
- [Web アプリ/API]を選択します。
- アプリ名とサインオンURL用の任意のURL を入力します。サインオンURLは本製品 や認証ステップで使用されることはないので、ホームページやhttp://localhost などの任意のURLに設定できます。
- アプリを作成したら、アプリ設定の[プロパティ]セクションで[マルチテナント]オプションを[はい]に設定します。
- 応答URLを、ユーザーがアプリケーションにアクセス許可を付与した後にアクセストークンを返すようにするURLに設定します。
- [キー]セクションで、アプリ用のキーを作成して期間を選択します。
- キーを保存したら、キーの値は一度だけ表示されます。
- [必要なアクセス許可]を選択し、[追加]をクリックします。 [APIを選択します]でDynamics CRM Online権限を選択します。
- 変更を保存します。
[ASTERIA Warpサーバー]
Microsoft Dynamics 365 for Salesアダプターを利用するためには事前にインストールしておく必要があります。
アダプターは［FSMC］→［システム］→［アップデート］画面にてダウンロードするか、ユーザーサイトからダウンロードしたアダプターをサーバーにアップロードすることで適用できます。
アダプターのインストールについて詳しくは下記弊社のオンラインヘルプをご参考ください。
［FSMC > システム > アップデート］のオンラインヘルプ
※アダプターのインストール後設定を有効にするためにはフローサービス全体の再起動が必要となります。
[フローデザイナー]
ASTERIA Warpサーバー側でアダプターが正常にインストールされたら、フローデザイナー側でコンポーネントを取得する必要があります。
手順は下記になります。
- フローデザイナーからフローサービスへ接続
- メニューの「ツール > コンポーネント／マッパー関数の取得」でjarファイルを取得
- フローデザイナーを再起動
※今回ダウンロードするファイルはfccdatad365sales-1806.0520.jarとなります。
■コネクションの作成
事前準備が終わりましたら、コネクションを作成します。
FSMCでコネクションを作成する手順は下記になります。
FSMC画面の［設定］→［コネクション］→［D365Sales］メニューから「新規」ボタンをクリックします。
コネクション作成画面が表示されますので、下記の通り項目を設定します。
- 接続名：コネクション名を設定します。
- 組織Url：Dynamics 365 組織へのURLを設定します。
例えば、https://abc123.crm7.dynamics.com/ です。 - イニシエートOAuth：GETANDREFRESHを選択します。
現在トークンが存在しない場合にはブラウザを通じてユーザーをプロンプトすることで取得されます。
トークンが存在する場合には必要に応じてリフレッシュされます。
※デザイナーからもコネクションの設定が可能です。
■コネクションの接続テスト
Microsoft Dynamics 365 for Salesアダプターのコネクションが作成されたので、コネクションの接続テストを実行してみます。
今回はOAuthトークン情報を自動で取得更新するために、「イニシエートOAuth」に「GETANDREFRESH」を設定しました。この時、最初にOAuthトークンを取得するにはWARPサーバー側でブラウザが起動され、ログイン画面が表示されます。
ログインに成功するとアプリで必要なアクセス許可をリクエストする画面が表示されますので、許可をクリックします。
許可をクリックすると認証に成功し、OAuthトークンが取得されます。
また、以下のようにコネクション接続テスト成功画面も確認できます。
■最後に
Microsoft Dynamics 365 for Salesアダプターの利用するために必要な事前準備、およびコネクションの作成方法についてご紹介いたしました。
コネクションの作成後接続テストが正常に行われるとD365SalesGetコンポーネント、D365SalesPutコンポーネント、D365SalesSQLCallコンポーネントが使えます。
各コンポーネントの使い方については既存のRDB系のコンポーネントと同様です。
つまり、RDBGetコンポーネントの付属ツールである「SQLビルダー」、RDBPutコンポーネントの付属ツールである「テーブルの選択」ツールについても同様に使えます。
また、D365SalesSQLCallコンポーネントを利用してストアドプロシージャを実行することができます。
- D365SalesGetコンポーネントのSQLビルダー
- D365SalesPutコンポーネントのテーブルの選択
