ILIAS  release_8 Revision v8.24
ilUICoreSetupAgent Class Reference

Class ilUICoreSetupAgent. More...

+ Inheritance diagram for ilUICoreSetupAgent:
+ Collaboration diagram for ilUICoreSetupAgent:

Public Member Functions

 hasConfig ()
 Does this agent require a configuration? More...
 
 getArrayToConfigTransformation ()
 Agents must be able to tell how to create a configuration from a nested array.
Exceptions
LogicExceptionif Agent has no Config
More...
 
 getInstallObjective (Config $config=null)
 Get the goals the agent wants to achieve on setup.The provided configuration is to be used to set according configuration values in the installation.
Exceptions
InvalidArgumentExceptionif Config does not match the Agent..
More...
 
 getUpdateObjective (Config $config=null)
 Get the goal the agent wants to achieve on update.The provided configuration is to be used to change according configuration values in the installation. If this is not possible for some reason, an according UnachievableException needs to be thrown in the according objective.The configuration is not to be used to initialize the required environment for the objectives. This must be done via ClientIdReadObjective and depending objectives like ilIniFilesLoadedObjective.If no configuration is provided the configuration of the component should stay as is.
Exceptions
InvalidArgumentExceptionif Config does not match the Agent..
More...
 
 getBuildArtifactObjective ()
 Get the goal the agent wants to achieve to build artifacts.
Exceptions
InvalidArgumentExceptionif Config does not match the Agent.
More...
 
 getStatusObjective (Storage $storage)
 
 getMigrations ()
 @inheritDoc More...
 
 getNamedObjectives (?Config $config=null)
 @inheritDoc More...
 
- Public Member Functions inherited from ILIAS\Setup\Agent
 hasConfig ()
 Does this agent require a configuration? More...
 
 getArrayToConfigTransformation ()
 Agents must be able to tell how to create a configuration from a nested array. More...
 
 getInstallObjective (Config $config=null)
 Get the goals the agent wants to achieve on setup. More...
 
 getUpdateObjective (Config $config=null)
 Get the goal the agent wants to achieve on update. More...
 
 getBuildArtifactObjective ()
 Get the goal the agent wants to achieve to build artifacts. More...
 
 getStatusObjective (Metrics\Storage $storage)
 Get the objective to be achieved when status is requested. More...
 
 getMigrations ()
 Get a named map of migrations available for this Agent. More...
 
 getNamedObjectives (?Config $config=null)
 Gets all named objectives The keys of the returned array are the commands. More...
 

Detailed Description

Member Function Documentation

◆ getArrayToConfigTransformation()

ilUICoreSetupAgent::getArrayToConfigTransformation ( )

Agents must be able to tell how to create a configuration from a nested array.

Exceptions
LogicExceptionif Agent has no Config

Implements ILIAS\Setup\Agent.

Definition at line 34 of file class.ilUICoreSetupAgent.php.

35 {
36 throw new LogicException(self::class . " has no Config.");
37 }
A transformation is a function from one datatype to another.

◆ getBuildArtifactObjective()

ilUICoreSetupAgent::getBuildArtifactObjective ( )

Get the goal the agent wants to achieve to build artifacts.

Exceptions
InvalidArgumentExceptionif Config does not match the Agent.

Implements ILIAS\Setup\Agent.

Definition at line 60 of file class.ilUICoreSetupAgent.php.

60 : Objective
61 {
62 return new ObjectiveCollection(
63 'buildIlCtrlArtifacts',
64 false,
68 );
69 }
A objective collection is a objective that is achieved once all subobjectives are achieved.
Class ilCtrlSecurityArtifactObjective.
An objective is a desired state of the system that is supposed to be created by the setup.
Definition: Objective.php:31

Referenced by getNamedObjectives().

+ Here is the caller graph for this function:

◆ getInstallObjective()

ilUICoreSetupAgent::getInstallObjective ( Config  $config = null)

Get the goals the agent wants to achieve on setup.The provided configuration is to be used to set according configuration values in the installation.

Exceptions
InvalidArgumentExceptionif Config does not match the Agent..

Implements ILIAS\Setup\Agent.

Definition at line 42 of file class.ilUICoreSetupAgent.php.

42 : Objective
43 {
44 return new NullObjective();
45 }
A non-objective, nothing to do to achieve it...

◆ getMigrations()

ilUICoreSetupAgent::getMigrations ( )

@inheritDoc

Implements ILIAS\Setup\Agent.

Definition at line 82 of file class.ilUICoreSetupAgent.php.

82 : array
83 {
84 return [];
85 }

◆ getNamedObjectives()

ilUICoreSetupAgent::getNamedObjectives ( ?Config  $config = null)

@inheritDoc

Implements ILIAS\Setup\Agent.

Definition at line 90 of file class.ilUICoreSetupAgent.php.

90 : array
91 {
92 return [
93 'buildIlCtrlArtifacts' => new ObjectiveConstructor(
94 'builds all necessary ilCtrl artifacts.',
95 function () {
96 return $this->getBuildArtifactObjective();
97 }
98 ),
99
100 'updateIlCtrlDatabase' => new ObjectiveConstructor(
101 'executes all ilCtrl database update steps.',
102 function () {
103 return $this->getUpdateObjective();
104 }
105 ),
106 ];
107 }
getUpdateObjective(Config $config=null)
Get the goal the agent wants to achieve on update.The provided configuration is to be used to change ...
getBuildArtifactObjective()
Get the goal the agent wants to achieve to build artifacts.

References getBuildArtifactObjective(), and getUpdateObjective().

+ Here is the call graph for this function:

◆ getStatusObjective()

ilUICoreSetupAgent::getStatusObjective ( Storage  $storage)

Definition at line 74 of file class.ilUICoreSetupAgent.php.

74 : Objective
75 {
76 return new NullObjective();
77 }

◆ getUpdateObjective()

ilUICoreSetupAgent::getUpdateObjective ( Config  $config = null)

Get the goal the agent wants to achieve on update.The provided configuration is to be used to change according configuration values in the installation. If this is not possible for some reason, an according UnachievableException needs to be thrown in the according objective.The configuration is not to be used to initialize the required environment for the objectives. This must be done via ClientIdReadObjective and depending objectives like ilIniFilesLoadedObjective.If no configuration is provided the configuration of the component should stay as is.

Exceptions
InvalidArgumentExceptionif Config does not match the Agent..

Implements ILIAS\Setup\Agent.

Definition at line 50 of file class.ilUICoreSetupAgent.php.

50 : Objective
51 {
54 );
55 }
Class ilCtrlDatabaseUpdateSteps holds the database update- steps affecting ilCtrl tables.
This class attempt to achieve a set of database update steps.

Referenced by getNamedObjectives().

+ Here is the caller graph for this function:

◆ hasConfig()

ilUICoreSetupAgent::hasConfig ( )

Does this agent require a configuration?

Implements ILIAS\Setup\Agent.

Definition at line 26 of file class.ilUICoreSetupAgent.php.

26 : bool
27 {
28 return false;
29 }

The documentation for this class was generated from the following file: