dynamics crm アダプタ for asteria warp 製品概要説明
TRANSCRIPT
Microsoft Dynamics CRM アダプタ
製品概要- ASTERIA WARP -
アーティサン株式会社
CRM事業部 製品開発部
▣ Microsoft Dynamics CRM アダプタの概要
ASTERIA WARPは、さまざまな製品・サービス間と簡単に接続、連携することのできる国内No.1のデータ連携ミドルウェアです。技術者向けではなく、アイコンのドラッグ&ドロップとプロパティ設定でフローを作成することができます。
この『Microsoft Dynamics CRM アダプタ』により、ASTERIAからDynamics CRM に対してデータの操作が可能になります。ASTERIAの既存の豊富なアダプタを選択して組み合わせて利用することで、Dynamics CRM と外部システムとの連携は柔軟に対応できるようになり、APIによる個別開発で起きる開発期間とメンテナンス工数を削減するとともにコストの低減を可能にします。
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 2
など
Dynamics CRM アダプタ
レコードを抽出・作成・更新・削除・関連付けおよび解除
豊富なアダプタ 連携
連携
■ 連携概要図
▣ Microsoft Dynamics CRM アダプタ 提供機能
Dynamics CRM のレコード操作を提供します。取得、作成、更新、作成更新、削除、関連付け、関連付け解除、活動関係者設定
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 3
No. 機能 内容
1 DCRMRetrieveMultiple コンポーネント Dynamics CRMから条件を指定してレコードを抽出します
2 DCRMCreateMultiple コンポーネント Dynamics CRMのレコードを作成します。
3 DCRMUpdateMultiple コンポーネント Dynamics CRMのレコードを更新します。
4 DCRMUpsertMultiple コンポーネント Dynamics CRMのレコードを作成、または、更新します。
5 DCRMDeleteMultiple コンポーネント Dynamics CRMのレコードを削除します。
6 DCRMAssociateMultiple コンポーネント Dynamics CRMのレコードとレコードを関連付けます。
7 DCRMDisassociateMultiple コンポーネント Dynamics CRMのレコードの関連付けを解除します。
8 DCRMActivityPartyMultiple コンポーネント Dynamics CRMの活動レコードに関係者を設定します。
◆ DCRMRetrieveMultiple コンポーネント
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 4
プロパティ名 説明
コネクション名Dynamics CRM のHTTP接続名を選択します。(全コンポーネント共通)
クライアントIDAzure ADへのアプリケーション登録により生成されたクライアントIDを入力します。(オンライン版の全コンポーネント共通。オンプレミス版にはありません。)
エンティティ名 レコードを取得するエンティティ名を入力します。
検索条件($filter) Web APIの $filter を使った条件を入力します。
並び順($orderby) Web APIの $orderby を使ったレコードの並び順を入力します。
上位取得件数($top) Web APIの $top を使った件数を入力します。
ループを開始結果をまとめて出力するか、複数に分けて出力するかを選択します。データ量が大きい時のメモリの枯渇を防止するのに有効なプロパティです。
1度に取得する件数 「ループを開始」プロパティが「はい」の場合に有効になるプロパティです。
ストリーム
取得するフィールド名を定義します。
◆ Retrieve ビルダー
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 5
各プロパティやストリームはフローデザイナーから手入力することもできます
が、ビルダーを使ってグラフィカルに入力することも可能です。
Retrieveビルダーを使用すると、検索条件や並び順の指定書式を
知らなくても簡単に設定することができます。
また、フィールド名のスペルミスなどの予防にもなります。
以下のいずれかの操作でビルダーを起動できます。
配置しているコンポーネントをダブルクリック
配置しているコンポーネントを右クリックして表示されるメニューから
「Retrieveビルダー」をクリック
Associate と Disassociate 以外のコンポーネントには
それぞれ専用のビルダーが搭載されていますが、
起動方法は全て同じで、操作方法にも大きな違いはありません。
◆ DCRMCreateMultiple コンポーネント
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 6
プロパティ名 説明
コネクション名 全コンポーネント共通
クライアントID オンライン版の全コンポーネント共通
エンティティ名 レコードを作成するエンティティ名を入力します。
入力設定
フィールド名 設定を行うフィールド名を入力します。
固定値 入力ストリームの情報に関わらず、ここで指定した値で登録を行います。
関連エンティティ名
Lookupフィールドの関連先のエンティティ名を指定します。
指定がない場合、Dynamics CRM のエンティティのメタデータにもとづき
代表のものと関連を行います。
エラーメッセージで使用する作成に失敗した時に、そのレコードの情報として出力するフィールドかどうかを指定します。
どのフィールドにも指定がない場合、レコードの行番号が出力されます。
ストリーム
登録するフィールド名を定義します。
◆ Create ビルダー
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 7
◆ DCRMUpdate (Upsert) Multiple コンポーネント
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 8
プロパティ名 説明
コネクション名 全コンポーネント共通
クライアントID オンライン版の全コンポーネント共通
エンティティ名 レコードを更新するエンティティ名を入力します。
null更新を許可する入力ストリームの情報がnullの場合に、そのままnullで更新するかどうかを指定します。
許可しない場合は、その項目をnullに更新しません。
入力設定
フィールド名 Createビルダーと同じ
固定値
関連エンティティ名
エラーメッセージで使用する
ストリーム
更新するフィールド名を定義します。
UpdateとUpsertの設定項目は同じものになります。
◆ Update (Upsert) ビルダー
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 9
◆ DCRMDeleteMultiple コンポーネント
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 10
プロパティ名 説明
コネクション名 全コンポーネント共通
クライアントID オンライン版の全コンポーネント共通
エンティティ名 レコードを削除するエンティティ名を入力します。
ストリーム
入力ストリームのフィールド定義です。
編集することはできず、削除するレコードのGUIDで固定です。
◆ Delete ビルダー
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 11
◆ DCRMAssociate (Disassociate) Multiple コンポーネント
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 12
プロパティ名 説明
コネクション名 全コンポーネント共通
クライアントID オンライン版の全コンポーネント共通
ストリーム
入力ストリームのフィールド定義です。編集することはできず、以下で固定です。
ReferencedEntityName 関連元のエンティティ名
ReferencedGuid 上記で指定したエンティティのレコードのGUID
RelationshipName 関連名
ReferencingGuid 関連先エンティティのレコードのGUID
AssociateとDisassociateの設定項目は同じものになります。
◆ DCRMActivityPartyMultiple コンポーネント
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 13
プロパティ名 説明
コネクション名 全コンポーネント共通
クライアントID オンライン版の全コンポーネント共通
エンティティ名 活動関係者を設定するエンティティ名を入力します。
ストリーム
入力ストリームのフィールド定義です。編集することはできず、以下で固定です。
ActivityId 活動レコードのGUID
ReferencingEntityName 関連先のエンティティ名
ReferencingGuid 上記で指定したエンティティのレコードのGUID
ParticipationTypeMask 活動関係者の種類
◆ ActivityParty ビルダー
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 14
活動関係者の設定に対応しているエンティティは限られています。
ActivityPartyビルダーのエンティティ一覧には対応しているものだけが表示されるため、探す手間がかかりません。
▣ Microsoft Dynamics CRM アダプタ 対応
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 15
対応 Dynamics CRM バージョン
• Dynamics CRM Online(2016)、Dynamics CRM 2016 以降(オンプレミス可)
• ※ Web API に対応していないバージョンは対象外(Dynamics CRM 2015 以前)
対応 ASTERIA WARP バージョン➢ ASTERIA WARP 4.9 以降
対応 プラットフォーム➢ 『ASTERIA WARP』に準ずる
▣ リリース履歴
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 16
2016.03.31 Experimental Build版 リリース
2016.04.27 初回リリース
2016.06.07 オンプレミス対応版 リリース
2016.09.13 繰り返し処理対応版 リリース
➢ 最大取得件数による制限を削除しました
➢ ASTERIA既存のアダプタ仕様に合わせたため、操作が統一されました
2017.02.03 ビルダー対応版 リリース
➢ AssociateとDisassociate以外のコンポーネントにビルダーを追加しました
付録:バージョン対応表
© 2017 ARTISAN INC. – PROPRIETARY & CONFIDENTIAL 17
アダプタバージョン 1.0.0 1.1.0 1.2.0 2.0.0
ASTERIA WARP 4.9.0 〇 〇 〇 〇
ASTERIA WARP 4.9.1 〇 〇 〇 〇
ASTERIA WARP 1610 〇 〇 〇 〇
アダプタバージョン 1.0.0 1.1.0 1.2.0 2.0.0
Dynamics CRM 2016 オンライン 〇 〇 〇 〇
オンプレミス × 〇 〇 〇
Dynamics 365 オンライン 〇 〇 〇 〇
オンプレミス × 〇 〇 〇
ASTERIA WARP × Dynamics CRM アダプタ
Microsoft Dynamics CRM × Dynamics CRM アダプタ