Customização de Campos no Vendas - GR
Voltar
BI > BI Desenvolvedor > GDI > Customizar Tabela>Customização de Campos no Vendas - GR
1. Resumo
Foi criado um campo chamado VERSAO na tabela BIFT_FA_VENDASGR. Esse campo ajuda a identificar se o registro já foi atualizado pela rotina customizada (Passo customizado).
- Quando o documento é sincronizado normalmente, o campo VERSAO fica nulo.
- Após a execução do novo passo, o campo VERSAO será preenchido, indicando que o registro já passou pela atualização customizada.
2. Novo passo na tarefa
Na tarefa “GR - Sincronismo Gestão de Resultados”, você deverá criar um novo PASSO que roda logo depois do “Sincronismo de Documentos”.
Esse novo passo serve para:
- Preencher campos personalizados/novos (por exemplo: campos iniciados com custom_), ou
- Atualizar informações específicas conforme regras do cliente (sobrescrever colunas existentes)
3. Como Funciona
3.1. O sistema faz o sincronismo normal dos documentos.
→ Os novos registros aparecem na tabela BIFT_FA_VENDASGR com o campo VERSAO vazio (null).
3.2. Em seguida, o novo PASSO é executado.
→ Ele identifica os registros que estão com VERSAO = NULL.
→ Atualiza as informações conforme a regra definida.
→ Grava um valor no campo VERSAO, indicando que o registro foi tratado
3.3. A partir desse momento, esses registros não serão mais processados novamente, evitando reprocessamentos desnecessários.
4.Como identificar registros pendentes
Caso queira verificar se há registros ainda não tratados:
SELECT COUNT(*) AS Pendentes FROM BIFT_FA_VENDASGR WHERE VERSAO IS NULL;
Se o resultado for zero, todos os registros já foram atualizados
5. Cuidados Importantes
- Não alterar manualmente o campo VERSAO, pois ele é controlado pela rotina.
- Novos campos personalizados devem seguir o padrão de nome custom_nome_do_campo.
- Caso o novo passo falhe, o sincronismo continuará funcionando, mas os campos customizados não serão preenchidos — é necessário reexecutar o passo depois.
6. Resumo
| Etapa | O que faz | Resultado |
|---|---|---|
| Sincronismo de Documento | Insere os registros base | Campo VERSAO fica NULL |
| Passo de Customização | Atualiza os campos customizados | Campo VERSAO é preenchido |
| Verificação | Consulta registros pendentes, quando campo VERSAO = NULL | Garante que tudo foi processado |
Exemplo
UPDATE BIFT_FA_VENDASGR a
SET a.versao = '1',
a.custom_novo_campo = (a.mt_quantidade * a.mt_valor_contabil)
WHERE a.versao IS NULL;
Para manter um comando e tarefa específica para atualização customizada, pode-se usar da técnica que criar um passo em nova tarefa customizada específica, que ao rodar faça o comando. Este passo (de outra, tarefa), poderá ser referenciado por um novo passo criado do tipo "Agrupador de Passos", sendo criado após o processo de sincronismo de documento.
Desta forma se mantém atualizado os dados pelo controle do campo "versão" por agendamento recorrente (de forma individual), ou a partir de execução do Sincronismo de Documentos, sendo este o "gatilho" para atualização dos dados de forma customizado (em novos campos ou em campos atuais).
