EARevokeApproval

This document was generated using Claude.ai

Overview

Revokes approval for entities currently in approval workflows. Can target the current entity, entities referenced through fields, or entities found by SQL query. Includes safety checks to prevent revoking partially completed approvals.

When This Action Runs

Manual execution when approval workflows need to be reset, cancelled, or restarted due to data changes, errors, or business process requirements.

How It Works

  1. Determines target entities - Current entity (if no parameters), entities from reference field, or entities from SQL query
  2. Validates approval state - Ensures entities are currently in active approval cycles
  3. Checks partial approvals - Prevents revoking approvals that have already been partially processed (unless forced)
  4. Revokes approval - Calls EntityMediator.revokeApproval() to reset approval workflow
  5. Handles multiple entities - Processes all target entities with individual validation

Parameters

Parameter 1: Field Name (Optional) - Field ID pointing to entities to revoke approval for (can be in detail collections)

Parameter 2: Finder query (Optional) - SQL query returning entityType and id/code columns

  • Example Query:
select entityType,id from SalesInvoice where ref1Id = {id} and documentFileStatus = 'ApprovalPending'

Parameter 3: Force Revoke Partially Approved (Optional) - true to allow revoking approvals with existing approval steps (default: false)

Database Tables Affected

  • Approval Case Tables - Resets current approval case and workflow state
  • Approval Step Tables - May clear existing approval steps
  • Entity Status Fields - Updates entity approval status and workflow state
  • Query Target Tables - Reads from tables specified in finder query

Module: core

Full Class Name: com.namasoft.infor.domainbase.util.actions.EARevokeApproval