Navigation:  Integração via banco de dados >

Definição da estrutura do arquivo XLS

 Previous  Top  Next

A tabela DIINTERFACE também pode ser alimentada através de um arquivo XLS ou XLSX. Para utilizar esta funcionalidade é necessário de um arquivo com extensão XLS ou XLSX cujo cabeçalho (primeira linha) contenha todos os campos existentes na tabela DIINTERFACE. Exemplo do arquivo na figura a seguir:

 

xls

 

IMPORTANTE!

O arquivo XLS ou XLSX deve conter no cabeçalho todos os campos da tabela DIINTERFACE, mesmo que nem todos sejam utilizados.

 

Recursos de importação e exportação

Siga abaixo os recursos possíveis a serem selecionados dentro da função de importação:

import

Importar dados (Importar planilha)

Botão utilizado para importar a planilha para o sistema.

import_xls

Modelo de importação (Expor planilha modelo de importação)

Botão utilizado para baixar o modelo de importação.

export

Exportar dados (Exportar planilha)

Botão utilizado para exportar a planilha para o computador.

 

Baixar modelo de planilha

Ao invés de preencher todas as colunas da tabela DIINTERFACE manualmente, o sistema permite baixar um modelo pronto com estas colunas já preenchidas, necessitando apenas adicionar as informações necessárias no corpo de cada coluna utilizada. Para realizar o ​download do modelo de planilha, navegue até a tela de acompanhamento SoftExpert Configuração arrowrgray Acompanhamento arrowrgray Ferramenta arrowrgray Importação arrowrgray Acompanhamento (CM015).

Dentro desta tela é possível utilizar o botão import_xls (Modelo de importação) para baixar o arquivo de modelo.

 

Importar arquivo para o sistema

Existem três formas diferentes de se importar dados para o sistema através do modelo de planilha descrito anteriormente. Estas três abordagens serão descritas abaixo:

 

Upload pelo sistema

Para realizar o upload do arquivo, navegue até a tela acompanhamento (SoftExpert Configuração arrowrgray Ferramenta arrowrgray Importação arrowrgray Acompanhamento (CM015)). Dentro desta tela utilize o botão Importar planilha​ para realizar o upload ​do arquivo para dentro do sistema. Em seguida, uma tela será aberta para realizar o processo de importação de dados. Arraste o arquivo de planilha para dentro da tela exibida ou então o selecione através do botão Selecionar. Caso o arquivo a ser importado esteja correto, será demonstrado a seguinte mensagem: "Arquivo Excel validado com sucesso". Após incluir o arquivo na tela, utilize o botão ​Importar​ para concluir a importação dos dados.

 

Inclusão por diretório

Para realizar a operação de inclusão do arquivo de planilha via inserção por diretório, primeiramente o arquivo deve conter em seu nome a palavra ​seimport​.

 

Estrutura

Exemplo

<seimport>

seimport.xls

<nome> + <seimport>

example.seimport.xls

<seimport> + <nome>

seimport.example.xls

<nome> + <seimport> + <nome>

example.seimport.example.xls

 

O arquivo desejado também deve estar dentro do diretório import: <SE_SUITE_HOME arrowrgray Web arrowrgray Import>

IMPORTANTE!

<SE_SUITE_HOME> indica o diretório onde o SoftExpert Suite está contido​.

 

Caso esteja sendo utilizado o recurso de ​multidatabase​, o nome do arquivo deve conter o domínio presente no arquivo ​database-config​, seguido pelo sufixo _seimport​. Na tabela abaixo há exemplos para a denominação de nomes usando como exemplo o domínio “www.softexpert.com”.

 

Estrutura

Exemplo

<domínio> + <seimport>

www.softexpert.com_seimport.xls

<domínio> + <seimport> + <nome>

www.softexpert.com_seimport.example.xls

 <nome> + <domínio> + <seimport>

example.www.softexpert.com_seimport.xls

<nome> + <domínio> + <seimport> + <nome>

example.www.softexpert_seimport.example.xls

 

Para clientes que utilizam Hosting SoftExpert e queiram fazer uso deste método de upload de dados para a tabela DIINTERFACE, sugerimos um contato com a equipe comercial da SoftExpert, com o objetivo de solicitar detalhes do nosso serviço de SFTP. Uma vez adquirido este serviço, será possível utilizar este meio para depositar arquivos de carga para a tabela DIINTERFACE seguindo o modelo descrito acima.

 

Upload de planilha via webservice

Para utilizar este método basta fazer uma requisição HTTP (POST) ao endpoint https://<domain>/apigateway/se/dataintegration/importjob/upload.php com conteúdo do tipo form-data (multipart/form-data) e incluir a planilha (respeitando o formado descrito nos tópicos anteriores) como parâmetro no respectivo formulário.

 

A chave deste parâmetro precisa ser "userfile". A camada de autenticação deste endpoint irá respeitar as regras de segurança do APIGateway do SoftExpert Suite (descritas na seção Integração via web services SOAP arrowrgray Overview técnico).

 

As imagens a seguir exemplificam um exemplo de requisição utilizando o aplicativo Postman:

 

postman1_zoom80

 

postman2_zoom80