Diretório “jsRule” -> Dentro deste diretório, contém N diretórios referenciando cada um a um sistema diferente (system e a sigla).
Dentro de cada um destes diretórios (ou sistemas) estão 2 arquivos: webrunFunctions.js e o webrunRules.js
Como o próprio nome diz, o webrunFunctions contém todas as funções do sistema (Geralmente a API + funções que você tenha criado).
Observação: Apenas as funções da camada CLIENTE estão ali, afinal, é um arquivo .JS.
O outro arquivo (webrunRules.js) contém todos os fluxos na camada cliente.

Diretório “reports” -> Possui o mesmo diretório system_sigla referenciando os relatórios do determinado sistema, este diretório contém todos os .rtm dos relatórios. Este de fato são os relatórios. Todos estes arquivos são numerados: 1.rtm, 6.rtm e assim em diante. Este número na verdade é o código do relatório.
Outro arquivo também é encontrado no diretório, o names.properties. Este arquivo contém o código e nome de todos os relatórios, desta forma, quando o Webrun possui apenas o código ou o nome de um relatório em algum momento, é possível obter a outra informação.

Diretório “src” -> Este é o diretório que contém basicamente tudo do sistema: Os formulários, os fluxos (camada servidor), dicionário de dados, menu, traduções, etc..
Dentro do diretório forms, se encontram os arquivos dos formulários. No diretório “rules”, encontram-se as regras e o WebrunFunctions.java (Que contém todas as funções do sistema na camada servidor).

Diretório “webservices” -> Caso hajam regras a serem exportadas como webservices, as mesmas estarão dentro do arquivo .jws no diretório.

Agora que você ja sabe o que é o .jar e o que contém, vamos ao principal: Como aplica-lo.
A pasta systems (C:\Program Files\Softwell Solutions\Maker 2.5\Webrun 2\systems) é o diretório que contém todos os apontadores (wfre) dos sistemas. Basicamente, o que precisa ser feito é copiar o .JAR gerado para este diretório e renomea-lo com o mesmo nome do apontador (Exceto pela extensão, obviamente) como na imagem:

Diretório system e o .JAR

Tenha certeza que o servidor de aplicações esteja parado ao efetuar esta atualização. Após isto, é necessário reiniciar o servidor de aplicações por duas vezes.
No diretório webapps, você deve manter apenas o webrun.war com a versão escolhida por você. O .jar será extraído e aplicado no webrun.

Basicamente, para o envio de notas fiscais, precisamos apenas das funcoes:
-Chamar serviço WEB com Certificado Digital (Consumo de WebServices seguros)
-Assinar XML (Para assinar os arquivos XML que são enviados)
-Instalar certificado para comunicação HTTPS

Os parâmetros de entrada da função “Chamar serviço WEB com certificado digital” requer um arquivo keystore e sua senha.
Mas afinal, o que é este arquivo e do que ele é composto?

O arquivo keystore funciona como um arquivo banco de dados que contém os certificados que estarão envolvidos na comunicação com a Sefaz. Quem são os envolvidos?
1) A empresa que está enviando a nota
2) A autoridade certificadora (Quem emitiu o certificado da empresa (Ex: Serasa))
3) O Servidor da SEFAZ

Então precisamos basicamente de 3 certificados dentro do keystore: Da empresa, da autoridade certificadora e do servidor da sefaz.
Os certificados que devem ser importados no arquivo keystore devem estar no padrão DER encoded binary X.509 (Extensão .CER).

Para obter o certificado de sua empresa  e da autoridade certificadora no formato .CER:
-Você deve possuir o arquivo .PFX (Certificado digital da sua empresa). Possuindo este arquivo, dê um duplo-clique para importa-lo no sistema operacional. Basta dar “Next Next Next” e preencher a senha quando necessário. Após isto, o certificado estará disponível no Internet Explorer. (Caso seja solicitada a senha do seu arquivo .PFX, preencha-o.)
-Agora que o arquivo .PFX está importado, vamos gerar o certificado no formato .CER, abra o Internet Explorer, vá em Ferramentas -> Opções da Internet. Vá a aba “Conteúdo”. Clique no botão “Certificados”.
Observe que estará disponível na aba “Personal” o certificado de sua empresa. Selecione ela e clique no botão “Export…” e então dê “Next Next Next”. Guarde o arquivo .CER num diretório qualquer mas lembre-se dele, pois utilizaremos novamente. Para este exemplo, considerarei o diretório C:/
-O certificado da autoridade certificadora está disponível nesta mesma tela de certificados, entretanto, na aba de “Intermediate Certification Authorities”. No caso do serasa, são 2 certificados. Exporte os 2 e salve no mesmo diretório

