MS Dynamics CRMの統合

Microsoft Dynamics CRMと統合して、追加のログインを必要とせずにリード、商談、およびケースの監視と管理を行います。

以下のプロセスを使用して、MS Dynamics CRM統合を有効にします。前提条件を確認し、新しいアプリケーションを登録し、キー値を取得して、権限を委任します。

追加設定不要のJiraマイクロアプリの一覧については、「MS Dynamics CRMマイクロアプリの使用」を参照してください。

必須条件の確認

専用のOffice 365アカウントを作成して、統合を構成します。このプロセスを完了すると、Citrixマイクロアプリの使用によって実行されたすべてのアクションを含む、既存のレベルの監査ログが保持されます。

MS Dynamics CRMでこの統合をセットアップした後、Citrix Workspaceマイクロアプリに統合を追加するには、以下のアーティファクトが必要になります:

  • 認証サインオンURL
  • アプリケーション(クライアント)ID
  • 秘密キーの値
  • 有効なMS Dynamics CRMアカウントの詳細

以下の前提条件を満たしていることを確認します:

  • Workspaceをホストする内部サーバーがファイアウォールの内側にある場合、ポート443でホスト名www.dynamics.comへのアクセスを許可して、WorkspaceがMS Dynamics CRMクラウドに接続できるようにします。

  • 認証サインオンURL(Citrix提供)。Citrix GatewayがMS Dynamicsのシングルサインオンに対応するように構成して、ユーザーがログインすると、再度資格情報を入力しなくても自動的に再ログインできるようにします。SSOの構成について詳しくは、「Citrix Gatewayサービス」を参照してください。

  • MS Dynamics CRM統合の構成に使用する専用のOffice 365アカウント。この専用アカウントには、MS Dynamics CRMの完全なデータアクセス特権(システム管理者)が必要です。詳しくは、「Dynamics 365 for Customer Engagementアプリでのユーザーの作成とセキュリティロールの割り当て」を参照してください。

アプリケーションおよびコールバックURLの登録

新しいアプリケーションを登録し、コールバックURLを追加してアプリケーションIDを収集します。

  1. https://portal.azure.comにログインします。
  2. [Azure Active Directory]>[アプリの登録]>[+ 新しいアプリケーション] と選択します。
  3. アプリケーションに使用する名前を入力し、組織のニーズに応じてサポートされているアカウントの種類を選択します。このオプションのガイドのため、[選択に関する詳細…]を選択します。
  4. インスタンス構成にカスタムURLを追加して、プライベートデータへのアクセスを許可し、OAuth認証済みユーザーアクションを有効にします。[リダイレクトURI(オプション)][Web] を選択し、次の2つのコールバックURLとMS DynamicsのインスタンスのベースURLを入力してください。これは、統合を設定する際にマイクロアプリUIで入力する必要があるURLと同じURLです:
    • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.dynamics.DynamicsCrmService/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
    • ベースURLは、この統合に使用するWebアドレスの一貫した部分です。例: https://app.{yoursaasapp}.com
  5. アプリケーションID(クライアント) をコピーして、統合をCitrix Workspaceマイクロアプリに追加するときに使用します。同様にアプリケーションID URIもコピーして、必要な際に後で使用するために保存しておきます。

委任権限の有効化

委任権限がある場合、アプリは権限を委任されると、ターゲットリソースへの呼び出しを行うときにサインインユーザーとして機能します。

  1. 登録したアプリのビューから、[APIのアクセス許可][+アクセス許可の追加] を選択します。
  2. Dynamics CRMのタイルを選択し、[アプリケーションに必要なアクセス許可の種類][委任されたアクセス許可] タイルを選択します。
  3. 追加する権限のチェックボックスを選択し、下部の [アクセス許可の追加] を追加します。

秘密キーの値の生成

トークンを要求する際、アプリケーションがその身元を証明するために使用するシークレット文字列を生成します。

  1. [証明書とシークレット] を選択して、[+ 新しいクライアントシークレット] を選択します。
  2. クライアントシークレットの説明を入力します。
  3. [有効期限][無期限] を選択します。[追加] を選択します。
  4. 作成されたクライアントシークレットのをコピーして保存します。このページを離れると、表示されなくなります。

Citrix Workspaceマイクロアプリへの統合の追加

