Configuration FAQs
Last updated
Last updated
Find answers to some of the most frequently asked configuration questions.
In the video below, we demonstrate how to rotate text -90 degrees around the z-axis using block styling's transform option.
In the video below, we demonstrate how to toggle on your Data Grid's export button so that at runtime the grid contents can be exported to Excel.
"My computer is configured to use the date format DD/MM/YYYY, but my date selector is formatted as MM/DD/YYYY. How do I change it?"
The Date Selector date display format is based on the browser display language, not your computer's local settings. For example:
When the browser display language is set to English (Australia), the date format will be DD/MM/YYYY.
When the browser display language is set to English (United States), the format will be MM/DD/YYYY.
You should adjust your browser's display language settings - rather than your computer's local settings - to change the date format in XMPro.
"I'm copying the same pattern used in another Data Stream and I want to use the same version of a specific Agent (v2.7) when a newer version is available (v2.8)."
No, using an older version of an Agent when a newer version is available is not possible. The latest Agent should incorporate all of the functionalities of the previous version as well as any further modifications made.
However, you could clone the original Data Stream and choose not to upgrade the Agent to the latest version.
In the video below, we demonstrate how to view the log for a particular Stream Host in a Collection. The log contains errors encountered when publishing or running a Data Stream.
“I'm trying to reconcile the Stream Load metric in Data Stream designer with what I'm expecting based on the listeners. Is the metric calculated on the stream outputs or the inputs?
I have 3 listeners, each running at a 1 second interval, so I expect a 180/min metric. Is the ~360/min metric because there are double the number of outputs (action agents) per listener?”
Stream load is different from ingestion rate. The Stream load represents the total number of events published by all Stream Objects on the canvas. In this case, 60 x the total number of agents on the screen (assuming your Listeners bring back 1 record on every poll).
You would notice the actual number is much less because although you want it to run every second, the calls to dependencies like SQL etc do not return its data as quickly and hence the actual rate is less.
Generally, the number of events published per Agent decreases as you work through your data stream, because the intention is to work towards a smaller payload focused on the event in which you’re interested.
We advise you to only have one recommendation agent on a data stream.
A recommendation rule is configured against a single Data Stream, not a given Stream Object in a Stream. It will find the first Run Recommendation in the selected Data Stream and let you define your Recommendation Rule against the output payload of that Agent. If the payload differs at runtime, you may get weird results when triggering a recommendation alert.
If the data cannot be merged (using a join or union transformation) and used in the different recommendations, then consider creating 3 different data streams. Remember you can have one data stream feed data to as many recommendations as you want to, BUT you should only have one run recommendation agent on a data stream canvas.
Although a wide variety of data can be surfaced from a Data Stream into your Application using the Data Stream Connector, there is a downside. The Data Stream is constantly pushing data, which can lead to out-of-resource errors - which appear as XMPro product errors. If your data requirement is ad-hoc, consider the other Connectors.
You, as the owner of the recommendation, will not see the recommendation alerts unless you give yourself Run Access to your own recommendations.
You can achieve this by combining navigating between pages and passing data to the Page by configuring the Pass Page Parameters. The data passed can be static, an expression, or dynamic. Please refer to the how-to article below for step-by-step instructions.
Although each Stream Host in a given Collection downloads the same definition of a Data Stream, the Variables defined in Data Stream Designer can be overridden by the individual Stream Host to provide the unique configuration per Asset e.g. OPC IP Address. Please refer to the how-to articles below for step-by-step instructions.
To delete a Data Stream, your account must meet the following conditions:
You need Co-Owner or Write access to the specific Data Stream.
You must have the DeleteUseCase product right assigned to your user account, which is configured in Subscription Manager.
Once you have access to the Data Stream and the right to delete, click Properties to access the Delete button.
The Delete button on the canvas is used to delete Stream Objects.
