Versão Padronização Atualizado em: 2 de maio de 2012 DEFINIÇÃO DAS TABELAS

Transcrição

1 Versão Padronização Atualizado em: 2 de maio de 2012 Complementos Opcionais DEFINIÇÃO DAS TABELAS (47)

2 HISTÓRICO DE ALTERAÇÕES VERSÃO DATA TABELA ALTERAÇÃO out Novo complemento de Catálogo de Produtos, verifique a sessão de Complementos out Novo complemento de Textos adicionais e Anexos dos Produtos, verifique a sessão de Complementos. 2-5

3 COMPLEMENTOS - ** OPCIONAIS ** CÓDIGO DE BARRAS 2D (QR-CODE) CLIENTES E PRODUTOS Este código é lido pelo Apogeus Android utilizando o programa Barcode Scanner. Obs.: Este programa é opcional na instalação do Apogeus Android, sendo assim, em cada PDA pode ser instalado automaticamente pelo botão de código de barras, em uma destas consultas: Clientes, Produtos ou Mix. Para gerar este código de barras 2D, basta utilizar sites com geradores do mesmo. Ex.: Obs.: O tipo de código de barras deve ser TEXTO. Existem várias Bibliotecas livres que geram este tipo de código(qrcode). Exemplo de utilização dos códigos de barras: * Confirmação de presença no cliente, usando o mesmo fixado no Estabelecimento do cliente * Fácil interação com o catálogo impresso ou eletrônico, sendo assim, uma vez escolhido o produto basta ler o código de barras do mesmo Código QRCODE IMAGEMS/VÍDEOS DOS PRODUTOS Este complemento é opcional, caso não queria usar imagens basta mudar no PDA o tipo de lista para não exibir! Existem 2 modos para enviar as imagens/vídeos para o PDA: Modo 1: Criar um ZIP com as especificações abaixo na pasta C:\APOGEUSANDROID\PDA\UPGRADE Modo 2: Extrair o ZIP no cartão de memória manualmente dentro da pasta chamada apogeusandroid. Ex.: No modo 2 a pasta do cartão irá ficar assim /apogeusandroid/produtos/imagens e /apogeusandroid/produtos/videos Especificação ZIP: * Nome deve ser: DATAxxxxxxxxxx.ZIP (No lugar xxxxxxxxxx pode ser a data do arquivo). Ex.: DATA ZIP IMAGENS: * O arquivo deve conter a pasta chamada imagens (deve ser minúsculo) dentro da pasta de produtos * Dentro da pasta imagens, deve conter 1 pasta para cada produto, sendo que o nome da pasta é o código do produto. Dentro da pasta com o código do produto, pode colocar várias imagens do mesmo, seguindo a regra abaixo em vermelho. * O código do produto deve respeitar a formatação descrita abaixo em vermelho. * Para exibir a miniatura do produto a pasta do produto deve conter uma imagem reduzida, seguindo as regras abaixo: - Normal: thumb.jpg, thumb.png ou thumb.gif = Usado em PDA com pouco processamento(padrão) - Grande: lthumb.jpg, lthumb.png ou lthumb.gif = Usado em PDA com maior resolução - Extra Grande: xlthumb.jpg, xlthumb.png ou xlthumb.gif = Usado em PDA com alta resolução - Ordenado: Ordena os arquivos pelo nome, usando a primeira como miniatura. Obs.: Caso a empresa somente utilize um tipo de aparelho, pode optar por usar somente um tipo de miniatura(normal). EX.: /produtos/imagens/123/frente.jpg, /produtos/imagens/456/lado.png VÍDEOS: * O arquivo deve conter a pasta chamada videos (deve ser minúsculo) dentro da pasta de produtos * Dentro da pasta videos, deve conter 1 pasta para cada produto, sendo que o nome da pasta é o código do produto. Dentro da pasta com o código do produto, pode colocar vários vídeos do mesmo, seguindo a regra abaixo em vermelho. EX.: /produtos/videos/123/lancamento.mpg, /produtos/videos/abc/demonstracao.mpg Abaixo segue caracteres que serão TROCADOS por _ : * < > :? " Isso deve-se aos caracteres não suportados pelo Windows no nome dos Arquivos. Não podem ser utilizados acentos e Ç, devido ao Android usar UTF-8 e Windows utilizar CP1252(ISO8859-1). TEXTOS/IMAGEMS DAS OUVIDORIAS Este módulo é opcional, somente pode ser ativado/desativado no PDA! Depois de digitadas as ouvidorias, ou capturadas as fotos, o vendedor pode optar por enviar ou não as ouvidorias(devido a grande uso do plano de Dados). Quando são enviadas as ouvidorias para a empresa, todos os arquivos serão colocados na pasta: C:\APOGEUSANDROID\MEDIA\ Obs.: Dentro da pasta MEDIA, não pode ser realizado nenhum processo externo. Caso a empresa queira usar os arquivos para outros fins, basta copiá-los para outro local. Quando estiver fazendo a cópia, evitar que o Tomcat esteja aberto, para que assim nenhum vendedor envie novos arquivos. Tipos de Ouvidoria: Envidadas pelo pedido: Estão disponíveis na pasta: C:\APOGEUSANDROID\MEDIA\pedidos Envidadas pelo novo cliente: Estão disponíveis na pasta: C:\APOGEUSANDROID\MEDIA\novos_clientes Envidadas pela não-venda: Estão disponíveis na pasta: C:\APOGEUSANDROID\MEDIA\nao_vendas 3-5

