Histórico da Página

Requisito

Nenhum

Obrigatório?

Não

Sintaxe

RUN recebeParametros IN h-handle(INPUT TABLE tt-param-reporte).

Descrição

Recebe uma temp-table populada com os parâmetros para execução da API. É o primeiro método que deve ser chamado, logo após instanciar a API.

Parâmetros

Descrição

tt-param-reporte

Temp-table de parâmetros

Funcionamento

Cada parâmetro que a API recebe corresponde a um registro na temp-table tt-param-reporte. Assim, antes de chamar a procedure recebeParametros, é necessário criar na tt-param-reporte os registros.

Cada parâmetro possui um valor padrão. Assim, caso a procedure recebeParametros não seja chamada, ou não seja criado na temp-table um registro relativo a algum dos parâmetros, a API assumirá o valor padrão.

Um parâmetro pode ser do tipo Lógico, Caractér, Data, Decimal, Rowid e Handle. Assim, a temp-table de parâmetros tem um campo de cada um destes tipos. Conforme o tipo de parâmetro, deve ser usado o campo do tipo correspondente, conforme a listagem abaixo e o detalhamento da temp-table tt-param-reporte, feito anteriormente.

Retorno

Não há.

Lista de Parâmetros

Cód. Parâmetro   l-on-line

Tipo:      Lógico

Valor Default:       No

Descrição:            Quando marcado como Yes, este parâmetro indica que a API está sendo executada on-line. Assim, em algumas situações ela poderá emitir mensagens de pergunta diretamente em tela.

Este parâmetro pode ser utilizado com o valor Yes quando a API estiver sendo chamada por uma tela, por exemplo, na qual há um usuário interagindo diretamente com a aplicação. Já em aplicações com execução em batch, este parâmetro deve ter o valor No.

Cód. Parâmetro   l-gera-rowErrors

Tipo:      Lógico

Valor Default:       No

Descrição:            Quando marcado como Yes, indica que a API também irá gerar os erros na temp-table rowErrors, em paralelo à temp-table de erros padrão (tt-erro).

Esta opção é útil quando se está chamando a API a partir de uma interface escrita com thinTemplates, a qual tem como temp-table padrão de erros a rowErrors.

_________________________________________________________________________

Cód. Parâmetro   l-msg-qtd-menor-rep-ant

Tipo:      Lógico

Valor Default:       No

Descrição:            Parâmetro que só terá efeito caso o parâmetro l-on-line seja igual à no. Nas situações em que o reporte da operação anterior possui quantidade inferior ao reporte atual e o sistema emitiria a mensagem 17623 (mensagens EMS*), este parâmetro irá “responder” a pergunta, conduzindo a continuação do processo.

Yes = Continua;

Cód. Parâmetro   l-msg-reporta-tempo-dif-real

Tipo:      Lógico

Valor Default:       Yes

Descrição:            Parâmetro que só terá efeito caso o parâmetro l-on-line seja igual à no. Nas situações em que o tempo reportado difere em mais de 1000% do tempo padrão, e o sistema emitiria a mensagem 18508 (mensagens EMS*), este parâmetro irá “responder” a pergunta, conduzindo a continuação do processo.

Yes = Continua;

Cód. Parâmetro   l-msg-parada-sobrep-continua

Tipo:      Lógico

Valor Default:       Yes

Descrição:            Parâmetro que só terá efeito caso o parâmetro l-on-line seja igual à no. Nas situações em que o período do reporte está sobrepondo uma parada, e o sistema emitiria a mensagem 18011 (mensagens EMS*), este parâmetro irá “responder” a pergunta, conduzindo a continuação do processo.

Yes = Continua;

Cód. Parâmetro   l-msg-reservas-n-requis-continua

Tipo:      Lógico

Valor Default:       Yes

Descrição:            Parâmetro que só terá efeito caso o parâmetro l-on-line seja igual à no  e a função especial Valida Reporte Sem Requisição** estiver implantada. Nas situações em que há reservas ainda não requisitadas, e o sistema emitiria a mensagem 30025 (mensagens EMS*), este parâmetro irá “responder” a pergunta, conduzindo a continuação do processo.

Yes = Continua;

Cód. Parâmetro   l-msg-requisita-saldo-disponivel

Tipo:      Lógico

Valor Default:       Yes

Descrição:            Parâmetro que só terá efeito caso o parâmetro l-on-line seja igual à no. Nas situações em que há reservas sem saldo suficiente para atender por completo, e o sistema emitiria a mensagem 32133, perguntando se deseja que seja requisitado para estas reservas apenas o saldo disponível (mensagens EMS*), este parâmetro irá “responder” a pergunta, tomando a ação especificada.

Yes = Requisita apenas o saldo disponível;

No = Entra na pergunta 32134 (parâmetro a seguir).

Cód. Parâmetro   l-msg-nao-req-sem-saldo-sufic

Tipo:      Lógico

Valor Default:       Yes

Descrição:            Parâmetro que só terá efeito caso o parâmetro l-on-line seja igual à no. Nas situações em que há reservas sem saldo suficiente para atender, e o sistema emitiria a mensagem 32134, informando que as reservas sem saldo suficiente não serão requisitadas e perguntando se deseja continuar (mensagens EMS*), este parâmetro irá “responder” a pergunta, conduzindo a continuação do processo.

Yes = Continua;

Cód. Parâmetro   l-msg-sem-reporte-ggf

Tipo:      Lógico

Valor Default:       No

Descrição:            Parâmetro que só terá efeito caso o parâmetro l-on-line seja igual à no e a função especial Valida Reporte sem GGF** estiver ativa. Nas situações em que não há reporte de GGF informado, e o sistema emitiria a mensagem 30112, perguntando se deseja continuar (mensagens EMS*), este parâmetro irá “responder” a pergunta, conduzindo a continuação do processo.

Yes = Continua;

Cód. Parâmetro   l-msg-sem-reporte-mob

Tipo:      Lógico

Valor Default:       No

Descrição:            Parâmetro que só terá efeito caso o parâmetro l-on-line seja igual à no e a função especial Valida Reporte sem MOB** estiver ativa. Nas situações em que não há reporte de MOB informado, e o sistema emitiria a mensagem 30112, perguntando se deseja continuar (mensagens EMS*), este parâmetro irá “responder” a pergunta, conduzindo a continuação do processo.

Yes = Continua;

Cód. Parâmetro   l-valida-op-anterior

Tipo:      Lógico

Valor Default:       Yes

Descrição:            Indica que irá validar se a operação anterior já foi reportada (mensagem EMS 3414 *) na inicialização da API. Na efetivação do registro, contudo, a validação continuará ocorrendo, independente deste parâmetro.

Yes = Valida na inicialização;