コネクタ ジョブの準備
重要 - 画像/情報は四半期ごとのリリースで更新されます!
四半期ごとのリリースにて、最新の機能・情報を反映し、画像を含めた情報は更新されます。
重要: Gainsight は、Horizon Experience を使用して Connectors 2.0 をアップグレードしています。 この記事は、Horizon Experience for Connectors 2.0 にアップグレードされたテナントに適用されます。 以前のバージョンで Connectors 2.0 を使用している場合は、こちらのドキュメントを参照してください。 |
この記事では、外部アプリケーションのデータをGainsightに同期するデータジョブを作成する方法を管理者に説明します。
[概要]
外部アプリケーションに接続すると、管理者はカスタムタスクを作成して、外部アプリケーションのデータを Gainsightに同期できます。Gainsightは、他のソースオブジェクトからのデータをGainsightに同期するための初期セットアップに必要な、いくつかのコネクタ用のアウトオブザボックス(OOB)ジョブを提供しています。
ジョブページにアクセスするには、[管理] > [統合] > [コネクタ 2.0] > [ジョブ] に移動します。
ジョブリストページでは、1 つまたは複数のジョブが接続に関連付けられていることを確認できます。特定のジョブを検索するには、[検索] テキストボックスを使用するか、[接続] テキストボックスを使用して接続名でジョブを検索します。ジョブページには、各ジョブの次の詳細が表示されます。
コラム |
説明 |
---|---|
ジョブ名 |
ジョブの名前が表示されます。 |
接続名 |
接続ページで作成された接続名。 |
[ソース] |
データを取得するシステム。 |
目的地 |
ターゲットの Gainsight オブジェクトを参照します。 |
最終実行ステータス |
実行されたジョブのステータスを、前回の実行で成功、一部成功、または失敗として示します。 |
最終実行日 |
タイムスタンプとジョブが最後に実行された日付を示します。 |
スケジュールタイプ |
データ同期ジョブのスケジュールタイプを [スケジュール実行] または [オンデマンド] として示します。スケジュールタイプの詳細については、この記事の最後にある「その他のリソース」の「ジョブの設定」を参照してください。 |
コンテキストメニューオプション
接続のコンテキストメニューから、以下のオプションのいずれかを選択して、それぞれのアクションを実行します。
- ジョブの編集: このオプションを使用してジョブを編集します。詳細については、この記事の最後にある「その他のリソース」セクションの「求人リスト」ページの記事を参照してください。
- ジョブの削除: このオプションを使用して、選択したジョブを削除します。
- ジョブの実行: このオプションを使用して、データ同期オプションのいずれかを使用してジョブを実行します。
- 前回の同期日時以降に変更されたデータ
- 指定された日時に変更されたデータ
- [すべてのデータ]
「ジョブの実行」オプションの詳細については、この記事の最後にある「その他のリソース」セクションの「ジョブまたはジョブチェーンの設定」の記事を参照してください。
コネクタジョブの作成
データジョブでは、データソースを選択してデータセットを作成し、2 つの異なるデータセットをマージして出力データセットを作成し、データセットを変換し、Add to Destination を使用して最終データを Gainsight に同期できます。データジョブの作成時には、次の機能を使用できます。
ジョブを作成するには:
- [管理] > [統合] > [コネクタ 2.0] > [ジョブ] に移動します。すべての接続の既存のジョブを表示できます。
- [ジョブを作成] をクリックします。「ジョブの作成」ポップアップウィンドウが表示されます。
- 「ジョブの名前」 フィールドに、一意の名前を入力します。
- [次へ] をクリックします。準備手順が表示されます。
- [データソース] ドロップダウンから、接続を選択します。選択したデータソースのすべてのオブジェクトが表示されます。
ソースオブジェクトを追加
ソースオブジェクトを追加するには:
- 必要なオブジェクトをオブジェクトリストから準備ステップにドラッグアンドドロップします。オブジェクトの詳細ページが表示され、フィールドを選択したり、フィルターを追加したり、概要を表示したりできます。
フィールド
フィールドタブでは、Gainsightにデータを同期したいソースフィールドを選択できます。
フィールドを選択するには:
- (オプション)「データセットの名前」で、ソースオブジェクトの名前を変更できます。
- (オプション)「主キーのリファレンス」フィールドで、参照する主フィールドを選択します。
- (オプション)「最終変更日までの参照」フィールドで、最終変更日を記録するために使用できる参照フィールドを選択します。
- ソースオブジェクトに追加する必須フィールドを選択します。
- (オプション)「表示名」 フィールドでは、フィールド名を変更できます。
- [フィルター] タブをクリックします。
フィルター
「フィルター」タブでは、要件に応じてソースオブジェクトのデータを同期するフィルターを追加できます。たとえば、特定の日付以降にデータを同期するフィルターを追加できます。
フィルターを追加するには:
- 「フィルターを追加」をクリックします。
- フィールドから、フィルタリングするフィールドを選択します。
- 「演算子」フィールドから、演算子を選択します。
- 「値」フィールドから、適切な値を選択します。
メモ:
- さらにフィルターを追加するには、+ アイコンをクリックします。
- フィルターを削除するには、x アイコンをクリックします。
- (A または B) AND C などの高度なフィルターを追加するには、「アドバンスロジック」テキストボックスに目的のEXPRESSIONを入力します。
- 「概要」タブをクリックします。
サマリー
「概要」タブでは、選択したすべてのフィールドとソースオブジェクトに追加されたフィルターのリストを表示できます。
重要:
- ソースオブジェクトを準備したら、ソースオブジェクトにデスティネーションを追加するか、ソースオブジェクトを設定 (トランスフォームまたはマージ) できます。宛先を追加する方法の詳細については、「宛先への追加」セクションを参照してください。
データをプレビュー:
データプレビュー機能により、ジョブ作成中にオブジェクト向けのサンプルデータを表示できるようになります。これにより、実装チームは抽出済みのデータをよりよく理解でき、管理者向けの統合セットアップを加速できるようになります。
オブジェクト向けのサンプルデータを表示するには、
-
管理 > 統合 > コネクタ 2.0 > ジョブ に移動します。
-
縦に3つ並んだドットのメニューアイコンから、「編集」を選択します。準備ステップの ページが表示されます。
-
ソースオブジェクト上の目のアイコンをクリックします。オブジェクト向けのソースシステムに存在するデータのプレビューが表示されます。
オブジェクト向けのデータプレビューに含まれるフィールドを変更するには、
-
ソースオブジェクトから、縦に3つ並んだドットのメニューアイコンをクリックします。
-
編集を選択します。フィールドスライドアウトパネルが表示されます。
-
フィールド選択リストで、プレビューするフィールドを選択します。
-
完了をクリックします。
-
ソースオブジェクト上の目のアイコンをクリックします。選択済みフィールドのプレビューデータが変更されています。
注意:
-
データプレビュー機能は、ジョブ作成段階でも利用できます。
-
データプレビュー機能は、現在HubSpotコネクターでのみ利用できますが、他のコネクターでも順次利用できるようになります。
変換
準備段階では、管理者はデータを変換してケースフィールドを追加し、顧客データからより有意義な洞察を得ることができます。
ビジネスユースケースの例: Transform 関数は、新しいケースフィールドを作成または変更する機能を提供します。新しいケースフィールドを使用して、Gainsightデータモデルの消費要件に基づいて外部フィールドを変更できます。ケースフィールドは、ケース条件ごとに異なる値を入力するように定義できます。
たとえば、「新規」、「オープン」、「クローズ」などの外部選択リストの値を、Gainsightの選択リストの値と一致するように「有効」と「非アクティブ」に変更できます。
メモ: トランスフォーム機能はZendesk、Freshdesk、ServiceNow、Jira、Zuora、Zoho、Pipedriveでのみご利用いただけます。
オブジェクトを変換するには:
- [管理] > [コネクタ 2.0] > [ジョブ] タブに移動します。
- [ジョブを作成] をクリックします。
- 「ジョブの名前」フィールドに、名前を入力します。
- [次へ] をクリックします。
- 「データソース」ドロップダウンで、ソースを選択します。
- 必要なオブジェクトを準備画面にドラッグアンドドロップします。
- データセットのコンテキストメニューから、[変換] をクリックします。
- 「ケースフィールドを追加」をクリックします。
- 「ラベル」フィールドに、ケースフィールドの名前を入力します。
- 「データタイプ」フィールドから、データタイプとして「ブーリアン」、「数値」、または「文字列」を選択します。
- ケース 1 をクリックしてビューを拡大します。
- [フィルターを追加] をクリックして、要件に応じて条件を追加します。
- THEN フィールドで、設定した条件が満たされたときに結果データを表示するフィールドと値を選択します。
- (オプション) 手順 3 ~ 7 に従って、「+CASE」をクリックして別のケースフィールドを追加します。
- どの条件も一致しない場合の値を DEFAULT フィールドから選択します。
- 「追加」をクリックします。
- 「保存」をクリックします。
マージ
この 2 つのデータをまとめて、出力データセットを作成できます。2 つのデータセットまたは複数のデータセットをマージして、最終データセットを 1 つ作成できます。
ビジネスユースケース: たとえば、チケットの詳細と、Zendeskでサポートチケットを作成したユーザーを知りたい場合です。このユースケースを実現するには、Zendesk TicketsとZendesk Usersオブジェクトで作成されたデータセットを1つの出力データセットにマージし、データをGainsight標準またはカスタムオブジェクト(ターゲットオブジェクト)にインポートできます。
2 つのデータセットを結合するには、目的のデータセットとマージするデータセットのオプションから [マージ] を選択します。
データセットをマージすると、「マージ」という名前の新しいウィンドウが表示され、[結合]、[フィールド]、[フィルター]、[概要] タブが表示されます。
加入
基本的な JOIN 句は、2 つ以上のテーブルの行を、それらのテーブルに共通するフィールドに基づいて結合するために使用されます。Gainsightでは次の4種類のジョインがサポートされています。内部結合、左結合、右結合、外部結合。各結合タイプをコネクタのマージタスクで使用すると、生成されるデータセットは少し異なります。詳細については、「結合タイプ」の記事を参照してください。
- 内部結合: 両方のデータセットの共通のレコードが保持されます。
- 左ジョイン: 左側のデータセットのすべてのレコードが保持されます。
- 正しいジョイン: 適切なデータセットのすべてのレコードが保持されます。
- フルアウタージョイン: 両方のデータセットのすべてのレコードが保持されます。
2 つのデータセットを結合するには:
- 「結合」タブに移動します。
- 必要な結合タイプを選択します。
- 各データセットからフィールドを選択して条件を設定します。たとえば、オブジェクト、Zendesk Tickets、Zendeskユーザーで作成されたデータセットをマージする場合、最初のデータセットのユーザーIDは担当者ID、2番目のデータセットのユーザーIDはIDです。
- 複数のレコード一致条件を追加するには、[+] をクリックします。これにより、ビジネス要件に基づいてレコードをフィルタリングできます。
- 「保存」をクリックします。
フィールド
「フィールド」タブでは、
- ソースデータセットから追加された個々のフィールドを選択または選択解除し、それらをマージされた出力データセットに追加します。
- (オプション)「表示名」フィールドでは、表示名を変更できます。
- 「保存」をクリックします。
フィルター
Merge のフィルターは、「データセットの準備」のフィルターとして機能します。詳細については、「フィルター」セクションを参照してください。
宛先に追加
最終的な出力データセットが準備できたら、出力データセットに宛先を追加して、ソースからのデータをターゲットの Gainsightオブジェクトに同期できます。「宛先に追加」では、Gainsightからターゲットオブジェクトを選択し、外部システムオブジェクトのソースフィールドをGainsightの対応するターゲットフィールドにマップできます。
出力データセットに宛先を追加するには:
- 最終出力データセットの3つのドットメニューをクリックし、「宛先を追加」を選択します。
- Gainsightオブジェクトドロップダウンリストから、ターゲットGainsightオブジェクトを選択します。ターゲットオブジェクトを選択したら、ソースフィールドとターゲットフィールド間の直接マッピングと派生マッピングの設定に進むことができます。
メモ: 準備画面に追加されたソースオブジェクトは、マージやターゲットの追加など、どれでも選択できます。フィールドがマップされると、ソースオブジェクトは変更できません。
オプションの削除
Add to Destination タスクの削除オプションは、宛先タスクを削除し、管理者が Merge または Transform 機能を追加/削除して既存のジョブを変更できるようにします。 その結果、新しいジョブを作成することなく、複数のオブジェクト、マージ、および変換を含む複雑またはかさばるスキーマを簡単に変更できます。
タスクを削除するには:
- [管理] > [統合] > [コネクタ 2.0] > [ジョブ] に移動します。 ジョブ リスト ページが表示されます。
- それぞれのジョブの 3 つの縦のドット アイコンをクリックします。
- [編集] をクリックします。 準備ステップが表示されます。
- [宛先に追加] タスクから、縦に 3 つ並んだ点をクリックします。
- [削除] を選択します。 確認ダイアログボックスが表示されます。
- [確認] をクリックします。 [宛先に追加] タスクが削除されます。
注:
- ジョブを構成/スケジュールするには、[宛先に追加] タスクを追加する必要があります。失敗すると、画面にエラー メッセージが表示されます。
- [宛先に追加] タスクを追加せずにジョブを保存しようとすると、ジョブが保存されます。 ただし、スケジュールまたはジョブチェーンによってトリガーされたジョブの実行中に、ジョブが失敗する場合があります。
- Add to Destination タスクがないと、Manual Job Run 機能を実行できません。
ユーザー、通貨、企業チーム、画像など、削除オプションが無効になっている標準ジョブがいくつかあります。 管理者が - Add to Destination タスクを削除すると、カスタム ジョブの作成中にそのオブジェクトが Gainsight オブジェクト リストに表示されなくなります。
スケジュールフィールド
このセクションには、次のサブセクションが含まれています。
ダイレクトマッピング
ダイレクトマッピングでは、出力データセットのフィールドをフィールドマッピングのターゲットオブジェクトにマッピングできます。外部システムのソースフィールドからGainsightのターゲットフィールドへのデータ同期は、設定されたフィールドマッピングに基づいて行われます。データセットから選択したすべてのソースフィールドが [ソースフィールド] 列に表示されます。
フィールド間に直接マッピングを追加するには:
- 「ターゲットフィールド」列で、データを同期するフィールドを選択します。
- 少なくとも 1 つのフィールドの [識別子に含める] チェックボックスをオンにします。ソースからGainsightまでのユニークなレコードを識別しながら、残りのマッピングされたフィールドにデータを更新するのに役立ちます。固有の値を持つ任意のソースフィールドを識別子として使用できます (例: (ZendeskのチケットIDをGainsightの外部IDへ)。
- これで、「派生マッピング」セクションに進むことができます。
派生マッピング
これはオプションであり、データタイプ GSID のターゲットフィールドに値を設定する場合にのみ、派生マッピングを設定する必要があります。GSID 値は、検索によって同じオブジェクトまたは別のオブジェクトから入力されます。
この派生マッピング段階では、データ同期ジョブでルックアップマッピングを作成します。同じオブジェクトまたは別の標準オブジェクトを検索して、最大 6 つの列を照合できます。必要なマッチングが実行されたら、検索オブジェクトから GSID データ型フィールドに Gainsight ID (GSID) を取得します。派生マッピングの詳細については、この記事の最後の「その他のリソース」セクションにある「データインポート検索」の記事を参照してください。
重要: 派生マッピングを使用するには、ターゲットオブジェクトに GSID のデータ型のフィールドが少なくとも 1 つ必要です。
- [派生マッピング] をクリックして展開します。
- 「構成済みの派生マッピング」ボタンをクリックします。
- 「マッピングを追加」ボタンをクリックして、派生マッピングフィールドを追加します。
- Salesforce フィールドドロップダウンメニューからソースを選択します。
- データフロードロップダウンメニューから、データを取得する方向を選択します。
- Gainsight フィールドのドロップダウンメニューから値を選択します。
メモ: Gainsightフィールドドロップダウンには、GSIDデータタイプのフィールドのみが表示されます。ルックアップの定義は、(設定保留中と表示される) 十字アイコンで有効になります。 - 「検索を定義」ボタンをクリックします。「ルックアップを定義」スライドアウトパネルが表示されます。
- 「中央のオブジェクトを選択」ドロップダウンリストから、検索する中間オブジェクトを選択します。
- 「中間オブジェクトのフィールド」ドロップダウンメニューから、マップするオブジェクトを選択します。
- 「複数一致した場合」 ドロップダウンメニューで、値を選択します。
メモ: 選択した値によって、一致する条件に一致するレコードが複数見つかった場合に実行する必要があるアクションが決まります。「複数マッチ発生時」ドロップダウンメニューのドロップダウンメニューには、以下のオプションがあります。
- マッチするものを1つ使ってください: 2 つのレコードのうちの 1 つが選択されます。
- レコードにエラーをマークする: レコードは同期されず、エラーとしてマークされます。
- 「一致するものが見つからない場合」ドロップダウンメニューで、値を選択します。
メモ: 選択した値によって、一致するレコードが見つからない場合の対処方法が決まります。「一致するものが見つからない場合」ドロップダウンメニューのオプションは次のとおりです。
- NULL 値の挿入: ターゲットオブジェクトの GSID フィールドに NULL 値が挿入されます。
- レコードを拒否: 特定の記録は考慮されず、却下されます。
- 「完了」をクリックします。検索の定義には、緑色のチェックアイコン (「設定完了」) が表示されます。
- (オプション)「追加」アイコンをクリックして、別の一致条件を追加します。