Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de APi

Nome Físico:

lap/mlaapi014.p

...

detalheDocumento

Requisito

NenhumPendência gerada no MLA.

Descrição

Busca os detalhes do documento MLA.

Obs: A mlaapi014 serve como ponte de comunicação entre o Fluig e o programa Progress referente ao documento utilizado. Através do número da transação da pendência, é recuperado o código do documento e então é executada a procedure "detalheDocumento" do programa padrão referente ao documento.

Por exemplo:

  • Doc 1 executará a procedure detalheDocumento do laphtml/mlahtml001p.p;
  • Doc 501 executará a procedure detalheDocumento do laphtml/mlahtml501p.p

Para mais informações acesse a documentação específica destas API's em API - MLA.

Parâmetros

Tipo

Input/Output

Descrição

pNrTransacao

INTEGER

INPUT

Número da transação

lGeracaoPend

LOGICAL

INPUT

Indica se a chamada está sendo feita pela geração da pendência (true) ou da consulta do detalhe (false)

pDesTipDocCHARACTEROUTPUTDescrição do tipo do documento
pSituacaoINTEGEROUTPUTSituação do documento
ttDadosTEMP-TABLEOUTPUTTemp-table genérica com todas as informações referentes ao documento

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK".

detalhePendencia

Requisito

NenhumPendência gerada no MLA.

Descrição

Busca os detalhes da pendência do MLA

Parâmetros

Tipo

Input/Output

Descrição

 pNrTransacao

INTEGER 

INPUT Número da transação 

 ttDados

TEMP-TABLE OUTPUT Temp-table com as informações detalhadas da pendência e chave formatada do documento 

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK".

historicoDocumento

Requisito

NenhumPendência gerada no MLA.

Descrição

Busca o histórico de aprovação do documento.

Parâmetros

Tipo

Input/Output

Descrição

 pNrTransacao

INTEGER 

INPUT Número da transação 

 ttDados

TEMP-TABLE OUTPUT Temp-table com as informações detalhadas da pendência e chave formatada do documento 

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK"

...

aprovarDocumento

Requisito

Nenhum.

Descrição

Aprova/Reprova o documento MLA

Parâmetros

Tipo

Input/Output

Descrição

 pUsuario

CHARACTER

INPUT  Usuário que está realizando a aprovação/reprovação do documento.

pSelecionados 

CHARACTER INPUT Transações selecionadas que serão aprovadas/reprovadas. Obs: separadas por "," 
pAcao INTEGERINPUT  1 - Aprovar; 2 - Reprovar
pNarrativa CHARACTER INPUT Narrativa de aprovação/reprovação. 
pCodRejeicao INTEGER INPUT Código da rejeição. Obs: Passar 0 caso seja aprovação. 
pLoteLOGICALINPUT

Flag que indica se a aprovação está sendo feito em lote ou individualmente.

Obs: Quando o valor desta flag for verdadeiro (movimentação em lote), o sistema usará a narrativa e código de rejeição padrão.

pLogErroLOGICALOUTPUTFlag que indica se houve erro no processamento
RowErrorsTEMP-TABLEOUTPUTTemp-table com os erros do processamento

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK".

startProcessFluig

Requisito

NenhumPendência gerada no MLA.

Descrição

Inicia uma solicitação no Fluig

Parâmetros

Tipo

Input/Output

Descrição

iNrTransacao

INTEGER 

INPUTNúmero da transação que dará inicio a solicitação no Fluig

iNrSolicFluig 

INTEGER OUTPUT Número da solicitação criada no Fluig 
RowErrorsTEMP-TABLE OUTPUT Temp-table com os erros do processamento 

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK".

cancelProcessFluig

Requisito

NenhumPendência gerada no MLA.

Descrição

Cancelar uma solicitação no Fluig

Parâmetros

Tipo

Input/Output

Descrição

iNrTransacao

INTEGER

INPUTNúmero da transação que terá a solicitação Fluig cancelada

iTipo

INTEGER

INPUT

