Á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ísicoprgfin/fas/fas791ZA


Observação: A partir da release 12.1.23xx.

Objetivo

Criar documentos de entrada no módulo de Ativo Fixo do EMS 5.

Funcionamento

Na forma padrão, realiza-se a chamada através de um comando RUN normal, armazenando o programa em uma variável através do comando PERSISTENT e em seguida executando uma PROCEDURE deste programa, passando-se os parâmetros com as informações necessárias.

A sintaxe para a chamada da API é:

DEF VAR v_hdl_program AS HANDLE NO-UNDO.
RUN prgfin\fas\fas791za.py PERSISTENT SET v_hdl_program.
RUN pi_api_criacao_docto_entr IN v_hdl_program (input "ems2",
                                                                                     input table tt_bem_invest_mga,
                                                                                     output table tt_log_erros).
DELETE PROCEDURE v_hdl_program. 


Parâmetros

Parâmetro

Descrição

Código Matriz Tradução Organização Externa

Neste parâmetro deverá ser informada a matriz de tradução da organização externa.

tt_bem_invest_mga

Esta temp-table conterá os registros com as informações do documento de entrada e dos itens que serão criados. Deverá ser definida conforme os atributos mencionados a seguir, na seção Tabelas Temporárias.

tt_log_erros

Esta temp-table conterá os erros ocorridos durante as validações feitas pela API no momento da inclusão do documento de entrada. Deverá ser definida conforme os atributos mencionados a seguir, na seção Tabelas Temporárias. Não deverá ser alimentada ao chamar a API.

Observações:

- Deve ser gerada a temp-table no programa que chamará a API. Esta temp-table conterá as informações sobre os documentos de entrada e os itens do documento que serão implantados no Ativo Fixo.

...

1) Criação de Bem Patrimonial via API

Tabela Temporária

Descrição

Entrada/Saída

tt_integr_incorp_bem_pat_2

Conterá as informações das incorporações a serem implantadas.

Entrada

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

tta_num_id_bem_pat

integer

>>,>>>,>>9

Número de Identificação do Bem ao qual a incorporação será vinculada.

Sim


tta_num_seq_incorp_bem_pat

integer

>>,>>>,>>9

Número da sequência da incorporação do bem.

Sim



4) Tabela de erros

Tabela Temporária

Descrição

Entrada/Saída

tt_log_erros_int_inc_bem_pat_1

Conterá as informações dos movimentos que não foram importados com a respectiva mensagem de erro.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

ttv_row_integr_incorp_bem_pat

rowid


ROWID da incorporação ao qual o erro está vinculado.



ttv_num_erro

integer

>>>>,>>9

Número do erro para a incorporação do bem patrimonial com a chave formada pelos atributos acima nesta temp table.



ttv_des_msg_erro

characterx(60)

Mensagem de erro para a incorporação do bem patrimonial com a chave formada pelos atributos acima nesta temp table.



tta_des_msg_ajuda

character

x(40)

Mensagem de ajuda referente ao erro para a incorporação do bem patrimonial com a chave formada pelos atributos acima nesta temp table.




Execução

Leitura e Criação dos Registros

Exemplo do programa para criação dos registros nas temp-tables com os documentos de entrada a serem implantados:

def new global shared var v_cod_empres_usuar
    as character
    format "x(3)":U
    label "Empresa"
    column-label "Empresa"
    no-undo.

...