PHSYS - Wiki

Conceito

Os Leiautes de importação tem a capacidade de importar dados de arquivos de forma eficiente e segura. Essa ferramenta é muito útil na migração de dados para o sistema, principalmente quando se trata de um sistema legado.

Os Leiautes de Importação são uma funcionalidade inovadora que permite a configuração flexível e personalizada de diferentes formatos de arquivo CSV para a importação de dados. Com essa ferramenta, é possível cadastrar vários leiautes, adaptando-os a diferentes cadastros e necessidades específicas do usuário.

Uso de Regras de Negócio

O grande diferencial dessa funcionalidade está na sua capacidade de integrar as classes de negócio e scripts do cliente no processo de importação. Dessa forma, as mesmas regras de negócio aplicadas durante a digitação manual das informações são automaticamente incorporadas ao processo de importação. Isso não apenas garante consistência nos dados, mas também simplifica o fluxo de trabalho ao eliminar a necessidade de redefinir as regras a cada importação.

Como Funciona a Importação?

A praticidade do processo de importação é surpreendente. Basta preparar um arquivo no formato CSV e, em seguida, definir a configuração das colunas de acordo com o leiaute cadastrado. O sistema se encarrega de processar os dados de maneira rápida e eficiente, garantindo que as informações sejam integradas de acordo com as especificações previamente estabelecidas.

A configuração dos leiautes e a execução da importação são de fácil compreensão e tornam-se tarefas acessíveis a usuários de diferentes níveis de habilidade.

O preenchimento do leiaute:

• Código: Identificação numérica do leiaute.
• Nome: Texto de identificação do leiaute.
• Data /Hora: Data e hora de inclusão ou alteração.
• Usuário que incluiu: Usuário que realizou o cadastro do leiaute.
• Opções: Opções gerais do leiaute de importação.

• Utilizar transação: Será utilizada transação durante o processo de importação, caso ocorrer algum erro e o registro estiver configurado para 'Parar quando der erro', as alterações não serão efetivadas.

Registros do Leiaute: Os registros do leiautes são equivalentes das tabelas que iremos importar. Exemplo PESSOAS e PESSOATELEFONES.

• Sequência: Número correspondente a sequencia de importação do registros.
• Tabela: Tabela de os registros serão importados.
• Cadastro: Quando informado o cadastro da tabela, será realizado uso das informações padrões de inclusão, e o cadastro que possuir classe de servidor informada, também serão utilizadas as regras de negócio presentes na classe.
• Opções: Opções do arquivo para importação.

• Linhas Cabeçalho: Quantidade de linhas de cabeçalho para que seja desconsiderado no processo de importação.
• Separador: Carácter de separação entre as colunas. O padrão é ";".
• Atualizar quando existir: Quando marcada, será utilizada as colunas do arquivo marcadas como chave para busca do registro, caso localizado, será realizado atualização das linha, senão é realizada a inclusão.
• Iniciar Script: Determina a inicialização do engenho de script presente na tabela do registro.
• Parar quando der erro: Quando marcado o processo de importação será parado e o erro exibido para o usuário. Quando desmarcado os erros apresentados serão registrados no log do registro e a importação segue até o final do arquivo.
• Log: Indica que deverá ser realizado registro de log do registro.

Campos do Arquivo: Opções para importação das colunas.

• Coluna: Número da coluna do arquivo CSV. Pode-se utilizar 1,2,3 ou 10,20,30. O objetivo é que os campos estejam na mesma ordem das colunas do arquivo.
• Campo: Campo da tabela correspondente a coluna do arquivo. Dependendo do tipo do campo, existem alguns tratamentos previstos de forma automática:

• Campo CNPJ ou CPF é realizada a formação 00.000.000/0000-00 ou 000.000.000-00. Mesmo que houver formatação no arquivo, todos os caracteres são removidos e é aplicada a formatação padrão do sistema.
• Campo Cep: Aplicada a formatação padrão do sistema 00000-000.

• Valor Padrão: Pode-se definir um valor padrão que será atribuído na inclusão e substituído pelo valor do arquivo quando existir.
• Chave: Definir que a coluna é parte da chave de busca, quando o registro estiver definido para atualizar quando existir.
• Campo Relacionado: Quando o campo for do tipo tabela, é necessário informar qual coluna corresponde a informação presente no arquivo. Exemplo: Se a coluna for correspondente ao estado e no arquivo a coluna do estado está preenchida com a sigla, será necessário que o campo correspondente preenchido com o campo da tabela relacionada que contém a sigla do estado.
• Ignorar quando não existir: Quando desmarcado e não for localizado registro na tabela correspondente, a importação será interrompida.
• Formato: Para os campos do tipo data ou data/hora podes definir uma formatação diferente. O padrão é 'dd/mm/yyyy' ou 'dd/mm/yyyy hh:nn:ss'.
  • dd: Dia como um número com zero à esquerda (01-31).
  • mm: Mês como um número com zero à esquerda (01-12).
  • yyyy: Ano como um número de quatro dígitos (0000-9999).
  • hh: Hora com zero à esquerda (00-23).
  • nn: Minutos com zero à esquerda (00-59).
  • ss: Segundos com zero à esquerda (00-59).
• Condições de Substituição de Informações: Quando houver a necessidade de realizar a substituição de informações da coluna, pode incluir nesta funcionalidade, uma lista de opções informando os campos "De" e "Para". Dessa forma as informações do arquivo podem ser substituídas.

Campos Fixos: Nesta lista podemos incluir informações de colunas que precisamos preencher com informações padrões para todos os registros, que não estão presentes no arquivo.

• Campo: Campo da tabela correspondente a coluna do arquivo.
• Chave: Definir que a coluna é parte da chave de busca, quando o registro estiver definido para atualizar quando existir.
• Tipo:
  • Informado: Valor fixo informado.
  • Empresa Corrente: Realiza o preenchimento automático com o id da empresa corrente.

Dica Para remover quebras de linhas no Excel, utilizar a função substituir e o comando Ctrl+J no campo "Localizar" para inserir o carácter correspondente a quebra de linha.

Conclusão

Em resumo, a funcionalidade de "Leiautes de Importação" do nosso sistema é uma ferramenta essencial para otimizar e simplificar o processo de incorporação de dados. Agregue eficiência aos seus fluxos de trabalho, garantindo precisão e consistência nas informações importadas. Experimente essa revolucionária funcionalidade e descubra um novo patamar de produtividade em sua operação.