Skip to content

Configure the Job List in DPF Tracker

Columns of the Job List

By default, no columns are displayed in the job list.

Requirements

The users and rights management must have been activated, refer to Activate the Users and Rights Management.

Instructions

This is how you configure which columns of the job list are displayed:

  1. Edit the following configuration file:

    %SEAL_CUSTOMDIR%\server\web\conf\passwd.cfg

  2. If you want to specify the columns for all users, specify it in the [DPFTRACKER] section:

    [DPFTRACKER]
TRACKER_COLUMNS = column1 column2 ...

  3. If you want to specify the columns for the users of a specific user group, specify the keyword in the section of the user group:

    [group_name]
TRACKER_COLUMNS = column1 column2 ...

  4. To configure language-specific titles for the columns, specify them in the [DPFTRACKER\LANGUAGE\lang] section:

    [DPFTRACKER\LANGUAGE\DE]
column1 = title_de1
column2 = title_de2
...
[DPFTRACKER\LANGUAGE\EN]
column1 = title_en1
column2 = title_en2
...

  5. Save the passwd.cfg file. The change takes effect immediately after saving.

Example

Example

All users see the job name, the user name, the process name and the status after processing. The users of the USER user group additionally see a column with operation icons. The column with the WFNAME parameter is overwritten with Prozess in German and Process in English. The users of the ADMINISTRATOR user group see more information about the job:

[DPFTRACKER]
TRACKER_COLUMNS = JOBNAME JOBUSERNAME WFNAME JOBFINALSTATUS
...
[USER]
TRACKER_COLUMNS = JOBNAME JOBUSERNAME WFNAME JOBFINALSTATUS
JOBACTIONS ...
[ADMINISTRATOR]
TRACKER_COLUMNS = JOBNAME JOBUSERNAME JOBTSFINISHED JOBDURATION
JOBTSDELETE JOBTSFORGET WFNAME JOBFINALSTATUS JOBACTIONS
...
[DPFTRACKER\LANGUAGE\DE]
WFNAME = Prozess
...
[DPFTRACKER\LANGUAGE\EN]
WFNAME = Process

Sorting of the Job List

By default, the job lists is sorted by the job ID in descending order.

Requirements

The users and rights management must have been activated, refer to Activate the Users and Rights Management.

Instructions

This is how you configure the sorting of the job list:

  1. Edit the following configuration file:

    %SEAL_CUSTOMDIR%\server\web\conf\passwd.cfg

  2. To configure the sorting for all users, specify it in the [DPFTRACKER] section:

    [DPFTRACKER]
TRACKER_DEFAULT_JOBLIST_SORT_COLUMN = column
TRACKER_DEFAULT_JOBLIST_SORT_ORDER = order

  3. To configure the sorting for the users of a specific user group, specify the keywords in the section of the user group:

    [group_name]
TRACKER_DEFAULT_JOBLIST_SORT_COLUMN = column
TRACKER_DEFAULT_JOBLIST_SORT_ORDER = order

  4. The change takes effect immediately after saving the passwd.cfg configuration file.

Example

Example

For all users, the job list is sorted by DPF_JOB_PROGRESS parameter in ascending example order:

[DPFTRACKER]
TRACKER_DEFAULT_JOBLIST_SORT_COLUMN = DPF_JOB_PROGRESS
TRACKER_DEFAULT_JOBLIST_SORT_ORDER = ASC

Start Tab and Job Details

By default, the All tab is displayed when opening the job list, and the Log File tab when opening the job details.

Requirements

The users and rights management must have been activated, refer to Activate the Users and Rights Management.

Instructions

This is how you configure which tabs are displayed when opening the job list and the job details:

  1. Edit the following configuration file:

    %SEAL_CUSTOMDIR%\server\web\conf\passwd.cfg

  2. To configure the start tabs for all users, specify them in the [DPFTRACKER] section:

    [DPFTRACKER]
TRACKER_DEFAULT_JOBLIST_TAB = tab
TRACKER_DEFAULT_JOBVIEW_TAB = tab

  3. To configure the start tabs for the users of a specific user group, specify the keywords in the section of the user group:

    [group_name]
TRACKER_DEFAULT_JOBLIST_TAB = tab
TRACKER_DEFAULT_JOBVIEW_TAB = tab

  4. The change takes effect immediately after saving the passwd.cfg configuration file.

Example

Example

When opening the job list, the user sees the erroneous jobs and, when opening the job details, they see the log file:

[DPFTRACKER]
TRACKER_DEFAULT_JOBLIST_TAB = error
TRACKER_DEFAULT_JOBVIEW_TAB = logfile

Job List Updating

By default, the regular updating the job list is deactivated and after activation, the interval of the regular updating is 10 seconds.

Requirements

The users and rights management must have been activated, refer to Activate the Users and Rights Management.

Instructions

This is how you configure the updating of the job list:

  1. Edit the following configuration file:

    %SEAL_CUSTOMDIR%\server\web\conf\passwd.cfg

  2. To configure the update interval for all users, specify it in the [DPFTRACKER] section:

    [DPFTRACKER]
TRACKER_REFRESH = sec

    If you want that the regular updating is active right after the start, you specify the update interval with negative value:

    TRACKER_REFRESH = -sec

  3. To configure the regular updating for the users of a specific user group, specify the keyword in the section of the user group:

    [group_name]
TRACKER_REFRESH = sec

  4. The change takes effect immediately after saving the passwd.cfg configuration file.

Example

Example

For all users except the ones of the ADMINISTRATOR user group, the job list is updated all 20 seconds after the user has activated the regular updating. For the users of the ADMINISTRATOR user group, the regular updating is active right after the start and job list is updated all 15 seconds:

[DPFTRACKER]
TRACKER_REFRESH = 20
...
[ADMINISTRATOR]
TRACKER_REFRESH = -15

Jobs per Page

By default, 10 jobs are displayed per page in the job list.

Requirements

The users and rights management must have been activated, refer to Activate the Users and Rights Management.

Instructions

This is how you configure the number of jobs per page in the job list:

  1. Edit the following configuration file:

    %SEAL_CUSTOMDIR%\server\web\conf\passwd.cfg

  2. To configure the number of jobs per page for all users, specify it in the [DPFTRACKER] section:

    [DPFTRACKER]
TRACKER_JOBS_PER_PAGE = number

  3. To configure the number of jobs per page for the users of a specific user group, specify the keyword in the section of the user group:

    [group_name]
TRACKER_JOBS_PER_PAGE = number

  4. The change takes effect immediately after saving the passwd.cfg configuration file.

Example

Example - 100 jobs per page in the job list

[DPFTRACKER]
TRACKER_JOBS_PER_PAGE = 100

By default, the link in the History tab in the job details leads to the Log File tab.

Requirements

The users and rights management must have been activated, refer to Activate the Users and Rights Management.

Instructions

This is how you configure the link in the History tab in the job details:

  1. Edit the following configuration file:

    %SEAL_CUSTOMDIR%\server\web\conf\passwd.cfg

  2. To configure the link for all users, specify it in the [DPFTRACKER] section:

    [DPFTRACKER]
TRACKER_DEFAULT_JOBHISTORY_LINK = tab

  3. To configure the link for the users of a specific user group, specify the keyword in the section of the user group:

    [group_name]
TRACKER_DEFAULT_JOBHISTORY_LINK = tab

  4. The change takes effect immediately after saving the passwd.cfg configuration file.

Example

Example - link in History tab opens Parameter tab

[DPFTRACKER]
TRACKER_DEFAULT_JOBHISTORY_LINK = viewpar

Default Search Filter

By default, all jobs are displayed without being filtered via a search.

Requirements

The users and rights management must have been activated, refer to Activate the Users and Rights Management.

Instructions

This is how you configure the filtering of jobs via a search:

  1. Edit the following configuration file:

    %SEAL_CUSTOMDIR%\server\web\conf\passwd.cfg

  2. To configure the search item for all users, specify it in the [DPFTRACKER] section:

    [DPFTRACKER]
TRACKER_DEFAULT_SEARCH = search_item

  3. To configure the search item for the users of a specific user group, specify the keyword in the section of the user group:

    [group_name]
TRACKER_DEFAULT_SEARCH = search_item

  4. The change takes effect immediately after saving the passwd.cfg configuration file.

Example

Example - all jobs found when searching for publish are displayed

[DPFTRACKER]
TRACKER_DEFAULT_SEARCH = publish

Default Process Filter

By default, the jobs of all processes are displayed in the job list.

Requirements

The users and rights management must have been activated, refer to Activate the Users and Rights Management.

Instructions

This is how you configure that only the jobs of a process are displayed:

  1. Edit the following configuration file:

    %SEAL_CUSTOMDIR%\server\web\conf\passwd.cfg

  2. To configure the process used for filtering the job list for all users, specify it in the [DPFTRACKER] section:

    [DPFTRACKER]
TRACKER_DEFAULT_SEARCH_PROCESS = process

  3. To configure the process to be used for filtering the job list for the users of a specific user group, specify the keyword in the section of the user group:

    [group_name]
TRACKER_DEFAULT_SEARCH_PROCESS = process

  4. The change takes effect immediately after saving the passwd.cfg configuration file.

Example

Example - display only jobs of the dpf4publish process

[DPFTRACKER]
TRACKER_DEFAULT_SEARCH_PROCESS = dpf4publish
Back to top