重要 - 画像/情報は四半期ごとのリリースで更新されます!

概要

データ同期ジョブは、承認された Dynamics CRM 組織からデータを取得し、Gainsight NXTに取り込みます。データ同期ジョブには5つの段階があり、これらの段階を必要に応じて構成する必要があります。データ同期ジョブの5つの段階は次のとおりです：

• 同期構成ステージ
• データソースとフィールドマッピング
• 派生マッピング
• フィルターの同期
• スケジュール

新しいジョブを作成するには、[ジョブの作成]アイコンをクリックします。新規ジョブウィンドウが表示されます。

同期構成ステージ

このステージはデータ同期ジョブで構成する基本設定にて構成されています。このセクションでは、以下のフィールドの構成が可能です。

• 接続名：このジョブが作成される接続。このフィールドには、接続名が自動的に入力されます。このフィールドは編集することができません。
• コネクター：このフィールドには、コネクタ名が表示されます。このフィールドはすべてのジョブにおいて常にDynamicsに設定されます。
• ジョブ名：このフィールドには、ユーザーが入力したジョブ名が保持されます。
• 依存ジョブ:：現在のジョブの前に他のジョブを終了する必要がある場合は、そのジョブをここに追加する必要があります。依存ジョブが最初に実行され、次に現在のジョブが実行されます。追加できる依存ジョブは 1 つだけです。
• 通知の詳細：このフィールドは現在のジョブの成功または失敗に関してユーザーに通知します。最初のテキストボックスに、このジョブが正常に実行されたときに通知を受ける受信者のメールアドレスを入力します。2番目のテキストボックスに、このジョブの実行に失敗したときに通知を受ける受信者のメールアドレスを入力します。

複数のメールアドレスをカンマで区切って入力することができます。

• 保存をクリックします。

データソースとフィールドマッピングステージ

このステージでは、Dynamics CRMからソースエンティティを選択し、Gainsightからターゲットオブジェクトを選択し、Dynamics CRMエンティティからのソースフィールドをGainsightの対応するフィールドにマップすることができます。このセクションでは、以下のフィールドの構成が可能です。

• ダイナミクス ソースエンティティを選択：このフィールドでは、Dynamics CRMから標準およびカスタムエンティティを選択することができます。

選択されたオブジェクトのすべてのフィールドと、このオブジェクトのルックアップフィールドをフィールドマッピングステージに含めることが可能です。フィールドマッピングに進むと、ソースエンティティを変更することはできません。

• ターゲットGainsightオブジェクトを選択する：このフィールドでは、標準オブジェクトとカスタムオブジェクトのみが表示されます。フィールドマッピングに進むと、ソースオブジェクトを変更することはできません。
• フィールドマッピング：フィールドマッピングステージで、フィールドをソースオブジェクトからターゲットオブジェクトにマップする必要があります。データは構成されたフィールドマッピングに従って、Dynamics CRMオブジェクトのソース フィールドからGainsightのターゲットフィールドに同期されます。

フィールド マッピングを追加するには：

1. ダイナミクス ソース オブジェクトを選択フィールドから、ソースオブジェクトを選択します。
2. ターゲットGainsightオブジェクトを選択フィールドから、ターゲットオブジェクトを選択します。
3. マッピングに進むをクリックします。フィールドマッピングセクションが表示されます。
4. 追加するをクリックしてフィールドマッピングを追加します。
5. ソース フィールド列で、データのインポート元のフィールドを選択します。
6. ターゲットフィールド列で、データのインポート先のフィールドを選択します。
7. 追加をクリックして、さらにフィールドマッピングを追加します。
8. ソースフィールドとターゲットフィールドの間でフィールドマッピングを実行します。

個人記録の同期中、Dynamics連絡先オブジェクトとGainsight個人オブジェクト間のマッピングのUpsertキーは、個人Resolutionキー構成によって決定されます。個人Resolutionキー構成で選択されたフィールドは、個人を連絡先から個人オブジェクトに同期する際にUpsertキーとして自動的に選択されます。Gainsightで人物の識別に使用される1つまたは複数のupsertキーが存在する可能性がありますが、それらを編集することはできません。