4 Além dos tipos de ouvidoria, serão exportados os motivos no nome do arquivo, seguindo o padrões descritos abaixo: 1. O arquivo será exportado dentro da pasta C:\APOGEUSANDROID\MEDIA\XXXXXX, no qual XXXXXX é o tipo de ouvidoria. 2. Dentro das pastas dos tipos de ouvidoria, cada tipo irá respeitar as regras abaixo: * Pedidos: serão exportados para C:\APOGEUSANDROID\MEDIA\pedidos\, no qual dentro desta pasta irá criada uma pasta com o código do pedido, e na mesma serão colocados os arquivos enviados pela ouvidoria. * Não-venda: serão exportados para C:\APOGEUSANDROID\MEDIA\nao_vendas\, no qual dentro desta pasta irá criada uma pasta com uma chave composta( Código do vendedor + Data da digitação(yyyymmdd) + Hora da digitação(hhmmss) + Código da Filial + Código do Cliente ), e na mesma serão colocados os arquivos enviados pela ouvidoria. * Novos clientes: serão exportados para C:\APOGEUSANDROID\MEDIA\novos_clientes\, no qual dentro desta pasta irá criada uma pasta com uma chave composta( Código do vendedor + Código do Cliente ), e na mesma serão colocados os arquivos enviados pela ouvidoria. 3. Cada arquivo envidado para as pastas de pedidos/não-vendas/novos clientes, irão seguir a nomenclatura abaixo: 3.1 A primeira letra do nome será o motivo da ouvidoria, conforme tabela abaixo: P = Presença U = Assinatura A = Atendimentos V = Vendas E = Entregas S = Sugestões R = Reclamações N = Novidades do Cliente C = Concorrentes O = Outros 3.2 Extensões enviadas em anexo:.jpg = Foto tirada pelo PDA e enviada pela Ouvidoria(formato JPG).txt =.bar = Texto digitado na ouvidoria(arquivo texto com encoding UTF-8) Código de barras lido pelo PDA(Valor lido está no arquivo e utiliza encoding UTF-8) 3.3 Os números seguintes formam a chave única de cada envio na ouvidoria, permitindo digitar textos para fotos e códigos de barras. Para entender este métodos veja os exemplos abaixo: Exemplo 1: Não venda enviando uma foto de PRESENÇA em anexo: C:\APOGEUSANDROID\MEDIA\nao_vendas\1_ _82921_1_3\P jpg (foto) C:\APOGEUSANDROID\MEDIA\nao_vendas\1_ _82921_1_3\P txt (texto) Note que os números da imagem e do arquivo texto são iguais, sendo assim o texto no arquivo.txt foi digitado para descrever a imagem. Exemplo 2: Pedido enviando uma foto de PRESENÇA em anexo: C:\APOGEUSANDROID\MEDIA\pedidos\ \P bar (código de barras) C:\APOGEUSANDROID\MEDIA\pedidos\ \P txt (texto) No exemplo acima temos um arquivo que possui o código de barras lido(.bar) e um arquivo texto(.txt), onde pela chave única podemos identificar que o texto é uma descrição do código de barras lido. CATÁLOGOS DE PRODUTOS(HTML) Este complemento permite usar um catálogo HTML, com imagens e layout próprio da empresa. Permitindo a empresa utilizar o próprio layout do catálogo impresso, porém no formato HTML! Importante: A criação de manutenção do catálogo é de responsabilidade do cliente. O este complemento utiliza o mesmo arquivo das imagens/vídeos, para mais informações consulte o tópico anterior. Especificação complementar do ZIP: * Nome conforme descrito no tópico anterior deve ser: DATAxxxxxxxxxx.ZIP * Dentro da pasta produtos deve ser criada uma pasta chamada catalogos (deve ser minúsculo) * Dentro da pasta catalogos deve ser criado o arquivo index.html (deve ser minúsculo) Especificação HTML: * Todas as imagens de produtos enviadas ao PDA no tópico acima IMAGEM(S)/VÍDEOS(S) DO(S) PRODUTO(S), podem ser utilizadas. Ex.: <img src=../imagens/1/frente.jpg /> * O arquivo inicial do catálogo deve ter o nome de index.html. * Arquivos de imagens exclusivas do catálogo, podem ser colocadas na pasta catalogos. * Caso a empresa utilize mais de um catálogo, é sugerido que tinha no index.html um índice de catálogos para o vendedor. * O link para selecionar um produto no HTML deve ser catalog://select?codpro=xxxx, onde o XXXX é o código do produto. Ex.: <a href= catalog://select?codpro=1 >código 1</a> Como testar o catálogo no Sistema? Para visualizar o catálogo no PDA, coloque o ZIP na pasta descrita nos passos acima, faça uma conexão com recebimento de imagens/vídeos. Uma vez recebidos todos os dados na conexão, inicie uma digitação de pedidos e entre na tela de Itens. Na tela de Itens clique em Menu, em seguida Modo Catálogo. Importante: a opção de Modo Catálogo na tela de Itens, somente é visível se possuir o arquivo index.html 4-5

