{"id":3394,"date":"2019-03-25T17:44:05","date_gmt":"2019-03-25T20:44:05","guid":{"rendered":"http:\/\/xexeu.elipse.com.br\/pt\/customizing-your-powerexplorer\/"},"modified":"2019-10-03T13:09:38","modified_gmt":"2019-10-03T16:09:38","slug":"customizing-your-powerexplorer","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/","title":{"rendered":"Customizing your PowerExplorer."},"content":{"rendered":"
\n

The PowerExplorer <\/b>is a feature that automatically lists all analog and discrete measurements in a device, as well as all its commands and protections, with no need for further settings.<\/p>\n

\"\"<\/div>\n

This article illustrates a few alternatives for customizing the PowerExplorer’s interface.<\/p>\n

Accessing the object’s methods and properties<\/u><\/b><\/p>\n

To apply any changes to the interface’s behavior, you must first access the script of the XPowerMenuCreator <\/b>object, which is an XControl belonging to PowerControls <\/b>libraries.<\/p>\n

\"\"<\/div>\n

At Rectangle1’s script, use the script’s editor Search tool to retrieve “ShowPowerExplorer” text.<\/p>\n

\"\"<\/div>\n

The line containing this method will be retrieved. It is usually somewhere near line 300, but this position may vary according to the version of the library being used.<\/p>\n

\"\"<\/div>\n

Right below this line, add the following script:<\/p>\n

\u00a0\u00a0 set PE = Application.GetPowerExplorer(MeaPath)<\/span><\/div>\n

With this, the PowerExplorer object will be referred in the script’s PE variable. Thus, you will be able to access all its methods and properties. The more relevant ones will be shown next.<\/p>\n

Interlocked commands behavior<\/b><\/u><\/p>\n

The PowerExplorer has three different behaviors for the interlocked commands tab. To do so, set up CommandInterlockMode property with one of the following three values:<\/p>\n

    \n
  • 0 – cimDoNothing<\/b>: doesn’t send the command, doesn’t show the interlock notice, and doesn’t disable the Operate <\/b>button on PowerExplorer’s Commands <\/b>tab.<\/li>\n
  • 1 – cimWarning<\/b>: allows sending the command, but warns the user that this command unit is interlocked. The message is shown alongside the message that asks for confirmation for sending the command.<\/li>\n<\/ul>\n

     <\/p>\n

    \"\"<\/div>\n

     <\/p>\n

      \n
    • 2 – cimBlockCommand<\/b>: blocks sending the command, disabling the buttons even when there are set up scripts. The exception is the Cancel button, which is never disabled.<\/li>\n<\/ul>\n

       <\/p>\n

      \"\"<\/div>\n

      The script should look like this:<\/p>\n

      \u00a0\u00a0\u00a0 set PE = Application.GetPowerExplorer(MeaPath)
      \nPE.CommandInterlockMode = xxx\u00a0 ‘0, 1 ou 2<\/span><\/p>\n

      Opening the window in Read Only<\/i> mode<\/b><\/u><\/p>\n

      You must edit ReadOnly <\/i>property. When it is set up as True, you can neither edit measurements nor send commands (the command’s Select<\/b>, Operate<\/b>, and Cancel <\/b>buttons are disabled).\u00a0 This property’s default value is False.<\/p>\n

      \"\"<\/div>\n

      The script should look like this:<\/p>\n

      \u00a0\u00a0\u00a0 set PE = Application.GetPowerExplorer(MeaPath)<\/span>
      \n\u00a0\u00a0\u00a0 PE.ReadOnly = xxx\u00a0 ‘TRUE ou FALSE<\/span><\/div>\n

      Displaying the timestamp’s measurements<\/b><\/u><\/p>\n

      You must edit ShowMeasurementTimestamp <\/i>property. When it is set up as True, an extra column will be displayed at PowerExplorer’s window, with the measurement’s timestamp. These settings apply to the three tabs showing the measurements: Analog<\/b>, Discrete<\/b>, and Protections<\/b>.<\/p>\n

      \"\"<\/div>\n

      The script should look like this:<\/p>\n

      \u00a0\u00a0\u00a0 set PE = Application.GetPowerExplorer(MeaPath)
      \nPE.ShowMeasurementTimestamp = xxx\u00a0 ‘TRUE ou FALSE<\/span><\/p>\n

      Hiding tabs<\/b><\/u><\/p>\n

      You must edit TabsEnabled <\/i>property, which allows you to set up the visible tabs on PowerExplorer window. If the window is already open, the tabs will be immediately updated. The property’s final value is any sum of the following values:<\/p>\n

        \n
      • 1: Shows only the Analog <\/b>tab<\/li>\n
      • 2: Shows only the Discrete <\/b>tab<\/li>\n
      • 4: Shows only the Commands <\/b>tab<\/li>\n
      • 8: Shows only the Protection <\/b>tab<\/li>\n<\/ul>\n

        For example, value 3 will show Analog <\/b>and Discrete <\/b>tabs while hiding Commands <\/b>and Protections<\/b>; value 12 shows Commands <\/b>and Protections <\/b>tabs while hiding Analog <\/b>and Discrete<\/b>.\u00a0 Special value -1 always shows all tabs (default). Value 0 (zero) is not accepted, which means you can’t hide all tabs (any attempt to do so will generate a script error).<\/p>\n

        \"\"<\/div>\n

        The script should look like this:<\/p>\n

        \u00a0\u00a0\u00a0 set PE = Application.GetPowerExplorer(MeaPath)
        \nPE.TabsEnabled = xxx ‘value between 1 and 15<\/span><\/p>\n

        Adding customized tabs<\/b><\/u><\/p>\n

        You must use InsertScreenTab <\/i>method:
        \n
        \nInsertScreenTab(TabName, TabTitle, ScreenPath[, Arg])<\/span><\/p>\n

        This tab is always inserted in the last position. Its parameters are:<\/p>\n

          \n
        • TabName<\/b>: this tab’s internal name. The method generates a script error if the tab’s name is an empty string or one of the default names (Analog, Discrete, Commands, or Protections).<\/li>\n
        • TabTitle<\/b>: this tab’s title. This is the text viewed by the operator on screen. If this parameter is empty, the value displayed is the same as TabName <\/b>parameter.<\/li>\n
        • ScreenPath<\/b>: name of the screen that will open when the tab is selected.<\/li>\n
        • Arg<\/b>: optional parameter, indicates the argument that will be passed to the screen when it opens. When clicking on the tab to activate it, the screen’s OnPreShow <\/i>event is fired, receiving then the value passed by Arg <\/b>parameter.<\/li>\n<\/ul>\n

          The script should look like this:<\/p>\n

          \u00a0\u00a0\u00a0 set PE = Application.GetPowerExplorer(MeaPath)<\/span>
          \n\u00a0\u00a0\u00a0 PE.InsertScreenTab “AlarmsTab”, “Alarms”, “Alarms_Screen”, MeaPath<\/span><\/div>\n

          In this example, a tab called Alarms <\/b>will be available to the operator, and when clicked it will open the Alarms_Screen<\/b> screen. The device has been passed as an argument, therefore the developer must capture this information at the screen’s OnPreShow <\/i>event and use it to set up its alarms banner’s filter.<\/p>\n

          \"\"<\/div>\n

          Changing the screen’s initial tab<\/b><\/u><\/p>\n

          You must set up ActiveTab <\/i>property. It receives a string with the name of the desired tab. The possible values are: Analog<\/b>, Discrete<\/b>, Commands<\/b>, Protections<\/b>, or any other name the user had added as a customized tab.<\/p>\n

          The script should look like this:
          \n
          \nset PE = Application.GetPowerExplorer(MeaPath)
          \nPE.ActiveTab = “xxxx” ‘tab name<\/span><\/p>\n

          You should remember that all of the object’s methods and properties are documented at the Elipse Power’s Scripts Reference<\/b>, under Visualization–PowerExplorer<\/b>. This article only presents the more important one, but a thorough and careful read of Elipse Power’s documentation is recommended for further information on this subject.<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

          The PowerExplorer is a feature that automatically lists all analog and discrete measurements in a device, as well as all its commands and protections, with no need for further settings.…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0},"categories":[825],"tags":[],"yoast_head":"\nCustomizing your PowerExplorer. - Elipse Knowledgebase<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Customizing your PowerExplorer.\" \/>\n<meta property=\"og:description\" content=\"The PowerExplorer is a feature that automatically lists all analog and discrete measurements in a device, as well as all its commands and protections, with no need for further settings.…\" \/>\n<meta property=\"og:url\" content=\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/\" \/>\n<meta property=\"og:site_name\" content=\"Elipse Knowledgebase\" \/>\n<meta property=\"article:publisher\" content=\"http:\/\/www.facebook.com\/elipsesoftware\" \/>\n<meta property=\"article:published_time\" content=\"2019-03-25T20:44:05+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2019-10-03T16:09:38+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/kb.elipse.com.br\/pt-br\/images\/ID5086\/Figura1.jpg\" \/>\n<meta name=\"author\" content=\"Elipse Software\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Elipse Software\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/\"},\"author\":{\"name\":\"Elipse Software\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/person\/def69ea453ea60b250497b89225a9f87\"},\"headline\":\"Customizing your PowerExplorer.\",\"datePublished\":\"2019-03-25T20:44:05+00:00\",\"dateModified\":\"2019-10-03T16:09:38+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/\"},\"wordCount\":854,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#organization\"},\"articleSection\":[\"Elipse Power\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/\",\"url\":\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/\",\"name\":\"[:pt]Customizing your PowerExplorer.[:] - Elipse Knowledgebase\",\"isPartOf\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#website\"},\"datePublished\":\"2019-03-25T20:44:05+00:00\",\"dateModified\":\"2019-10-03T16:09:38+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/kb.elipse.com.br\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Customizing your PowerExplorer.\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/kb.elipse.com.br\/#website\",\"url\":\"https:\/\/kb.elipse.com.br\/\",\"name\":\"Elipse Knowledgebase\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/kb.elipse.com.br\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/kb.elipse.com.br\/#organization\",\"name\":\"Elipse Software\",\"url\":\"https:\/\/kb.elipse.com.br\/\",\"sameAs\":[\"http:\/\/www.facebook.com\/elipsesoftware\"],\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/kb.elipse.com.br\/wp-content\/uploads\/2019\/05\/schererelipse-com-br\/logoElipse.png\",\"contentUrl\":\"https:\/\/kb.elipse.com.br\/wp-content\/uploads\/2019\/05\/schererelipse-com-br\/logoElipse.png\",\"width\":161,\"height\":58,\"caption\":\"Elipse Software\"},\"image\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/person\/def69ea453ea60b250497b89225a9f87\",\"name\":\"Elipse Software\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/ff1f7ec38f4687b06f6851d97b3cd2d0?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/ff1f7ec38f4687b06f6851d97b3cd2d0?s=96&d=mm&r=g\",\"caption\":\"Elipse Software\"},\"url\":\"https:\/\/kb.elipse.com.br\/en\/author\/webmasterelipse-com-br\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Customizing your PowerExplorer. - Elipse Knowledgebase","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/","og_locale":"en_US","og_type":"article","og_title":"[:pt]Customizing your PowerExplorer.[:] - Elipse Knowledgebase","og_description":"The PowerExplorer is a feature that automatically lists all analog and discrete measurements in a device, as well as all its commands and protections, with no need for further settings.…","og_url":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/","og_site_name":"Elipse Knowledgebase","article_publisher":"http:\/\/www.facebook.com\/elipsesoftware","article_published_time":"2019-03-25T20:44:05+00:00","article_modified_time":"2019-10-03T16:09:38+00:00","og_image":[{"url":"http:\/\/kb.elipse.com.br\/pt-br\/images\/ID5086\/Figura1.jpg"}],"author":"Elipse Software","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Elipse Software","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/#article","isPartOf":{"@id":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/"},"author":{"name":"Elipse Software","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/person\/def69ea453ea60b250497b89225a9f87"},"headline":"Customizing your PowerExplorer.","datePublished":"2019-03-25T20:44:05+00:00","dateModified":"2019-10-03T16:09:38+00:00","mainEntityOfPage":{"@id":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/"},"wordCount":854,"commentCount":0,"publisher":{"@id":"https:\/\/kb.elipse.com.br\/#organization"},"articleSection":["Elipse Power"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/","url":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/","name":"[:pt]Customizing your PowerExplorer.[:] - Elipse Knowledgebase","isPartOf":{"@id":"https:\/\/kb.elipse.com.br\/#website"},"datePublished":"2019-03-25T20:44:05+00:00","dateModified":"2019-10-03T16:09:38+00:00","breadcrumb":{"@id":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/kb.elipse.com.br\/en\/customizing-your-powerexplorer\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/kb.elipse.com.br\/en\/"},{"@type":"ListItem","position":2,"name":"Customizing your PowerExplorer."}]},{"@type":"WebSite","@id":"https:\/\/kb.elipse.com.br\/#website","url":"https:\/\/kb.elipse.com.br\/","name":"Elipse Knowledgebase","description":"","publisher":{"@id":"https:\/\/kb.elipse.com.br\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/kb.elipse.com.br\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/kb.elipse.com.br\/#organization","name":"Elipse Software","url":"https:\/\/kb.elipse.com.br\/","sameAs":["http:\/\/www.facebook.com\/elipsesoftware"],"logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/logo\/image\/","url":"https:\/\/kb.elipse.com.br\/wp-content\/uploads\/2019\/05\/schererelipse-com-br\/logoElipse.png","contentUrl":"https:\/\/kb.elipse.com.br\/wp-content\/uploads\/2019\/05\/schererelipse-com-br\/logoElipse.png","width":161,"height":58,"caption":"Elipse Software"},"image":{"@id":"https:\/\/kb.elipse.com.br\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/person\/def69ea453ea60b250497b89225a9f87","name":"Elipse Software","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/ff1f7ec38f4687b06f6851d97b3cd2d0?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/ff1f7ec38f4687b06f6851d97b3cd2d0?s=96&d=mm&r=g","caption":"Elipse Software"},"url":"https:\/\/kb.elipse.com.br\/en\/author\/webmasterelipse-com-br\/"}]}},"_links":{"self":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts\/3394"}],"collection":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/comments?post=3394"}],"version-history":[{"count":1,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts\/3394\/revisions"}],"predecessor-version":[{"id":8954,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts\/3394\/revisions\/8954"}],"wp:attachment":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/media?parent=3394"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/categories?post=3394"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/tags?post=3394"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}