{"id":17832,"date":"2026-07-27T10:46:49","date_gmt":"2026-07-27T13:46:49","guid":{"rendered":"https:\/\/kb.elipse.com.br\/?p=17832"},"modified":"2026-07-27T10:46:49","modified_gmt":"2026-07-27T13:46:49","slug":"escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/","title":{"rendered":"Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal."},"content":{"rendered":"
\n
\n
<\/div>\n<\/div>\n<\/div>\n
\n
\n

1.<\/span> Introdu\u00e7\u00e3o<\/h2>\n

\u00c9 comum precisar que uma a\u00e7\u00e3o do usu\u00e1rio em um dashboard do EPM Portal<\/strong> \u2014 como clicar em um bot\u00e3o \u2014 grave um valor em uma vari\u00e1vel do EPM<\/strong>, em vez de apenas ler e exibir dados. Isso \u00e9 o que permite, por exemplo, montar um controle simples de setpoint ou um comando manual diretamente no Portal.<\/p>\n

O EPM Portal resolve isso com um c\u00f3digo em TypeScript<\/strong> que usa o servi\u00e7o OpcUaService<\/code> para escrever um valor em uma vari\u00e1vel do EPM<\/strong>. Esse c\u00f3digo pode ser adicionado em dois lugares equivalentes: na propriedade Code<\/code> de um widget (por exemplo, um widget Button<\/strong>) ou em um Dataset Code<\/strong> do dashboard.<\/p>\n

\n

N\u00e3o confunda com o Dataset Processor<\/p>\n

Esse recurso n\u00e3o tem rela\u00e7\u00e3o com o Dataset Processor<\/strong> do EPM Portal \u2014 o Dataset Processor serve para chamar algoritmos em Python<\/strong> executados pelo EPM Processor<\/strong>. Aqui o c\u00f3digo roda em TypeScript<\/strong>, dentro do pr\u00f3prio Portal (widget Button ou Dataset Code).<\/p>\n<\/div>\n<\/section>\n

\n

2.<\/span> O que \u00e9 o c\u00f3digo do widget Button \/ Dataset Code<\/h2>\n

Tanto a propriedade Code<\/code> do widget Button<\/strong> quanto um Dataset Code<\/strong> do EPM Portal aceitam um c\u00f3digo em TypeScript<\/strong>. Dentro dele, o EPM Portal disponibiliza um servi\u00e7o de escrita (OpcUaService<\/code>) que permite localizar uma vari\u00e1vel do EPM pelo nome<\/strong> e gravar um valor nela<\/strong>.<\/p>\n

O valor gravado \u00e9 representado por um objeto (DataValue<\/code>) que re\u00fane tr\u00eas informa\u00e7\u00f5es: o valor<\/strong> em si, a qualidade<\/strong> e o timestamp<\/strong> (data\/hora) da escrita.<\/p>\n

\n

Por que isso resolve o problema?<\/p>\n

N\u00e3o \u00e9 preciso informar a qualidade e o timestamp manualmente: por padr\u00e3o, a qualidade \u00e9 registrada como Boa<\/strong> e o timestamp \u00e9 o momento em que o c\u00f3digo \u00e9 executado<\/strong> \u2014 ou seja, com uma \u00fanica chamada o c\u00f3digo j\u00e1 grava um valor v\u00e1lido e com data\/hora correta, sem passos adicionais.<\/p>\n<\/div>\n<\/section>\n

\n

3.<\/span> Como configurar a escrita da vari\u00e1vel<\/h2>\n
    \n
  1. Abra o dashboard no editor do EPM Portal<\/strong>.<\/li>\n
  2. Escolha onde o c\u00f3digo vai rodar: na propriedade Code<\/strong> de um widget Button<\/strong> (executado ao clicar) ou em um Dataset Code<\/strong> do dashboard.<\/li>\n
  3. Adicione o c\u00f3digo TypeScript abaixo, substituindo 'NomeDaVariavel'<\/code> pelo nome real da Basic Variable<\/strong> de destino no EPM.<\/li>\n
  4. Salve e publique o dashboard. A partir da\u00ed, a escrita ocorre conforme o disparo escolhido (clique no bot\u00e3o, ou execu\u00e7\u00e3o do Dataset Code).<\/li>\n<\/ol>\n

    O c\u00f3digo abaixo grava o valor 10<\/code> em uma Basic Variable:<\/p>\n

    \n
    <\/div>\n
    import<\/span> { BaseProcessor, IExecuteContext } from<\/span> '@elipse\/processor-javascript'<\/span>;\r\nimport<\/span> { OpcUaService, OpcUaVariable } from<\/span> '@elipse\/portal\/opcua'<\/span>;\r\nimport<\/span> { DataValue } from<\/span> '@elipse\/webapi\/common'<\/span>;\r\n\r\nexport class<\/span> CodeProcessor extends<\/span> BaseProcessor {\r\n  async<\/span> on_process(context: IExecuteContext, inputs: Map): Promise {\r\n    const<\/span> opcua = context.get_service(OpcUaService);\r\n\r\n    const<\/span> random1 = await<\/span> opcua.dataObjectAsync('NomeDaVariavel'<\/span>) as<\/span> OpcUaVariable;\r\n\r\n    const<\/span> value = new<\/span> DataValue(10, 0, new<\/span> Date());\r\n\r\n    \/\/ Escreve o valor 10 na vari\u00e1vel<\/span>\r\n    await<\/span> random1.writeAsync(value);\r\n  }\r\n}<\/pre>\n<\/div>\n<\/section>\n
    \n
    4.<\/span> Resultado<\/h2>\n
    Ao ser executado \u2014 pelo clique no widget Button ou pela execu\u00e7\u00e3o do Dataset Code \u2014 o OpcUaService<\/code> localiza a vari\u00e1vel pelo nome informado em dataObjectAsync<\/code> e executa writeAsync<\/code>, gravando o valor imediatamente na vari\u00e1vel do EPM, sem necessidade de nenhuma configura\u00e7\u00e3o adicional fora do pr\u00f3prio c\u00f3digo.<\/p>\n<\/section>\n
    \n
    5.<\/span> Observa\u00e7\u00f5es e boas pr\u00e1ticas<\/h2>\n
      \n
    • O objeto DataValue<\/code> concentra os tr\u00eas atributos de uma escrita OPC UA: value<\/code>, quality<\/code> e timestamp<\/code>. Quando esses dois \u00faltimos n\u00e3o s\u00e3o informados explicitamente, o padr\u00e3o \u00e9 qualidade Boa<\/strong> e timestamp do momento da escrita<\/strong>.<\/li>\n
    • O valor gravado n\u00e3o precisa ser fixo (como o 10<\/code> do exemplo). Tamb\u00e9m \u00e9 poss\u00edvel vincular uma entrada (input) do Dataset<\/strong> ao valor informado por outro widget do pr\u00f3prio dashboard \u2014 como um EditBox<\/strong> ou ComboBox<\/strong> \u2014 e escrever esse valor lido na vari\u00e1vel desejada, conforme a necessidade do dashboard.<\/li>\n
    • Como a escrita passa pelo OpcUaService<\/code>, a vari\u00e1vel de destino precisa estar acess\u00edvel como um objeto OPC UA v\u00e1lido a partir do Portal (ou seja, exposta\/mapeada normalmente como qualquer outra vari\u00e1vel usada em bindings do Portal).<\/li>\n<\/ul>\n<\/section>\n
      <\/section>\n
      \n
      <\/h2>\n<\/section>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
      1. Introdu\u00e7\u00e3o \u00c9 comum precisar que uma a\u00e7\u00e3o do usu\u00e1rio em um dashboard do EPM Portal \u2014 como clicar em um bot\u00e3o \u2014 grave um valor em uma vari\u00e1vel do…<\/p>\n","protected":false},"author":22,"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":[676,1126],"tags":[],"yoast_head":"\nEscrevendo em vari\u00e1veis do EPM a partir do EPM Portal.<\/title>\n<meta name=\"description\" content=\"Veja como gravar um valor em uma vari\u00e1vel do EPM a partir de um widgetButton ou Dataset Code do EPM Portal, usando OpcUaService e DataValueem TypeScript.\" \/>\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\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:locale:alternate\" content=\"pt_BR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal.\" \/>\n<meta property=\"og:description\" content=\"Veja como gravar um valor em uma vari\u00e1vel do EPM a partir de um widgetButton ou Dataset Code do EPM Portal, usando OpcUaService e DataValueem TypeScript.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/kb.elipse.com.br\/en\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/\" \/>\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=\"2026-07-27T13:46:49+00:00\" \/>\n<meta name=\"author\" content=\"Samir Lima\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Samir Lima\" \/>\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\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/\"},\"author\":{\"name\":\"Samir Lima\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/person\/6187f4add11d5e8b204dc7032d2f15cf\"},\"headline\":\"Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal.\",\"datePublished\":\"2026-07-27T13:46:49+00:00\",\"dateModified\":\"2026-07-27T13:46:49+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/\"},\"wordCount\":588,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#organization\"},\"articleSection\":[\"Elipse Plant Manager\",\"EPM Portal\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/\",\"url\":\"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/\",\"name\":\"Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal.\",\"isPartOf\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#website\"},\"datePublished\":\"2026-07-27T13:46:49+00:00\",\"dateModified\":\"2026-07-27T13:46:49+00:00\",\"description\":\"Veja como gravar um valor em uma vari\u00e1vel do EPM a partir de um widgetButton ou Dataset Code do EPM Portal, usando OpcUaService e DataValueem TypeScript.\",\"breadcrumb\":{\"@id\":\"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/kb.elipse.com.br\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal.\"}]},{\"@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\/6187f4add11d5e8b204dc7032d2f15cf\",\"name\":\"Samir Lima\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/e9f438f26a32e9429a4f6073c6598fae?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/e9f438f26a32e9429a4f6073c6598fae?s=96&d=mm&r=g\",\"caption\":\"Samir Lima\"},\"sameAs\":[\"https:\/\/www.linkedin.com\/in\/samirlima\"],\"url\":\"https:\/\/kb.elipse.com.br\/en\/author\/samir\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal.","description":"Veja como gravar um valor em uma vari\u00e1vel do EPM a partir de um widgetButton ou Dataset Code do EPM Portal, usando OpcUaService e DataValueem TypeScript.","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\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/","og_locale":"en_US","og_type":"article","og_title":"[:pt]Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal.[:] - Elipse Knowledgebase","og_description":"[:pt]Veja como gravar um valor em uma vari\u00e1vel do EPM a partir de um widgetButton ou Dataset Code do EPM Portal, usando OpcUaService e DataValueem TypeScript.[:]","og_url":"https:\/\/kb.elipse.com.br\/en\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/","og_site_name":"Elipse Knowledgebase","article_publisher":"http:\/\/www.facebook.com\/elipsesoftware","article_published_time":"2026-07-27T13:46:49+00:00","author":"Samir Lima","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Samir Lima","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/#article","isPartOf":{"@id":"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/"},"author":{"name":"Samir Lima","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/person\/6187f4add11d5e8b204dc7032d2f15cf"},"headline":"Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal.","datePublished":"2026-07-27T13:46:49+00:00","dateModified":"2026-07-27T13:46:49+00:00","mainEntityOfPage":{"@id":"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/"},"wordCount":588,"commentCount":0,"publisher":{"@id":"https:\/\/kb.elipse.com.br\/#organization"},"articleSection":["Elipse Plant Manager","EPM Portal"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/","url":"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/","name":"Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal.","isPartOf":{"@id":"https:\/\/kb.elipse.com.br\/#website"},"datePublished":"2026-07-27T13:46:49+00:00","dateModified":"2026-07-27T13:46:49+00:00","description":"Veja como gravar um valor em uma vari\u00e1vel do EPM a partir de um widgetButton ou Dataset Code do EPM Portal, usando OpcUaService e DataValueem TypeScript.","breadcrumb":{"@id":"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/kb.elipse.com.br\/escrevendo-em-variaveis-do-epm-a-partir-do-epm-portal\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/kb.elipse.com.br\/en\/"},{"@type":"ListItem","position":2,"name":"Escrevendo em vari\u00e1veis do EPM a partir do EPM Portal."}]},{"@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\/6187f4add11d5e8b204dc7032d2f15cf","name":"Samir Lima","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/e9f438f26a32e9429a4f6073c6598fae?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e9f438f26a32e9429a4f6073c6598fae?s=96&d=mm&r=g","caption":"Samir Lima"},"sameAs":["https:\/\/www.linkedin.com\/in\/samirlima"],"url":"https:\/\/kb.elipse.com.br\/en\/author\/samir\/"}]}},"_links":{"self":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts\/17832"}],"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\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/comments?post=17832"}],"version-history":[{"count":2,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts\/17832\/revisions"}],"predecessor-version":[{"id":17834,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts\/17832\/revisions\/17834"}],"wp:attachment":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/media?parent=17832"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/categories?post=17832"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/tags?post=17832"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}