Task executions

The Task executions page shows details related to Qlik NPrinting Server tasks.

You can open the Task executions page by clicking on Admin and selecting Task executions or by typing the URL https://YourServer:4993/#/tasks/executions. Only users with Administrator role can open the Task executions page.

Task types

Qlik NPrinting has four types of task:

  • Import filters and recipients
  • Publish report
  • Generate connection cache
  • Search field values. If you press the Search button while adding an uncached field, Qlik NPrinting will start a task to retrieve the non-cached values.

A publish report task has three phases:

  1. Content resolution: Qlik NPrinting gets data needed to create a report from QlikView or Qlik Sense.
  2. Content production: Qlik NPrinting creates the report.
  3. Publish: the report is delivered according to your task settings.

These steps are executed in order for each combination of report and user. They are performed in parallel for different reports and many reports can be at the same stage at the same time.

Filters

By default, all in-progress or finished tasks are displayed. There are several drop-down menus that allow you to filter visible tasks by:

  • View:
    • All executions
    • In progress
    • Finished
  • Task type:
    • Import filters and recipients
    • Publish report
    • Generate connection cache
    • Search field value
  • Date range:
    • Created on
    • Last execution date

    You can also select the time range on the right drop-down menu. If you select Custom, you have to insert the start and end date.

  • Task name.
  • You can also use the Filter search box to filter by a string in the task name

Task executions

Task name The name of the task.
Task type The type of task.
Status

A blinking status means that the task is running. A fixed status means that the task is finished.

Possible statuses are:

  • Warning: some reports are created correctly, but some have problems.
  • Failed: all reports have problems.
  • Running (only blinking): everything is going well but the task is still in execution.
  • Completed (only fixed): all reports have been correctly created and delivered.
  • Queued: task is waiting to start its execution.
  • Aborted: task execution was manually stopped because the user pressed the Abort button in the Task detail page.
Progress Percentage of publishing completion. Progress will remain at 0% during content resolution and content production. It will start to increase when publishing starts or when a condition evaluation returns false. This means that some reports will not be produced and will be counted as finished.
Created Date and time task was created.
Last updated Date and time task was last updated.

You can change the number of visible rows by clicking on the numbered buttons at the bottom of the page.

Task executions details

Click on a task name to open its details page . The details page is divided into three sections:

  • Overview
  • Statistics
  • Logs

When opening this page, you need to wait until all logs are loaded. This could take several seconds.

Statistics

Elapsed time Time since the task started or since the latest task restart. It is updated only when there are timed updates on the task. If the task is blocked, the elapsed time will not be updated. Visible for all type of tasks.
Started resolutions The number of reports that have started the content resolution step. Visible only for publish report tasks.
Finished resolutions The number of reports which have finished the content resolution step. Visible only for publish report tasks.
Started productions The number of reports that have started the content production step. Visible only for publish report tasks.
Finished productions The number of reports which have finished the content production step. Visible only for publish report tasks.
Started publishing The number of reports that have started the publishing step. Visible only for publish report tasks.
Finished publishing The number of reports that have finished the publishing step. Visible only for publish report tasks.
Report failures The number of reports that failed any of the execution steps. Visible only for publish report tasks.

Logs

The last section of the task details page contains detailed logs. Each log is comprised of:

Date and time Date and time of log generation in the Qlik NPrinting Server time zone.
Level The log level is an hint about the severity of the event recorded. The values Error or Warn mean that something went wrong and we suggest to investigate. The value Info means that the event ended correctly.
Description Detailed description of the logged action.

Retrieve the report from the ID in the logs

Report IDs are not resolved in the logs of the task execution details page, so report names are not visible and you will need to retrieve them.

Do the following:

  1. Open the task details page.
  2. Select and copy the report ID that you want to resolve.
  3. Go to the publish task page.
  4. Open the publish task related to the original log.
  5. Open one of the available reports
  6. Replace the last part of the URL (the string on the right side of last backslash) by pasting the copied report ID.
  7. Press enter.

How to abort a task

You can stop the execution of a task at any time.

Do the following:

  1. Click on the name of the task.
  2. Click on the Abort button in the upper right corner.
  3. The execution of the task is stopped and shows an Aborted status.