Skip to main content

XINA Struct Report Email

The XINA Struct Report command line utility generates Export and Trend tasks for Profiles and Trend Definitions that are configured to auto generate. It can also optionally generate the XINA Report Email Task. The Export tasks will export the previous days data and the Trend tasks will use the time ranges or intervals as configured in the Trend Definition. The most common use case is to create the XINA Report Task (xina_struct_report) using XINA's internal cron system once per day.

Arguments

NameReqDescriptionDefault
cacheCache directory path. Used for any persistent caching across tasks for optimization purposes.
confFile path to the JSON config containing the report parameters.
envFile path to the JSON environment file which defines environment parameters such as project specific paths.
helpPrint available options.
hostXINA Tunnel host."localhost"
portXINA Tunnel port.41746
importImport directory path. Files that need to be imported will be placed here.
logFile path that log events will be written to.
outOuptut directory path. Files placed here will be uploaded and accessible directly from the Task interface (e.g. notifications panel).
postPost directory path (for post-import outputs) e.g. uploading log files to the Task record.
taskFile path to the JSON file containing info about the Task.
tempTemp directory path for storing temporary files during execution.

conf

The below table describes the available fields in the conf JSON file.

NameTypeReqDescriptionDefault
modelutf8text Path of model to generate Export and Trend tasks for e.g. "moma.fm"
hostnameutf8text The hostname that will be used for creating the URLs to the Export and Trend packages in the email contents e.g. "moma.xina.io"
emailbooleanIf true, the report email task will be generatedtrue

Example conf:

{
  "model": "pace.ops_pace",
  "hostname": "pace.xina.io",
  "email": true
}