5 TEXTOS ADICIONAIS DOS PRODUTOS Este complemento possibilita mostrar vários textos do produto. Todos serão mostrados nos dados do produto no PDA como Textos Adicionais. Ex.: Especificações, Bula, Observação completa, Dados da Embalagem, Novidades etc. Especificação de geração dos arquivos: * Deve ser criada uma pasta chamada produtos (deve ser minúsculo), no local das tabelas que são geradas para o Apogeus Android * Dentro da pasta produtos deve ser criada uma pasta chamada textos (deve ser minúsculo) * Na pasta textos, deve conter 1 pasta para cada produto, sendo que o nome da pasta é o código do produto. Dentro da pasta com o código do produto, pode colocar vários arquivos texto do mesmo. Seguindo a regra abaixo em vermelho. * Cada arquivo dentro da pasta textos deve terminar com.txt (deve ser minúsculo). Ex.: /produtos/textos/123/especificacoes.txt, /produtos/textos/234/bula.txt, /produtos/textos/abc/novidades.txt TEXTOS ADICIONAIS DOS CLIENTES Este complemento possibilita mostrar vários textos do cliente. Todos serão mostrados nos dados do cliente no PDA como Textos Adicionais. Ex.: Conversas dos últimos atendimentos, saldos da situação financeira, observação completa etc. Especificação de geração dos arquivos: * Deve ser criada uma pasta chamada clientes (deve ser minúsculo), no local das tabelas que são geradas para o Apogeus Android * Dentro da pasta clientes deve ser criada uma pasta chamada textos (deve ser minúsculo) * Na pasta textos, deve conter 1 pasta para cada cliente, sendo que o nome da pasta é o código do produto. Dentro da pasta com o código do cliente, pode colocar vários arquivos texto do mesmo. Seguindo a regra abaixo em vermelho. * Cada arquivo dentro da pasta textos deve terminar com.txt (deve ser minúsculo). Ex.: /clientes/textos/123/atendimento.txt, /clientes/textos/234/observacao.txt ANEXO(S) DO(S) PRODUTO(S) Este complemento pode anexar vários arquivos ao produto. Todos serão mostrados nos dados do produto no PDA como Anexos. É indicado para mostrar de PDF's, Áudio, Flash etc. Note que o aparelho deve suportar o tipo de arquivo. Ex.: Manual do produto, Informações do produto gravados em áudio etc. Especificação ZIP: * Nome deve ser: ATTAxxxxxxxxxx.ZIP (No lugar xxxxxxxxxx pode ser a data do arquivo). Ex.: DATA ZIP * Dentro da pasta produtos deve ser criada uma pasta chamada anexos (deve ser minúsculo) * Na pasta anexos, deve conter 1 pasta para cada produto, sendo que o nome da pasta é o código do produto. Dentro da pasta com o código do produto, pode colocar vários arquivos do mesmo, seguindo a regra abaixo em vermelho. * Cada arquivo dentro da pasta anexos será mostrado no PDA como um anexo, e o mesmo poderá ser visualizado se o PDA suportar o tipo de arquivo. Ex.: /produtos/anexos/123/manual.pdf, /produtos/anexos/234/propaganda.mp3, /produtos/textos/abc/instrucoes.pdf Abaixo segue caracteres que serão TROCADOS por _ : * < > :? " Isso deve-se aos caracteres não suportados pelo Windows no nome dos Arquivos. Não podem ser utilizados acentos e Ç, devido ao Android usar UTF-8 e Windows utilizar CP1252(ISO8859-1). LOGO PERSONALIZADO Este complemento possibilita a empresa mudar o logo exibido no fundo da tela inicial e de consulta do Apogeus Android. Especificação complementar do ZIP: * Nome conforme descrito no tópicos anteriores sobre imagens dos produtos deve ser: DATAxxxxxxxxxx.ZIP * O arquivo deve conter a pasta chamada theme (deve ser minúsculo) * Dentro da pasta theme deve colocada uma imagem chamada logo.png com a imagem desejada. Importante: a imagem utilizada deve ser do tipo PNG. Extensões JPG e GIF não são suportadas neste complemento. Evite enviar imagens com tamanhos superiores a 240x240, pois irão afetar o tempo de carregamento do sistema. 5-5