{"id":1218,"date":"2018-10-26T14:41:34","date_gmt":"2018-10-26T17:41:34","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?p=1218"},"modified":"2024-03-14T12:04:29","modified_gmt":"2024-03-14T15:04:29","slug":"como-obter-suporte-para-as-apis","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2018\/10\/como-obter-suporte-para-as-apis\/","title":{"rendered":"Como obter suporte para as APIs"},"content":{"rendered":"<p>O presente documento visa facilitar o trabalho de comunica\u00e7\u00e3o entre o cliente e o nosso suporte.<\/p>\n<p>Se deseja ter uma <span style=\"color: #ff0000;\"><strong>solu\u00e7\u00e3o mais r\u00e1pida<\/strong><\/span>, e <strong><span style=\"color: #ff0000;\">atendimento priorit\u00e1rio<\/span><\/strong> tenha em mente os principais pontos:<\/p>\n<ul>\n<li>Verifique se a pasta <a href=\"\/documentacao\/2015\/10\/pastas-arquivos-maker-webrun\/\">Maker.Commons<\/a> est\u00e1 no lugar correto;<\/li>\n<li>Coloque a vers\u00e3o mais atual da API e da <a href=\"\/documentacao\/2016\/11\/biblioteca-basica-da-l2-l2s-core-jar\/\">l2s-core.jar<\/a>;<\/li>\n<li>Ative o <strong>DebugMode<\/strong>;<\/li>\n<li>Gere o HAR e Log do erro (se for camada cliente);<\/li>\n<li>Tenha um ambiente pronto para reproduzir o erro, n\u00e3o damos suporte no ambiente do cliente ou produ\u00e7\u00e3o;<\/li>\n<li>N\u00e3o fa\u00e7a perguntas sobre <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2022\/10\/itens-nao-cobertos-pelo-suporte\/\" target=\"_blank\" rel=\"noopener\"><span style=\"color: #ff0000;\"><strong>itens n\u00e3o cobertos pelo suporte<\/strong><\/span><\/a>.<\/li>\n<li>Se o problema \u00e9 URGENTE ou NO CLIENTE, este n\u00e3o \u00e9 o canal. O suporte \u00e9 ao desenvolvedor apenas, e tem SLA de 05 (cinco) dias. Suporte para<span style=\"color: #ff0000;\"><strong> ambiente de produ\u00e7\u00e3o n\u00e3o \u00e9 coberto<\/strong><\/span>, e pode opcionalmente ser contratado \u00e0 parte.<\/li>\n<\/ul>\n<h1>Antes de pedir suporte<\/h1>\n<ol>\n<li>Verifique se a fun\u00e7\u00e3o em quest\u00e3o foi feita pela L2MAKER;<\/li>\n<li>Verifique se voc\u00ea est\u00e1 usando a vers\u00e3o mais recente, se necess\u00e1rio atualize para a vers\u00e3o mais atual dispon\u00edvel da API;<\/li>\n<li>Remova qualquer altera\u00e7\u00e3o e\/ou personaliza\u00e7\u00e3o que n\u00e3o esteja inclu\u00edda no pacote oficial;<\/li>\n<li>Saiba a vers\u00e3o do Webrun lendo o arquivo <strong>changelog.txt<\/strong> no contexto do Webrun;<\/li>\n<li>Saiba a vers\u00e3o do <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2018\/06\/configurando-o-java-do-tomcat\/\">Java do Tomcat<\/a>;<\/li>\n<li>Saiba a vers\u00e3o do Maker;<\/li>\n<li>Ative (colocando o valor &#8220;1&#8221;) o modo debug (<a href=\"https:\/\/suporte.softwell.com.br\/Manual\/MakerStudio\/webrun_3\/parametro_configuracao\/parametros_configuracao_sessao.htm\">DebugMode<\/a>) nas configura\u00e7\u00f5es do Webrun para que o bot\u00e3o <strong>&#8220;+ Detalhes&#8221;<\/strong> seja exibido:\n<ul>\n<li>Pela interface de configura\u00e7\u00e3o do Webrun:<a href=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/DebugMode1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-2272 size-full\" src=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/DebugMode1.png\" alt=\"DebugMode\" width=\"490\" height=\"520\" srcset=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/DebugMode1.png 490w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/DebugMode1-283x300.png 283w\" sizes=\"auto, (max-width: 490px) 100vw, 490px\" \/><\/a>;<\/li>\n<li>Ou editando diretamente o arquivo &#8220;<strong>config\/config.xml<\/strong>&#8221; dentro da pasta do Webrun, trocando o valor da tag XML &#8216;DebugMode&#8217; de 0 (zero) para 1 (um).<\/li>\n<\/ul>\n<\/li>\n<li>Pesquise na documenta\u00e7\u00e3o pela mensagem de erro, certifique-se que n\u00e3o j\u00e1 exista documenta\u00e7\u00e3o a respeito;<\/li>\n<li>Determine os passos para reprodu\u00e7\u00e3o do erro.<\/li>\n<\/ol>\n<h2>Erros na camada cliente (HAR e Logs)<\/h2>\n<p>Muitas vezes para diagn\u00f3sticar o erro na camada cliente ser\u00e1 necess\u00e1rio enviar os logs do navegador, isso \u00e9 feito exportando o HAR e o LOG com os passos abaixo.<\/p>\n<h4><span style=\"color: #003366;\">Salvador o HAR<\/span><\/h4>\n<ol>\n<li>Na aba do navegador onde est\u00e1 rodando a API clique o bot\u00e3o direito e escolha &#8220;Inspecionar&#8221; (por ser tamb\u00e9m &#8220;Inpsect&#8221;\u00a0 ou &#8220;Inspect Element&#8221;). Se a janela for um popup voc\u00ea deve inspecionar a Janela do popup);<a href=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/abrir-inspecionar.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-1831\" src=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/abrir-inspecionar.png\" alt=\"\" width=\"1013\" height=\"498\" srcset=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/abrir-inspecionar.png 1013w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/abrir-inspecionar-300x147.png 300w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/abrir-inspecionar-768x378.png 768w\" sizes=\"auto, (max-width: 1013px) 100vw, 1013px\" \/><\/a><\/li>\n<li>Em seguida, clique na aba &#8220;Rede&#8221; (&#8220;Network&#8221;);<\/li>\n<li>Na aba rede voc\u00ea deve limpar o hist\u00f3rico usando o segundo bot\u00e3o no topo esquerdo da aba,\u00a0 ele se chama &#8220;Clear&#8221; ou &#8220;Limpar&#8221; (ao lado do bot\u00e3o vermelho);<\/li>\n<li>Em seguida execute o fluxo que provoca o erro (duas ou tr\u00eas vezes se poss\u00edvel);<\/li>\n<li>V\u00e1 na lista de chamadas da rede (&#8220;Netowrk&#8221;), clique o com o bot\u00e3o direito e selecione a op\u00e7\u00e3o de exportar todo o conte\u00fado como HAR (&#8220;Save all HAR with content&#8221;) e <span style=\"color: #0000ff;\"><strong>salve o arquivo HAR<\/strong><\/span>;<a href=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/exportar-har.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-1832\" src=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/exportar-har.png\" alt=\"\" width=\"1171\" height=\"653\" srcset=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/exportar-har.png 1171w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/exportar-har-300x167.png 300w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/exportar-har-768x428.png 768w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/exportar-har-1024x571.png 1024w\" sizes=\"auto, (max-width: 1171px) 100vw, 1171px\" \/><\/a><\/li>\n<\/ol>\n<h4><span style=\"color: #003366;\">Salvador o arquivo de LOG<\/span><\/h4>\n<ol>\n<li>Agora clique na aba &#8220;<strong>Console<\/strong>&#8220;;<\/li>\n<li>Com o bot\u00e3o direito escolha a op\u00e7\u00e3o &#8220;Save as&#8230;&#8221; \/ &#8220;Salvar como&#8230;&#8221; e <span style=\"color: #0000ff;\"><strong>salve o arquivo de LOG<\/strong><\/span>.<\/li>\n<\/ol>\n<p><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/salvar-log.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-2983\" src=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/salvar-log.png\" alt=\"\" width=\"892\" height=\"278\" srcset=\"https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/salvar-log.png 892w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/salvar-log-300x93.png 300w, https:\/\/www.l2maker.com.br\/documentacao\/wp-content\/uploads\/2018\/10\/salvar-log-768x239.png 768w\" sizes=\"auto, (max-width: 892px) 100vw, 892px\" \/><\/a><\/p>\n<p>Envie os dois arquivos <strong><span style=\"color: #0000ff;\">HAR<\/span><\/strong> e <strong><span style=\"color: #0000ff;\">LOG<\/span><\/strong> salvos.<\/p>\n<h1>Erros em fluxo Web<\/h1>\n<p>Se o fluxo Web estiver dando erro interno (500), desabilite a p\u00e1gina de erros do Webrun para que os detalhes do erro aparece na tela;<\/p>\n<ol>\n<li>Acessa a pasta &#8220;WEB-INF&#8221; dentro do contexto do Webrun, e abra o arquivo &#8220;web.xml&#8221;. (EX: &#8220;\/MINHACONTA\/tomcat\/webapps\/webrun\/WEB-INF\/web.xml&#8221;);<\/li>\n<li>Localize o bloco de c\u00f3digo abaixo (por volta da linha 446):<br \/>\n<span style=\"color: #0000ff;\">&lt;error-page&gt;<\/span><br \/>\n<span style=\"color: #0000ff;\">&lt;error-code&gt;500&lt;\/error-code&gt;<\/span><br \/>\n<span style=\"color: #0000ff;\">&lt;location&gt;\/errors\/500.jsp&lt;\/location&gt;<\/span><br \/>\n<span style=\"color: #0000ff;\">&lt;\/error-page&gt;<\/span><\/li>\n<li>Remova o bloco e salve o arquivo web.xml;<\/li>\n<li>Reinicie o Tomcat\/Webrun.<\/li>\n<\/ol>\n<h1>Hor\u00e1rio e Formato<\/h1>\n<ol>\n<li>O suporte funciona de <strong>09:00 &#8211; 12:00<\/strong> e <strong>14:00 &#8211; 17:00<\/strong>. Suporte fora desse hor\u00e1rio ser\u00e1 tratado no dia \u00fatil seguinte;<\/li>\n<li>O suporte deve ser solicitado <strong>exclusivamente via texto<\/strong>. O envio \u00e1udio, fotos, v\u00eddeos e outras informa\u00e7\u00f5es s\u00f3 devem ser enviadas de forma complementar.<\/li>\n<\/ol>\n<h1>Prazos e Prioridades<\/h1>\n<ol>\n<li>Os prazos s\u00f3 come\u00e7am a contar a partir da checagem dos itens acima;<\/li>\n<li>A prioridade de atendimento da demanda atual e das pr\u00f3ximas vai ser reduzida de acordo com a qualidade das informa\u00e7\u00f5es fornecidas;<\/li>\n<li>Demandas sem instru\u00e7\u00f5es para reprodu\u00e7\u00e3o ficam com prazos congelados;<\/li>\n<li>Demandas URGENTES ou NO CLIENTE n\u00e3o s\u00e3o atendidas como suporte ao desenvolvedor, e deve opcionalmente ser contratada \u00e0 parte.<\/li>\n<\/ol>\n<h1>Respostas<\/h1>\n<ol>\n<li>Seja objetivo nas respostas;<\/li>\n<li>Evite referencias (&#8220;A \u00faltima&#8221;, &#8220;Aquela l\u00e1&#8221;, &#8220;A da \u00faltima vez&#8221;, &#8230;) &#8211; Ainda que seja a mesma pessoa a te atender, h\u00e1 outros clientes e outras demandas sendo atendida, fica imposs\u00edvel lembrar detalhes de todos os atendimentos, SEJA REPETITIVO, \u00e9 a melhor maneira pra agilizar seu atendimento.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>O presente documento visa facilitar o trabalho de comunica\u00e7\u00e3o entre o cliente e o nosso suporte. Se deseja ter uma solu\u00e7\u00e3o mais r\u00e1pida, e atendimento priorit\u00e1rio tenha em mente os principais pontos: Verifique se a pasta Maker.Commons est\u00e1 no lugar correto; Coloque a vers\u00e3o mais atual da API e da l2s-core.jar; Ative o DebugMode; Gere [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-1218","post","type-post","status-publish","format-standard","hentry","category-apis"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/1218","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/post"}],"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=1218"}],"version-history":[{"count":39,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/1218\/revisions"}],"predecessor-version":[{"id":3407,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/1218\/revisions\/3407"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=1218"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=1218"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=1218"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}