O QR Code ("Quick Response" - Resposta Rápida) é uma versão avançada do código de barras, também bidimensional, com mais funções e composto de padrões de pixels. O uso dessa tecnologia é livre e as empresas costumam utilizá-la para oferecer mais informações e conteúdos exclusivos através de links. 

O plugin Gerar QR Code gera um código QR em formato de imagem (png ou jpg) conforme a informação passada. Diferente dos componentes visuais (web e mobile), este plugin gera uma lista de bytes e é tratado no lado servidor.

Adicionar plugin

Siga os passos abaixo para instalar o Plugin Gerar QRCode em seu projeto Cronapp.

Figura 1.1 - Instalando plugin

1. Acesse Plugin no menu do sistema e selecione a opção Instalar Plugins;
2. Selecione a categoria General e avance ou pesquise pelo nome Gerar QRCode;
3. Selecione Gerar QRCode, clique em Avançar e, em seguida, em Finalizar.
   Se o botão Modo Avançado estiver habilitado, aparecerá a janela "Sumário de alterações no arquivo POM" informando as modificações necessárias para a instalação do plugin, clique em Salvar. Caso o botão esteja desabilitado, a instalação será feita sem a janela de notificação.

Gerar QRCode

Bloco de Programação

Após instalar o plugin, será possível visualizar nos blocos de programação do tipo Servidor a categoria QRCode e o bloco Gerar QRCode.

Figura 2.1 - Bloco Gerar QRCode

• Conteúdo: informação que será exibida ao ler o código;
• Formato: formato da imagem que será gerada;
• Largura¹: largura em pixel do código;
• Altura¹: altura em pixel do código.

¹ O QR Code possui o formato quadrado. Caso as medidas difiram, todos os seus lados serão definidos conforme a menor medida.

Exemplo

No exemplo abaixo o usuário deve informar o conteúdo para gerar o QRCode, um nome para o arquivo da imagem que contém o QRCode e em seguida clicar no botão para fazer o download.

Abra a página home (localização: Formulários/Web/Autenticado  ) e insira dois componentes de Entrada de Texto e um Botão no formulário. Configure os componentes de Caixa de seleção como na Figura 3.1: o primeiro receberá o conteúdo do QRCode e o segundo, o nome do arquivo com sua extensão. 

Figura 3.1 - Inserindo componentes no formulário

Em seguida, crie um bloco do tipo Servidor chamado "GerarQRCode". Caso tenha dúvida de como criar, acesse o tópico "Criar arquivo Blockly" em Bloco de programação.

Figura 3.2 - Função para gerar código QR

1. Clique no ícone engrenagem para abrir a janela de Configuração dos tipos de regras e no campo Formulário de Referência clique em "..." para selecionar formulário home, local onde adicionamos nossos componentes e clique em Salvar;

2. Crie a variável "conteudo" e arraste o bloco de Atribuir variável (categoria Variáveis) correspondente a ela. Associe o bloco Obter valor do campo (categoria Formulário), no parâmetro Campo selecione o valor da entrada de texto onde será informado o conteúdo: vars.conteudo.
3. Repita o passo 2. No entanto, crie a variável "nome" e no parâmetro Campo, selecione o valor da entrada de texto onde será informado o nome do arquivo: vars.nome.
4. Arraste o bloco Iniciar download com o campo Arquivo/Path/Bytes (categoria Arquivo):
   • Associe o bloco Gerar QRCode (categoria QRCode). No parâmetro Conteúdo, associe a variável "conteudo", no Formato deixe PNG selecionado e defina a Largura e Altura para 500.
   • No parâmetro Nome, associe a variável "nome".

Volte ao formulário da Figura 3.1, selecione o Botão, depois vá até os Eventos e associe a função "GerarQRCode" no evento Ao Clicar.

Figura 3.3 - Associando o bloco do evento Ao Clicar

Por fim, rode o projeto, abra a aplicação no navegador, preencha os dados - preencha o nome do arquivo com a extensão - e clique no botão. O navegador abrirá o explorador de arquivos, salve o arquivo onde preferir.

Figura 3.4 - Preenchendo os dados na aplicação e salvando o arquivo