{"id":5349,"date":"2017-10-06T10:11:39","date_gmt":"2017-10-06T02:11:39","guid":{"rendered":"http:\/\/localhost\/help\/?page_id=5349"},"modified":"2024-06-21T15:11:35","modified_gmt":"2024-06-21T07:11:35","slug":"phd-adaptor-features","status":"publish","type":"page","link":"https:\/\/oihelp.corporate.ifs.com\/help\/p2-server\/primers\/datasources\/phd-adaptor-features\/","title":{"rendered":"PHD Adaptor Features"},"content":{"rendered":"\n<p class=\"left-bar\">The PHD Adaptor supports PHD 300.1.0.1. The adaptor must have this version of the PHDAPINET.dll installed. If this version is not installed then the PHD Adaptor will not be able to connect to PHD.<\/p>\n<p class=\"intro-text\">The PHD Adaptor provides standardised access to Honeywell's Uniformance PHD Desktop Historian servers, hiding the complexity of obtaining data from PHD.<\/p>\n<p class=\"intro-text\">The PHD Adaptor requires the Honeywell PHD API to be installed to access real-time and historical data from Honeywell's PHD historian. This requires a license for the Honeywell PHD API, which is a third party component.<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">64-bit Support<\/h2>\n<p class=\"intro-text\">A separate PHD 410 64-bit Adaptor is available in the Explorer installer. This has the same capabilities and configuration options as the PHD300 Adaptor, but is designed specifically for 64-bit systems.<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">Domain Authentication<\/h2>\n<p class=\"intro-text\">PHD 300 has removed the need to log on using a user name and password, this is now done through the user that is logged on and running the PHD API. In order for IFS OI Server to use this feature, the Adaptor Pool Service must be set to a user that has access to the PHD system.<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">Tag Fetching<\/h2>\n<p class=\"intro-text\">The PHD API that is used by the adaptor does not support batch fetching of tags and therefore cannot perform batch fetching. It is recommended that the fetch is done in a single fetch or it is filtered by A-Z; this will depend on how many tags exist in PHD.<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">Minimum and Maximum Values<\/h2>\n<p class=\"intro-text\">The PHD Adaptor can understand minimum and maximum values that are defined using exponential notation (e.g. -1.643e6 to mean -1643000.0). If the adaptor does not recognise the value configured for a tag\u2019s minimum or maximum, it sets both to \u2018null\u2019 (meaning \u201cunknown\u201d) rather than failing to fetch the tag. In versions prior to Server 4.5.3, these values would be rejected.\u00a0<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">PHD Adaptor Settings<\/h2>\n<p class=\"intro-text\">The following table lists the adaptor's parameters, along with the <em>name<\/em>\u00a0and\u00a0<em>type<\/em>\u00a0to be used in the Import\/Export spreadsheet.<\/p>\n<table>\n<tbody>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\" width=\"170\"><strong>Parameter<\/strong><\/td>\n<td><strong>Description and example<\/strong><\/td>\n<td><strong>Name<\/strong><\/td>\n<td><strong>Type<\/strong><\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Server<\/span><\/strong><\/td>\n<td>Name of the server machine on which the historian is hosted.<\/td>\n<td>Server<\/td>\n<td>String<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Connection Type<\/span><\/strong><\/td>\n<td>The connection type to use when connecting to the PHD historian. While the Default type is normally sufficient, using Remote API may be necessary when connecting to a PHD server residing on a different domain to the machine where the adaptor is running. Options: Default, Remote API. <br \/>\nNote: This option was added in v4.5.3.<\/td>\n<td>ConnectionType<\/td>\n<td>String<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">User ID<\/span><\/strong><\/td>\n<td>User ID to use to connect to the historian.<\/td>\n<td>User ID<\/td>\n<td>String<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Password<\/span><\/strong><\/td>\n<td>Password for the User ID used to connect to the historian.<\/td>\n<td>Password<\/td>\n<td>EncryptedString<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Use Domain Authentication<\/span><\/strong><\/td>\n<td>When enabled, domain authentication will be used for the connection; please see the description for the \"User ID\" setting. This should be enabled if connecting to PHD 300 and disabled if connecting to PHD 200. Options: True, False.<\/td>\n<td>Use Domain Authentication<\/td>\n<td>Boolean<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">PHD Single Point Collapse Method<\/span><\/strong><\/td>\n<td>Specifies the handling method when more than one datum is returned for a single-point fetch. Default: <em>Oldest<\/em>.<\/td>\n<td>PHD Single Point Collapse Method<\/td>\n<td>String<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">PHD Default Average Sample Interval<\/span><\/strong><\/td>\n<td>The default average sampling interval (in seconds) to use when an incoming data request specifies the Average <a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-server\/primers\/transforms\/\">sample method<\/a>. Setting this parameter to zero (the default) will cause all all raw data to be fetched when calculating the average.<\/td>\n<td>PHD Default Average Sample Interval<\/td>\n<td>Integer<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">PHD Average Sampling Type<\/span><\/strong><\/td>\n<td>The sampling type for PHD to use when an incoming data request specifies the Average sample method. Default: <em>Resampled<\/em>.<\/td>\n<td>PHD Average Sampling Type<\/td>\n<td>String<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">PHD Average Reduction Type<\/span><\/strong><\/td>\n<td>The reduction type for PHD to use when an incoming data request specifies the Average sample method. Default: <em>Average<\/em>.<\/td>\n<td>PHD Average Reduction Type<\/td>\n<td>String<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">PHD Reduction Offset<\/span><\/strong><\/td>\n<td>The reduction offset for PHD to use when an incoming data request specifies the Average sample method. Default: <em>Before<\/em>.<br \/>\nNote: Prior to version 4.4.6, the default was <em>After<\/em>.<\/td>\n<td>PHD Reduction Offset<\/td>\n<td>String<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Enable Timing Logs<\/span><\/strong><\/td>\n<td>Enable this setting to log request timing information to the IFS OI Server logs, independently of whether reporting timing information is enabled on the incoming Data Broker request. Note: Log Level may need to be increased for these timing results to become visible in the logs. Options: True, False.<\/td>\n<td>Enable Timing Logs<\/td>\n<td>Boolean<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Allow Write<\/span><\/strong><\/td>\n<td>Whether this data source should allow IFS OI Server client applications to write data to tags on the historian. Options: True, False.<\/td>\n<td>AllowWrite<\/td>\n<td>Boolean<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Null Handling<\/span><\/strong><\/td>\n<td>Controls how the adaptor handles the presence of \"null\" (confidence is -1) data points in the historian. Changing this setting can, depending on the functions used, significantly affect the results of calculations based on tags from this datasource, should those tags contain such \"null\" points within the fetch range (default: As Historian). Options:<\/p>\n<ul>\n<li>AsHistorian<\/li>\n<li>Omit<\/li>\n<li>ReplaceWithNoValueErrorNoConfidence<\/li>\n<li>ReplaceWithNoValueErrorFullConfidence<\/li>\n<\/ul>\n<\/td>\n<td>NullHandling<\/td>\n<td>String<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<hr \/>\n<h2 class=\"page-subheading\"><span id=\"Release_History\">Release History<\/span><\/h2>\n<ul class=\"intro-text\">\n<li>PHD Adaptor Features 4.13.0\n<ul class=\"intro-text\">\n<li>Support for data types int(I) and long(L)<\/li>\n<\/ul>\n<\/li>\n<li>PHD Adaptor Features 4.10.3\n<ul class=\"intro-text\">\n<li>Added a separate 64-bit PHD Adaptor to the installer\u00a0<\/li>\n<\/ul>\n<\/li>\n<li>PHD Adaptor Features 4.6.5\n<ul class=\"intro-text\">\n<li>Added Null Handling<\/li>\n<\/ul>\n<\/li>\n<li>PHD Adaptor Features 4.5.3\n<ul class=\"intro-text\">\n<li>Added Connection Type<\/li>\n<li>Added support for minimum and maximum values that are defined using exponential notation<\/li>\n<\/ul>\n<\/li>\n<li>PHD Adaptor Features 4.3.1\n<ul class=\"intro-text\">\n<li>Initial version<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>The PHD Adaptor provides standardised access to Honeywell's Uniformance PHD Desktop Historian servers, hiding the complexity of obtaining data from PHD. The  Adaptor requires the Honeywell PHD API to be installed to access real-time and historical data from Honeywell's PHD historian. This article describes the features of the PHD Adaptor.<\/p>\n<p class=\"continue-reading-button\"> <a class=\"continue-reading-link\" href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-server\/primers\/datasources\/phd-adaptor-features\/\">Read more<i class=\"crycon-right-dir\"><\/i><\/a><\/p>\n","protected":false},"author":1,"featured_media":5210,"parent":3668,"menu_order":12,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":"","_members_access_role":[],"_members_access_error":""},"categories":[9],"tags":[98,305],"class_list":["post-5349","page","type-page","status-publish","has-post-thumbnail","hentry","category-tech-ref","tag-adaptors","tag-phd","Version-4-10-3","Version-4-13-0","Version-4-3-1","Version-4-5-3","Version-4-6-5","Product-srv"],"_links":{"self":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/5349","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/comments?post=5349"}],"version-history":[{"count":9,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/5349\/revisions"}],"predecessor-version":[{"id":67513,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/5349\/revisions\/67513"}],"up":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/3668"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/media\/5210"}],"wp:attachment":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/media?parent=5349"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/categories?post=5349"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/tags?post=5349"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}