Microsoft Dynamics 365へのエンゲージの組込み

エンゲージをMicrosoft Dynamics 365インスタンスに追加できます。

前提条件

インストール済のEngageインスタンス、それに関連する資格証明(会社名とそのログイン・プリフィクスなど)
Microsoft Dynamics 365インスタンスと、それをカスタマイズするために必要な権限

エンゲージをMicrosoft Dynamics 365にインストールする手順は、次のとおりです。

Microsoft Dynamics 365にログインし、「Settings」にナビゲートします。
「Customization」セクションで「Customizations」をクリックします。
「Customization」ページで「Customize the System」をクリックします。
「PowerApps」ページの「Components」で、「Entities」 > 「Contact」 > 「Forms」を選択します。
「New」をクリックし、エンゲージを追加するフォームを選択します(「Main Form」など)。
「挿入」タブをクリックします。
「One Column Tab」を追加して新規タブを選択し、「IFRAME」をクリックしてそこにiframeを追加します。「Add an IFRAME」ウィンドウが表示されます。
次のiframe値を入力します。
1. Name: IFRAME_Engage
2. URL: http://about:blank
3. Label: Eloqua Engage
4. 「Security」セクションで、「Restrict cross-frame scripting」オプションの選択を解除します。
(推奨)「Formatting」タブの「Row Layout」セクションで、エンゲージの情報を表示するための十分なスペースを確保するために、行の数を20に設定して高さを増やします。
「Dependencies」タブで、「email」を依存フィールドとして追加します。
「OK」をクリックして「Add an IFRAME」ウィンドウをクローズします。
「Home」タブで、「Form Properties」をクリックします。「Form Properties」ウィンドウの「Events」タブが表示されます。
「Form Libraries」セクションで、「Add」をクリックします。「Lookup Record」ウィンドウが表示されます。
「new_EPPOnLoad」を選択し、「Add」をクリックします。
「Form Properties」ウィンドウの「Event Handlers」セクションで「Add」をクリックします。「Handler Properties」ウィンドウが表示されます。
「Library」リストから「new_EPPOnLoad」を選択します。
「Function」ボックスにloadEngageと入力し、「OK」をクリックしてから「OK」をクリックして、「Form Properties」ウィンドウをクローズします。
新しいiframeをダブルクリックします。「IFRAME Properties」ウィンドウが表示されます。
「Events」タブをクリックし、「Form Libraries」を展開して、「new_EPPOnLoad」をダブルクリックします。「Edit Content」ウィンドウが表示されます。
ログイン・タイプに応じて、次のいずれかのコード・スニペットをコード・エディタにコピー・アンド・ペーストします。
- 直接ログイン
  function loadEngage() {
  var newUrl = "https://login.eloqua.com/apps/salesTools/engage?YYYY
  Xrm.Page.ui.controls.get("IFRAME_Engage").setSrc(newUrl);
  }
- 自動ログイン
  function loadEngage() {
  var newUrl = "https://login.eloqua.com/autoLogin?LoginPrefix={Login_Prefix}&Url=/apps/salesTools/engage?YYYY
  Xrm.Page.ui.controls.get("IFRAME_Engage").setSrc(newUrl);
  }
- SAML SSO
  function loadEngage() {
  var newUrl = "https://login.eloqua.com/auth/saml2/autologin?LoginPrefix={Login_Prefix}&ReturnUrl=/apps/salesTools/engage?YYYY
  Xrm.Page.ui.controls.get("IFRAME_Engage").setSrc(newUrl);
  }
直接ログインの例:
{Login_Prefix}を4桁のEloquaログイン・プリフィクス・コードで置き換えます(ELQAなど)。かわりに、SiteId={site_ID}にEloquaサイトID (数値コード)を使用することもできます。ログイン・プリフィクスまたはサイトIDを検出するには、「設定」 > 「表示プリファレンス」 > 「会社のデフォルト」にナビゲートします。このパラメータを無視することもできます。その場合は、最初に見つかった、Eloquaに保存されている資格証明を使用してログインが試行されます。
YYYYはオプションです。
テンプレート・ピッカーをオープンしてエンゲージを起動するには、YYYYをemailChooser=trueに置き換えます
特定のテンプレートを指定してエンゲージを起動するには、YYYYをemailId={templateID}に置き換えます
コンタクトのEメール・アドレスを指定してエンゲージを起動するには、YYYYをemailAddress="+ document.getElementById("{emailaddress1}").title;に置き換え、{emailaddress1}をMicrosoft Dynamics 365インスタンスの値に置き換えます。たとえば、emailaddress1、emailaddress1_dまたはemailaddress1_iを使用できます。自分のMicrosoft Dynamics 365データで何が使用されているかを確認するには、ブラウザの開発者ツールを使用して既存のコンタクトのEメール・アドレスを検査します。たとえば、Google Chromeを使用して値を調べる手順は、次のとおりです。
1. 「Sales」 > 「Contacts」に移動して既存のコンタクトをクリックします。
2. [Ctrl]を押しながら[Shift]と[I]を押して、開発者ツールをオープンします。
3. 「Elements」タブで、[Ctrl]を押しながら[F]を押し、emailaddress1を検索します。
4. title="{emailAddress}"の前にあるコンタクトのEメール・アドレス・フィールドに関連付けられた値が、含める必要がある値を示します。次の例では、必要な値はemailaddress1_dです。
例: 自動ログインを選択した場合、{LoginPrefix}はELQA、{emailaddress1}値はemailaddress1_dで、コードは次のようになります。
function loadEngage(){
var newUrl = "https://login.eloqua.com/autoLogin?LoginPrefix=ELQA&Url=/apps/salesTools/engage?emailAddress="+ document.getElementById("emailaddress1_d").title;Xrm.Page.ui.controls.get("IFRAME_Engage").setSrc(newUrl);
}
「OK」をクリックしてから「OK」をクリックして、「IFRAME Properties」ウィンドウをクローズします。
「Home」タブで「Save」をクリックし、「Publish」をクリックしてから「PowerApps」ウィンドウをクローズします。

Microsoft Dynamics 365, MS Dynamics, EPPOnLoad

Microsoft Dynamics 365へのエンゲージの組込み

関連項目

Microsoft Dynamics 365, MS Dynamics, EPPOnLoad