Microsoft Dynamics CRMアダプターの紹介

フォローする
 ／ 公開日
更新日

Microsoft Dynamics CRM連携アダプターについてご紹介させていただきます。
このアダプターで使えるコンポーネントは次の通りです。

CDataDynamicsCRMGet.png Microsoft Dynamics CRMへSELECT 文を発行して結果セットをストリームとして出力します。
CDataDynamicsCRMPut.png Microsoft Dynamics CRMのテーブルに対して更新を行います。
CDataDynamicsCRMSQLCall.png Microsoft Dynamics CRMへ任意のSQLの実行を行います。

今回は、アダプターをOAuth認証で使うための事前準備とコネクション作成方法についてご紹介させていただきます。
※下記のバージョンでOAuth認証に対応したアダプターを使うためにはMicrosoft Dynamics CRMアダプターの公開パッチを適用していただく必要がございます。下記以前のバージョンをご利用の方はバージョンアップしてください。

  • ASTERIA Warp 1906
  • ASTERIA Warp 1912
  • ASTERIA Warp 2012

 

■事前準備

【Azure】

下記の手順に従って、Azure側の設定を行います。

  1. https://portal.azure.comにログインします。
  2. 左側のナビゲーションペインで[Azure Active Directory] > [アプリの登録]を選択して、[新規登録]ボタンをクリックします。
    DynamicsCRM_ADNBlog_0020.png
  3. アプリケーションの登録画面で下記の通り指定します。
    ・名前：任意の名前を指定
    ・サポートされているアカウントの種類：「任意の組織ディレクトリ内のアカウント（任意のAzure AD ディレクトリ-マルチテナント）」を指定
    ・リダイレクトURI：「Web」の「http://localhost:33333」を指定
    DynamicsCRM_ADNBlog_0030.png
  4. 左側のナビゲーションペインで[APIのアクセス許可] > [アクセス許可の追加]をクリックして、[Dynamics CRM]を選択し、「委任されたアクセス許可」にある「user_impersonation」を付与します。
    DynamicsCRM_ADNBlog_0040.png
    DynamicsCRM_ADNBlog_0050.png
  5. 左側のナビゲーションペインで[証明書とシークレット] > [新しいクライアントシークレット]をクリックしてクライアントシークレットを作成し、値を取得します。
    このデータはコネクション作成時にOAuthクライアントシークレットとして設定します。
    DynamicsCRM_ADNBlog_0063.png
  6. 左側のナビゲーションペインで[概要]を選択してアプリケーション（クライアント）IDを取得します。
    このデータはコネクション作成時にOAuthクライアントIDとして設定します。
    DynamicsCRM_ADNBlog_0070.png

【ASTERIA Warpサーバー】

ASTERIA Warpサーバーでは事前にアダプターをインストールしておく必要があります。
アダプターは［FSMC］→［システム］→［アップデート］画面にてダウンロードするか、ユーザーサイトからダウンロードしてサーバーにアップロードすることで適用できます。
DynamicsCRM_ADNBlog_0080.png

アダプターのインストールについて詳しくは下記弊社のオンラインヘルプをご参考ください。


［FSMC > システム > アップデート］のオンラインヘルプ

※アダプターのインストール後設定を有効にするためにはフローサービス全体の再起動が必要となります。
※アダプターのインストール後、必要に応じて公開パッチを適用してください。

【フローデザイナー】

ASTERIA Warpサーバー側でアダプターが正常にインストールされたら、フローデザイナー側でコンポーネントを取得する必要があります。
手順は下記になります。

  1. フローデザイナーからフローサービスへ接続
  2. メニューの「ツール > コンポーネント／マッパー関数の取得」でjarファイルを取得
  3. フローデザイナーを再起動

DynamicsCRM_ADNBlog_0090.png

※今回ダウンロードするファイルはfccdatadynamicscrm-2012.0991.jarとなります。
※Micorsoft Dynamics CRMアダプターの公開パッチを適用した場合はファイル名が異なりますので、適切なファイルをダウンロードしてください。

 

■コネクションの作成

事前準備が終わりましたら、コネクションを作成します。

FSMCでコネクションを作成する手順は下記になります。

FSMC画面の［設定］→［コネクション］→［DynamicsCRM］メニューから「新規」ボタンをクリックします。コネクション作成画面が表示されますので、下記の通り項目を設定します。

DynamicsCRM_ADNBlog_0110.png

  • 接続名：コネクション名を設定します。
  • 認証スキーマ：OAuthを選択します。
  • CRMバージョン：接続するCRMバージョンを選択します。ここではCRMOnlineを設定します。
  • URL：Dynamics CRMへのURLを設定します。
  • イニシエートOAuth：GETANDREFRESHを選択します。
    現在トークンが存在しない場合にはブラウザを通じてユーザーをプロンプトすることで取得されます。
    トークンが存在する場合には必要に応じてリフレッシュされます。
  • OAuthクライアントID：Azureの事前準備で取得したアプリケーション（クライアント）IDを設定します。
  • OAuthクライアントシークレット：Azureの事前準備で取得したクライアントシークレットの値を設定します。

※フローデザイナーからもコネクションの設定が可能です。

 

■コネクションの接続テスト

Microsoft Dynamics CRM連携アダプターのコネクションが作成されたので、コネクションの接続テストを実行してみます。

以下のようにコネクション接続テスト成功画面が確認できます。

DynamicsCRM_ADNBlog_0130.png

DynamicsCRM_ADNBlog_0140.png

 

■最後に

Microsoft Dynamics CRM連携アダプターの利用するために必要な事前準備、およびコネクションの作成方法についてご紹介いたしました。コネクションの作成後接続テストが正常に行われるとDynamicsCRMGetコンポーネント、DynamicsCRMPutコンポーネント、DynamicsCRMSQLCallコンポーネントが使えます。

各コンポーネントの使い方については既存のRDB系のコンポーネントと同様です。
つまり、RDBGetコンポーネントの付属ツールである「SQLビルダー」、RDBPutコンポーネントの付属ツールである「テーブルの選択」ツールについても同様に使えます。
また、DynamicsCRMSQLCallコンポーネントを利用してストアドプロシージャを実行することができます。

  • DynamicsCRMGetコンポーネントのSQLビルダー
    DynamicsCRM_ADNBlog_0150.png
  • DynamicsCRMPutコンポーネントのテーブル選択
    DynamicsCRM_ADNBlog_0160.png
この記事は役に立ちましたか？
0人中0人がこの記事が役に立ったと言っています

他のキーワードで検索する