Para obter o certificado do servidor da sefaz no formato .CER:
-Acesse a URL do webservice (utilizando o IE) de recepcao de notas fiscais  referente ao estado onde serão enviadas as notas. (Lembre-se que empresas apenas enviam notas para o seu estado).
-Após acessar, existe um “cadeado” indicando que é um site seguro. Dê um duplo-clique nele e exporte o certificado do site. Novamente escolha o formato .CER e salve em um diretório qualquer do seu computador.

Agora que você já possui os certificados, você já está preparado para criar o seu arquivo .keystore
Para geração deste arquivos utilizaremos a ferramenta KeyTool (É uma ferramenta gratuita disponível em qualquer JDK).
Você pode inclusive utilizar a JDK que é instalada junto com o Webrun no diretório:
C:\Arquivos de Programas\Softwell Solutions\Maker 2.5\Webrun 2\java\bin\keytool.exe
Abra o promt de comando e se dirija até o diretório acima (bin).
Vamos primeiramente criar o arquivo keystore. Para isto, digite o comando:
keytool.exe -genkey -keystore nome.keystore -alias nomeDoProjeto -keypass senha
Ex: C:\Program Files (x86)\Softwell Solutions\Maker 2.5\Webrun 2\java\bin>keytool.ex
e -genkey -keystore certificado.keystore -alias nfe -keypass teste123

Após isto, serão feitas algumas perguntas, preencha de acordo com os dados de sua empresa. Exemplo:

Enter keystore password:  teste123
What is your first and last name?
[Unknown]:  Márcio Saeger
What is the name of your organizational unit?
[Unknown]:  MakerPortal Informática Ltda
What is the name of your organization?
[Unknown]:  MakerPortal Informática Ltda
What is the name of your City or Locality?
[Unknown]:  Salvador
What is the name of your State or Province?
[Unknown]:  Bahia
What is the two-letter country code for this unit?
[Unknown]:  BR
Is CN=Márcio Saeger, OU=MakerPortal Informática Ltda, O=MakerPortal Informática
Ltda, L=Salvador, ST=Bahia, C=BR correct?
[no]:  yes
C:\Program Files (x86)\Softwell Solutions\Maker 2.5\Webrun 2\java\bin>

Pronto. Seu arquivo .keystore está criado. O arquivo foi gerado no diretório do keytool. Copie-o para o diretório C:/ onde estão os arquivos de certificados .CER para facilitar na importação.
Agora devemos importar os certificados (.cer) no arquivo keystore. Vamos fazer através do comando:
keytool.exe -import -trustcacerts -alias nome -file C:\certificado1.cer -keystore c:\certificado.keystore

Observe que: após o parâmetro -alias devemos especificar um nome para o certificado que estamos importanto. Apenas tenha certeza de colocar um nome diferente para cada arquivo .CER que você for importar. Para ser franco, o nome que voce irá escolher pouco importa. No meu caso importo com nomes: c1, c2, c3 etc..

Exemplo de uso do comando:
keytool.exe -import -trustcacerts -alias serasa1 -file C:\serasaV1.cer -keystore C:\certs.keystore
keytool.exe -import -trustcacerts -alias serasa2 -file C:\serasaV2.cer -keystore C:\certs.keystore
keytool.exe -import -trustcacerts -alias sefazServer -file C:\sefazServer.cer -keystore C:\certs.keystore
keytool.exe -import -trustcacerts -alias makerportal -file C:\makerportal.cer -keystore C:\certs.keystore

Ao efetuar cada importação, poderá ser exibido um resumo sobre o certificado no console e perguntado se você tem certeza que gostaria de improtar tal certificado para o arquivo keystore. Basta apenas confirmar, digitando yes.
Ao termino da importação dos certificados, seu arquivo já está pronto para ser utilizado nos WebServices da Sefaz. Basta informar como parâmetro de entrada da função o caminho do arquivo .keystore e sua senha.
PS: Não esqueça de previamente instalar o certificado .keystore no browser através da função “Instalar certificado para comunicação HTTPS”. Este passo só é necessário apenas uma única vez por browser.

Espero ter desmistificado um pouco quanto ao arquivo keystore. Este é apenas um único detalhe da imensidão de um sistema de Nota Fiscal Eletrônica

Dúvidas!? Utilize o nosso fórum!

Atualmente, apenas os leitores digitais da NitGen são homologados. Mais especificamente, a linha Hamster, que contam com os leitores Hamster I e Hamster II.

Hamster I

Se você ja possui, instale os drivers do dispositivo e suas devidas configurações (Caso necessário). Os drivers podem ser obtidos direto do site do fabricante em: http://www.nitgen.com.br/Downloads/Downloads_Driver.aspx

Hamster II

Após a instalação, o dispositivo está pronto para ser utilizado, faltando apenas o Servidor de Digitais da Softwell.
Este “Servidor de Digitais” nada mais é do que um serviço responsável pelo armazenamento das digitais em um pequeno banco de dados embarcado. O instalador do servidor de digitais pode ser encontrado na nossa página de downloads.
Após o download do Servidor de Digitais, basta seguir os passos Next, Next, Next do Instalador e o serviço será instalado e iniciado automáticamente, sem a necessidade de configuração alguma.
Como nenhum usuário possui uma digital devidamente cadastrada, deve-se primeiramente, acessar o Maker com algum usuário de administrador e então cadastrar as digitais para os devidos usuários no controle de acessos. (Imagem Abaixo)

Cadastrando impressão digital para os usuários

Se for apresenta a mensagem de erro: “Não foi possível iniciar o dispositivo de captura de digitais.”, possívelmente o driver não foi corretamente instalado ou não foi detectado ou a máquina precisa ser reiniciada. (Imagem abaixo).

Dispositivo não encontrado

Após cadastradas as digitais, basta utilizar o ícone ao lado da caixa de texto “Usuário” da tela de Login do Maker ou do Webrun para se autenticar por meio do leitor de digital sem a necessidade de digitação. (Imagem abaixo)

Botão para login utilizando o leitor biométrico

No caso do Webrun, o meio de login é da mesma forma que pelo Maker. Inclusive as digitais podem ser cadastradas também pelo browser, entretanto, um ActiveX / Applet deverá ser previamente instalado. Este aplicativo já está embarcado no Webrun dentro da pasta APPS:

• SDigitalCapture.jar

• DigitalCaptureNativeWin.jar

• DigitalCaptureWithoutChecksum.jar

Alguma dúvida?! Utilize o nosso fórum!

MakerPortal.COM.BR Mobile

Acesse e confira – http://www.makerportal.com.br

Apesar de simples, muita gente ainda tem dificuldades de como realizar este tipo de operação. Em se tratando de banco de dados, uma das melhores (e mais rápida) maneira de resolver, seria no proprio select. Entretanto, o sistema iria começar a ficar “particular” para um banco de dados específico. Então geralmente partimos pro fluxograma.
E lá nos deparamos: Não há função para decrementar!

Como resolver?

Simples! Na função (Incrementar dia/mês/ano), passamos a data e um valor que será incrementado na data passada como primeiro parâmetro. O valor será somado na data. Para decrementar, basta passarmos um valor negativo!

Passando um valor negativo como parâmetro de entrada para a função.

A função irá fazer: data=data+valor.
Se valor for igual a -7 por exemplo, ficará: data=data+-7, o que acabará subtraindo o dia/mês ou ano.

Dúvidas!? Utilize o nosso forum!

1. Webrun Enterprise Reports
2. Webrun Enterprise UTF-8

Vejamos suas características abaixo:

Webrun Enterprise Reports

