Usina BRAdvPL Guia
Entrar
← Todos os tópicos
PONTO DE ENTRADAEm revisão

F060LOOP

ExecBlock("F060LOOP", .F., .F.)

Filtro de títulos associado a FINA060/FINA061. Chamada catalogada, contrato pendente e exemplo isolado para conferir uma regra de seleção.

F060LOOPFINA060FINA061
01 · VISÃO GERAL

Visão geral

O índice oficial classifica F060LOOP como filtro de títulos em FINA060/FINA061 e mantém a ficha específica em construção. (TOTVS, s.d., ref. 1) A listagem de chamadas registra ExecBlock("F060LOOP", .F., .F.) nas duas rotinas. (TOTVS, s.d., ref. 2) A listagem não informa a expressão que consome o retorno, o alias ativo ou o momento da seleção. Portanto, ela não permite concluir que .T. inclui um título ou que .F. encerra o processamento. Esta ficha está em revisão, baseada em evidência indexada com leitura integral limitada. O exemplo exercita uma regra fictícia fora do PE para facilitar a conferência de resultados esperados.

02 · SINTAXE

Sintaxe

ExecBlock("F060LOOP", .F., .F.)

Parâmetros

Contexto do PE
Não documentadoContexto a confirmar

Não há quarto argumento explícito na chamada catalogada. O conteúdo de PARAMIXB e os aliases disponíveis não foram confirmados; o array do exemplo pertence exclusivamente ao exercício.

Retorno

Tipo e significado do retorno de F060LOOP não confirmados nas fontes localizadas. Os valores lógicos calculados pelo auxiliar não constituem contrato do PE.

03 · EXEMPLO PRÁTICO

Separar a regra de seleção da integração com o PE

#Include "Protheus.ch"

User Function ExF060Loop()
    Local aCasos := {{100, .T.}, {0, .T.}, {100, .F.}}
    Local nIndice := 0
    Local lElegivel := .F.

    // Regra fictícia: valor positivo e autorização local do exercício.
    // Não lemos SE1 e não definimos o retorno de F060LOOP.
    For nIndice := 1 To Len(aCasos)
        lElegivel := aCasos[nIndice][1] > 0 .And. aCasos[nIndice][2]
        If lElegivel
            ConOut("Caso elegivel no exercicio")
        Else
            ConOut("Caso inelegivel no exercicio")
        EndIf
    Next nIndice
Return
Resultado esperado

O primeiro caso é elegível; o segundo e o terceiro são inelegíveis segundo a regra fictícia. Isso não demonstra como o Protheus seleciona títulos. Depois de confirmar o contrato, compare os três grupos em homologação com o processamento padrão. O exemplo não foi compilado nem executado em Protheus.

BOAS PRÁTICAS
  • Escreva os resultados esperados da regra antes de conectá-la ao ponto de entrada. Separe a decisão de negócio da adaptação ao contrato real.
  • Confirme no chamador se o retorno é consumido por título, por conjunto ou de outra forma. O nome LOOP não comprova a frequência de execução.
  • Monte cenários com todos, alguns e nenhum título elegível; confira também cancelamento da operação e reentrada na tela.
  • Valide FINA060 e FINA061 separadamente e registre a quantidade de chamadas observada em cada cenário.
  • Mantenha a regra livre de gravações enquanto testa seleção; preserve áreas de trabalho se a implementação futura consultar aliases.
ARMADILHAS COMUNS
  • Retornar .T. ou .F. por analogia com outro PE sem confirmar a semântica do chamador.
  • Interpretar a chamada sem quarto argumento como garantia de PARAMIXB vazio.
  • Alterar movimentos ou gravar títulos dentro de uma hipótese de filtro ainda não validada.
  • Confundir a regra fictícia do auxiliar com um requisito funcional do borderô.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Pontos de Entrada - Financeiro - P12. TDN. Evidência indexada consultada em 2026-10-20.
  2. TOTVS. Pontos de Entrada. TDN. Evidência indexada consultada em 2026-10-20.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha