Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
devel:documentation:application_configuration:dev:scheduled_tasks:task-scheduler [2020/05/14 05:37]
kucerar
devel:documentation:application_configuration:dev:scheduled_tasks:task-scheduler [2021/02/22 20:38] (current)
apeterova generate initiliazation vector
Line 31: Line 31:
 === Configuration QUARTZ (datasource, etc.) === === Configuration QUARTZ (datasource, etc.) ===
  
-Configuration of QUARTZ (scheduler) it is using application properties by individual profiles. In every profile application properties is necessary set path for queart's settings (his own application properties) - ''scheduler.properties.location''. Change property ''scheduler.task.queue.process'' **needed server restart!** This property can not be overloaded by FE configuration agenda.+Configuration of QUARTZ (scheduler) it is using application properties by individual profiles. In every profile application properties is necessary set path for quartz's settings (his own application properties) - ''scheduler.properties.location''. Change property ''scheduler.task.queue.process'' **needed server restart!** This property can not be overloaded by FE configuration agenda.
  
  
Line 61: Line 61:
   * ''isRecoverable'' - ''false'' by default. See recoverable task introduction below.   * ''isRecoverable'' - ''false'' by default. See recoverable task introduction below.
  
-<note warning>Look out: when scheduled task is removed, then all item will be processed again! Processed items are linked to scheduled task instance. Prevent to remove tasks, which sends notifications etc. (e.g. passwor exrire warning) - notifications will be send again.</note>+<note warning>Look out: when scheduled task is removed, then all item will be processed again! Processed items are linked to scheduled task instance. Prevent to remove tasks, which sends notifications etc. (e.g. password expire warning) - notifications will be sent again.</note>
  
 ===== Recoverable tasks ===== ===== Recoverable tasks =====
Line 70: Line 70:
  
  
-<note>To enable this feature, task method ''isRecoverable'' has to be overiden and return ''true''.</note>+<note>To enable this feature, task method ''isRecoverable'' has to be overriden and return ''true''.</note>
  
 <note important>Only tasks created and **running** in the version **10.2.0** and higher can be run again!</note> <note important>Only tasks created and **running** in the version **10.2.0** and higher can be run again!</note>
Line 80: Line 80:
 ===== Implemented task types ===== ===== Implemented task types =====
  
-Implemented long running task are listed bellow. Non schedulable long running tasks are included.+Implemented long running task are listed below. Non schedulable long running tasks are included.
  
 ==== PasswordExpirationWarningTaskExecutor ==== ==== PasswordExpirationWarningTaskExecutor ====
Line 94: Line 94:
  
 ==== AccountProtectionExpirationTaskExecutor ==== ==== AccountProtectionExpirationTaskExecutor ====
-Removes accounts with expired protection interval. Account has to have ''inProtection'' flag setted to ''true''.+Removes accounts with expired protection interval. Account has to have ''inProtection'' flag set to ''true''.
  
 ==== RetryProvisioningTaskExecutor ==== ==== RetryProvisioningTaskExecutor ====
Line 119: Line 119:
   * ``Synchronization uuid`` - synchronization configuration to schedule.   * ``Synchronization uuid`` - synchronization configuration to schedule.
  
-==== AddNewAutomaticRoleTaskExecutor ====+==== <del>AddNewAutomaticRoleTaskExecutor</del> ==== 
 + 
 +@deprecated since 10.4.0 - ''ProcessAutomaticRoleByTreeTaskExecutor'' is used from version 10.4.0.
  
 Long running task for add newly added automatic role to users. Can be executed repetitively to assign role to unprocessed identities, after process was stopped or interrupted (e.g. by server restart). Long running task for add newly added automatic role to users. Can be executed repetitively to assign role to unprocessed identities, after process was stopped or interrupted (e.g. by server restart).
Line 132: Line 134:
 === Parameters === === Parameters ===
   * ``roleTreeNode`` - automatic role identifier.   * ``roleTreeNode`` - automatic role identifier.
 +
 +==== ProcessAutomaticRoleByTreeTaskExecutor ====
 +
 +@since 10.4.0
 +
 +Recalculate automatic role by tree structure for contracts and positions. Recalculate roles for identities with contract or other position match selected automatic role by tree structure. Can be executed repetitively to assign role to unprocessed identities, after process was stopped or interrupted (e.g. by server restart).
 +
 +=== Parameters ===
 +  * ``roletreenode`` - automatic roles by tree structure to recount.
 +
 +==== ProcessAllAutomaticRoleByTreeTaskExecutor ====
 +
 +@since 10.4.0
 +
 +Recalculate all automatic roles by tree structure for contracts and positions. Recalculate all roles for identities with contract or other position assigned by automatic role by tree structure. Can be executed repetitively to assign role to unprocessed identities, after process was stopped or interrupted (e.g. by server restart).
 +
 +==== ProcessSkippedAutomaticRoleByTreeTaskExecutor ====
 +
 +@since 10.4.0
 +
 +Recalculate skipped automatic role by tree structure. Recalculate automatic roles by tree structure, which were not processed (skipped) after tree structure was changed (e.g. from synchronization).
 +
 +==== ProcessSkippedAutomaticRoleByTreeForContractTaskExecutor ====
 +
 +@since 10.4.0
 +
 +Recalculate skipped automatic role by tree structure for contracts and other positions. Recalculate automatic roles by tree structure for contracts and other positions, which were not processed (skipped) after work position was changed (e.g. from synchronization).
  
 ==== AddNewRoleCompositionTaskExecutor ==== ==== AddNewRoleCompositionTaskExecutor ====
Line 193: Line 222:
 @since 8.2.0 @since 8.2.0
  
-Change key for crypt confidential storage. Taks can be started after you change key in application properties/file to newer. As parameter will be given old key.+Change key for crypt confidential storage. The task can be started after you change key in application properties/file to newer. As parameter will be given old key. See the [[devel:documentation:adm:confidential_storage#change_the_confidential_storage_key|admin guide]]. 
 + 
 + 
 +==== GenerateConfidentialStorageInitializationVectorsTaskExecutor ====  
 + 
 +@since 10.8.0 
 + 
 +The task processes every value in the confidential storage, generates a new initialization vector and encrypts the value using this new initialization vector. 
 +See the [[devel:documentation:adm:confidential_storage#generate_initialization_vectors|admin guide]]. 
  
 ==== RemoveOldLogsTaskExecutor ==== ==== RemoveOldLogsTaskExecutor ====
Line 226: Line 264:
 @since 9.7.0 @since 9.7.0
  
-Delete sucessfully executed entity events (in the state 'EXECUTED') older than given number of days.+Delete successfully executed entity events (in the state 'EXECUTED') older than given number of days.
  
 === Parameters === === Parameters ===
Line 314: Line 352:
   * ``Workflow definition`` - Delete historic workflow processes with this definition only.   * ``Workflow definition`` - Delete historic workflow processes with this definition only.
  
 +==== VsSystemGeneratorTaskExecutor ====
 +
 +@since 10.4.0
 +
 +Task generates given number of virtual systems, roles and identities. All generated entities are evenly distributed among themselves. I.e. Roles assigned to users and connected to generated systems. Task serves for generating required scenario and following performance test.
 +
 +=== Parameters ===
 +  * ``Item prefix`` - A name prefix of all generated entities. Serves for easier searching of entities in IdM.
 +  * ``System count`` - Number of generated virtual systems.
 +  * ``Role count`` - Number of generated roles.
 +  * ``User count`` - Number of generated identities.
  
 ===== Testing tips ===== ===== Testing tips =====
  • by kucerar