ON THIS PAGE:
The Canary Adaptor requires the Canary Historian to be installed to access real-time and historical data from Canary. This requires a license, which is a third party component.
Adaptor Settings
The following tables list the adaptor's parameters, along with the name and type to be used in the Import/Export spreadsheet.
| Parameter | Description | Name | Type |
| Host Name | Fully-qualified domain name of the host. | HostName | String |
| Port Number | Port number of the Views Service on the host. | PortNumber | Integer |
| User Name | User name to use to connect to the host. | UserName | String |
| Password | Password to use to connect to the host. | Password | EncryptedString |
| Use Native Sampling | Determines whether the historian's built-in native sampling should be used or IFS OI Server's own fallback sampling. | UseNativeSampling | Boolean |
| Tag Name | Name of the tag property to use as tag name when fetching data. If this value is not specified then the adaptor will use the original tag name. Also, if this value is configured but the tag property is not found during tag discovery then the adaptor will log a warning and use the original tag name. E.g. Historian ItemId | TagName | String |
| Tag Description | Name of the tag property which contains the tag descriptions. | TagDescription | String |
| Tag Minimum | Name of the tag property which contains the display range minimum values of tags. | TagMinimum | String |
| Tag Maximum | Name of the tag property which contains the display range maximum values of tags. | TagMaximum | String |
| Tag Scan Rate | Name of the tag property which contains the tag scan rates (the values will be treated as milliseconds). | TagScanRate | String |
| Tag Units | Name of the tag property which contains the tag unit names. | TagUnits | String |
| Good Qualities | Canary returns a status flag with each data point explaining the data quality of that point. The config here is a comma separated list of flags, represented in decimal (these flags may be represented in Hexadecimal when viewed in Canary). As a customer can add there own configuration, we allow this list to be customized to suit there needs. A good starting point is: 192, 1088, 1216, 2112, 2240, 32768. If a status being returned from Canary is in this list, it will return 100% confidence to Explorer. If the status is not in this list, it will return 0% confidence to Explorer. | String | |
| Ignored Qualities | Similar to 'Good Qualities' above, we also scan for data point that should be completely ignored by Explorer. If the returned status for a data point matches any status in this list, then the data point will be be treated as per the setting below 'Incompatible Value Behavior'. By default this is set to Remove Incompatible Values and so will completely remove the data point from being returned to Explorer. | String | |
| Incompatible Value Behavior | This setting determines how data is treated when a data point is detected as being in the Ignored Qualities list, and will determine what happens to the data point if its status list is in the Ignored Qualities field. You have some options to remove it completely, set the confidence to zero, or return a data point with a value of Null etc. A good starting point is: 33024, 57344. |
Installation
This adaptor is included in the Explorer installer.
Release History
- Explorer 4.15.0
- Added Tag Name parameter
- Explorer 4.10.6
- First version of the Canary Adaptor