Job PoDeletePersonsAfterYears

Purpose

The active job deletes person data after a configurable retention period. Depending on the selection, it processes persons that have already been logically deleted or persons with a terminated HR employment status.

Configuration

• Retention period (deletePersonsAfterTerminatedYears): Number of years. The cutoff date is calculated from it daily. Negative values are rejected.
• HR employment selection (useHREmploymentSelection): Processes currently valid, terminated HR employment states before the cutoff date. Persons with a future, non-terminated employment are skipped.
• Without the HR selection, persons whose PoPerson validity has expired are selected from the trash bin.
• Soft Delete (softDelete): Performs a logical deletion if the selection allows it; if deactivated, deletion is physical. With the trash bin selection, a further logical deletion has no effect because the persons are already logically deleted.
• Dry run (dryRun): Logs the intended actions without changing any data.
• Exclusion group (exclusionGroup): Persons with a currently valid membership in this group are skipped.
• E-mail (sendEmail, emailRecipients, emailSubject, emailBody): Optionally sends a summary to the specified recipients. In the script context, the selection is available under persons.

Behavior and security

• The final physical deletion cannot be undone and can remove data from connected systems as well as dependent data.
• Each person is reloaded before deletion; errors for one person are logged and the remaining persons continue to be processed.
• With the HR selection, the selection found is logged or passed on even if e-mail is activated; skipped future employments can be included in the summary.
• Test with dryRun first, check the retention period and exclusion group, and only activate physical deletion after approval.