Banco de Dados
Referenciado por: Dicas Técnicas |
Visão Geral
A carga para o Totali POS é feita pelo Totali Middleware.
O Middleware com acesso ao Totali Commerce disponibiliza uma API JSON chamada TCommerceAPI/ConsultaRetaguarda para realizar consultas conforme necessidade do POS.
Tutoriais
Exportar Coluna
1. Incluir coluna no respectivo insert em TConsultaRetaguardaDAO.Atualiza .
2. Incrementar a constante da versão da consulta da guarda.
VERSAO_CONSULTA_RETAGUARDA em TTUConsts.
Exportar Tabela
1. Criar novo insert em TConsultaRetaguardaDAO.Atualiza .
2. Incrementar a constante da versão da consulta da guarda.
VERSAO_CONSULTA_RETAGUARDA em TTUConsts.
Padrões
Definição de Nomes e Tipos
Os tipos e nomes das colunas devem ser acertados com a equipe do POS previamente.
Tipos
Os tipos devem ser sempre definidos. São aceitos os seguintes tipos:
- char
- date
- integer
- numeric
- text
- timestamp without time zone
- varchar
Importante:
Colunas booleanas devem ser exportadas no formato varchar com os valores 'true' ou 'false'. E a coluna precisa usar prefixo "b_". Exemplo:
cast('true' as varchar(5)) AS "B_Cid_Ativa"
O Middleware utiliza o prefixo "B_" para interpretar a coluna como sendo Boolean. E retirará o prefixo ao converter o conteúdo da query para o JSON.
Expressão Opcional
Utilize a expressão /*<opcional>*/ para deixar partes da consulta opcionais.
/*<opcional>*/ and cli.atu_em < :dateHour_Fim /*</opcional>*/
Parâmetros na Consulta
É permitido que as consultas tenham parâmetros. Os parâmetros são definidos com a sintaxe :<tipo>_<Nome>. Os seguintes tipos são aceitos:
| Prefixo | Descrição | Formato / Tratamento (Delphi) |
| date_ | Prefixo para variáveis de data | dd/mm/yyyy |
| dateHour_ | Prefixo para variáveis de data e hora | dd/mm/yyyy hh:nn:ss |
| hour_ | Prefixo para variáveis de hora | hh:nn:ss |
| int_ | Prefixo para variáveis numéricas inteiras | |
| real_ | Prefixo para variáveis reais | Separador ",". Máximo 4 casas decimais. |
| set_ | Prefixo para variaveis usadas na clausula IN | Substituição de string simples. Ex.: '1','2','3' ou ('1','1'),('2','2'). Conforme criado na query. |
| str_ | Prefixo para variáveis String | Substituição de string simples |
| tbl_ | Prefixo para nomes de tabela | Substituição de string simples |
Atualizar Constante de Versão
Para qualquer alteração feita nas consultas será necessário atualizar a constante VERSAO_CONSULTA_RETAGUARDA em TTUConsts.
Isso é necessário para que o Middleware saiba que ele precisa recriar o script de consultas (seu cache de consultas).
Ao iniciar o Middleware, ele carrega os scripts das consultas em memória de acordo com o conteúdo da tabela consultaretaguarda.
Ao sinalizar que houve alterações nos scripts, o sistema recria essa tabela e carrega a nova estrutura para memória.
Campos da Tabela ConsultaRetaguarda
Ao criar uma nova consulta, será necessário definir conteúdo para as seguintes colunas:
conret_origem: "C" - Totali Commerce
conret_codtab: Descobrir qual foi a última numeração usada, e incrementar 1.
SELECT MAX(conret_codtab) FROM ConsultaRetaguarda
conret_versao: Usado somente quando há necessidade de manter uma versão diferente do select por questões de compatibilidade.
conret_titulo: Nome da consulta, para facilitar localização.
conret_sqlstr: o select da consulta.