でのフローの編集 ワークフロースタジオ

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:5分
  • フローを編集して、ページネーションが正しく実装されていることを確認します。これにより、データが正しくインポートされたことを確認できます。

    バッチインポートには次の 4 つの方法があります。
    • なし
    • オフセット
    • 時間ベース
    • トークンベース

    なし バッチインポート

    オートメーションセンター で提供されているページネーション方法を使用しない場合は、[なし] バッチインポート方法を選択します。ここでは必要な手順はありません。

    オフセットベースのバッチインポート

    特定の開始点 (オフセット) とバッチサイズ (制限) を使用してデータをインポートする場合は、オフセットベースのバッチインポート方法 (ページネーション方法) を選択します。

    • オフセット:データのインポートの開始点。
    • 合計アイテム:インポートするレコードの合計数。
    • 制限:各バッチでインポートするレコードの数。

    例:オフセットを 20、合計アイテムを 200、制限を 10 に設定した場合、システムはレコード 20 から始まり、200 レコードすべてがインポートされるまで、データを 10 レコードずつ一括してインポートします。

    設定手順

    1. SourceHub の [オフセットベースのページネーションチャンクを取得] アクションで、 [オフセット] フィールド、 [合計アイテム] フィールド、および [制限] フィールドの値を指定し、 [完了] を選択します。

      値を定義すると、右側のパネル ([For Each] の下) で [chunks_child0] フィールドが使用できるようになります。

    2. [アクションを選択] ステップで選択したアクションについて、SourceHub の [オフセットベースのページネーションチャンクを取得] アクションによって生成されたchunks_child0フィールド出力を使用して、SourceHub からの制限をマッピングします。

      オフセットバッチインポート方法

      制限とオフセットをサポートしないアクションの処理

      SourceHub の [オフセットベースのページネーションチャンクを取得] アクションによって返された出力を使用して、アクションの制限値とオフセット値をマッピングします。

      選択したアクションにオフセットベースのページネーション用の事前定義されたパラメーターがなく、これらのパラメーターに対応できるフィルターが含まれている場合は、次のいずれかを実行できます。

      • オプション 1:選択したアクションの直前にアクションを追加して、制限とオフセットを処理します。このアクションでは、プライマリアクションがデータをフェッチするために使用できるクエリを生成する必要があります。
      • オプション 2:プライマリアクションをコピーして変更し、制限とオフセットの入力を含め、これらの入力を処理してクエリを作成します。このクエリを元のアクションのフィルターに渡します。
      注:
      オプション 2 を選択した場合は、必ず最初に元のアクションのコピーを作成してください。コピー後、[ アクションの選択 ] ステップでコピーしたアクションを再選択し、フローを再生成します。アクションの選択については、「 アクションを選択」を参照してください。
    3. [ 完了 ] と [テスト] を選択します。
    4. データのバッチインポートの構成の手順 3 以降を実行します。

    時間ベースのバッチインポート

    特定の日付範囲のデータをインポートする場合は、時間ベースのバッチインポート方法を選択します。

    設定手順

    1. [SourceHub で日付ベースのページネーションチャンクを取得] アクションで、開始日と終了日を指定し、[完了] をクリックします。

      値を定義すると、右側のパネル の範囲 フィールドが使用可能になります。

    2. [アクションを選択] ステップで選択したアクションについて、SourceHub の [日付ベースのページネーションチャンクを取得] アクションによって生成された範囲フィールド出力を使用して、開始日と終了日の値をマッピングします。

      日付形式

      接続マネージャーは、YYYY:MM:DD:HH:MM:SS という形式の日付を使用して返します。アクションが日付範囲をサポートしている場合、形式は自動的に適用されます。

      日付範囲をサポートしていないアクションの処理

      アクションが日付範囲を自動的にサポートせず、カスタムパラメーターのフィルターが含まれている場合は、次のいずれかの方法を使用できます。
      • オプション 1:選択したアクションの前にアクションを追加して、開始日と終了日を処理します。このアクションでは、プライマリアクションがデータをフェッチするために使用できるクエリを生成する必要があります。
      • オプション 2:プライマリアクションをコピーし、開始日と終了日の入力を含めるように変更します。アクション内でこれらの入力を処理してクエリを作成し、元のアクションのフィルターに渡します。

        時間ベースのバッチインポート

        注:
        オプション 2 を選択した場合は、必ず最初に元のアクションのコピーを作成してください。コピー後、[ アクションの選択 ] ステップでコピーしたアクションを再選択し、フローを再生成します。アクションの選択については、「 アクションを選択」を参照してください。
    3. [ 完了 ] と [テスト] を選択します。
    4. データのバッチインポートの構成の手順 3 以降を実行します。

    トークンベースのバッチインポート

    継続トークンを使用してデータをインポートする場合は、トークンベースのバッチインポート方法を選択します。

    [ バッチインポートを構成 ] ページでトークンベースのバッチインポート方法を選択する場合は、トークンの名前を指定する必要があります。このトークンは、アクションによって返される継続値 (next_url、next_token、next など) を表します。トークン名が、スペルや大文字と小文字の区別など、アクションから返されたとおりに正確に一致していることを確認します。

    トークン名

    設定手順

    1. 指定されたトークン名が正しい場合、do-while 条件によって自動的にマッピングされます。空白のままの場合は、アクションの出力から do-while ロジックの条件フィールドに継続トークンを手動でドラッグします。
    2. トークンの更新された値を保存する文字列タイプの フロー変数 を追加します。
    3. 変更を保存し、[ 完了] をクリックします。
    4. 選択したアクションの後にフロー 変数の設定 ロジックステップを挿入します。このステップでは、新しく作成したフロー変数の値を、アクションによって返された継続トークンに設定します。このトークンが do-while 条件にマッピングされたトークンと一致することを確認してください。

      トークンベースのバッチインポート方法

    5. [ 完了 ] と [テスト] を選択します。
    6. データのバッチインポートの構成の手順 3 以降を実行します。