Scope
- Customizations are a powerful means to create and manage custom filters that are available for any list view with the JOC Cockpit.
- By default customizations are private, however, they can be shared across teams.
- Permissions can be managed to allow specific roles to manage shared customizations.
- Shared customizations are stored centrally and are provided for any device that is used by a user.
Management of Customizations
- Customizations can be held privately, i.e. they are accessible exclusively for the current user.
- In addition customizations can be shared across teams.
- Shared customizations are updated when loading the respective view in the JOC Cockpit.
Create Customization
Customizations are context-dependent - a customization configured for a Job Chain will differ from one configured for the daily plan.
This can be seen in the modal windows for the configuration of customization of Job Chain and Daily Plan shown below.
Job Chain Customization
(Screenshot made from JOC Cockpit Dark accessible theme)
Daily Plan Customization
(Screenshot made from JOC Cockpit Midnight Blue theme)
Configuration
- Customization names
- Customization names can be freely chosen.
- Folders
- The filter parameters used to limit entries in a result list view to specific folder can be selected from the JobScheduler's live tree or specified by a regular expression. In the Daily Plan Customization Window the Jobs and Job Chains fields must include the individual Job Chain or Job - e.g.
/test/hello_world/job_chain01
. A regular expression such as that shown i the screenshot above must be used to show all the Jobs or Job Chains in a folder.
- The filter parameters used to limit entries in a result list view to specific folder can be selected from the JobScheduler's live tree or specified by a regular expression. In the Daily Plan Customization Window the Jobs and Job Chains fields must include the individual Job Chain or Job - e.g.
- Time ranges
- The time range can be specified with a relative expression that includes the use of the words
now
andtoday
, optionally in combination with a number of seconds, hours (h
), days (d
), weeks (w
) or months (m
) .- Examples:
- Executed in the last 10 minutes:
now-600
- Executed in the last hour:
-1h
- Executed yesterday:
-1d
to-1d
- Executed since yesterday (i.e. yesterday and today):
-1d
- Executed this week:
-0w
- Executed last week:
-1w
to-1w
- Executed last month:
-1m
to-1m
- Executed since last month (i.e. last month and the current month):
-1m
- Executed in the last 10 minutes:
- The interpretation of time ranges was modified in Release 1.11.5 - for details see issue - JOC-332Getting issue details... STATUS .
- Examples:
- The time range can be specified with a relative expression that includes the use of the words
Customizations vs. Advanced Search
In contrast with Customizations, the JOC Cockpit's Advanced Search function allows absolute start and end dates and times to be used. These are not available in customizations, which are intended to be saved and reused.
Advanced Search configurations can be saved as Customizations, without any absolute start and end dates and times.
Managing Customizations
Configuration
- The name of the currently active customization is displayed with the Customization menu.
- The list of available private and shared customizations is also displayed.
- Clicking the circled
x
symbol deactivates an active customization, this operation does not remove a customization.
Edit Customizations
Configuration
- The list includes customizations that are marked as shared (or otherwise are private)
- The star symbol in front of the customization name can be clicked to select a favorite customization that would automatically become active whenever the associated list is viewed and no other customizations are active.
Permissions
For details of Permission sets see Authentication and Authorization - Permissions for the JOC Cockpit Web Service
Private Customizations
- By default customizations created by a user are private, i.e. they are accessible exclusively for the given account.
- By default users have all the permissions required to manage private customizations, i.e. create, view, edit, delete and share:
- Permission
sos:products:joc_cockpit:customization:private:view
- Permission
sos:products:joc_cockpit:customization:private:edit_content
- Permission
sos:products:joc_cockpit:customization:private:delete
- Permission
sos:products:joc_cockpit:customization:private:make_shared
allows a private customization to be shared
- Permission
Shared Customizations
- By default exclusively the
application_manager
roles is granted permissions to manage shared customizations. - Users granted the relevant permissions can managed shared customizations:
- Permission
sos:products:joc_cockpit:customization:share
allows a shared customization to be created. - Permission
sos:products:joc_cockpit:customization:share:view
- Permission
sos:products:joc_cockpit:customization:share:edit_content
- Permission
sos:products:joc_cockpit:customization:share:delete
- Permission
allows a shared customization to be made private.sos:products:joc_cockpit:customization:share:make_private
- Permission