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.

Task execution times are displayed relative to the time zone of the logged in user. These may be different than the time zone of the Qlik NPrinting Server. You can change your time zone by clicking on your user name in the top right, and selecting Settings.

Execution phases

A publish 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 executed at the same stage at the same time.

Filtering tasks

By default, all in-progress or finished tasks are displayed. You can filter tasks by View, Task type, or Date range. You can also search by task name. Clicking the black triangles next to the header titles of any column will sort column items alphabetically.

The View drop-down list has the following options:

• All executions
• In progress
• Finished

The Task type drop-down list has the following options:

• Import filters and recipients
• Publish report
• Generate connection cache
• Generate report template: this task is related to migrating QlikView NPrinting 16 report templates. See: Using the migration tool.
• Search field value: If you press the Search button while adding an uncached field, Qlik NPrinting will start a task to retrieve the non-cached values.

There are two Date range drop-down lists:

• Created:
  • Created
  • Last updated
• All time:
  • All time
  • Today
  • Yesterday
  • This week
  • This month
  • Last 7 days
  • Last 30 days

  • Custom: Lets you set a specific date range.

To search by name, type the name of task you are looking for into the search form on the right. The list of tasks will be dynamically filtered.

Task execution status

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

There are several types of Status:

• Warning (only blinking): some reports are created correctly, but some have problems.

  The task is still running.

• Warning (only fixed): some reports are created correctly, but some have problems.

  The task has been completed with a Warning status.

• 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.

Task execution 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.

Overview

This section contains basic information about the task:

• Task name
• Task type
• Status
• Progress
• Created
• Last updated

Statistics

The second section shows the task's statistics.

Logs

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

Retrieving the report from the ID in the logs

Report IDs are not resolved in the logs of the task execution details page. 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.

Aborting 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.

Changing task settings

Administrators can set what happens when reports or variables do not render. They can also choose to receive task notification emails.

Requirements

Before you can set up task notifications via email, make sure that the NewsStand and Qlik NPrinting web console URL settings are configured. If you do not configure the URLs, links in the notification emails will not work.

Do the following:

1. In the main menu, go to Admin > Settings.
2. Click the System button.
3. Enter the Qlik NPrinting web console URL including port number in Web Console URL. You can copy the URL including port number from the Qlik NPrinting web console browser address bar.
4. Enter the NewsStand URL including port number in NewsStand URL.
5. Click Update.

Error handling: reports

By default, if report generation fails, recipients still receive scheduled emails. Instead of the report, users see an error message and instructions to contact an administrator. Administrators can disable this behavior so that emails are not sent when reports fail. Report failure appears as an error in the log files.

If you disable this behavior, emails are still sent if at least one report was created successfully.

For example:

You have 3 users in a single task. The task has 2 reports for each user, which are sent via e-mail.

• User A: report generation successful.
• User B: one report fails to generate.
• User C: all reports fail to generate.

In this case:

• User A receives the email with the two attachments.
• User B receives the email with a single attachment. There will be no mention of the report that failed.
• User C will not receive any email.

Do the following:

1. In the main menu, go to Admin > Settings.
2. Click the Task button.
3. Under Email distribution errors, go to When a publish task cannot generate one or more reports. Choose from the following options:

   • Recipients will receive successful reports, with a message listing reports that failed

   • Recipients will receive successful reports, with no error message

     Information noteIf all reports fail, recipients will not receive an email.
4. Click Update.

Error handling: variables

Administrators can set what happens if variables in an email do not resolve.

Do the following:

1. In the main menu, go to Admin > Settings.
2. Click the Task button.
3. Under Email distribution errors, go to When a publish task cannot resolve a variable tag. Choose from the following options:
   • Send the email with the tag as is
   • Send the email with the tag removed
   • Do not send the email
4. Click Update.

Task execution notifications

You can receive notifications if tasks end with success, errors, or warnings. Notifications can be sent to multiple email addresses.

Do the following:

1. In the main menu, go to Admin > Settings.
2. Click the Task button.
3. Under Notifications, you can choose to send emails if tasks end with:
   • Errors
   • Warnings
   • Success
4. Under Email configuration, you must add:
   • Sender address
   • Sender name
   • To

5. You can choose to add a CC or BCC.

   Information noteYou can use semicolons to add multiple To, CC, or BCC addresses.

6. Click Update.
7. If you want to receive notification emails for a task, they need to be enabled. Open the task, go to the bottom of Overview, and select Send task notifications.