MS Dynamics CRM統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順を実行します:

  1. 概要ページから、[はじめに]を選択します。

    [統合の管理]ページが開きます。

  2. [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  3. 追加するMS Dynamics CRMタイルを選択します。
  4. 統合の名前を入力します。

    MS Dynamics CRMのコネクタのパラメーター、URL、アプリケーションID、キー、OAuth認証

  5. 前の手順で収集したコネクタのパラメーターを入力します。
    • [URL] を入力します。
    • [アプリケーションID][キー] を入力します。
    • OAuthマイクロアプリのアクションが必要な場合は、[アクションでユーザーOAuth認証を使用する]をトグルします。
    • [MS Dynamics CRMアカウントでログインする] を選択して、OAuth認証を有効にします。サインインページが新しいタブで開きます。アカウント名の入力、アクセスの確認、パスワードの入力を求められます。
  6. [追加] を選択します。

[マイクロアプリ統合] ページが開き、追加した統合とそのマイクロアプリが表示されています。ここから別の統合を追加したり、追加設定不要のマイクロアプリのセットアップを続行したり、この統合用の新しいマイクロアプリを作成したりできます。

これで、最初のデータ同期を設定して実行する準備ができました。統合アプリケーションからマイクロアプリプラットフォームに大量のデータをプルできるので、[テーブル] ページを使用して、最初のデータ同期のエンティティをフィルタリングし、同期を高速化することをお勧めします。

詳しくは、「統合の構成」で「必要なエンティティの確認」および「データ同期の設定」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「MS Dynamicsコネクタの仕様」を参照してください。

MS Dynamics CRMマイクロアプリの使用

既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。

MS Dynamics CRMマイクロアプリ

MS Dynamics CRM統合には、以下の設定済みで追加設定不要のマイクロアプリが付属しています:

取引先: 取引先を検索、表示、編集します。

通知またはページ ユースケースワークフロー
取引先割り当て(既存)通知 取引先の所有者が変更されると、新しい所有者は通知を受け取ります。
取引先割り当て(新規)通知 新しい取引先がユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者一覧や取引先責任者の詳細へのリンクなど取引先の詳細を提供します。
取引先責任者の詳細ページ 取引先責任者の詳細を提供します。
取引先の編集ページ 取引先の詳細を更新するためのフォームを提供します。
私の取引先ページ 検索機能や詳細へのリンクなどユーザーの取引先のテーブルビューを提供します。

予定: 予定を検索、表示、編集します。

通知またはページ ユースケースワークフロー
割り当てられた予定(既存)通知 予定の所有者が変更されると、新しい所有者は通知を受け取ります。
割り当てられた予定(新規)通知 新しい予定がユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者一覧や取引先責任者の詳細へのリンクなど取引先の詳細を提供します。
予定の詳細ページ 予定の詳細を提供します。
ケースの詳細ページ サポート案件の詳細を提供します。
取引先責任者の詳細ページ 取引先責任者の詳細を提供します。
予定の編集ページ 予定の詳細を更新するためのフォームを提供します。
リードの詳細ページ リードの詳細を提供します。
自分のオープンしている予定ページ 検索機能や詳細へのリンクなどユーザーの予定のテーブルビューを提供します。
商談の詳細ページ 商談の詳細を提供します。

サポート案件: サポート案件を検索、表示、編集します。

通知またはページ ユースケースワークフロー
ケース割り当て(既存)通知 ケースの所有者が変更されると、新しい所有者は通知を受け取ります。
ケース割り当て(新規)通知 新しいケースがユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者一覧や取引先責任者の詳細へのリンクなど取引先の詳細を提供します。
ケースの詳細ページ サポート案件の詳細を提供します。
サポート案件の解決ページ サポート案件を解決するためのフォームを提供します。
取引先責任者の詳細ページ 取引先責任者の詳細を提供します。
ケースの編集ページ サポート案件の詳細を更新するためのフォームを提供します。
私のオープンケースページ 検索機能や詳細へのリンクなどユーザーのオープンしているサポート案件のテーブルビューを提供します。

取引先責任者: 取引先責任者を検索、表示、編集します。

通知またはページ ユースケースワークフロー
取引先責任者割り当て(既存)通知 取引先責任者の所有者が変更されると、新しい所有者は通知を受け取ります。
取引先責任者割り当て(新規)通知 新しい取引先責任者がユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者一覧や取引先責任者の詳細へのリンクなど取引先の詳細を提供します。
取引先責任者の詳細ページ 取引先責任者の詳細を提供します。
取引先責任者の編集ページ 取引先責任者の詳細を更新するためのフォームを提供します。
私の取引先責任者ページ 検索機能や詳細へのリンクなどユーザーの取引先責任者のテーブルビューを提供します。

取引先の作成: 取引先を作成します。

通知またはページ ユースケースワークフロー
取引先の作成ページ 新しい取引先の詳細を送信するためのフォームを提供します。

予定の作成: 予定を作成します。

通知またはページ ユースケースワークフロー
予定の作成ページ 新しい予定の詳細を送信するためのフォームを提供します。

サポート案件の作成: サポート案件を作成します。

通知またはページ ユースケースワークフロー
ケースの作成ページ 新しいサポート案件の詳細を送信するためのフォームを提供します。

取引先責任者の作成: 取引先責任者を作成します。

通知またはページ ユースケースワークフロー
取引先責任者の作成ページ 新しい取引先責任者の詳細を送信するためのフォームを提供します。

リードの作成: リードを作成します。

通知またはページ ユースケースワークフロー
リードの作成ページ 新しいリードの詳細を送信するためのフォームを提供します。

商談の作成: 商談を作成します。

通知またはページ ユースケースワークフロー
商談の作成ページ 新しい商談の詳細を送信するためのフォームを提供します。

電話の作成: 電話を作成します。

通知またはページ ユースケースワークフロー
電話の作成ページ 新しい電話の詳細を送信するためのフォームを提供します。

タスクの作成: タスクを作成します。

通知またはページ ユースケースワークフロー
タスクの作成ページ 新しいタスクの詳細を送信するためのフォームを提供します。

リード: リードを検索、表示、編集します。

通知またはページ ユースケースワークフロー
リード割り当て(既存)通知 リードの所有者が変更されると、新しい所有者は通知を受け取ります。
リード割り当て(新規)通知 新しいリードがユーザーに割り当てられると、ユーザーは通知を受け取ります。
リードの編集ページ リードの詳細を更新するためのフォームを提供します。
リードの詳細ページ リードの詳細を提供します。
自分のオープンしているリードページ 検索機能や詳細へのリンクなどユーザーのオープンしているリードのテーブルビューを提供します。

商談: 商談を検索、表示、編集します。

通知またはページ ユースケースワークフロー
商談割り当て(既存)通知 商談の所有者が変更されると、新しい所有者は通知を受け取ります。
商談割り当て(新規)通知 新しい商談がユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者一覧や取引先責任者の詳細へのリンクなど取引先の詳細を提供します。
失注としてクローズページ 商談を失注としてクローズするためのフォームを提供します。
受注としてクローズページ 商談を受注としてクローズするためのフォームを提供します。
取引先責任者の詳細ページ 取引先責任者の詳細を提供します。
商談の編集ページ 商談の詳細を更新するためのフォームを提供します。
私のオープン商談ページ 検索機能や詳細へのリンクなどユーザーのオープンしている商談のテーブルビューを提供します。
商談の詳細ページ 商談の詳細を提供します。

電話: 電話を検索、表示、編集します。

通知またはページ ユースケースワークフロー
割り当てられた電話(既存)通知 電話の所有者が変更されると、新しい所有者は通知を受け取ります。
割り当てられた電話(新規)通知 新しい電話がユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者一覧や取引先責任者の詳細へのリンクなど取引先の詳細を提供します。
ケースの詳細ページ サポート案件の詳細を提供します。
取引先責任者の詳細ページ 取引先責任者の詳細を提供します。
電話の編集ページ 電話の詳細を更新するためのフォームを提供します。
自分のオープンしている電話ページ 検索機能や詳細へのリンクなどユーザーのオープンしている電話のテーブルビューを提供します。
商談の詳細ページ 商談の詳細を提供します。
電話の詳細ページ 電話の詳細を提供します。

タスク: タスクを検索、表示、編集します。

通知またはページ ユースケースワークフロー
割り当てられたタスク(既存)通知 タスクの所有者が変更されると、新しい所有者は通知を受け取ります。
割り当てられたタスク(新規)通知 新しいタスクがユーザーに割り当てられると、ユーザーは通知を受け取ります。
取引先の詳細ページ 取引先責任者一覧や取引先責任者の詳細へのリンクなど取引先の詳細を提供します。
ケースの詳細ページ サポート案件の詳細を提供します。
取引先責任者の詳細ページ 取引先責任者の詳細を提供します。
タスクの編集ページ タスクの詳細を更新するためのフォームを提供します。
リードの詳細ページ リードの詳細を提供します。
自分のオープンタスクページ 検索機能や詳細へのリンクなどユーザーのオープンしているタスクのテーブルビューを提供します。
商談の詳細ページ 商談の詳細を提供します。
タスクの詳細ページ タスクの詳細を提供します。