{"id":25053,"date":"2018-01-03T13:13:07","date_gmt":"2018-01-03T05:13:07","guid":{"rendered":"http:\/\/localhost\/help\/?page_id=25053"},"modified":"2024-06-06T11:42:49","modified_gmt":"2024-06-06T03:42:49","slug":"using-labels","status":"publish","type":"page","link":"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/using-the-page-controls\/using-labels\/","title":{"rendered":"Using Labels"},"content":{"rendered":"\n<p class=\"left-bar\">This article applies to versions 4.5.3 and later of IFS OI Explorer. See <a href=\"#Release_History\">Release History<\/a> for more.<\/p>\n<h2 class=\"page-subheading\"><span id=\"Overview\">Overview<\/span><\/h2>\n<p class=\"intro-text\">IFS OI Explorer pages are interactive, allowing you to display labels that can change depending on various selections made on a page. This article describes how labels can change and how to use them to obtain further information from your data.<\/p>\n<p class=\"intro-text\">You may find either of the following label types on your page:<\/p>\n<ul class=\"intro-text\">\n<li>Data label<\/li>\n<li>Text label<\/li>\n<\/ul>\n<p class=\"intro-text\">Data Labels and Text Labels look similar, but are designed for different purposes.<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">Data Label<\/h2>\n<p class=\"intro-text\">The data label displays a single value, usually from a tag, calculation, or attribute value.<\/p>\n<p class=\"intro-text\">If a data label is configured to show units, then these can appear as a prefix or a suffix to the value, or not at all, depending on the configuration (the units appear in the tooltip as well).<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-32330 size-full alignnone\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Data-Label-Tooltip-2.png\" alt=\"\" width=\"329\" height=\"117\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Data-Label-Tooltip-2.png 329w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Data-Label-Tooltip-2-150x53.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Data-Label-Tooltip-2-24x9.png 24w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Data-Label-Tooltip-2-36x13.png 36w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Data-Label-Tooltip-2-48x17.png 48w\" sizes=\"auto, (max-width: 329px) 100vw, 329px\" \/><\/p>\n<p class=\"intro-text\">The displayed decimal value for a tag is based either on the decimal value in the control (if this has been configured), or on the tag\u2019s decimal value, as defined in IFS OI Server.<\/p>\n<p class=\"note\"><strong>Note<\/strong>: Units have to be configured for a tag in IFS OI Server, in order to appear in Explorer.<\/p>\n<p class=\"no-toc-heading\">Digital State Sets<\/p>\n<p class=\"intro-text\">If the data label's value contains a tag or calculation that has a digital state set assigned, the corresponding digital state pair's <em>Name<\/em> is used instead of the <em>Value,<\/em> if there is a match.<\/p>\n<table style=\"border: 1px solid #cccccc;\">\n<tbody>\n<tr>\n<td style=\"padding-left: 5px;\" width=\"400\">\n<p>This data label's value uses a calculation tag with an allocated digital state set, which causes it to display 'F' instead of 5:<\/p>\n<\/td>\n<td style=\"padding-left: 5px;\" width=\"400\">\n<p>This data label's value uses a similar calculation tag, but without an allocated digital state set:<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"padding-left: 5px;\" width=\"400\">\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-32339 size-full alignnone\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Using-a-digital-state-set.png\" alt=\"\" width=\"400\" height=\"108\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Using-a-digital-state-set.png 400w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Using-a-digital-state-set-150x41.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Using-a-digital-state-set-24x6.png 24w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Using-a-digital-state-set-36x10.png 36w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Using-a-digital-state-set-48x13.png 48w\" sizes=\"auto, (max-width: 400px) 100vw, 400px\" \/><\/p>\n<\/td>\n<td width=\"400\">\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-32338 size-full alignnone\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Not-using-a-digital-state-set.png\" alt=\"\" width=\"446\" height=\"115\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Not-using-a-digital-state-set.png 446w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Not-using-a-digital-state-set-150x39.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Not-using-a-digital-state-set-24x6.png 24w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Not-using-a-digital-state-set-36x9.png 36w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Not-using-a-digital-state-set-48x12.png 48w\" sizes=\"auto, (max-width: 446px) 100vw, 446px\" \/><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Hover<\/h3>\n<p class=\"intro-text\">When you hover over a label and see a tooltip, then this is a data label rather than a plain text label. Data labels are often used to display numerical data (although they can also used for string attribute values). The tooltip shows the data label\u2019s data definition which could be a tag name, a fully qualified attribute name, an ad hoc calculation, or a dataset query name with value column name. Data label tooltips for tags and attributes show units (where available), as well the description.<\/p>\n<table style=\"border: 1px solid #cccccc;\">\n<tbody>\n<tr>\n<td style=\"padding-left: 5px;\" width=\"400\">\n<p>Hovering over a data label for an attribute value:<\/p>\n<\/td>\n<td style=\"padding-left: 5px;\" width=\"400\">\n<p>Hovering over a data label for a tag:<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"padding-left: 5px;\" width=\"400\">\n<p><a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-2-1.png\" rel=\"lightbox-0\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-32290 size-full alignnone\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-2-1.png\" alt=\"\" width=\"321\" height=\"106\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-2-1.png 321w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-2-1-150x50.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-2-1-24x8.png 24w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-2-1-36x12.png 36w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-2-1-48x16.png 48w\" sizes=\"auto, (max-width: 321px) 100vw, 321px\" \/><\/a><\/p>\n<\/td>\n<td width=\"400\">\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-32291 size-full alignnone\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-3-1.png\" alt=\"\" width=\"280\" height=\"117\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-3-1.png 280w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-3-1-150x63.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-3-1-24x10.png 24w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-3-1-36x15.png 36w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/Display-Mode-3-1-48x20.png 48w\" sizes=\"auto, (max-width: 280px) 100vw, 280px\" \/><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Right-click<\/h3>\n<p class=\"intro-text\">Depending on what data your data label has been configured to display, when you right-click the component, a variety of menu options is presented.<\/p>\n<p><a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/right-click-menu-options.png\" rel=\"lightbox-1\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-32253 size-full alignnone\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/right-click-menu-options.png\" alt=\"\" width=\"236\" height=\"128\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/right-click-menu-options.png 236w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/right-click-menu-options-150x81.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/right-click-menu-options-24x13.png 24w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/right-click-menu-options-36x20.png 36w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2017\/10\/right-click-menu-options-48x26.png 48w\" sizes=\"auto, (max-width: 236px) 100vw, 236px\" \/><\/a><\/p>\n<table>\n<tbody>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\" width=\"120px\"><strong>Menu option<\/strong><\/td>\n<td><strong>Displayed for<\/strong><\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/trends\/explorer-trend-interactive-tour\/\">Open Trend<\/a><\/td>\n<td>Time series data. Opens a trend containing a trace of the data.<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/explorer-getting-started\/point-detail\/\">Open Detail<\/a><\/td>\n<td>Attribute value or tag. Opens the Point Detail page of the data point.<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/using-the-page-controls\/writing-values\/\">Write Value<\/a><\/td>\n<td>Attribute value or tag, if the datasource allows writing to the database. Opens the <strong>Enter value<\/strong> dialog, where you can change the value of the data point.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p class=\"left-bar-blue\"><i class=\"fa fa-eye fa-2x fa-pull-left\">\u00a0<\/i>Watch this video to see the functionality available on the menu.<\/p>\n\r\n\t<!-- Begin Video.js -->\r\n\t<video id=\"example_video_id_1142492578\" class=\"video-js vjs-default-skin\" width=\"818\" height=\"624\" controls preload=\"auto\" data-setup='[]'>\r\n\t\t<source src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/videos\/DemoDataLabel.mp4\" type='video\/mp4' \/>\r\n\t\t\r\n\t\t\r\n\t<\/video>\r\n\t<!-- End Video.js -->\r\n\n<p>&nbsp;<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">Text Label<\/h2>\n<p class=\"intro-text\">Text labels display some text and are often used for headings, titles, and to convey information or instructions.<\/p>\n<p class=\"intro-text\">Sometimes the text label is used to display data from IFS OI Server, such as tags, attribute values, or calculations. <br \/>\nIf the text label's content includes a tag or calculation that has a digital state set assigned, the corresponding digital state pair's <em>Name<\/em> is used instead of the <em>Value,<\/em> if there is a match.<\/p>\n<p class=\"intro-text\">Depending on how text labels are configured, they can sometimes change depending on what is displayed on the page. For example, the label may display an entity, which could change depending on what is selected from a <a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/using-the-page-controls\/selecting-items\/\">combo box<\/a>.<\/p>\n<p class=\"intro-text\">\u00a0Watch the following video for an example of a text label that displays the name of the entity selected from a combo box.<\/p>\n\r\n\t<!-- Begin Video.js -->\r\n\t<video id=\"example_video_id_1501425291\" class=\"video-js vjs-default-skin\" width=\"816\" height=\"548\" controls preload=\"auto\" data-setup='[]'>\r\n\t\t<source src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/videos\/SelectedOptionInTextLabel.mp4\" type='video\/mp4' \/>\r\n\t\t\r\n\t\t\r\n\t<\/video>\r\n\t<!-- End Video.js -->\r\n\n<p>&nbsp;<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">Release History<\/h2>\n<ul class=\"intro-text\">\n<li class=\"overview\">Using Labels 4.5.3 (this release)\n<ul>\n<li class=\"overview\">The data label's tooltip has changed; it now shows the data label\u2019s data definition which could be a tag name, a fully qualified attribute name, an ad hoc calculation, or a dataset query name with value column name. Data labels for tags and attributes show units (where available), as well the description.<\/li>\n<\/ul>\n<\/li>\n<li class=\"intro-text\">Using Labels 4.4.6\n<ul>\n<li class=\"intro-text\">The radial menu has been replaced by a context menu.<\/li>\n<\/ul>\n<\/li>\n<li class=\"intro-text\"><a title=\"Using Labels (4.4.5)\" href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/using-the-page-controls\/using-labels\/using-labels-4-4-5\/\">Using Labels 4.4.5<\/a>\n<ul>\n<li>Tags can have units configured and stored in P2 Server. These can be displayed in the Data Label, using the new <strong>Units Location<\/strong> property.<\/li>\n<li>Tag decimals are configured and stored in P2 Server, which means they don't need to be configured for the component.<\/li>\n<\/ul>\n<\/li>\n<li class=\"intro-text\"><a title=\"Using Labels (4.4)\" href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/using-the-page-controls\/using-labels\/using-labels-4-4\/\">Using Labels 4.4<\/a><\/li>\n<li class=\"intro-text\"><a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/using-the-page-controls\/using-labels\/using-labels-4-3-1\/\"><span class=\"removed_link\" title=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/using-the-page-controls\/using-labels-4-3-1\/\">Using Labels 4.3.1<\/span><\/a><\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>IFS OI Explorer pages are interactive, allowing you to display labels that can change depending on various selections made on a page. This article describes how labels can change and how to use them to obtain further information from your data.<\/p>\n<p class=\"continue-reading-button\"> <a class=\"continue-reading-link\" href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/using-the-page-controls\/using-labels\/\">Read more<i class=\"crycon-right-dir\"><\/i><\/a><\/p>\n","protected":false},"author":8,"featured_media":25057,"parent":4254,"menu_order":44,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":"","_members_access_role":[],"_members_access_error":""},"categories":[4],"tags":[30,513],"class_list":["post-25053","page","type-page","status-publish","has-post-thumbnail","hentry","category-explainer","tag-labels","tag-text","Product-ex"],"_links":{"self":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/25053","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\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/comments?post=25053"}],"version-history":[{"count":3,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/25053\/revisions"}],"predecessor-version":[{"id":66974,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/25053\/revisions\/66974"}],"up":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/4254"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/media\/25057"}],"wp:attachment":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/media?parent=25053"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/categories?post=25053"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/tags?post=25053"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}