Work Definition (Types of Activities)

Last modified 26 Nov 2021 15:40 +01:00

This section defines what the activity should do (i.e. the action) and on what items (the item set). As of midPoint 4.4, the following items are supported (MT means "Supports multi-threading", MN means "Support multi-node operation"):

Item Meaning Activity type MT MN Parameter Meaning Default

recomputation

Recomputes specified objects.

Simple

Y

Y

objects

What objects to recompute.

All of AssignmentHolderType.

executionOptions

What options to use.

reconcile

import

Imports specified resource objects.

Simple

Y

Y

resourceObjects

What resource objects to import.

This is obligatory parameter.

reconciliation

Reconciles specified resource objects.

Predefined composite

Y

Y

resourceObjects

What resource objects to reconcile.

This is obligatory parameter.

asynchronousUpdate

Processes asynchronous updates for given resource objects (EXPERIMENTAL).

Simple

Y

N

updatedResourceObjects

What resource objects to receive updates for. (Not all configuration items are supported - TODO.)

This is obligatory parameter.

liveSynchronization

Processes live synchronization events for give resource objects.

Simple

Y

N

resourceObjects

What resource objects to synchronize.

This is obligatory parameter.

batchSize

See Live Synchronization.

0

updateLiveSyncTokenInDryRun

See Live Synchronization.

false

cleanup

Cleans up obsolete objects: audit records, closed tasks, closed cases, closed certification campaigns, output reports, and dead nodes.

Predefined composite

N

N

policies

Cleanup policies to be used. (Specifying typically max. age and/or max. number of records to keep.)

Global cleanup policies defined in the system configuration.

reportExport

Exports any report in a "classical" way. (Does not support bucketing.)

Simple

Y

N

reportRef

Definition of the report.

Obligatory.

reportParam

Definition of the report parameters.

No parameters.

distributedReportExport

Exports a report on repository objects or audit records.

Predefined composite

Y

Y

reportRef

Definition of the report.

Obligatory.

reportParam

Definition of the report parameters.

No parameters.

reportImport

Imports a report.

Simple

Y

N

reportRef

Definition of the report.

Obligatory.

reportParam

Definition of the report parameters.

No parameters.

reportDataRef

Report data to be imported.

Obligatory.

iterativeScripting

Executes a script (a.k.a. bulk action) over a set of objects.

Simple

Y

Y

objects

What objects to process.

All objects in repo.

scriptExecutionRequest

Script to execute (ExecuteScriptType). Contains scripting expression, options, and variables. Note: input can be set, but it is ignored.

Obligatory.

nonIterativeScripting

Executes a script (a.k.a. bulk action) on an empty or explicitly specified input. NOTE: not implemented yet, but hopefully will be in 4.4.

Simple

N

N

scriptExecutionRequest

Script to execute (ExecuteScriptType). Contains scripting expression, input, options`, and variables.

Obligatory.

focusValidityScan

Executes validity scan on focal objects. Works in one of two modes:

In standard mode it recomputes all objects that have at least one validity interval (validFrom/validTo for object or any of its assignments) falling into an interval of (lastScanTimestamp, currentTime], where lastScanTimestamp is the timestamp of last executed scan.

In custom validity constraint mode, it looks for objects that have specified property fall between (lastScanTimestamp-offset, currentTime-offset] where offset is a value given in the explicit validity constraint (the activateOn value). It recomputes these objects, with the explicitly added triggered validity policy rule. Note that this is an experimental functionality.

Predefined composite

Y

Y

objects

What objects to scan. If a query is present, the filter computed by the activity is added to it (as a conjunction).

All of FocusType.

queryStyle

How to find the objects: singleQuery - issues a single (combined) query, looking for objects and their assignments, or separateObjectAndAssignmentQueries - issues two queries: one for objects, another for assignments. The latter runs in two separate sub-activities.

singleQuery

validityConstraint

Custom validity constraint. See above.

None.

triggerScan

Executes trigger scan on repository objects. Invokes trigger handlers for any triggers that have fire time less than or equal currentTime. (Unlike validity scanner, this one intentionally ignores lastScanTimestamp.)

Simple

Y

Y

objects

What objects to scan. If a query is present, the filter computed by the activity is added to it (as a conjunction).

All of ObjectType.

shadowRefresh

Looks for pending operations in shadows and updates their status.

Simple

Y

Y

shadows

What shadows to process. If a query with filter is present, it replaces the default query. If a query without filter is present, the default filter is "implanted" into it (reusing e.g. the ordering).

All shadows with pending operations.

changeExecution

Executes specified changes on specified objects.

Simple

Y

Y

objects

What objects to process.

All of ObjectType (can be dangerous!)

delta

What delta to apply.

Obligatory.

executionOptions

What execution options to use.

Default execution options.

reindexing

Re-indexes specified repository objects.

Simple

Y

Y

objects

What objects to reindex.

All of ObjectType.

shadowCleanup

Deletes all shadows that have not been updated for given time. (I.e. their fullSynchronizationTimestamp is either null or less or equal "current time - specified interval".)

Simple

Y

Y

shadows

What shadows to check. The task works only if given resource is not in maintenance mode. If a query is specified, it is always appended to the default time-scanning query.

Obligatory.

interval

How "stale" must be a shadow to be deleted.

Obligatory.

objectIntegrityCheck

x

Simple

N

N

x

x

x

shadowIntegrityCheck

x

Simple

N

N

x

x

x

activityAutoScaling

x

Simple

Y

Y

x

x

x

noOp

x

Simple

Y

Y

x

x

x

extension

x

Simple

-

-

x

x

x