Skip to content

Attribute delete constructor

Ryan Newington edited this page Sep 4, 2025 · 7 revisions

Attribute Delete Constructor

The Attribute Delete Constructor provides comprehensive attribute value removal functionality within the ACMA framework. This constructor offers the simplest and most direct approach to clearing all values from specified attributes, making it essential for data cleanup, status resets, and conditional attribute clearing operations.

Purpose and Capabilities

The Attribute Delete Constructor enables:

  • Complete attribute clearing: Remove all values from single or multi-valued attributes
  • Conditional deletion: Clear attributes based on business rules and object states
  • Data lifecycle management: Support object state transitions requiring attribute resets
  • Cleanup operations: Remove obsolete or invalid attribute values
  • Security clearing: Clear sensitive attributes when access changes

Configuration Parameters

Basic Constructor Settings

Constructor Identity

  • Constructor ID: Unique identifier across entire ACMA configuration
  • Format: Alphanumeric characters (A-Z, 0-9) and hyphens (-) only
  • Best practice: Use descriptive names like clear-temp-access or reset-assignment

Administrative Controls

  • Description: Document constructor purpose, business rules, and usage context
  • Disable Constructor: Temporarily disable without removing configuration

Target Configuration

Target Attribute

  • Scope: Any attribute bound to current object class
  • Flexibility: Single-valued or multi-valued attributes supported
  • Data types: String, integer, reference, binary, boolean attributes

Modification Behavior

  • Operation: Deletes all values present in target attribute
  • Scope: Complete attribute clearing, not selective value removal
  • Result: Attribute becomes empty/null after execution

Important Usage Distinction

Complete vs. Selective Deletion

  • Attribute Delete Constructor: Removes ALL values from an attribute
  • Selective deletion: Use Declarative value constructor with delete operation
  • Use case guidance: Choose based on whether you need complete clearing or specific value removal

When to Use Each Approach

Complete Clearing (Attribute Delete Constructor):
✅ Reset all group memberships during role change
✅ Clear all temporary permissions
✅ Remove all project assignments at termination
✅ Clear all access rights during department transfer

Selective Removal (Declarative Value Constructor):
✅ Remove specific group membership
✅ Delete particular access right
✅ Remove individual project assignment
✅ Clear specific temporary permission

Practical Implementation Examples

Employee Termination Cleanup

Purpose: Clear sensitive attributes when employee terminates
Target Attributes: manager, department, accessRights, projects
Execution Condition: employeeStatus = "Terminated"
Business Rule: Remove all organizational relationships and access

Role Change Preparation

Purpose: Clear role-specific attributes before new role assignment
Target Attributes: rolePermissions, departmentAccess, teamMemberships
Execution Condition: roleChangeRequested = true
Business Rule: Clean slate for new role assignment

Clone this wiki locally