Gainsightバルク API

ジョブの詳細

「ジョブの詳細」セクションには、次の情報が表示されます。

1. 接続: 接続の名前が表示されます。
2. コネクタ: コネクタ名が表示されます。
3. ジョブ名: 一意のジョブ名を入力します。
4. 通知の受信者: 通知受信者に、次の情報を入力します。
   • 成功者: ジョブのデータインポートの一部または全部が成功すると、ここに入力したメールアドレスに成功通知メールが送信されます。
   • 失敗した受信者: すべてのレコードのインポートに失敗すると、ここに入力したメールアドレスに失敗通知メールが送信されます。
     
     メモ: 複数のメールをカンマで区切って受信者リストに追加できます。
5. 「保存」をクリックします。
   
   メモ: システムは、同じ名前のすべてのジョブを検証します。重複するジョブ名が見つかると、「ジョブ名は既に存在します」というエラーが表示されます。常に一意のジョブ名を割り当ててください。

CSV ファイルから Gainsight オブジェクトにデータを取り込む

タスク作成プロセスを完了するには、CSV 列と Gainsight オブジェクトフィールドをマッピングする必要があります。この例では、レコードは CSV ファイル CompanyDetails.csv から企業オブジェクトに抽出されます。

例として、名前、業種、従業員、当初の契約日、更新日、ARR、CSMFirstName、CSMLastNameというヘッダーが付いたCSVファイル内のレコードを以下に示します。

メモ: このドキュメントで使用されている名前、レコード、およびアクセスキーは参照用です。

メモ:

• CSV ファイル名にスペースが含まれていないことを確認します。
• CSM のファーストネームとラストネームは、派生マッピングで使用できるようにここに追加されています。

CSVファイルの日付と日時の値の形式がGainsightでサポートされていることを確認してください。Gainsightでサポートされているフォーマットのリストについては、この記事の最後にある「追加リソース」セクションにある「データ管理の基本操作」を参照してください。

管理者は複数のジョブを作成してデータをオブジェクトに取り込むことができます。

フィールドマッピング

[フィールドマッピング] をクリックしてセクションを展開し、次の詳細を入力します。

1. ターゲットオブジェクト: 「ターゲットオブジェクト」ドロップダウンリストから、データを抽出するターゲットオブジェクトを選択します。たとえば、「会社オブジェクト」を選択します。特定の Target Object でジョブを保存すると、データを取り込む前にジョブを変更することはできません。
2. BROWSE をクリックして、ローカルマシンから CSV ファイルを選択します。このセクションのCSVファイルは、CSVヘッダーとGainsightオブジェクトフィールド間のマッピングを選択するためにアップロードされます。
   
   メモ:
   • CSV ファイルにヘッダーがあることを確認します。
   • 最大サイズが 1MB の CSV ファイルをロードできます。
3. データロード操作: 必要なデータロード操作を選択します。それぞれの操作で、[アップサート]、[更新]、または [挿入] を選択します。
4. Upsert と Update では、+ アイコンをクリックして識別子として使用できるキーフィールドを設定します。
5. CSV プロパティ: 適切な CSV プロパティを選択します。推奨される CSV プロパティ:
   1. 文字エンコーディング: UTF-8。
   2. セパレーター: , (カンマ)
   3. 引用文字: 「(二重引用符)
   4. エスケープ・チャー: バックスラッシュ
   5. ヘッダー行: 1 (必須)
   6. 複数選択セパレータ: ; (セミコロン)
      
       注:
      • Gainsight バルク API は常に UTF-8 でエンコードされたファイルのみをサポートします。
      • セパレータは、CSV 内のさまざまなフィールドの値を区切るために使用されます。ユーザーは、アップロードする CSV ファイルで使用されているジョブ設定と同じ区切り文字を使用する必要があります。デフォルトでは、(カンマ) が区切り文字として選択されていますが、ユーザーは必要に応じて変更できます。
      • 引用文字は、データをインポートする際に、見積書で指定された値を (特殊文字と一緒に) インポートするために使用されます。アップロードする CSV ファイルで使用されているジョブ設定と同じ引用符文字を使用することを推奨します。デフォルトでは、タスク設定では二重引用符が選択されていますが、ユーザーは必要に応じて一重引用符に変更できます。
      • エスケープ文字は、値に特殊文字を含めるために使用されます。デフォルトでは、バックスラッシュは値の特殊文字の前のエスケープ文字として使用されます。ロード後のデータに不一致が生じないように、CSV ファイルではバックスラッシュを使用することをお勧めします。
      • 複数選択セパレータは、データタイプの複数選択ドロップダウンリストのフィールドの複数の値を区切るために使用されます。ユーザーは、アップロードする CSV ファイルで使用されているのと同じ複数選択区切り文字を使用する必要があります。デフォルトでは、; (セミコロン) が区切り文字として選択されていますが、ユーザーは必要に応じて変更できます。
6. 「マッピングを取得」をクリックします。フィールドが正常に取得されたことを示す成功メッセージが表示されます。

「マッピング」タブと「ルックアップマッピング」タブが表示されます。