{"id":133,"date":"2015-11-20T15:07:44","date_gmt":"2015-11-20T18:07:44","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?page_id=133"},"modified":"2026-01-13T13:47:17","modified_gmt":"2026-01-13T16:47:17","slug":"agente-de-comunicacao","status":"publish","type":"page","link":"https:\/\/www.l2maker.com.br\/documentacao\/agente-de-comunicacao\/","title":{"rendered":"Agente de comunica\u00e7\u00e3o"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Com a advento da interrup\u00e7\u00e3o do suporte a Applets no Chrome desenvolvemos um agente especial que permite continuar usando as nossas fun\u00e7\u00f5es na camada cliente.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Como funciona<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Um programa especial \u00e9 instalado no computador do cliente (usu\u00e1rio do sistema) e ir\u00e1 fornecer suporte aos recursos antes fornecidos pelos Applets do Java.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O programa deve ser iniciado na m\u00e1quina do cliente sempre que ele precisar usar uma das fun\u00e7\u00f5es nativas. Por padr\u00e3o o programa se inicia e executa na &#8220;bandeja&#8221; do Windows.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Restri\u00e7\u00f5es e Uso<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">A partir de <span style=\"color: #ff0000;\"><strong>SETEMBRO de 2021<\/strong><\/span> os navegadores Chrome e outros passaram a <span style=\"color: #ff0000;\">exigir HTTPS<\/span> (HTTP SEGURO) para comunica\u00e7\u00e3o com agentes instalados localmente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Assim, para usar local\/desenvolvimento <strong><span style=\"color: #000080;\">voc\u00ea deve<\/span><\/strong> acessar o Webrun atr\u00e1ves do endere\u00e7o <strong><span style=\"color: #000080;\">http:\/\/localhost:PORTA\/webrun<\/span><\/strong>&#8230;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><span style=\"color: #ff0000;\">N\u00e3o usar<\/span> http:\/\/<del><span style=\"color: #ff0000;\"><strong>127.0.0.1<\/strong><\/span><\/del>:PORTA\/contexto, <span style=\"color: #000080;\"><strong>sempre usa<\/strong><\/span>r http:\/\/<strong><span style=\"color: #000080;\">localhost<\/span><\/strong>:PORTA\/contexto<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para <strong>acesso remoto deve sempre usar HTTPS<\/strong>:\/\/servidor.xyz.br&#8230;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Esta restri\u00e7\u00e3o afeta TODAS AS VERS\u00d5ES do Agente e das APIs nele instaladas.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Refer\u00eancias:<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/developer.mozilla.org\/en-US\/docs\/Web\/Security\/Mixed_content?utm_source=mozilla&amp;utm_medium=firefox-console-errors&amp;utm_campaign=default\" target=\"_blank\" rel=\"noopener\">https:\/\/developer.mozilla.org\/en-US\/docs\/Web\/Security\/Mixed_content?utm_source=mozilla&amp;utm_medium=firefox-console-errors&amp;utm_campaign=default<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/blog.chromium.org\/2019\/10\/no-more-mixed-messages-about-https.html\" target=\"_blank\" rel=\"noopener\">https:\/\/blog.chromium.org\/2019\/10\/no-more-mixed-messages-about-https.html<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/developer.mozilla.org\/en-US\/docs\/Web\/Security\/Mixed_content\/How_to_fix_website_with_mixed_content\" target=\"_blank\" rel=\"noopener\">https:\/\/developer.mozilla.org\/en-US\/docs\/Web\/Security\/Mixed_content\/How_to_fix_website_with_mixed_content<\/a><\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Solu\u00e7\u00f5es alternativas:<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Alguns navegadores permitem desabilitar essa valida\u00e7\u00e3o, <span style=\"color: #ff0000;\"><strong>o suporte padr\u00e3o n\u00e3o cobre tais configura\u00e7\u00f5es<\/strong><\/span>, use por conta e risco:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/stackoverflow.com\/questions\/18321032\/how-to-get-chrome-to-allow-mixed-content\" target=\"_blank\" rel=\"noopener\">https:\/\/stackoverflow.com\/questions\/18321032\/how-to-get-chrome-to-allow-mixed-content<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/experienceleague.adobe.com\/en\/docs\/target\/using\/experiences\/vec\/troubleshoot-composer\/mixed-content\" target=\"_blank\" rel=\"noopener\">https:\/\/experienceleague.adobe.com\/en\/docs\/target\/using\/experiences\/vec\/troubleshoot-composer\/mixed-content<\/a><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">IMPORTANTE: Qualquer solicita\u00e7\u00e3o de suporte deve ser feita num servidor em &#8220;localhost&#8221; ou num dom\u00ednio com HTTPS. Caso se fa\u00e7a necess\u00e1rio, contrate horas de suporte\/mentoring para atender ambientes espec\u00edficos.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Instala\u00e7\u00e3o\/Configura\u00e7\u00e3o do HTTPS<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">O suporte a instala\u00e7\u00e3o\/configura\u00e7\u00e3o do HTTPS n\u00e3o \u00e9 fornecido como parte do suporte \u00e0s APIs. Voc\u00ea pode usar HTTPS de qualquer fornecedor, desde que compat\u00edvel com os navegadores modernos (Chrome, Firefox&#8230;). Entre os fornecedores tem a op\u00e7\u00e3o gratuita do <a href=\"https:\/\/letsencrypt.org\/\" target=\"_blank\" rel=\"noopener\">https:\/\/letsencrypt.org\/<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Se precisar de ajuda com a configura\u00e7\u00e3o do HTTPS voc\u00ea pode contratar horas de consultoria\/mentoria.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Como instalar<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Baixe a \u00faltima vers\u00e3o e execute o instalador&nbsp;passo-a-passo. Ele ir\u00e1 instalar e criar os atalhos de inicializa\u00e7\u00e3o. O pacote vem sem nenhuma API pr\u00e9-instalada, voc\u00ea deve adicionar as APIs que deseja utilizar.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Instalando\/Atualizando APIs ou a licen\u00e7a<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Baixa o&nbsp;pacote da API que deseja instalar (vers\u00f5es publicadas ap\u00f3s 05\/05\/2016);<\/li>\n\n\n\n<li>Abra o Agente, se estiver minimizado use o bot\u00e3o direito para exibir a interface completa;<\/li>\n\n\n\n<li>Clique sobre o bot\u00e3o &#8220;Instalar \/ Atualizar API&#8221;;<br><br><figure><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2015\/11\/passo1.png\"><img loading=\"lazy\" decoding=\"async\" width=\"300\" height=\"196\" class=\"alignnone size-medium wp-image-479\" src=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2015\/11\/passo1-300x196.png\" alt=\"passo1\" srcset=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2015\/11\/passo1-300x196.png 300w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2015\/11\/passo1.png 568w\" sizes=\"auto, (max-width: 300px) 100vw, 300px\" \/><\/a><\/figure><\/li>\n\n\n\n<li>Selecione o arquivo ZIP com a vers\u00e3o da API, repita esse passo para cada API que deseja instalar no Agente;<\/li>\n\n\n\n<li>Ap\u00f3s importr todas as APIs importe o XML de licen\u00e7a;<br><br><figure><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2015\/11\/passo2.png\"><img loading=\"lazy\" decoding=\"async\" width=\"300\" height=\"196\" class=\"alignnone size-medium wp-image-480\" src=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2015\/11\/passo2-300x196.png\" alt=\"passo2\" srcset=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2015\/11\/passo2-300x196.png 300w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2015\/11\/passo2.png 569w\" sizes=\"auto, (max-width: 300px) 100vw, 300px\" \/><\/a><\/figure><\/li>\n\n\n\n<li>Se o UAC estiver ativo ser\u00e1 necess\u00e1rio conceder permiss\u00e3o para execu\u00e7\u00e3o;<\/li>\n\n\n\n<li>Ap\u00f3s a importa\u00e7\u00e3o um novo servi\u00e7o estar\u00e1 dispon\u00edvel.<\/li>\n\n\n\n<li>Repita os mesmos passos para o arquivo de licen\u00e7a (l2s-licensas.xml).<\/li>\n<\/ol>\n\n\n\n<h1 class=\"wp-block-heading\">Configura\u00e7\u00f5es e Ajustes<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">O agente permite algumas personaliza\u00e7\u00f5es, como trocar a vers\u00e3o do Java, ou obter os logs de uma API.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Logs das APIs<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Para acessar a tela de logs simplesmente d\u00ea um clique duplo sobre o espa\u00e7o vazio entre o nome da API e o bot\u00e3o de iniciar\/parar.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2023\/07\/agente-duplo-clique.png\"><img loading=\"lazy\" decoding=\"async\" width=\"535\" height=\"365\" src=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2023\/07\/agente-duplo-clique.png\" alt=\"\" class=\"wp-image-2976\" srcset=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2023\/07\/agente-duplo-clique.png 535w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2023\/07\/agente-duplo-clique-300x205.png 300w\" sizes=\"auto, (max-width: 535px) 100vw, 535px\" \/><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Trocando a vers\u00e3o do Java<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Para usar uma vers\u00e3 odo Java espec\u00edfica voc\u00ca deve seguir os seguintes passos:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Duplo clique no topo do agente, sobre o nome &#8220;Agente de comunica\u00e7\u00e3o&#8221;;<\/li>\n\n\n\n<li>Na tela que se abre desmarque a op\u00e7\u00e3o &#8220;Automatico&#8221; (se estiver marcada);<\/li>\n\n\n\n<li>Informe o caminho do Java desejado, apontado para a raiz da pasta (EX: &#8220;C:\\Program Files (x86)\\Java\\jdk1.8.0_<strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">405<\/mark><\/strong>&#8220;);<\/li>\n\n\n\n<li>Pressine &#8220;OK&#8221;;<\/li>\n\n\n\n<li>Pare e inicie novamente as APIs para que a altera\u00e7\u00e3o tenha efeito.<\/li>\n<\/ol>\n\n\n\n<h1 class=\"wp-block-heading\">Gerando uma vers\u00e3o para distribui\u00e7\u00e3o<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">\u00c9 poss\u00edvel gerar uma vers\u00e3o de instala\u00e7\u00e3o com todas as APIs e a licen\u00e7a j\u00e1 adicionada, facilitando assim a distribui\u00e7\u00e3o do agente para os usu\u00e1rio finais.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Este novo instalador n\u00e3o precisa da adi\u00e7\u00e3o de novas APIs, todas as configuradas j\u00e1 v\u00e3o estar inicialmente configuradas ap\u00f3s a instala\u00e7\u00e3o no cliente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para gerar o novo instalador basta clicar com o bot\u00e3o direito em algum espa\u00e7o vazio do Agente e escolher a op\u00e7\u00e3o &#8220;<strong>Gerar instalador&#8230;<\/strong>&#8220;.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2019\/12\/instalador-1.png\"><img loading=\"lazy\" decoding=\"async\" width=\"560\" height=\"373\" src=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2019\/12\/instalador-1.png\" alt=\"\" class=\"wp-image-1606\" srcset=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2019\/12\/instalador-1.png 560w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2019\/12\/instalador-1-300x200.png 300w\" sizes=\"auto, (max-width: 560px) 100vw, 560px\" \/><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Na tela que se abre voc\u00ea pode personalizar algumas informa\u00e7\u00f5es do instalador:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2020\/01\/instalador2.png\"><img loading=\"lazy\" decoding=\"async\" width=\"524\" height=\"350\" src=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2020\/01\/instalador2.png\" alt=\"\" class=\"wp-image-1677\" srcset=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2020\/01\/instalador2.png 524w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2020\/01\/instalador2-300x200.png 300w\" sizes=\"auto, (max-width: 524px) 100vw, 524px\" \/><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ap\u00f3s preencher com as informa\u00e7\u00f5es de sua empresa clique no bot\u00e3o gerar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">OBS: Caso deseje j\u00e1 incluir o Java no instalador basta marcar a op\u00e7\u00e3o na hora de gerar o instalador. Evitando assim tamb\u00e9m a necessidade de instala\u00e7\u00e3o pr\u00e9via do Java.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ap\u00f3s gera\u00e7\u00e3o um novo instalador ficar\u00e1 dispon\u00edvel na pasta documentos. O cliente ao executar esta fun\u00e7\u00e3o ir\u00e1 instalador a agente junto com todas as APIs e licen\u00e7as, evitando que tenha que instalar cada uma individualmente.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00cdcone personalizado<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Um arquivo de \u00edcone personalizado pode ser adicionado na raiz do instalador, ele deve ser criado com o nome &#8220;brand.ico&#8221;, quando ele existir, se estiver no formato aceito pelo Windows, ser\u00e1 utilizado como \u00edcone do programa.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Dicas e solu\u00e7\u00e3o de problemas de compila\u00e7\u00e3o<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Na compila\u00e7\u00e3o costuma ocorrer dois erros principais:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Falta de permiss\u00e3o<\/strong>: Durante a gera\u00e7\u00e3o de um novo instalador o agente precisa ler\/acessar arquivo dentro da pasta do Agente, a depender das configura\u00e7\u00f5es do Windows\/Antiv\u00edrus pode haver bloqueio.<br>SOLU\u00c7\u00c3O: Copiar e executar o Agente num pasta  sem restri\u00e7\u00f5es, como &#8220;Meus Documentos&#8221; ou  &#8220;C:\\TEMP&#8221;.<\/li>\n\n\n\n<li><strong>\u00cdcone em formato errado<\/strong>: ICO \u00e9 um formato espec\u00edfico. Para usar PNG ou JPG utilize um gerador\/conversor de \u00edcones.<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\">\u00daltimas vers\u00f5es<\/h1>\n\n\n<ul class=\"lcp_catlist\" id=\"lcp_instance_0\"><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2023\/05\/agente-de-comunicacao-v2-5-0-03-03-2021\/\">Agente de comunica\u00e7\u00e3o v2.5.0 (03\/03\/2021)<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2020\/08\/agente-de-comunicacao-v2-4-0-20-08-2020\/\">Agente de comunica\u00e7\u00e3o v2.4.0 (20\/08\/2020)<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2020\/04\/agente-de-comunicacao-v2-3-1-20-04-2020\/\">Agente de comunica\u00e7\u00e3o v2.3.1 (20\/04\/2020)<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2019\/05\/agente-de-comunicacao-v2-2-0\/\">Agente de comunica\u00e7\u00e3o v2.2.0 (09\/05\/2019)<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2017\/01\/agente-de-comunicacao-v1-6-0\/\">Agente de comunica\u00e7\u00e3o v1.6.0<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/08\/agente-1-5-3\/\">Agente de comunica\u00e7\u00e3o v1.5.3<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/07\/agente-de-comunicacao-v1-5-1\/\">Agente de comunica\u00e7\u00e3o v1.5.1<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/05\/agente-de-comunicacao-v1-1-0\/\">Agente de comunica\u00e7\u00e3o v1.1.0<\/a><\/li><\/ul>\n\n\n\n<h1 class=\"wp-block-heading\">Firewall<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">O agente usa as seguintes portas:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Portas: <strong>7099<\/strong> e <strong>7998<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">As APIs instaladas podem abrir portas adicionais no Java.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Com a advento da interrup\u00e7\u00e3o do suporte a Applets no Chrome desenvolvemos um agente especial que permite continuar usando as nossas fun\u00e7\u00f5es na camada cliente. Como funciona Um programa especial \u00e9 instalado no computador do cliente (usu\u00e1rio do sistema) e ir\u00e1 fornecer suporte aos recursos antes fornecidos pelos Applets do Java. O programa deve ser [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-133","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/133","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/comments?post=133"}],"version-history":[{"count":32,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/133\/revisions"}],"predecessor-version":[{"id":4158,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/133\/revisions\/4158"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=133"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}