Report Target

The report targets run a report whenever an automation fires. There are two built-in report targets: one runs the report, the other runs it for a range you give.

Id	Name	Template	Icon
odsl.report	Run a report	run [report]	file-text text-onenote
odsl.report_range	Run a report with a range	run [report] for [range]	file-text text-onenote

Both targets work with any service and any action. They support property-change filtering but not @transformer: the output is controlled by the report itself.

How it works

• The report named in report is run
• When the triggering data has an ondate, for example a dataset ondate or a curve date, the report is run for that date
• With odsl.report_range, the range property is also passed to the report

---

odsl.report: Run a report

Inputs

Input	Description
report	The name of the report to run

Example: run a report when a dataset is complete

ODSL

a = AutomationBuilder("dataset", "private", "MY.PROVIDER.FEED").build()

c = SimpleObject()
c.source = "private"
c.service = "dataset"
c.id = "MY.PROVIDER.FEED"
c.action = "complete"
conds = []
conds.add(c)
a.conditions = conds

a.target = "odsl.report"
a.template = "When 'MY.PROVIDER.FEED' is complete, run [report]"
a.icon = "file-text text-onenote"
a.properties.report = "MY_DAILY_SUMMARY_REPORT"
a.enabled = true
save ${automation:a}

REST API

POST https://api.opendatadsl.com/api/automation/v1

{
  "target": "odsl.report",
  "template": "When 'MY.PROVIDER.FEED' is complete, run [report]",
  "icon": "file-text text-onenote",
  "enabled": true,
  "conditions": [
    {
      "source": "private",
      "service": "dataset",
      "id": "MY.PROVIDER.FEED",
      "action": "complete"
    }
  ],
  "properties": {
    "report": "MY_DAILY_SUMMARY_REPORT"
  }
}

---

odsl.report_range: Run a report with a range

Inputs

Input	Description
report	The name of the report to run
range	The range to run the report for

Example: run a report for a range when a curve is updated

ODSL

a = AutomationBuilder("data", "private", "MY_OBJECT:CURVE").build()

c = SimpleObject()
c.source = "private"
c.service = "data"
c.id = "MY_OBJECT:CURVE"
c.action = "update"
conds = []
conds.add(c)
a.conditions = conds

a.target = "odsl.report_range"
a.template = "When 'MY_OBJECT:CURVE' is updated, run [report] for [range]"
a.icon = "file-text text-onenote"
a.properties.report = "MY_CURVE_REPORT"
a.properties.range = "between(T-1M,T)"
a.enabled = true
save ${automation:a}

REST API

POST https://api.opendatadsl.com/api/automation/v1

{
  "target": "odsl.report_range",
  "template": "When 'MY_OBJECT:CURVE' is updated, run [report] for [range]",
  "icon": "file-text text-onenote",
  "enabled": true,
  "conditions": [
    {
      "source": "private",
      "service": "data",
      "id": "MY_OBJECT:CURVE",
      "action": "update"
    }
  ],
  "properties": {
    "report": "MY_CURVE_REPORT",
    "range": "between(T-1M,T)"
  }
}

---

Choosing between the two targets

	odsl.report	odsl.report_range
Range	Not set	Set per automation
Best for	Reports run for the date of the triggering data	Reports that need a specific window
Transformer support	No	No

---

Related pages

• Automation Basics: how automations work, conditions and templates
• Creating Automations: step-by-step guide to setting up automations
• Export Group Target: run an export group when data changes
• Automation Targets: overview of all available targets