JOC Cockpit - Customizations

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.
• Time ranges
  • The time range can be specified with a relative expression that includes the use of the words now and today, optionally in combination with a number of seconds, hours () or days .
    • Examples:
      • Executed in the last 10 minutes: now-600
      • Executed in the last hour: -1h
      • Executed yesterday: -1d to -1d
      • Executed since yesterday: -1d
      • Executed this week: -0w
      • Executed in the last week: -1w to -1w
      • Executed in the last month: -1M to -1M
      • Executed since last month: -1M

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

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 sos:products:joc_cockpit:customization:share:make_private allows a shared customization to be made private.