アップロードの共通上限と結果保持を設定する

1. このページで伝える機能

ファイルを使った一括登録・更新について、共通の容量・行数・列数・エラー収集数・処理時間・同時実行数を設定できます。待機時間と処理結果の保持期間も共通で決めます。

2. Wagby11で実現できること

2.1 受け付けるファイルと処理量を制限する

ファイルの受け付けと登録・更新の成功は別です。検証だけを行うモードや、エラー時の反映方針はアップロードの定義で指定します。

2.2 共通上限とアップロード定義ごとの上限を組み合わせる

モデル内のアップロード定義ごとにlimitsを指定します。ファイル容量・行数・列数・最大エラー数・処理時間は、共通設定と個別設定の小さい方が実効上限になります。個別値で共通上限を引き上げることはできません。

例えば共通が10万行、在庫取り込みが1000行なら、その取り込みは1000行までです。共通上限を増やすだけでは個別の1000行は増えません。逆に共通を500行へ下げると、その取り込みも500行までになります。

個別上限の省略はできません。共通値を使う場合も、個別定義の5項目をすべて指定します。省略すると生成前の検証でエラーになります。同時実行数・待機時間・終了結果の保持期間は共通設定です。

個別設定の方法、AIへの指示例、AppSchemaの抜粋は、アップロード定義ごとの上限を参照してください。

2.3 待機時間と終了後の保持期間を分ける

待機の上限は、ジョブが処理を開始するまで待てる時間です。処理の制限時間とは別です。結果の保持期間は、終了したジョブの結果を残す期間です。例えば待機1時間、処理10分、終了後の結果を7日間保持する構成にできます。

期間はPT1Hが1時間、PT10Mが10分、P7Dが7日です。結果を後で照会する業務では、利用者が確認するまでの時間を考慮して保持期間を決めます。

3. AIへの指示例

最小限の指示例

アップロードの共通上限を設定し、結果を7日間確認できるようにしてください。

AIは既存の個別上限、ファイルの規模、許容する待機時間と処理時間を類推します。容量・行数・列数や同時実行数も指定すると、個別定義との調整ができます。短い指示だけで、次の詳細例と同じ設定になるとは限りません。

より詳細な指示例

Wagby11のguideと必要なreferenceを確認してください。
environment.uploadは100 MiB、10万行、200列、エラー収集1万件、処理10分、同時4件、待機1時間、終了結果の保持7日としてください。
各アップロード定義のlimitsを保持し、ファイル容量・行数・列数は共通と個別の小さい方が有効になることを確認してください。共通10万行・個別1000行の例を説明してください。個別limitsの5項目は省略せず、エラー数・処理時間も共通との小さい方を使います。既存の入力形式、検証・反映方針、権限は保持してください。
既存のenvironment全体を置き換えず、必要な項目を編集してください。設定の検証・生成と必要なサービスの再起動を行い、変更内容と確認結果を説明してください。

4. 編集されるAppSchemaの例

次は共通設定の抜粋です。設定名を覚えなくても、必要な動作や上限をAIへ伝えられます。既存のenvironment内へ追加・編集し、他の共通設定を保持します。

environment:
  upload:
    max_file_size_bytes: 104857600
    max_rows: 100000
    max_columns: 200
    max_errors: 10000
    max_processing_time: PT10M
    max_concurrent: 4
    result_retention: P7D
    max_queue_time: PT1H

5. 参考資料

guide：環境

designer/docs/appschema/html/guide/02-environment/01-appschema-environment.html

reference：AppSchema全体構成

designer/docs/appschema/html/reference/02-root-schema.html

guide：アップロード更新の概要

designer/docs/appschema/html/guide/09-data-transfer/08-upload-update-overview.html