intra-mart Accel Platform IM-Workflow 仕様書 第37版 2024-04-01

6.1.9.2.9. 一括処理

未完了案件の一括処理を実行します。
このAPIは ProcessManager#approve の動作に基づきます。
指定された処理情報の件数分、内部で上記APIを実行しています。

以下の場合は対象の案件情報に対する処理をスキップします。
  • システム案件ID、ノードIDに対する情報が存在しない
  • システム案件ID、ノードIDに対する処理権限を有していない
  • システム案件ID、ノードIDに対して、フロー設定の処理種別「承認」の処理許可がされていない
  • システム案件ID、ノードIDに対して、フロー設定の機能設定「一括承認」が無効

6.1.9.2.9.1. HTTP リクエスト

POST /api/workflow/active-matter-tasks/lump-approvals/approve

6.1.9.2.9.2. リクエストボディ

6.1.9.2.9.2.1. JSON

{
  "authUserCd": "string",
  "authUserDepartmentInfo": {
    "companyCd": "string",
    "departmentCd": "string",
    "departmentSetCd": "string"
  },
  "lumpProcessTargetParameters": [
    {
      "nodeId": "string",
      "systemMatterId": "string"
    }
  ],
  "processComment": "string"
}

6.1.9.2.9.2.2. 詳細

プロパティ名 論理名 必須 デフォルト値 説明
authUserCd 処理権限者コード string   アカウントコンテキストのユーザコード 未指定の場合、内部で値を解決します。
authUserDepartmentInfo 権限ユーザ組織情報 object   REST API内部解決組織情報

未指定の場合、以下の優先順位 (処理可能な組織に基づく)で内部で組織情報を解決します。

  1. ユーザコンテキストのカレント組織(代理時は利用しない)
  2. 主所属
  3. 処理可能な組織の先頭(処理対象者プラグインの実装に依存する)
- companyCd 会社コード string 必須 - 権限ユーザ組織情報を指定する場合は必須です。
- departmentSetCd 組織セットコード string 必須 - 権限ユーザ組織情報を指定する場合は必須です。
- departmentCd 組織コード string 必須 - 権限ユーザ組織情報を指定する場合は必須です。
lumpProcessTargetParameters 一括処理対象情報 array<object> 必須 -  
- nodeId ノードID string 必須 -  
- systemMatterId システム案件ID string 必須 -  
processComment 処理コメント string    

6.1.9.2.9.3. エラーコード

エラーコード エラーメッセージ 備考
0024 案件の処理権限チェックに失敗しました。 対象の案件に対する処理権限チェックに失敗した場合
1087 一括処理実行パラメータが未指定です。 リクエストボディ または リクエストボディ - lumpProcessTargetParameters が未指定の場合
1090 フロー設定のチェックに失敗しました。 対象ノードの有効処理種別確認のためのフロー設定情報取得に失敗した場合
1096 システム案件IDが未指定です。 リクエストボディ - lumpProcessTargetParameters - systemMatterId が未指定の場合
1097 ノードIDが未指定です。 リクエストボディ - lumpProcessTargetParameters - nodeId が未指定の場合
1089 組織情報のチェック、または補完に失敗しました。 処理権限者として指定したユーザの未完了案件に対する処理権限者の所属組織情報取得に失敗した場合
3022 一括処理の実行に失敗しました。 対象の案件に対する承認処理が失敗した場合
7008 一括処理機能は設定により利用できません。管理者に連絡してください。 ワークフローパラメータ 「 lump-processing一括処理機能・一括確認機能の設定) 」 に false が指定されている場合
7009 一括処理機能の利用可否設定情報の取得に失敗しました。管理者に連絡してください。 上記ワークフローパラメータの取得に失敗した場合
8807 権限者の所属組織情報の取得に失敗しました。 代理元ユーザの組織情報取得処理に失敗した場合
8808 指定された権限者の組織情報が不正です。 指定された権限者の組織情報では該当案件に対する処理権限がない場合