Upsertキーは、フィールド マッピングセクションでマッピングされる必要があります。それらがマッピングされていない場合、データは同期されません。

次の図 (ステップ9の後) では、Dynamics CRMのメールフィールドの値がGainsightのメールフィールドに同期されています。同様に、他のソースフィールドからのデータはGainsightフィールドに同期されます。Dynamics CRMのメールフィールドは、一意のDynamics CRM記録を識別し、Gainsight個人記録と一致させるのに役立ちます。同様に、フルネーム、ファーストネーム、苗字、および 一意の識別子フィールドは、Gainsightの名前、ファーストネーム、苗字、および外部IDフィールドにそれぞれマッピングできます。

9. マッピングを保存をクリックします。このボタンをクリックすると、派生マッピングステージが有効になります。必要に応じて、同期フィルター またはスケジュールステージに直接進むこともできます。

派生マッピングステージ

このステージはオプションであり、上記のマッピングのターゲットフィールドのいずれかに GSIDデータタイプのフィールドがある場合にのみ設定する必要があります。このステージでは、データ同期ジョブでルックアップマッピングを作成することができます。同じオブジェクトまたは別の標準オブジェクトを参照して、最大6列まで一致させることが可能です。必要な照合が実行されると、ルックアップオブジェクトからGSIDデータタイプフィールドに Gainsight ID (GSID) を取得することができます。主な目的は、記録のGSIDを同じオブジェクトまたは別のオブジェクトから設定することです派生マッピングは、データインポートルックアップとも呼ばれています。

ルックアップには次の2つのタイプがあります。ダイレクトとセルフです。

• ダイレクトルックアップにより、管理者は別のMDA標準オブジェクトを参照し、その参照オブジェクトから記録のGSIDを取得することができます。
• セルフルックアップにより、管理者は同じ標準オブジェクトを検索し、別の記録のGSIDをターゲットフィールドに取得できます。派生マッピングの詳細については、データインポートルックアップ記事を参照してください。

重要：派生マッピングを使用するためには、フィールドマッピングステージで選択したターゲットオブジェクトに、GSIDデータタイプのフィールドが少なくとも1つ必要になります。

派生 マッピングを追加するには：

1. 追加をクリックします。データインポートルックアップ構成ウィンドウが表示されます。
2. ルックアップ タイプ：ダイレクトまたはセルフルックアップのいずれかを選択します。
    
   • ダイレクト：ダイレクトルックアップでは、別のGainsight標準オブジェクトを参照し、その参照オブジェクトから記録のGSIDを取得することができます。
   • セルフ：セルフルックアップでは、同じ標準オブジェクトを検索し、別の記録のGSIDをターゲットフィールドに取得できます。
      
3. から：GSIDを取得するソースオブジェクトを選択します。ルックアップは同じオブジェクト自体に対して行われるため、このフィールドではセルフルックアップに同じオブジェクトが自動的に設定されます。
4. ターゲットフィールドに：GSIDがロードされるターゲットフィールドを選択します。このフィールドでは、GSIDデータタイプのフィールドのみを表示することができます。
5. 一致：どの記録を一致させる必要があるかに従って、2つのフィールドを選択します。最初のフィールドはDynamics CRMソースオブジェクトからのもので、2番目のフィールドはルックアップオブジェクトからのものです。
6. 別の追加をクリックして、追加のマッピングを追加します(オプション) 。
7. [複数の一致が発生した場合]フィールドで値を選択します。一致基準に対して複数の記録が見つかった場合、選択した値によって実行する必要があるアクションが決まります。
    
   • 任意の1つの一致を使用します。このオプションを選択すると、2つの記録のいずれかが選択されます。
   • エラーのある記録をマーク：このオプションが選択されている場合、記録はターゲットオブジェクトにエラーとしてマークされ、ターゲットオブジェクトに同期されます。
      
