REST (統合ハブ) タイプのデータソースを作成する

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分
  • [REST (IntegrationHub)] タイプのデータソースレコードを作成して、インポートセットが REST API からインポートする必要のあるデータを定義します。

    始める前に

    必要なロール:import_admin および action_designer

    手順

    1. 移動先 すべて > システムインポートセット > 管理 > データソース.
    2. [新規] をクリックします。
    3. フォームに入力します。
      フィールド 説明
      名前 このデータソースの一意の名前。
      インポートセットテーブルラベル 使用するインポートセットステージングテーブルのラベル。
      インポートセットテーブル名 Now Platform は、入力したラベルを使用して一意のテーブル名を作成します。これにより、既存のテーブルとの名前空間の衝突が防止されます。
      タイプ REST (IntegrationHub)
      フォーマット 次のいずれかの形式:カスタム (スクリプトによる解析)、JSON、または XML。
      バッチインポートを使用 選択した場合、[データのロード] または [20 件のレコードのテストロード] をクリックしたときにデータのロードをバッチ処理する必要があることを指定します。
      バッチサイズ バッチの大きさを指定します。[バッチインポートを使用] フィールドが選択されている場合にのみ表示されます。
      glide.import_set_load_usebatch および glide.import_set_load_batch_size プロパティは、これらのフィールドに影響します。プロパティとフィールドの優先順位は次のとおりです。プロパティが設定されている場合は、プロパティ値を使用します。そうでない場合は、フィールド値を使用します。どちらのプロパティも設定されていない場合は、デフォルトのバッチサイズである 1000 を使用します。
      • たとえば、glide.import_set_load_usebatch = trueglide.import_set_load_batch_size = 200 の場合、フィールド値に関係なくバッチサイズとして 200 を使用します。
      • たとえば、 glide.import_set_load_usebatch = trueglide.import_set_load_batch_size プロパティが設定されていない場合は、デフォルトのバッチサイズである 1000 を使用します。
      • たとえば、 glide.import_set_load_usebatch プロパティが設定されておらず、[バッチインポートを使用] フィールド = true の場合、[バッチサイズ] フィールド値 (または [バッチサイズ] フィールド値が設定されていない場合はデフォルトの 1000) を使用します。
      • たとえば、glide.import_set_load_usebatch プロパティ= false で、[バッチインポートを使用] フィールド = true の場合、プロパティが false に設定されているため、バッチインポートは使用しません。
      要求アクション データを取得するために呼び出されるデータソース要求アクション。公開された要求アクションのみを選択できます。

      下のダイアログボックスのリンクをクリックして、統合ハブ で新しいデータソース要求アクションを作成/構成します。要求アクションが 統合ハブで公開された後、それをデータソースレコードの要求アクションとして選択できます。詳細については、「アクションプロパティを定義する」を参照してください。

      ページネーションのサポート 要求アクションのページネーションを有効にする場合に選択します。ページネーションを使用すると、すべてのレコードを一度に処理するのではなく、一度に指定した数のレコードを処理することで、処理のオーバーヘッドを削減できます。
      制限 ページあたりの最大レコード数。たとえば、一度に 50 のレコードを処理するには、[制限] に 50 を入力します。
      オフセット ページネーションに使用された初期オフセット。オフセットは開始レコード番号です。たとえば、一度に 50 のレコードを処理するには、最初のレコードから開始して、[制限] に 50、[オフセット] に 0 を入力します。
      解析スクリプト 単一行の入力を解析するために使用されるスクリプトを入力します。この関数では、次の 3 つのパラメーターを使用できます。
      • line:スクリプトによって解析される現在の行
      • lineNumber:応答ペイロード全体の現在の行番号
      • result:出力結果
      各行のパス インポートセットテーブルで行となる JSON オブジェクトの選択に使用するパス式。JSON オブジェクトのパスは // にする必要があります。
      配列を破棄 JSON アレイを値として破棄する場合に選択します。JSON アレイを値としてシリアル化する場合に選択解除します。
      拡張ノード子 XML ノードまたは JSON オブジェクトの子要素を追加の列に変換する必要がある場合に選択します。親列の値を XML または JSON フラグメントにする必要がある場合に選択解除します。JSON の場合、このオプションを選択すると、オブジェクトのみが展開され、アレイは展開されないことに注意してください。ネストされたアレイのサポートについては、「JSON ファイルのインポート例」を参照してください。
      単一列のデータ 単一列にデータを格納する場合に選択されます。
      各行の XPath インポートテーブルの行となるノードを選択する XPath 式。選択したノードの子が行の列になります。
    4. [送信] をクリックします。

    次のタスク

    新しいデータソースの変換マップを定義し、インポートを実行します。