1 - Cancelado pois o documento originador foi alterado

2 - Cancelado pois o documento originador foi removido

RowErrorsTEMP-TABLEOUTPUTTemp-table com os erros do processamento

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK".

changeStateFluig

Requisito

Nenhum.

Descrição

Movimentar uma solicitação no Fluig

Parâmetros

Tipo

Input/Output

Descrição

iNrTransacao

INTEGER 

INPUT Número da  transação MLA

iAtividade 

INTEGER INPUT Número da atividade: 6 - Aprovar; 7 - Reprovar 
RowErrors TEMP-TABLE OUTPUT Temp-table com os erros do processamento 

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK".

trocaAprovador

Requisito

NenhumPendência gerada no Fluig e já alterada no MLA.

Descrição

Altera o aprovador da solicitação Fluig.

Obs: O novo aprovador é recuperado da tabela mla-doc-pend-aprov, por isso não há necessidade de passá-lo como parâmetro para a procedure.

Porém é necessário passar o usuário original da pendência, que era o aprovador antes da troca.

Parâmetros

Tipo

Input/Output

Descrição

iNrTransacao 

INTEGER 

INPUT Número da transação MLA

cUserOrig 

CHARACTER INPUT Código do usuário ERP Origem (antigo responsável da pendência)
RowErrors TEMP-TABLE OUTPUT Temp-table com os erros do processamento

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK".

...

setHandleFluig

Requisito

Nenhum.

Descrição

Inicia o handle da api de integração com o Fluig.

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK".

setHandleFluigunsetHandleFluig

Requisito

Nenhum.

Descrição

Encerra e elimina o handle da api de integração com o Fluig.

Retorno

O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK".

 

Documentação das temp-tables usadas na MLAAPI014:

ttDados

Entrada/Saída

Temp-table com dados agrupados das tabelas que trafegam entre o ERP e o Fluig.

Saída

Atributo

Tipo

Descrição

Obrigatório

Evolução

cTable

CHARACTER

Nome da tabela

 

Sim

Não se aplica

iRow

INTEGER

 

Número da linha/registro. Usa este campo para indicar quais campos pertencem ao mesmo registro

 

Sim

Não se aplica

cFieldCHARACTERNome do campo da tabelaSimNão se aplica
cValueCHARACTERValor do campoSimNão se aplica

ttCodRejeita

Entrada/Saída

Temp-table com dados das rejeições cadastradas no ERP

Saída

Atributo

Tipo

Descrição

Obrigatório

Evolução

codRejeita

INTEGER 

Código da rejeição 

Sim

Não se aplica

descRejeita

CHARACTER Descrição da rejeição 

Sim

Não se aplica

obrigaNarrativaLOGICALFlag que indica se é necessário informar a narrativa para a rejeição selecionada.SimNão se aplica

ttUsuarMestre

Entrada/Saída

Temp-table com dados dos usuários mestres cadastrados no ERP

Saída

Atributo

Tipo

Descrição

Obrigatório

Evolução

codUsuar

CHARACTER 

Código do usuário mestre 

Sim

Não se aplica

nomeUsuar

CHARACTER Nome do usuário mestre 

Sim

Não se aplica

eMailCHARACTER E-mail do usuário mestre SimNão se aplica

RowErrors

Entrada/Saída

Temp-table com dados dos erros ocorridos durante o processo

Saída

Atributo

Tipo

Descrição

Obrigatório

Evolução

ErrorSequence

 INTEGER

Número da sequência do erro

Sim

Não se aplica

ErrorNumber

INTEGER Código do erro 

Sim

Não se aplica

ErrorDescriptionCHARACTER Descrição do erro SimNão se aplica
ErrorParametersCHARACTER Parâmentros da mensagem de erro SimNão se aplica
ErrorTypeCHARACTER Tipo do erro SimNão se aplica
ErrorHelpCHARACTER Texto de ajuda da mensagem de erro SimNão se aplica
ErrorSubTypeCHARACTERSubtipo do erroSimNão se aplica