8. [一致が見つからない場合]フィールドで値を選択します。選択した値によって、一致する記録が見つからなかった場合に実行されるアクションが決まります。
    
   • null値を挿入：このオプションを選択すると、対象オブジェクトのGSIDフィールドにnull値が挿入されます。
   • 記録拒否：特定の記録は考慮されず、拒否されます。
      
9. [適用]をクリックします。

フィルターステージの同期

このステージでは、フィルターを追加して、同期する必要がある記録の一覧を絞り込むことができますDynamics CRMソースオブジェクトの標準のカスタムフィールドは、Gainsight NXTに同期されるデータをフィルタリングするために使用することができます。

メモ: ルックアップフィールドのフィルターは、Dynamicsコネクタではサポートされていません。

フィルターを追加する

1. +フィルタを追加をクリックします。
2. 値の選択セクションで、Dynamics CRMオブジェクトからフィールドを選択します。
3. 必要なオペレーターを選択します。
4. 一致クライテリアを選択します。
5. [フィルターを保存] をクリックします。
6. +フィルターの追加をクリックして、さらにィルターを追加します(オプション) 。

複数のフィルタを追加すると、デフォルトでAND演算が適用されます。ただし、これをOR演算に変更することもできます。

ジョブステージのスケジュール

このステージでは、データ同期ジョブを後で実行するようにスケジュールしたり、オンデマンドでデータ同期ジョブを実行したりすることができます。データが初めて同期されると、時間の始まり (1970年) から現在までのすべてのデータが Gainsightからインポートされます。これは、初回実行時だけ、[今すぐインポート]および [スケジュール]オプションに適用されます。

ログを表示

ログタブに移動して、すべてのデータ同期ジョブのログ履歴を表示することができます。このページには、すべてのコネクタのログが表示されます。このページをフィルタリングすると、特定のコネクタからの特定のジョブのログのみを表示することができますログをフィルタリングするには、表示ドロップダウン メニューから必要なジョブを選択し、更新をクリックします。

上の画像では、個人同期 のログのみを表示するようにフィルターが適用されています。

Gainsight NXTはすべてのデータ同期ジョブに対して2種類のログを保持します。

• オーディットログ：ジョブでアクティビティが実行されると、オーディットログが記録されます。さまざまなアクティビティとしては、作成、編集、削除などがあります。オーディットログはAL記号で表されます。このログに表示されるさまざまなフィールドは次のとおりです：
  • 属性：変更されたジョブのステージ。たとえば、マッピングを変更した場合、このフィールドにはマッピングが表示されます。
  • サブ属性：属性で変更された要素。
  • アクション：ジョブで実行されるアクティビティ。可能な値は、Create、Edit、Deleteです。
  • 古い値：変更された値。
  • 新しい値：変更されたフィールドの現在の値。
  • 追加情報：アクティビティに関する追加情報。
     
• 実行ログ:：ジョブが実行されると、実行ログが作成されます。実行ログはEL記号で表されます。緑色のELシンボルは、実行が成功したことを示します。

オーディットログに表示されるさまざまな詳細は次のとおりです：

• 日付: ジョブの実行日。
• コールタイプ：Dynamics 365コネクタのAPPLICATION_DATAを常に表示します。
• pステータス：ジョブのステータス。可能な値はSuccess, Failure, in progresです。
• # Success: 正常に同期された記録の数
• # Failure: 同期に失敗した記録の数

LOGSページには、データ同期ジョブのログのみが表示されます。接続ログを表示するために、Dynamics 365コネクタログ ページに移動することができます。接続ログのさまざまな列は次のとおりです：

• 接続名：接続の名前です。
• ユーザー：接続を作成したユーザーの名前。
• アクション：接続で実行されるアクション。
• 変更日：記録が最後に変更された日付。
• 属性：接続で変更された要素。
• 古い値：変更後に置き換えられた値。
• 新しい値：古い値を置き換えた新しい値。

こちらもご覧ください。

• Dynamics CRM コネクタの概要
• 接続を作成
• 接続を許可
• すぐに使えるジョブを変更する