Complementos


De Apogeus Wiki
Ir para: navegação, pesquisa

Os Complementos foram adicionados na primeira versão do Apogeus Android, os mesmos servem para adicionar novas funcionalidades sem requerer mudanças nas tabelas do sistema. Essas mudanças são desde imagens nos produtos, textos sem limitação para cliente e produtos, ou até mesmo catálogo HTML.

Complementos atuais:


  • Código de Barras 2D de Clientes e Produtos

Esse é um dos Complementos feitos no Apogeus Android, o mesmo permite que você leia código de barras 2D(QRCODE) no dispositivo. Aqui iremos abordar de como funciona a criação do mesmo.

O código é lido pelo Apogeus Android utilizando o programa Barcode Scanner. 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.: http://qrcode.kaywa.com/

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

  • Imagens/Vídeos dos Produtos

Esse é um dos Complementos feitos no Apogeus Android, Este complemento é opcional, caso não queria usar imagens basta mudar no PDA o tipo de lista para não exibir. Com ele você pode mostrar uma imagem ou várias, além de mostrar vídeos do seu produto.


Utilize o Apogeus Media Manager para criar os arquivos formatados conforme os padrões abaixo, evitando erros da criação manual dos arquivos. Acesse pelo menu de ferramentas do Progressiva Server.


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:\ProgressivaServer\PDA\2\Media
  • 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.: DATA20110627.ZIP
  • O arquivo deve conter a pasta chamada “produtos”(deve ser minúsculo)
    • 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 = Usado em PDA com pouco processamento(Padrão)
        • Grande: lthumb.jpg = Usado em PDA com maior resolução
        • Extra Grande: xlthumb.jpg = 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).
      • Exemplo: /produtos/imagens/123/frente.jpg , /produtos/imagens/456/lado.png
      • Importante: A partir da versão 1.0.00.07 somente são suportadas miniaturas do tipo JPG.
    • 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.
      • Exemplo: /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/Imagens das Ouvidorias

Esse é um dos Complementos feitos no Apogeus Android, Com as ouvidorias a empresa pode receber textos e fotos dos PDA's se o vendedor desejar, a empresa pode obrigar ao vendedor o envio das informações informando na Tabela de Clientes se o mesmo necessita de ouvidoria. Este módulo é opcional, e pode ser ativado/desativado.

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, todos os arquivos serão colocados na pasta: C:\ProgressivaServer\Uploads\2\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.

Você pode mostrar as ouvidorias nos e-mails enviados pela empresa, ou na impressão dos registros sejam eles de pedido/não-venda/novo cliente/alteração de cliente.

Tipos de Ouvidoria

  • Envidadas pelo pedido:
Estão disponíveis na pasta: C:\ProgressivaServer\Uploads\2\Media\pedidos
  • Envidadas pelos itens de pedidos:
Estão disponíveis na pasta: C:\ProgressivaServer\Uploads\2\Media\pedidos\XXXXXXX\YYYYYYY
No qual XXXXXXX é o identificador do pedido e YYYYYYY é o identificador do item de pedido.
  • Envidadas pelo novo cliente:
Estão disponíveis na pasta: C:\ProgressivaServer\Uploads\2\Media\novos_clientes
  • Enviadas por alteração de cliente:
Estão disponíveis na pasta: C:\ProgressivaServer\Uploads\2\Media\alteracoes_clientes
  • Envidadas pela não-venda:
Estão disponíveis na pasta: C:\ProgressivaServer\Uploads\2\Media\nao_vendas


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:\ProgressivaServer\Uploads\2\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:\ProgressivaServer\Uploads\2\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. Nesta pasta poderão existir pastas de itens, onde serão criadas uma pasta por item de pedido(se for enviada ouvidoria no item de pedido), o nome da pasta do item é uma chave composta (“Letra I” + “Código do produto” + “Se é Brinde”, todos separados por “_”) e dentro desta pasta estarão os arquivos da ouvidoria do item. Importante: Para enviar ouvidoria nos itens de produto deve ser informado na tabela de produto se o mesmo permite ouvidoria.
    • Não-venda: serão exportados para C:\ProgressivaServer\Uploads\2\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:\ProgressivaServer\Uploads\2\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.
    • Alterações de clientes: serão exportados para C:\ProgressivaServer\Uploads\2\Media\alteracoes_clientes\, no qual dentro desta pasta irá criada uma pasta com uma chave composta(“Código do vendedor” + “Código do Cliente” + “Chave de alteração”), e na mesma serão colocados os arquivos enviados pela ouvidoria. A chave de alteração será gerada baseada na data de alteração do cliente.
  3. Cada arquivo enviado para as pastas de pedidos/itens de pedidos/não-vendas/novos clientes, irão seguir a nomenclatura abaixo:
    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
      I = Descrição item (somente enviado os itens de pedido)
      D = Desenho (somente enviado nos itens de pedido)
    2. 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:\ProgressivaServer\Uploads\2\Media\nao_vendas\1_20110711_82921_1_3\P1310383794328.jpg (foto)
C:\ProgressivaServer\Uploads\2\Media\nao_vendas\1_20110711_82921_1_3\P1310383794328.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:\ProgressivaServer\Uploads\2\Media\pedidos\00103082011072231\P1310393794328.bar (código de barras)
C:\ProgressivaServer\Uploads\2\Media\pedidos\00103082011072231\P1310393794328.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.

Exemplo 3: Itens de pedido enviando uma DESCRIÇÃO DO ITEM em anexo:
C:\ProgressivaServer\Uploads\2\Media\pedidos\00103082011072231\I_0000000000002011_N\I1310393794328.png (desenho)
C:\ProgressivaServer\Uploads\2\Media\pedidos\00103082011072231\I_0000000000002011_N\I1310393794328.txt (texto)
No exemplo acima temos um arquivo que possui o desenho exemplificando a descrição do item(.png) e um arquivo texto(.txt), onde pela chave única podemos identificar que o texto é uma descrição do desenho do item.


  • Catálogo de Produtos

Esse é um dos Complementos feitos no Apogeus Android. 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 de Imagens/Vídeos dos Produtos, para mais informações consulte o tópico antes de prosseguir.


Especificação complementar do ZIP:

  • Nome conforme descrito no tópico de imagens e vídeos deve ser: “DATAxxxxxxxxxx.ZIP”
  • O arquivo deve conter a pasta chamada “produtos”(deve ser minúsculo)
  • 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:

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”


  • Textos Adicionais dos Produtos

Esse é um dos Complementos feitos no Apogeus Android, Este complemento possibilita mostrar vários textos do produto. Todos serão mostrados nos dados do produto no PDA como “Textos Adicionais”.

Exemplos de utilização: 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


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 Adicionais dos Clientes

Esse é um dos Complementos feitos no Apogeus Android, Este complemento possibilita mostrar vários textos do cliente. Todos serão mostrados nos dados do cliente no PDA como “Textos Adicionais”.

Exemplos de utilização: 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 cliente. 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


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 Adicionais dos Produtos por Clientes

Esse é um dos Complementos feitos no Apogeus Android, Este complemento possibilita mostrar vários textos do produto, porém será somente visível para o cliente desejado. Todos serão mostrados nos dados do produto no PDA como “Textos Adicionais”.

Exemplos de utilização: Novidades, últimas compras, promoções para o cliente 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 cliente, seguindo a regra abaixo em vermelho
  • Na pasta com o código do cliente deve ser criada uma pasta chamada “produtos”.(deve ser minúsculo)
  • Na pasta “produtos”, deve conter 1 pasta para cada produto, sendo que o nome da pasta é o código do produto, seguindo a regra abaixo em vermelho
  • Cada arquivo dentro da pasta “produtos” deve terminar com “.txt”(deve ser minúsculo).
Ex: /clientes/textos/123/produtos/1/Compras.txt, /clientes/textos/13/produtos/2/Promocao.txt


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). 

  • Anexos dos Produtos

Esse é um dos Complementos feitos no Apogeus Android, 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.

Exemplo: Manual do produto, Informações do produto gravados em áudio etc.


Utilize o Apogeus Media Manager para criar os arquivos formatados conforme os padrões abaixo, evitando erros da criação manual dos arquivos. Acesse pelo menu de ferramentas do Progressiva Server.

Especificação ZIP

  • Nome deve ser: “ATTAxxxxxxxxxx.ZIP” (No lugar xxxxxxxxxx pode ser a data do arquivo). Ex.: ATTA20110627.ZIP
  • O arquivo deve conter a pasta chamada “produtos”(deve ser minúsculo)
  • 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.
  • Exemplo: /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

Esse é um dos Complementos feitos no Apogeus Android. Este complemento possibilita a empresa mudar o logo exibido no fundo da tela inicial e de consulta do Apogeus Android.


Utilize o Apogeus Media Manager para criar os arquivos formatados conforme os padrões abaixo, evitando erros da criação manual dos arquivos. Acesse pelo menu de ferramentas do Progressiva Server.


Especificação complementar do ZIP de Imagens/Vídeos dos Produtos:

  • 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.

  • Indicadores por Vendedor Personalizado

Esse é um dos Complementos feitos no Apogeus Android, Este complemento possibilita mostrar para cada vendedor uma tela de indicadores personalizada, se existir dados na pasta do vendedor o sistema irá substituir os indicadores padrões do Apogeus.

Exemplo: A empresa pode enviar diariamente uma página HTML com os dados atualizados para consulta offline, porém o sistema irá permitir acesso a sites on-line permitindo um acesso fácil a um portal da empresa se necessário.


Especificação de geração dos arquivos:

  • Deve ser criada uma pasta chamada “vendedores”(deve ser minúsculo), no local das tabelas que são geradas para o Apogeus Android
  • Dentro da pasta “vendedores” deve ser criada uma pasta chamada “indicadores”(deve ser minúsculo)
  • Na pasta “indicadores”, deve conter 1 pasta para cada vendedor, sendo que o nome da pasta é o código do vendedor, seguindo a regra abaixo em vermelho
  • Na pasta com o código do vendedor deve ser criado um arquivo HTML para cada tipo de indicador. O nome do arquivo será utilizado na aba de indicadores, sendo assim o mesmo vendedor poderá ter vários arquivos que serão separados em abas. Você pode utilizar scripts e recursos online, porém o sistema não irá carregar recursos locais do dispositivo. O arquivo HTML deve utilizar o Encoding ISO8859-1, porém o mesmo não deve ficar fixo no html.
Ex.: /vendedores/indicadores/1/Empresa.html, /vendedores/indicadores/1/Metas.html, /vendedores/indicadores/2/Empresa.html


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). 

Histórico de Alterações

  • 3.0.00.15 (1 de agosto de 2016)
    • Nova opção de filial nos complementos de imagens/vídeos e anexos dos produtos.
  • 3.0.00.13 (9 de outubro de 2015)
    • Novo tipo de complemento de Indicadores por Vendedor Personalizado.
  • 2.0.00.12 (18 de junho de 2015)
    • Novo tipo de ouvidoria nas alterações de clientes, verifique a sessão de Complementos.
  • 2.0.00.11 (2 de fevereiro de 2015)
    • Novo tipo de arquivo de desenho com foto( .jpeg) na ouvidoria, verifique a sessão de Complementos.
  • 1.0.00.09 (3 de setembro de 2013)
    • Novo complemento de Textos adicionais do Produto por Cliente, verifique a sessão de Complementos.
    • Alterados caminhos de importação e exportação de dados para o novo servidor Progressiva Server.
  • 1.0.00.08 (20 de dezembro de 2012)
    • Novo tipo de ouvidoria nos itens de pedido, verifique a sessão de Complementos.
  • 1.0.00.04 (26 de outubro de 2011)
    • Novo complemento de Textos adicionais e Anexos dos Produtos, verifique a sessão de Complementos.
  • 1.0.00.03 (18 de outubro de 2011)
    • Novo complemento de Catálogo de Produtos, verifique a sessão de Complementos.