O Webrun Reports nada mais é do que o Webrun Enterprise com um conjunto de Applet’s/ActiveX do gerador de relatórios local.
O gerador de relatórios local tem como objetivo gerar os relatórios na maquina do cliente. Desta forma, os relatórios são processados pelo computador de quem está visualizando, evitando assim que o servidor seja o responsável pela geração de todos os relatórios.
Outra vantagem do gerador de relatório local é a possibilidade de imprimir “Na Tela” que é uma cópia fiel ao que é feito no Report Builder (Maker). Nem sempre o que fazemos no Maker é como fica ao fim quando imprimimos em PDF ou HTML por exemplo.
Como nem tudo são flores, existe a questão: O Applet/ActiveX “custa” em torno de 25-35mb de tamanho. Ou seja, o cliente deverá na primeira vez que for instalar, efetuar o download para sua maquina, o que leva tempo e consome banda (tanto do servidor quanto do cliente).
Entretanto, caso o sistema esteja numa rede local, talvez seja uma boa alternativa para eliminar um possível gargalo do servior.

O gerador local deve ser usado com cautela e por pessoas com uma boa bagagem de desenvolvimento com o Maker. A melhor forma de eliminar gargalo do servidor com geração de relatórios, é definir um outro servidor apenas para geração de relatórios através da ferramenta de Servidor de Relatórios da Softwell. Seja uma máquina física ou uma máquina virtual. O gerador local deve ser utilizado como último recurso.

Webrun Enterprise UTF-8

O Webrun Enterprise UTF-8 usa a codificação UTF-8. Com ela, é possível representar qualquer caracter universal padrão do Unicode, sendo também compatível com o ASCII. A tendencia dos aplicativos, softwares, banco de dados é a utilização deste padrão, visto que as informações serão retrocompatíveis seja aqui ou no japão.

Para mais informações sobre UTF-8 procure no Wiki ou Google !

O Webrun Enterprise padrão utiliza a codificação ISO-8859 que não dá suporte a caracteres  japoneses por exemplo.

Menu downloads no MakerPortal

Conseguimos links para versões do Maker em separado e 2 versões de instaladores, Webrun separado e Instalador (Webrun apenas), gerador de relatórios e Webrun.NET.

Definindo Acesso Externo ao Formulário

Feito isto, observe que no título da janela do Maker, ao final fica “(Modificado)”. Isso significa que
uma alteração de propriedade do sistema foi feita e deve-se salvar o projeto para que as alterações
entrem em vigor. Para fazer isto, vá no menu Projeto -> Salvar.

Pronto! O seu formulário está definido como externo, basta apenas reiniciar o servidor de aplicações.
Vejamos agora, como acessar o formulário externo. Mas, antes disso, vamos analisar como funciona
a URL de um formulário.

Endereço do Formulário

Observe o endereço do formulário acima:
http://127.0.0.1:8080/webrun/form.jsp?sys=N70&action=openform&formID=8489&align=0&mode=-1&goto=-1&filter=&scrolling=no

A partir deste endereço podemos entender alguns parâmetros utilizados:

sys=N70 – Todo formulário possui o parâmetro sys que indica o código do sistema (Aquele que definimos no momento da criação de um sistema no Maker).
formID=8489 – ID do formulário. Este número identifica o formulário.

Basicamente, estes 2 parâmetros identificam qual formulário será aberto em qual sistema.
Considerando que o nosso formulário já está definido como formulário externo e o servidor de aplicações reiniciado, basta acessar a URL:

http://127.0.0.1:8080/webrun/form.jsp?sys=N70&action=openform&formID=8489&align=0&mode=-1&goto=-1&filter=&scrolling=no

Obviamente, quando o seu sistema for publicado e estiver em um servidor em produção, você chamará a URL correta, por exemplo:

http://sistema.marciosaeger.com.br/form.jsp?sys=N70&action=openform&formID=8489&align=0&mode=-1&goto=-1&filter=&scrolling=no

Considerando que o endereço sistema.marciosaeger.com.br redireciona pro contexto do meu servidor de aplicações e que o mesmo está sendo acessado pela
porta 80 (Não precisa especificar, pois é a porta padrão http).

Usos

Com um formulário externo, podemos por exemplo utiliza-lo em qualquer página web que quisermos. Por exemplo, um site feito basicamente em HTML e php,
colocar um formulário de cadastro dentro de um iFrame e utiliza-lo como se fizesse parte do portal, ou, em um hotsite feito em flash por exemplo, um formulário de cadastro de clientes.