Histórico da Página
Button | ||||
---|---|---|---|---|
|
API de Integração entre Microsoft Excel e Progress (v.01)
Nome Físico: utp/utapi006.p
Nome do Include com Parâmetros: utp/utapi006.i
Versão de Integração: 1
Objetivo:
Ler planilhas do Excel e trazer os valores e fórmulas das células para que estas sejam usadas em um programa Progress.
Pré-requisitos:
É necessário ter o MS-EXCEL com uma versão compatível com o produto. Para mais detalhes consulte a documentação localizada em: https://tdn.totvs.com/pages/releaseview.action?pageId=195301010
Considerações Gerais
- Deve ser passada 2 (duas) temp-tables. A primeira deve ser passada através do comando INPUT-OUTPUT e a segunda através do OUPUT, que retornará uma lista dos erros ocorridos durante o processamento da API.
Parâmetros de Entrada
Temp-table tt-dados:
nesta temp-table deverão ser passadas todas as informações que deseja-se buscar da planilha. Nesta mesma temp-table serão armazenadas as informações retiradas da planilha.
TEMP-TABLE TT-DADOS | |||
Atributo | Tipo | Formato | Valor Inicial |
versao-integracao | integer | "999" | |
arquivo | character | “x(40)” | |
planilha | integer | “>>” | |
celula-linha | integer | “>>>” | |
celula-coluna | integer | “>>>” | |
valor | character | “x(20)” | |
formula-local | character | “x(20)” | |
formula | character | “x(20)” |
Atributo | Tipo |
versao-integracao | Número da versão de integração. |
arquivo | Nome físico do arquivo do Excel a ser lido. |
planilha | Número da planilha dentro do arquivo do Excel. |
celula-linha | Corresponde ao número da linha da célula. |
celula-coluna | Corresponde ao número da coluna da céluna. Ex: 2 = B. |
valor | Campo que irá armazenar o valor da célula. |
formula-local | Campo que irá armazenar a fórmula local da célula. |
formula | Campo que irá armazenar a fórmula padrão da célula. |
Temp-table tt-erros :
Tabela onde serão armazenados todos os erros ocorridos durante a execução da API.
TEMP-TABLE TT-ERROS | |||
Atributo | Tipo | Formato | Valor Inicial |
codigo-erro | integer | ||
descricao | character |
Atributo | Descrição |
codigo-erro | Código da mensagem de erro ocorrido. |
descricao | Descrição do erro ocorrido. |
Execução
O programa utp/utapi006.p irá executar os seguintes passos:
Parâmetros de Saída
No retorno da execução do programa utp/utapi006.p, será retornado via return-value:
NOK:
A execução da API foi efetivada, porém, algum pedido não foi criado.
OK:
A execução ocorreu com sucesso.