Job Create Reallocations

The Create Reallocations job automatically creates an account correction workflow process for selected active persons. The first work step of the generated process is accepted immediately. This allows, for example, reallocations or overtime payouts to be processed according to the workflow defined in the process.

Prerequisites

  • The TA and Workflow modules must be active.
  • A current process definition configured as an account correction process must be selected. The process definition provides, among other things, the account, correction type, and minimum and maximum values.
  • The persons to be processed must be active users and have a TA ID. Persons without a TA ID are skipped.
  • The accounts referenced in the process definition must be valid if minimum or maximum values are read from accounts.

Process

  1. The job determines the target or proposal date.
  2. It reads the selected groups from the configuration and derives the persons from them. The client selection in the form serves to restrict the available groups; the groups subsequently selected are processed.
  3. Persons for whom a matching open or completed process already exists for the same process definition and the same target date are not processed again. If a person is contained in multiple selected groups, they are only considered once.
  4. For each remaining person, the account values described in the process definition are read. By default, a process is only created if the minimum value is less than or equal to the maximum value.
  5. After successful creation, the first activity is accepted automatically. If mail notification is enabled, a mail is then sent to the affected person.

Job configuration

Process Link to the current process definition to be used. For this job, the definition must contain the information required for an account correction.
Reference date Optional date in the format dd.MM.yyyy. If set, this date is used for determining account values and creating the process.
Ignore min value from process If enabled, the check whether the minimum value is greater than the maximum value is skipped. The value determined from the process definition is still used as the account value; if the process definition allows null values, the account value is set to null.
Default comment value Text that is used as the default description in the generated account correction process.
Client Determines, per selection row, from which client the available groups are offered. The client itself is not the actual processing selection.
Groups Groups whose active persons are to be processed. Multiple combinations of client and groups can be recorded via Add selection.
Send mail to affected person? If enabled, a mail is sent to the e-mail address stored for the person after successful process creation. Without an e-mail address, no mail is sent.
Mail subject and Mail content Subject and HTML content of the notification. The job passes the content directly as the mail text; automatic replacement of placeholders is not provided in the job.

Date logic

If the reference date is left empty, the job uses the date default of the selected process definition. In the code, the defaults ultimoLastQuarter, ultimoLastMonth and yesterday are implemented. An unrecognized or missing default falls back to the current date.

The group assignment is determined using the current execution date, independent of the reference date. The reference date therefore controls the account value determination and process creation, not the selection of group members.

Operational notes

  • The job can be run repeatedly. For the same person, process definition and target date, no further matching process is created.
  • Persons without a TA ID, as well as persons for whom the value check is not satisfied, are skipped.
  • Errors during the processing of an individual person are logged; processing of the remaining persons continues. If processes are missing, check the job log and the configuration of the process definition.

Felder

NameWert
ModulTime & Attendance (ta)
Webdesk ActionnamecreateRebookings
Artefakt-TypJob
Kommentare (0)