Skip to main content

ancoreMate ancoreShare Reports

Run ancoreShare reports, download the report files and read the report usage. Triggers when an ancoreShare report button has finished a report.

In n8n, these actions are in the node ancoreMate; the triggers are events of the node ancoreMate Trigger. Each action below names its n8n resource and operation.

Get started​

Turn on Enable ancoreMate Event in an ancoreShare report button and copy its ancoreMate key. Create a flow with When an ancoreShare report is finished, enter the key, the account, the app and the report, add Apply to each over Files and Download report file, and save each file in SharePoint or send it by mail.

Good to know​

  • The trigger needs ancoreShare with the ancoreMate event (report button setting). The key of the button is the only protection of the event; create a new key in the button if it became known.
  • Links to report files are valid for 12 hours.
  • Run ancoreShare report needs the ancoreShare account ID and the execution token of the user the report runs for.

Overview​

ActionGroupDescription
When an ancoreShare report is finishedTriggerStarts when a report button with ancoreMate event enabled has finished a report in the tenant of the connection, run by a user or through ancoreShare External Execution.
List ancoreShare reportsReportLists the ancoreShare report buttons of an app with title, export type and tags.
Run ancoreShare reportReportStarts an ancoreShare report; ancoreShare queues it and sends the files to the targets of the report button, for example the ancoreMate event.
Download report fileReport fileDownloads one file of a finished report from its link; links are valid for 12 hours.
Download report filesReport fileDownloads all files of a finished report at once, for example to attach them to one mail.
Get report usageUsageReturns the number of report runs per month, of all runs by button and by External Execution, for the account or one app, report or Qlik user.
List automated report runsUsageLists the report runs started through ancoreShare External Execution (not by the button) with result and error, to find failed automated runs.

Every connector also has the actions Get Qlik connection and Send Qlik Cloud request. Errors that all actions share: Standard errors.

Triggers​

How triggers work and how their filters behave: Triggers.

When an ancoreShare report is finished​

Starts when a report button with ancoreMate event enabled has finished a report in the tenant of the connection, run by a user or through ancoreShare External Execution. With Include the report files the files come along as Attachments, ready for a mail.

n8nnode ancoreMate Trigger → event When an ancoreShare report is finished
InputTypeDescription
ancoreMate key requiredtextThe ancoreMate key shown in the ancoreMate settings of the report button.
Include the report filesyes/noWhether the trigger passes on the finished files as Attachments, ready for a mail; files up to 50 MB together. Turn off to get only the links. Default: on.
AppchoiceOnly reports of this app; useful when a copy of the app has a button with the same key.
ReportchoiceOnly reports of this report button.

Result: The finished report.

FieldTypeDescription
Event typetextThe type of the event.
Timedate and timeThe time ancoreMate received the event.
Tenant IDtextThe Qlik Cloud tenant of the app.
Account IDtextThe ancoreShare account.
App IDtextThe app of the report.
Report IDtextThe report button.
Report titletextThe title of the report.
Task IDtextThe ID of the run, only for reports started through ancoreShare External Execution, for example with Run ancoreShare report; empty when a user clicks the button.
User IDtextThe Qlik user who ran the report.
FileslistThe finished files; in n8n each file is a separate item. Each entry has: File name, Link.
File linkslistThe links to the finished files, for example for Download report files.
AttachmentslistThe finished files as mail attachments, with Include the report files; for example for Attachments in Send an email (V2). In n8n each item has its file as binary data. Each entry has: Attachment name, Attachment content.
File errortextWhy the files could not be included, for example because they are too large; they can still be downloaded with the links.
ParametersobjectThe ancoreMate parameters of the report button.

Errors specific to this action:

  • 400: The request is not valid or ancoreShare rejected it.

Report​

List ancoreShare reports​

Lists the ancoreShare report buttons of an app with title, export type and tags.

n8nresource ancoreShare Report → operation Get Many
InputTypeDescription
App requiredchoiceThe app with the report button.

Result: The result of the action.

FieldTypeDescription
ReportslistThe reports. Each entry has: Report ID, Title, Export type, Tags.

Errors specific to this action:

  • 400: The request is not valid or ancoreShare rejected it.

Run ancoreShare report​

Starts an ancoreShare report; ancoreShare queues it and sends the files to the targets of the report button, for example the ancoreMate event.

n8nresource ancoreShare Report → operation Run
InputTypeDescription
App requiredchoiceThe app with the report button.
Report requiredchoiceThe ancoreShare report button.
Account ID requiredtextThe ancoreShare account ID (customer number).
Execution token requiredtextThe ancoreShare execution token of the user the report runs for; each user has an own token.
Export typetextThe export type, default as configured in the button.
BookmarktextA bookmark to apply before the report runs.
SelectionstextSelections to apply before the report runs: one field with its values (Region,North,South), or for several fields the select=… part of the ancoreShare execution link (select=Region,North&select=Year,2026).
NotificationtextWhen ancoreShare sends a mail about the run, for example success.
Notification mailtextThe mail address for the notification.

Result: The started run.

FieldTypeDescription
Task IDtextThe ID of the report run in ancoreShare.
App IDtextThe app.
Report IDtextThe report button.

Errors specific to this action:

  • 400: The request is not valid or ancoreShare rejected it.

Report file​

Download report file​

Downloads one file of a finished report from its link; links are valid for 12 hours.

n8nresource Report file → operation Download Report File
InputTypeDescription
Link requiredtextThe link of the report file, for example from the trigger.

Result: The file. See Files.

Errors specific to this action:

  • 400: The request is not valid or ancoreShare rejected it.

Download report files​

Downloads all files of a finished report at once, for example to attach them to one mail.

n8nresource Report file → operation Download Report Files
InputTypeDescription
Links requiredlistThe links of the report files, at most 50.

Result: The files. See Files.

Errors specific to this action:

  • 400: The request is not valid or ancoreShare rejected it.

Usage​

Get report usage​

Returns the number of report runs per month, of all runs by button and by External Execution, for the account or one app, report or Qlik user.

n8nresource Usage → operation Get Report Usage
InputTypeDescription
Account ID requiredtextThe ancoreShare account ID (customer number).
AppchoiceOnly runs of this app.
ReportchoiceOnly runs of this report button.
Qlik user IDtextOnly runs of this Qlik user.

Result: The result of the action.

FieldTypeDescription
MonthslistThe months, newest first. Each entry has: Year, Month, Reports.
TotalnumberThe number of report runs of all months.

Errors specific to this action:

  • 400: The request is not valid or ancoreShare rejected it.

List automated report runs​

Lists the report runs started through ancoreShare External Execution (not by the button) with result and error, to find failed automated runs.

n8nresource Usage → operation Get Many Automated Report Runs
InputTypeDescription
Account ID requiredtextThe ancoreShare account ID (customer number).
AppchoiceOnly runs of this app.
ReportchoiceOnly runs of this report button.
Task IDtextOnly the run with this task ID, for example from Run ancoreShare report.
LimitnumberThe maximum number of runs, between 1 and 1000. Default 100.

Result: The result of the action.

FieldTypeDescription
RunslistThe runs, newest first. Each entry has: Task ID, App ID, Report ID, Export type, Succeeded, Error message, Start, End, Duration.

Errors specific to this action:

  • 400: The request is not valid or ancoreShare rejected it.