Knowi's report scheduling features allow you to schedule dashboard exports as a PDF and/or CSV attachment and sent to you directly via Email, Webhook, Slack, or Microsoft Teams. Say you have a frequently used dashboard that tracks daily KPI metrics. You can schedule an email report to have it delivered as a PDF and/or CSV directly to you and your team's inbox daily.
Sections
There are two ways to navigate to the Reports screen from any dashboard:
From the Left Side Bar:
From the Dashboard:
These are the initial steps to setting up a scheduled report. This portion of the process applies to Email, Webhook, Slack Reports, and Teams Reports. Proceeding sections will outline specific steps to set up each of the three report types.
To create a Scheduled Report:
Navigate to the Report Options Screen following the steps from the Navigating to Scheduled Reports section above
Give your Report a name. The name you will enter will be displayed in the Reports screen.
In the Dashboards dropdown, select the dashboard(s) you wish to send in the report.
Optionally include a CSV attachment by clicking on the Add CSV Attachment. This will show additional options
In the Report As dropdown, select the Knowi user the report will be executed by (available to Admin users only - allows the report to be run with lower privileges).
(Optional) In the Filters section, enter any User Content Filters that you wish to enforce. This ensures only data applicable to the recipient(s) is contained in the report.
In the Run every section, specify the schedule the report will be sent on. Reports can be scheduled to run every _Hour, Day, Month,_ or _Weekday (M-F)_ intervals.
Email Reports allow you to attach a PDF and/or CSV attachment of a dashboard(s) to an email. The email can be scheduled to be sent at a chosen interval to single or multiple recipients.
Follow the steps below to create an Email Report after completing the steps in the Setting up a Scheduled Report section.
To Create an Email Report:
Below is an example of what a common setup looks like:
Below is an example of what the actual email received in a specified account looks like:
Users have the ability to specify the c9_date token in the email report subject and body in the following format:
{$c9_<datetoken><op><number><timeunit>:YYYYMMdd}
For example, {$c9_today-1d:YYYYMMdd} will be translated automatically to yesterday.
If the format is not specified (YYYYMMdd in the example above) - then the default user date-time format is applied.
For more information on supported date tokens and time units, you can refer to the Date Tokens section of our documentation.
Webhook Reports allow you to attach a PDF and/or CSV attachment of a dashboard(s) and send it to the endpoint of your own application. The endpoint should be able to accept multipart form data as the results are sent separately as files of different content.
content-type of application/pdf for dashboard results;
content-type of text/csv for dataset results;
The following service provides you with free functional testing and validation facilities of the structure and content of the requests that'll be sent to your real endpoints.
https://webhook.site
Follow the steps below to create a Webhook Report after completing the steps in the Setting up a Scheduled Report section.
To Create a Webhook Report:
Under Report Actions, select Webhook and click on the + Add Webhook to open the Add Webhook window.
Under Name, enter the name of the webhook.
Under URL to Invoke, enter the endpoint in your application to invoke that can accept a POST request with JSON (array of objects).
Under Headers, enter any headers for HTTP requests to the URL to Invoke endpoint. There can be one header per line.
Knowi also provides the following C9 tokens which can be used to identify the report on the Webhook headers.
$c9_taskDate$: It denotes the date of the report in the (yyyy-mm-dd) format $c9_taskName$: It defines the name of the webhook report. For example: Test webhook $c9_taskId$: It denotes any Id of the report. For example: 2971 $c9_taskType$: This can be either report or alert
Custom header:
You can also have your own custom header passing through report content filters. Enter the required details in the fields (Mode, Field Name, Value ).
Fields | Descriptions |
---|---|
Mode | Select the mode from the dropdown menu. **Query Parameter**: Applicable for **Direct Query** modes, these are parameters that will be automatically passed in for this user. Field name must be in format $c9_XXX$ or $c9_XXX(defaultVal)$ where the default will be passed in at runtime if the value is empty. **Filter on Query Results**: Applies the filter on top of the query results to limit the data. Field name is the field name to filter by (without $c9_). |
Field Name | Enter the name of the field in the format applicable to the selected mode. |
Value | To enter multiple values, enter the value and hit Enter |
To Remove/Add Custom headers:
Under the Authentication URL, enter the authentication endpoint to get a token, which can be passed into each subsequent query. Only required if the API requires it. This is an absolute URL.
Under Auth Headers, enter any optional authentication-related headers. One Header per line.
Under the Custom POST Body, the user can pass data tokens through the webhook using the POST Body field. Enter a custom post body to be sent out. Data tokens can pass field values from data. If left empty, the post body for the webhook will contain the conditional data saved as JSON or just a default message with the dataset name triggered.
For example,
For sending activity samples, we can type %opened% or %customer%, etc., and it will be replaced with the value of the fields of the first row of triggered data.
Note: The data of token only can pass first record of triggered alert/report data (or conditional data alerted)
Click Save.
Below is an example of the webhook report that is produced based on the values defined.
Reference code sample here.
Slack Reports allow you to attach a PDF and/or CSV attachment of a dashboard(s) to a list of public channels on your team's Slack workspace including an alert message.
Follow the steps below to create a Slack Report after completing the steps in the Setting up a Scheduled Report section.
To Create a Slack Report:
Below is an example of how the common setup looks like:
Below is an example of the results that are actually sent and published to the specified Slack channel(s)
Similar to Slack reports, you can also send the reports and events into your Microsoft Teams channels or group chats for triggered conditions. Start creating the teams report by selecting the Teams under Report Actions and clicking on the +Add Teams button.
You don't have to create a schedule to export a dashboard. A user can export a dashboard at any time.
To export a dashboard to PDF:
Users can export the dashboard as a PDF file at any time by following the steps discussed below:
If the user is a "view-only" user then it doesn't have a "Share" button on the top bar but has separate "Export as PDF" button at the top bar.
If the dashboard is shown as an embedded OEM dashboard (see Embedding/OEM), and it is configured to show a header bar and action buttons, then one of the buttons- "Export to PDF" will export the dashboard to a PDF file.