メインコンテンツへスキップ

概要

処理が完了した複数画像クロップタスクにおいて、クロップされた子ファイルのカテゴリが不正確な場合、カテゴリ修正 API を使用してクロップファイルのカテゴリを変更できます。
この API は、複数画像クロップタスク(task_type = 2、親タスク)によって生成された子ファイルのカテゴリを変更するために使用します。事前に親タスクの task_id と子タスクの crop_child_task_id を取得する必要があります。

利用シーン

  1. クロップカテゴリの修正:自動クロップ後、一部の子ファイルのカテゴリ認識が不正確で、手動で修正が必要な場合
  2. カテゴリの調整:業務要件が変更され、クロップされたファイルの再分類が必要な場合

API エンドポイント

エンドポイント: POST /api/app-api/sip/platform/v2/file/amend_category

リクエストパラメータ

crop_tasks パラメータ説明

パラメータ説明

  • task_id:親タスク ID(task_type = 2)。file/fetch API を通じて取得できます
  • crop_child_task_id:子タスク ID(task_type = 3)。child_files から取得できます
  • category:新しいファイルカテゴリ名。DocFlow ワークスペースで設定済みのファイルカテゴリである必要があります

サンプルコード

親タスク ID と子ファイル情報の取得

ファイルカテゴリを変更する前に、親タスクの task_id と子ファイルの crop_child_task_id を取得する必要があります。file/fetch API で確認できます。

レスポンス

ファイルカテゴリの変更が成功すると、API は成功レスポンスを返します。

完全な例

以下は、複数画像クロップタスク情報を確認し、子ファイルのカテゴリを変更する完全な例です:
Python

子タスク ID に関する注意事項

  • crop_child_task_id は子タスクの task_id です。file/fetch API が返す child_files から取得できます
  • 複数画像クロップによって生成された各子ファイルには一意の task_id があります
  • 子ファイルの task_type3 で、複数画像クロップによって生成されたことを示します

注意事項

  1. タスクタイプの制限:複数画像クロップの親タスク(task_type = 2)のみ crop_tasks パラメータの使用に対応しています
  2. カテゴリが存在すること:指定する category は DocFlow ワークスペースで設定済みである必要があります。そうでない場合、エラーが返されます
  3. カテゴリ名の一致:カテゴリ名は設定された内容と完全に一致する必要があります(大文字・小文字を区別)
  4. 子タスク ID が有効であることcrop_child_task_id が有効な子タスク ID であることを確認してください
  5. 変更後の再処理:ファイルカテゴリを変更すると、システムは新しいカテゴリに従ってデータを再処理します