intra-mart Accel Platform IM-Workflow 仕様書 第36版 2023-10-01

6.1.9.8.5. 一括確認

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

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

6.1.9.8.5.1. HTTP リクエスト

POST /api/workflow/completed-matters-confirm/lump-confirmable/confirm

6.1.9.8.5.2. リクエストボディ

6.1.9.8.5.2.1. JSON

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

6.1.9.8.5.2.2. 詳細

プロパティ名 論理名 必須 デフォルト値 説明
authUserDepartmentInfo 権限ユーザ組織情報 object   REST API内部解決組織情報

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

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

6.1.9.8.5.3. エラーコード

エラーコード エラーメッセージ 備考
1099 一括確認実行パラメータが未指定です。 リクエストボディ - lumpProcessTargetParameters が未指定の場合
7011 一括確認機能は設定により利用できません。管理者に連絡してください。
ワークフローパラメータ 「 lump-confirm一括処理機能・一括確認機能の設定) 」 に false が指定されている場合
1101 一括確認機能の利用可否設定情報の取得に失敗しました。管理者に連絡してください。 上記ワークフローパラメータの取得に失敗した場合
1102 システム案件IDが未指定です。 リクエストボディ  - lumpProcessTargetParameters - systemMatterId が未指定の場合
1103 ノードIDが未指定です。 リクエストボディ  - lumpProcessTargetParameters - nodeId が未指定の場合
1104 組織情報のチェック、または補完に失敗しました。 対象の案件に対するアカウントコンテキストのユーザの所属組織情報取得に失敗した場合
3016 一括確認処理のための情報取得に失敗しました。 対象の案件に関する情報の取得に失敗した場合
3017 一括確認処理に失敗しました。 対象の案件に対する確認処理が失敗した場合
8807 権限者の所属組織情報の取得に失敗しました。 代理元ユーザの組織情報取得処理に失敗した場合
8808 指定された権限者の組織情報が不正です。 指定された権限者の組織情報では該当案件に対する処理権限がない場合