Contexto do PENão documentadoContexto a confirmar
Contexto não documentado nas evidências localizadas. Não presumir campos, aliases ou posições de PARAMIXB a partir dos argumentos do auxiliar, que são inteiramente autorais.
PONTO DE ENTRADAEm revisão
F060VBCO
F060VBCO()Validações complementares do usuário em FINA060/FINA061. Finalidade catalogada e organização de uma regra própria antes da integração com o PE.
Visão geral
O índice oficial Financeiro P12 descreve F060VBCO como ponto para validações extras do usuário em FINA060/FINA061; a ficha específica está em construção. (TOTVS, s.d., ref. 1) A relação de PEs de baixas repete essa finalidade. (TOTVS, s.d., ref. 2) As fontes localizadas não confirmam a chamada completa, os argumentos, o momento de execução ou o retorno. O nome não comprova uma validação bancária específica. F060VBCO() abaixo identifica o PE, sem estabelecer uma assinatura completa. A página está em revisão, baseada em evidências indexadas com acesso integral limitado. O exemplo mostra como separar mensagens de uma regra fictícia; não implementa nem substitui F060VBCO.
Sintaxe
F060VBCO()Parâmetros
Retorno
Retorno e efeito sobre o fluxo padrão não confirmados. O array de mensagens do exemplo pertence ao auxiliar e não deve ser devolvido por F060VBCO sem evidência do chamador.
Produzir mensagens sem acoplar a regra ao PE
#Include "Protheus.ch"
User Function ExF060VBCO()
Local aErros := ValidaCaso("", 0)
Local nIndice := 0
// Dois erros são esperados para estes dados fictícios.
// A exibição fica separada da regra que reúne as mensagens.
For nIndice := 1 To Len(aErros)
ConOut(aErros[nIndice])
Next nIndice
Return
Static Function ValidaCaso(cIdentificador, nValor)
Local aErros := {}
// Argumentos locais do exercício; não representam campos do Protheus.
If Empty(cIdentificador)
AAdd(aErros, "Informe o identificador do exercicio")
EndIf
If nValor <= 0
AAdd(aErros, "O valor do exercicio deve ser positivo")
EndIf
Return aErros
Resultado esperado
O auxiliar reúne e exibe duas mensagens: identificador ausente e valor não positivo. Com dados válidos segundo a regra fictícia, a lista fica vazia. A ausência de mensagens não autoriza uma operação do Protheus; a integração depende do contrato real. Exemplo não compilado nem executado em Protheus.
- Descreva a regra de negócio e seus resultados esperados antes de escolher o PE; confirme que o momento da chamada atende à necessidade.
- Mantenha o cálculo da validação separado da apresentação de mensagens e de gravações. Assim, a mesma regra pode ser conferida isoladamente.
- Prepare dados válidos, inválidos e com mais de um erro; confira se o processo precisa informar todas as falhas ou interromper na primeira.
- Após confirmar o contrato, teste o efeito da validação na confirmação e no cancelamento, em FINA060 e FINA061 separadamente.
- Registre release, patch, chamada e retorno observados; preserve áreas de trabalho se a integração consultar aliases.
- Deduzir campos bancários ou critérios obrigatórios apenas pelo sufixo VBCO.
- Retornar o array do auxiliar, .T. ou .F. sem verificar o chamador.
- Confundir ausência de mensagens do exemplo com autorização para gravar um borderô.
- Acrescentar gravações a uma regra de validação antes de confirmar transação e tratamento de erro.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.