Pular para o conteúdo principal
Versão: 2.2.0

Definição da estrutura do arquivo XLS ou XLSX

A tabela DIINTERFACE pode ser populada a partir de um arquivo XLS ou XLSX. Para usar essa funcionalidade, é preciso possuir um arquivo com extensão XLS ou XLSX que tenha um cabeçalho contendo todos os campos existentes na tabela DIINTERFACE na primeira linha.

A figura abaixo apresenta um exemplo de arquivo com o formato exigido:

sample-xlsx.png
perigo
Importante!

Para utilizar um arquivo XLS ou XLSX para popular a tabela DIINTERFACE, é imprescindível que seu cabeçalho contenha todos os campos da tabela, independentemente de serem ou não utilizados. Em outras palavras, todos os campos existentes devem estar presentes no cabeçalho do arquivo.

Dessa forma, fica garantido que a importação dos dados seja realizada de forma correta e sem erros.

Recursos de importação e exportação

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

import.pngImportar dados (Importar planilha)Botão utilizado para importar a planilha para o sistema.
export_xls.pngModelo de importação (Expor planilha modelo de importação)Botão utilizado para baixar o modelo de importação.
export.pngExportar 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 Configuração -> Ferramenta -> Importação -> Acompanhamento (CM015).

Dentro desta tela é possível utilizar o botão export_xls.png (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:

1. Upload pelo SoftExpert Suite

Para realizar o upload do arquivo, navegue até a tela acompanhamento (Configuração -> Ferramenta -> Importação -> Acompanhamento (CM015)). Dentro desta tela utilize o botão import.png 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.

2. Inclusão por diretório (Para clientes on-premises)

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.

EstruturaExemplo
<seimport>seimport.xlsx
<nome> + <seimport>example.seimport.xlsx
<seimport> + <nome>seimport.example.xlsx
<nome> + <seimport> + <nome>example.seimport.example.xlsx

O arquivo desejado também deve estar dentro do diretório import: se_suite_home\web\import

cuidado

Importante!

O termo se_suite_home indica o diretório onde o SoftExpert Suite está instalado.

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”.

EstruturaExemplo
<domínio> + <seimport>www.softexpert.com_seimport.xlsx
<domínio> + <seimport> + <nome>www.softexpert.com_seimport.example.xlsx
<nome> + <domínio> + <seimport>example.www.softexpert.com_seimport.xlsx
<nome> + <domínio> + <seimport> + <nome>example.www.softexpert_seimport.example.xlsx
info

Clientes que utilizam o Hosting SoftExpert e queira utilizar a interface de dados para importar arquivos eletrônicos para o SoftExpert Suite, recomendamos entrar em contato com nossa equipe comercial para solicitar informações sobre nosso serviço de SFTP (Secure File Transfer Protocol). Com a aquisição desse serviço, será possível utilizar esse meio seguro para transferir arquivos eletrônicos carga para a tabela DIINTERFACE, seguindo o modelo descrito anteriormente.

Nosso serviço de SFTP oferece alta segurança na transferência de arquivos, garantindo que seus dados sejam protegidos durante o processo. Além disso, nossa equipe técnica está sempre disponível para auxiliar na configuração e utilização do serviço.

3. Upload de arquivo XLS ou XLSX via API REST

Para utilizar esta API de upload de dados para a tabela DIINTERFACE, é necessário realizar uma requisição HTTP do tipo POST para o endpoint https://my-domain/apigateway/se/dataintegration/importjob/upload.php, incluindo a planilha (no formato descrito nos tópicos anteriores) como parâmetro do formulário do tipo form-data. O nome do parâmetro que deve ser utilizado para enviar o arquivo é "userfile".

É importante ressaltar que o endpoint em questão segue as regras de segurança do APIGateway do SoftExpert Suite, que são descritas na seção Integração via web services SOAP Overview técnico. Assim, a camada de autenticação deste endpoint irá respeitar essas regras, garantindo que apenas usuários autorizados possam realizar essa operação.

Para exemplificar como realizar a requisição utilizando o aplicativo Postman, as imagens abaixo demonstram um exemplo prático. Vale lembrar que outras ferramentas de cliente HTTP também podem ser utilizadas para realizar essa operação.

postman1_zoom80.png
postman2_zoom80.png