Premissas
- Para ter acesso a essa funcionalidade, o usuário precisa fazer parte de um grupo de permissão que tenha acesso ao modulo "ADM", Menu "Importação", Tabela "Importações".
- É imprescindível que o usuário tenha conhecimento do módulo de Cadastro para facilitar a criação e navegação das importações .
- Por que o Importador não está importando caracteres especiais?
Se o Importador deixar de importar caracteres especiais, como ö, ñ ou é, seu arquivo de dados de origem talvez não esteja devidamente codificado. Para garantir que o arquivo esteja devidamente codificado:
- Faça todas as modificações no seu arquivo de dados de origem em formato .xls.
- No Microsoft® Excel®, salve uma cópia do seu arquivo como arquivo de texto Unicode.
- Abra o arquivo de texto Unicode que acabou de salvar usando um editor de texto.
- Clique em para alterar as seguintes configurações do arquivo:
- Extensão do nome do arquivo — .csv ou .txt
- Salvar como tipo — Todos os arquivos
- Codificação — UTF-8
Clique em Salvar e feche o arquivo.
Não abra o arquivo depois de ter salvado as configurações ou as alterações de codificação talvez sejam revertidas.Importe os dados usando o Importador, como faria normalmente, e selecione o arquivo .csv recém-criado.
Processo
Para importar um mailing clique em "Novo":
Preencha todos os campos necessários para que a aplicação entenda as informações que serão carregadas referente aos dados dos clientes.
Todos os campos indicados com a barra lateral vermelha são de preenchimento obrigatório.
Quando se tratar de importação de planilha com novo formato, ainda não feito na aplicação:
- Nome da Importação: nome da importação que será executada
- Combo 1: para novos formatos não deverá ser selecionado informação neste campo, caso seja atualização veja a descrição deste item mais abaixo neste mesmo documento
- Clique para escolher os arquivos: clicar neste espaço para definir qual o arquivo que será importado
- arquivo deve ser salvo no formato .csv
- Nome do Layout: nome do formato de importação que será criado para que o arquivo selecionado possa ser carregado dentro da aplicação
- Entidade principal: Indicação da tela onde deverá ser inserida as informações contidas na planilha
- Importante lembrar que apenas é possível utilizar a Entidade "Pessoa", as demais ainda não estão mapeadas para esta funcionalidade.
- Importante lembrar que apenas é possível utilizar a Entidade "Pessoa", as demais ainda não estão mapeadas para esta funcionalidade.
- Tipo de dado: apenas traz a possibiidade de delimitado, por isso a idicação de arquivo no formato .csv
- Delimitador de Campo: indicador do símbolo utilizado para separação da informação. Quando selecionada a opção "Outros" o campo ao lado é aberto e obrigatório para que seja incluído qual a pontuação que fará a separação
- Possui cabeçalho: seleção do checkinbox quando o arquivo selecionado possuir cabeçalho, desta maneira a informação contida na primeira linha será desconsiderada
- Qualificador do Campo: este campo é responsável em identificar o início e fim do conteúdo de cada coluna da planilha
- Formato da data:quando qualquer coluna utilizar data em seu conteúdo, necessário indicar qual o formato utilizado
- Chave estratégica: deve ser utilizado para implementar customizações a importação, ou seja, a partir deste campo a equipe de desenvolvimento poderá incluir códigos que alteram informações na importação
- Moeda:quando qualquer coluna utilizar valores de moeda em seu conteúdo, necessário indicar qual o formato, sendo limitado a apenas dois tipos
- Dígtos depois da vírgula:quando qualquer coluna utilizar valores que apresentem decimais em seu conteúdo, necessário indicar quantos dígitos depois da vírgula devem ser considerados
- Simbolo Decimal:quando qualquer coluna utilizar valores que apresentem decimais em seu conteúdo, necessário descrever qual o símbolo utilizado
Quando se tratar de importação de formato já feito na aplicação:
- Nome da Importação: nome da importação que será executada
- Combo 1: selecionar o nome do Layout de importação que será utilizado para que o arquivo possa ser carregado na aplicação
- Importante atentar-se que o arquivo tenha o mesmo formato indicado no Layout selecionado.
- Importante atentar-se que o arquivo tenha o mesmo formato indicado no Layout selecionado.
- Clique para escolher os arquivos: clicar neste espaço para definir qual o arquivo que será importado
- arquivo deve ser salvo no formato .csv
- Demais campos: quando selecionado um formato já existente, os demais campos serão preenchidos automaticamente
Após o preenchimento dos campos descritos acima, é disposto na tela a leitura das informações contidas no arquivo, para que cada coluna possa ter sua paraemtrização específica.
- Esta etapa deverá ser preenchida independente se o formato de importação é novo ou já existente
- Entidade: indicar em qual tela deverá ser inserida as informações contidas na coluna selecionada
- Campo: indicar o campo que será preenchido na tela selecionada
- Tipo do Campo: definido automaticamente após a seleção dos dois campos acima, podem ser: String, Numeric, Char, Integer, Datetime, entre outros
- Importar: seleção do checkinbox para indicar que o campo deverá ser importado para aplicação
- É possível ter colunas em um arquivo que não serão importadas, neste caso, basta não selecionar esta opção
- Somente números: seleção do checkinbox quando a coluna trouxer informações apenas numéricas
- Atualizar dados existentes: campo fica disponível para a seleção apenas quando o checkinbox "Importação" for selecionado, pois no caso de já existir o cadastro na ferramenta ele apenas atualiza a informação, caso necessário
- Caso não seja selecionado e a informação já existir, será mantida a informação existente e o que contiver na planilha será desconsiderado (em relação a coluna em edição)
- Análise pelo campo: seleção do checkinbox quando o campo for o que traz a informação para validação do conteúdo, que evitará a duplicidade cadastral
- Importante usar dado que não pode ser igual para clientes diferentes, exemplo: CPF, CNPJ, RG, Código de Pessoa.
Ao editar cada coluna do arquivo a ferramenta indica o que foi parametrizado:
- A "coluna A" foi parametrizada com as indicações de importação, atualização dos dados existentes e análise de campo
- A "coluna B" foi parametrizada com a indicação de importação
- A "coluna C" foi parametrizada com e não será importada
- A "coluna D" está em edição dos parametros
Após todas as definições é necessário clicar no botão "Salvar" e em seguida clicar em "Próxima" para que a importação seja executada.