Documentação sobre uso de Consultas Auxiliares na Fórmula de Contabilização

Foi criada um forma nova de executar as fórmulas na contabilização. O usuário poderá criar arquivos de querys (.sql) e colocar no Repositório de arquivos no seguinte caminho:
Sistema/ctbz/consultas.
Todos esses arquivos de querys serão carregados no início de execução da contabilização.

Para isso foram criadas duas novas funções, que serão utilizadas nas fórmulas da contabilidade:

Exemplo 1: CONSULTA('impostos.sql', 'VLRDESDOB')

Neste primeiro exemplo o usuário passará os seguintes parâmetros:

  Nome do arquivo (.sql) salvo no repositório de arquivos;
  Nome do campo que ele deseja buscar o resultado.

O arquivo (.sql) deve possuir o seguinte formato:

SELECT SUM(NVL(VLRDESDOB,0)) AS VLRDESDOB
FROM CTBZCARTOES
WHERE NUNOTA= :CHAVE

Exemplo 2: CONSULTA('impostos.sql', 'VLRDESDOB', 123456)

No segundo exemplo o usuário passará os seguintes parâmetros:
  Nome do arquivo (.sql) salvo no repositório de arquivos;
  Nome do campo que ele deseja buscar o resultado;
  Nome da chave auxiliar.

O arquivo (.sql) deve possuir o seguinte formato:

/*#CHAVEAUX: CODCTACTB*/
SELECT CODCTACTB
, SUM(NVL(VLRDESDOB,0)) AS VLRDESDOB
FROM CTBZCARTOES
WHERE NUNOTA= :CHAVE
GROUP BY CODCTACTB

OBSERVAÇÕES:

CTBZCARTOES é o nome de uma VIEW na base do cliente. No exemplo 1 o usuário deseja buscar apenas o valor do campo "VLRDESDOB" para o resultado da query. Já no exemplo 2 o usuário deseja buscar o valor do campo VLRDESDOB para a CODCTACTB igual a 123456

• As querys deverão ter apenas o parâmetro: Chave que será preenchido durante a contabilização.

Por exemplo:

- Contabilização de Nota: CHAVE = NUNOTA
- Contabilização de Financeiro: CHAVE = NUFIN
- Contabilização de Baixa: CHAVE = NUFIN, etc.

Essas novas funções serão utilizadas nas seguintes contabilizações: lançamentos de Nota, lançamentos de Financeiro, lançamentos de Baixa e lançamentos de Redução Z.

• Criamos o campo "Consultas Auxiliares" no cadastro da TOP. Neste campo o usuário irá informar quais arquivos aquela TOP usará na contabilização. O usuário deverá separar o nome dos arquivos por ','.
  Exemplo: queryImposto.sql, queryImpostoPis.sql, queryImpostoCofins.sql

Este campo estará visível apenas na tela "Top Contabilização", no caminho: Contabilização » Arquivos » TOP Contabilização;

 'Contabilização » Arquivos » TOP Contabilização'