Data Importer - Definições para A Importação de Registros de Formulários e Solicitações de Processos

DATA IMPORTER: DEFINIÇÕES
PARA A IMPORTAÇÃO DE
REGISTROS DE FORMULÁRIOS
E SOLICITAÇÕES DE
PROCESSOS
Data Importer: Definições para a Importação de Registros de Formulários
e Solicitações de Processos
Índice
1. Estrutura do Arquivo ........................................................................................................................................ 3

2. Importação de Registros de Formulários ........................................................................................................... 4
2.1 Campo do tipo Texto ............................................................................................................................................... 4
2.2 Campo do tipo Booleano ........................................................................................................................................ 5
2.3 Campo do tipo Número Inteiro ............................................................................................................................... 6
2.4 Campo do tipo Número Decimal ............................................................................................................................ 7
2.5 Campo do tipo Data ................................................................................................................................................ 7
2.6 Campo do tipo Hora ................................................................................................................................................ 8
2.7 Campo do tipo Arquivo ........................................................................................................................................... 8
2.8 Campo do tipo Lista de Opções .............................................................................................................................. 9
2.9 Campo do tipo Usuário e Consenso ........................................................................................................................ 9
2.10 Campo do tipo E-form ........................................................................................................................................... 9
2.10.1 Campo E-form Selecionável ......................................................................................................................... 10
2.10.2 Campo E-form Não Selecionável.................................................................................................................. 11
2.10.3 Campo E-form Lista ...................................................................................................................................... 12
3. Importação de Solicitações de Processo .......................................................................................................... 13
3.1 Campo Código do processo: #process.code ......................................................................................................... 14
3.2 Campo Solicitante do processo: #process.requester............................................................................................ 14
3.3 Campo Data de Início: #process.startDate ........................................................................................................... 15
3.4 Campo Data de Finalização: #process.finishDate ................................................................................................. 16
3.5 Campo Atividade: #activity.name ......................................................................................................................... 16
4. Considerações Finais ...................................................................................................................................... 39
2
1. Estrutura do Arquivo
O importador só aceita arquivos do tipo Excel (.xls ou .xlsx), sendo a estrutura definida para este arquivo a
seguinte: cada coluna corresponde a um campo de formulário e cada linha a um registro.
Deste modo, na primeira linha deve constar os códigos, definidos no formulário de destino do Fusion
Platform, dos campos a serem importados ou o caminho do campo em casos de formulários relacionados
(E-form).
Os campos-chaves de formulários relacionados (E-form) deverão ser indicados na primeira linha com a
representação * (asterisco) ao lado do código do campo.
Nas importações de solicitações de processos, além dos campos de formulário, deve constar os códigos
dos campos padrões de solicitações de processo definidos pela Neomind.
É importante ressaltar que os registros que estiverem com valor em branco na planilha importada, serão
incluídos no banco de dados com o valor em branco, subscrevendo informações existentes em casos de
atualização.
3
2. Importação de Registros de Formulários
A importação de registros de formulários só pode ser realizada por usuários que além de administradores
do módulo de processos sejam também administradores gerais do sistema e não pode ser executada em
lote, deste modo, ao ser selecionado mais de um formulário a opção fica inativa, devendo ser realizada em
um formulário por vez. Já o limite de linhas de registros por importação é de 50.000, excedendo este limite
não é permitido a importação, levando a ocorrência de um erro estrutural.
Quando um campo informado na planilha não existe no Fusion Platform é gerado um erro estrutural de
modo a evitar inconsistências com a falta de um dado importante, o mesmo ocorre com a ausência de
campos-chaves de formulários relacionados.
Os registros que estiverem com valor em branco na planilha, serão incluídos no banco de dados com o
valor em branco. Deste modo, quando a coluna com o campo na planilha receber registros em branco, ele
ficará em branco no sistema, subscrevendo as informações existentes. Já, ao não informar a coluna na
planilha e importar, aquele campo ficará com o valor padrão, se configurado, ou com o valor presente no
banco de dados em casos de atualização.
Os campos de formulário seguem as máscaras configuradas no sistema e quando as informações
importadas não estiverem condizentes com os valores aceitos, é gerado erro e toda a linha de registros é
descartada. Deste modo, serão apresentados os valores aceitos para cada tipo de campo.
Nota
Dois tipos de erro podem ocorrer ao realizar a importação:
O erro estrutural que impede a realização da importação como um todo.
O erro de linha que realiza a importação apenas de linhas (registros) corretas e descarta as linhas
(registros) que possuem alguma inconsistência.
2.1 Campo do tipo Texto
Máscara Valores aceitos para a importação
Texto Padrão ● Todo tipo de texto desde que não exceda o limite de
caracteres.
Máscara Senha ● Importa desde que não exceda o limite de caracteres.
Máscara Personalizada ● Valores que atendam exatamente a configuração da

máscara personalizada, incluindo caracteres.
Máscara Telefone: ● (52) 3481-2231

+ 55 (00) 0000-0000 ● 5234812231
4
Máscara CEP: ● 96040-720

00000-000 ● 96040720
Máscara CPF: ● 070.840.070-16

000.000.000-00 ● 07084007016
Máscara CNPJ: ● 03.166.678/0001-37

00.000.000/0000-00 ● 03166678000137
Observações:
• Traduzível: Campos marcados como traduzíveis, funcionarão corretamente desde que o termo
esteja cadastrado.
• Limite de caracteres: Se o valor informado na planilha ultrapassar o limite de caracteres será
gerado erro e a linha de registros será descartada.
• Criptografia: Em campos configurados para armazenar o conteúdo criptografado, deve ser aplicado
o mesmo comportamento nas informações importadas.
Nota
A mensagem de erro "O valor do campo {0} não corresponde ao tipo de campo {0} ou à máscara."
também pode se referir ao tipo de célula do Excel. No caso, um campo texto no fusion recebendo uma
célula numérica do Excel.
2.2 Campo do tipo Booleano
Valores no Fusion Valores aceitos para a importação
Sim / Check ● True

● Sim
●1
Não / Sem Check ● False

● Não
●0
Observações:
• Valores em branco: Importação vazia, sem registros.
5
2.3 Campo do tipo Número Inteiro
Número Padrão: 1.234 ● 1.234

● 1234
Máscara Sem separador de ● 1.234

milhar: 1234 ● 1234
Máscara Personalizada ● Valores que atendam exatamente a configuração da

máscara personalizada, incluindo caracteres.
Máscara Porcentagem: ● 1234%

1234% ● 1234
Máscara Telefone: ● (52) 3481-2231

+ 55 (00) 0000-0000 ● 5234812231
Máscara CEP: ● 96040-720

00000-000 ● 96040720
Máscara CPF: ● 070.840.070-16

000.000.000-00 ● 07084007016
Máscara CNPJ: ● 03.166.678/0001-37

00.000.000/0000-00 ● 03166678000137
Observação:
● Limite de caracteres: Se o valor informado na planilha ultrapassar o limite de caracteres será

gerado erro e a linha de registros será descartada.
● Separadores: Os separadores seguem a configuração de idioma do ambiente (do sistema e não de
usuário), deste modo, quando o idioma for Inglês, por exemplo, o separador de milhar será a
vírgula ao invés do ponto. Utilizar um separador de milhar mais um separador decimal (ex.:
10.000,43) gerará erros.
● Criptografia: Em campos configurados para armazenar o conteúdo criptografado, deve ser aplicado
6
2.4 Campo do tipo Número Decimal
Número Padrão: 1.234,00 ● 1.234,00

● 1234.00
● 1234
Máscara Sem separador de ● 1.234,00

milhar: 1234,00 ● 1234.00
● 1234
Máscara Monetária Prefixo ou ● 1.234,00

Sufixo: $1.234,00 ou 1.234,00$ ● 1234.00
● 1234
● 1.234,00 $
● $ 1.234,00
Máscara Porcentagem: ● 1234,00%

1234,00% ● 1234.00
● 1234
1 Casa decimal: 0,0 ● 1,0

● 1.0
●1
Obs.: Este comportamento se aplica a todas as outras máscaras de casas decimais.
Observação:
● Separadores: Os separadores seguem a configuração de idioma do ambiente (do sistema e não de

usuário), deste modo, quando o idioma for Inglês, por exemplo, o separador de milhar será a
vírgula ao invés do ponto.
● Criptografia: Em campos configurados para armazenar o conteúdo criptografado, deve ser aplicado
2.5 Campo do tipo Data
Máscara: 00/00/0000 ● 15/05/2018
7
Máscara: 00/00/00 ● 15/03/18
Máscara: 00/00 ● 15/03
Máscara: 00/00/0000 - 00:00 ● 15/03/2018 - 16:34
Máscara: 00/00/0000 - 00:00:00 ● 15/03/2018 - 16:34:59
Observação:
● Dias Úteis: Neste primeiro momento, será possível importar datas que não sejam dias úteis mesmo
com essa configuração ativa.
Atenção!
O campo data segue a configuração de idioma do ambiente (do sistema e não do usuário) deste modo,
se estiver em Inglês, ao invés de ser 15/03/2018 - 16:34, seguirá o padrão mm/dd/aaaa - 00:00
PM/AM. Por exemplo: 03/15/2018 - 04:34 PM.
2.6 Campo do tipo Hora
Máscara: 00:00 ● 13:55
Máscara: 00:00:00 ● 13:42:45
Atenção!
O campo hora segue a configuração de idioma do ambiente (do sistema e não do usuário) deste modo,
se estiver em Inglês ao invés de ser 08:34, seguirá o padrão 00:00 PM/AM. Por exemplo: 08:34 AM.
2.7 Campo do tipo Arquivo
O arquivo pode estar no servidor ou na rede, desde que esteja visível para o servidor.
8
Servidor Valores aceitos para a importação
Linux ● Exemplo Path: /opt/nomeDoArquivo
Windows ● Exemplo Path: C:\temp\arquivo.xlsx
Observação:
● Tamanho máximo do arquivo: Se o arquivo ultrapassar o tamanho máximo configurado gerará

erro.
2.8 Campo do tipo Lista de Opções
O campo do tipo Lista de Opções aceitará o nome da opção ou o número referente a posição da opção.
Exemplo de opções: 1. Maçã, 2. Uva.
Valores aceitos para a importação Exemplos
Posição ●1
Nome ● Maçã
Observação: O sistema irá procurar primeiramente se o valor informado na planilha é compatível com a
posição, sendo compatível ele vai considerar a opção encontrada. Já se não for, o sistema irá buscar se o
valor informado é compatível com o nome da opção. Esta aplicação é necessária visto que a posição e o
nome podem conter valores numéricos e ocasionar conflito.
2.9 Campo do tipo Usuário e Consenso
Os campos do tipo usuário e consenso, são na verdade um campo do tipo e-form. (Ver definições na seção
específica do campo E-form.)
2.10 Campo do tipo E-form
9
Para campos do tipo e-form, deve ser utilizado o caminho deste campo como referência do campo
presente no formulário relacionado, na primeira linha da planilha.
Exemplo: usuario1.name
- usuario1: Código do campo do formulário principal, do tipo usuário.
- name: Código do campo “nome do usuário”, no e-form NeoUser.
Os campos do tipo e-form podem ser configurados como selecionáveis e não selecionáveis, além de
poderem ser configurados como lista.
Nota
Este projeto não possui suporte para a importação de campos que apontem para tipos de
documentos. Portanto ao importar campos do tipo arquivo, nenhum documento será criado ou
publicado no GED.
2.10.1 Campo E-form Selecionável
É o tipo de campo para vincular dados existentes de um formulário relacionado. Utilizará os campos-
chaves para buscar no sistema os respectivos valores.
Os campos-chaves de formulários relacionados (e-form) deverão ser indicados na primeira linha com a
representação * (asterisco) ao lado do código do campo.
Atenção!
Se nenhum campo do e-form for configurado como valor único, a chave não é obrigatória, deste modo
sempre serão criados novos registros e não atualizados, pois não haverá um campo chave de
parâmetro. Já, se for definida uma chave, a atualização irá funcionar.
Entretanto, se algum campo da planilha for valor único é necessário informá-lo como chave, caso
contrário um erro estrutural ocorrerá (o que impedirá a importação de todos os registros).
Os campos de formulários relacionados também seguirão as máscaras configuradas no sistema e quando

as informações importadas não estiverem condizentes com os valores aceitos, será gerado erro e toda a
linha de registros será descartada.
O importador de registros de formulários possui duas configurações que permitem a criação e atualização
de registros de e-forms selecionáveis:
10
Criação: Ao ativar esta opção, os registros cujos campos-chaves definidos não existam nos formulários
relacionados serão criados a partir dos dados importados, mesmo que possuam informações obrigatórias
ausentes. Caso a opção esteja desabilitada, a linha de registros importada será descartada.
Em casos de informações de sistema, como usuário, grupo e papel, se na planilha não tiver a coluna de
código do Fusion, o registro não poderá ser criado e um erro será gerado.
Atualização: Ao ativar esta opção, os registros cujos campos-chaves definidos já existam nos formulários
relacionados serão substituídos pelas informações importadas. Ao sobrescrever, todos os dados contidos
na planilha serão atualizados no banco de dados. Caso a opção esteja desativada, os registros serão
somente vinculados.
Configuração Código Informado Resultados esperado na importação
Criação e Atualização Existente no ● Vincula registros existentes e não

desativadas Fusion Platform cria novos registros ou editar
Criação e Atualização Novo ● Importa com o campo e-form em

desativadas branco
Criação ativada Existente no ● Vincula registros existentes

Fusion Platform
Criação ativada Novo ● Importa e cria novos registros
Atualização ativada Existente no ● Vincula e atualiza os registos

Fusion Platform existentes
Atualização ativada Novo ● Importa com o campo e-form em

branco
Criação e Atualização Existente no ● Vincula e atualiza os registos

ativadas Fusion Platform existentes
Criação e Atualização Novo ● Importa e cria novos registros

ativadas
2.10.2 Campo E-form Não Selecionável
É o tipo de campo para criar novos dados no formulário relacionado.
11
Os campos seguirão as formatações e regras já apresentadas e os registros sempre serão criados sem a
necessidade de um campo-chave ou de ativar as configurações avançadas destinadas a campos do tipo
selecionável.
2.10.3 Campo E-form Lista
O campo lista segue o mesmo comportamento do campo selecionável e não selecionável, porém utilizando
o separador “|” para separar os valores que correspondem a lista. Em casos avançados, que podem possuir
uma lista dentro de outra, utilizará também o separador “;”.
Exemplos: “Joinville|Curitiba” ou “Joinville|Curitiba;Blumenau|Brusque”(Lista dentro de lista).
Nota
Está previsto melhorias para as próximas versões, a fim de facilitar o uso.
12
3. Importação de Solicitações de Processo
A importação de solicitações de processo só pode ser realizada por usuários que além de administradores
do módulo sejam também administradores gerais do sistema e não pode ser executada em lote, deste
modo, ao ser selecionado mais de um modelo de processo a opção fica inativa, devendo ser realizada em
um processo por vez. Já o limite de linhas de registros por importação é de 50.000, excedendo este limite
não será permitido a importação.
Quando um campo informado na planilha não existir no Fusion Platform será gerado um erro estrutural
(que impede a importação de todos os registros da planilha) de modo a evitar inconsistências ao faltar um
dado importante, o mesmo ocorre com a ausência de campos-chaves de formulários relacionados.
Uma solicitação de processo pode ser importada finalizada ou em aberto e possui 5 campos que podem ser
importados: código, solicitante, data de início, data de conclusão e atividade. Ressaltando que quando as
informações importadas não estiverem condizentes com os valores aceitos, será gerado um erro
estrutural.
Processo Novo: Apresentará uma mensagem na tela principal de informações indicando que o processo foi
importado, o autor e a data, já o histórico estará vazio.
Processo Existente:
1. Terá um evento no histórico, informando que as informações foram editadas;
2. Um evento quando o processo for movimentado ou reaberto;
3. Um evento quando as informações do formulário forem atualizadas.
Em todos os casos citados acima, o motivo será a importação.
Configuração de Atualização: Há uma configuração que permite escolher se as solicitações de processos

com códigos já existentes no banco de dados serão atualizadas ou as informações da planilha serão
descartadas.
Permissões de Visualização da Aba Dados: As permissões de visualização seguirão as definidas no modelo

de processo, deste modo após importado, talvez o solicitante vinculado, bem como o autor da importação
não possuam permissão de visualização dos dados do processo, visto que não são gestores, nem usuários
de consulta ou não executaram nenhuma ação no processo.
Atualização de Formulário: Quando não clicado em atualizar processo, ele irá atualizar apenas
informações do formulário se o código for informado, no caso de códigos existentes.
Erros no Formulário: Erros nos formulários descartarão as linhas de solicitações.
13
3.1 Campo Código do processo: #process.code
Este campo só aceitará valores numéricos e quando não estiver preenchido o sistema gerará
automaticamente um novo código. Já quando o valor informado for inconsistente (ex.: texto) a linha de
registro será descartada e gerará log de falha.
Quando forem informados valores já existentes no sistema poderá seguir dois comportamentos:
1. Caso a configuração de atualizar solicitações esteja ativa, subscreve as informações.
2. Caso a configuração de atualizar solicitações não esteja ativa, irá descartar a linha de registro e gerar
erro no log.
Atenção!
Este campo será o campo chave para o sistema, deste modo, a opção de atualizar solicitações de
processos estará vinculada ao código ser existente ou não no Fusion Platform.
Valor inserido no campo Resultado Esperado na Importação

#process.code
Vazio ● Importa a solicitação e o sistema gera o código.
Código Existente ● “Atualizar” ativo: Atualiza as informações do processo.

● “Atualizar” desativado: Não conta aquele registro e dá
sucesso sem atualizar. Ou então, atualiza somente os
dados do formulário, se informados
Código Novo ● Importa a solicitação com o código informado.
Código Inconsistente (ex.: ● Importa todo tipo de valor, texto ou numérico

texto)
3.2 Campo Solicitante do processo: #process.requester
Este campo será obrigatório para a importação de solicitações de processos, deste modo, quando não
estiver preenchido, a linha de registro será descartada e gerará log de falha.
O valor aceito neste campo será o código do usuário cadastrado no Fusion Platform, com isso, a inserção
do nome do usuário, usuário inexistente ou valores inconsistentes (ex.: números) irá descartar as
solicitações e gerar erro no log.
14

#process.requester
Vazio ● Gera erro. Já em casos de atualização,

mantém o solicitante do sistema.
Usuário existente no sistema ● Existe: Altera e vincula o novo usuário

● Solicitação nova: Vincula o usuário
Usuário não existente no sistema ● Gera erro
Usuário Inconsistente (ex.: nome ou ● Gera erro

números)
3.3 Campo Data de Início: #process.startDate
Este campo será obrigatório para a importação de solicitações de processos quando a coluna for informada
na planilha e só aceitará valores de data com a máscara 00/00/0000 - 00:00, (seguindo o padrão de idioma
explicado no campo Data do Formulário).
Já se a coluna não for informada na planilha terá o seguinte comportamento:
1. Solicitação Nova: Pega a data de importação como data de início.
2. Solicitação Existente: Mantém a data de início contida no banco.
Deste modo, quando não estiver preenchido ou o valor for inconsistente (ex.: texto ou máscara não
compatível) a linha de registro será descartada e gerará log de falha.

#process.startDate
Vazio ● Gera erro
Máscara compatível ● Importa ou atualiza a solicitação com a data

informada
Valor inconsistente (ex.: texto ou ● Gera erro

máscara incompatível)
15
3.4 Campo Data de Finalização: #process.finishDate
Este campo só aceitará valores de data com a máscara 00/00/0000 - 00:00 (seguindo o padrão de idioma
explicado no campo Data do Formulário), deste modo, quando o valor informado for inconsistente (ex.:
texto ou máscara não compatível) a linha de registro será descartada e gerará log de falha.
Já quando não estiver preenchido terá dois comportamentos:
1. Finalizado (sem atividade informada): importa com a data de importação.
2. Em execução (com atividade informada): importa sem data pois está em andamento.
Em casos de a data de finalização informada ser menor do que a data de início a linha de registro será
descartada e gerará log de falha.

#process.finishDate
Vazio ● Finalizado: Importa ou atualiza com a data de

importação
● Em execução: Vazio
Máscara compatível ● Importa ou atualiza a solicitação com a data

informada
Valor inconsistente (ex.: texto) ● Gera erro
Menor que a data de início ● Gera erro
3.5 Campo Atividade: #activity.name
Por padrão o processo será posicionado na primeira atividade e finalizado. Ao definir uma atividade na
planilha, o processo será importado com o status “em execução” na atividade definida.
Já se a atividade preenchida não existir no modelo do processo gerará erro na linha de registro e constará
em log.
16

#activity.name
Vazio ● Importa a solicitação finalizada ou finaliza/mantém

em aberto as solicitações existentes.
Atividade existente no modelo ● Importa a solicitação em aberto na atividade

de processo informada ou reabre e movimenta solicitações
existentes para a atividade informada.
Atividade inexistente no ● Gera erro

modelo de processo
Observação: A coluna de atividade vai sobressair a coluna de data de finalização, deste modo, se as duas
estiverem preenchidas, a solicitação de processo é importada em execução na atividade informada.
Tipo de Solicitação Valor inserido no Resultado Esperado na Importação

campo #activity.name
Processo novo Vazio Importa a solicitação finalizada.

fechado
Processo novo Atividade existente no Importa a solicitação e movimenta

aberto modelo de processo para a atividade.
Processo existente Vazio Atualiza a solicitação e mantém

fechado fechado.
Processo existente Atividade existente no Atualiza a solicitação e reabre na

fechado modelo de processo atividade informada.
Processo existente Vazio Se a data de conclusão for informada

aberto finaliza a solicitação, se não mantém
em aberto.
Processo existente Atividade existente no Atualiza a solicitação e movimenta

aberto modelo de processo para a atividade.
17
4. Uso no Sistema
Abaixo serão descritos os passos para o acesso e uso das funcionalidades de importação.
4.1 Importador: Registros de Formulários
Na central de formulários ao interagir com um formulário através da seta de ações na lateral será possível
acessar a funcionalidade Importar registros. Esta opção será visível apenas para usuários que além de
administradores do módulo de processos, também sejam admnistradores gerais do sistema.
Não será possível fazer a importação em lote, portanto, ao selecionar vários formulários essa opção
aparecerá desativada.
4.1.1 Importar registros: Etapa de Configuração
Ao clicar na opção de Importar registros o usuário será direcionado para a primeira tela, onde poderá
realizar a etapa de configuração.
O primeiro passo na tela de configuração será fazer o upload do arquivo do tipo Excel (.xls ou .xlsx)
contendo os dados que você deseja importar. Você poderá fazer a importação arrastando o arquivo e
soltando na área indicada ou clicando sobre o espaço e buscando pelo arquivo em seu computador.
18
Ao tentar arrastar e soltar arquivos de tipos não aceitos o sistema irá bloquear o componente de
carregamento de arquivos, já ao navegar em seu computador através da tela aberta pelo sistema para
localizar o arquivo, apenas arquivos do tipo Excel serão exibidos. E ainda, enquanto nenhum arquivo for
carregado não será possível prosseguir para as demais etapas.
Você poderá remover o arquivo clicando no ícone de X e caso haja algum problema no carregamento do
arquivo o sistema irá informar que houve um erro.
19
Após o arquivo ser carregado o sistema irá exibir o segundo passo da etapa de configurações, carregando
em tela duas opções para que você habilite/desabilite conforme necessário.
20
Criar registros nos formulários relacionados: Ao ativar esta opção, os registros cujos campos-chaves
definidos não existam nos formulários relacionados serão criados a partir dos dados importados. Caso a
opção esteja desativada, os registros importados serão descartados.
Atualizar registros dos formulários relacionados: Ao ativar esta opção, os registros cujos campos-chaves
definidos já existam nos formulários relacionados serão substituídos pelas informações importadas. Caso a
opção esteja desativada, os registros serão somente vinculados.
Após realizar as configurações necessárias clique em Próximo para que o sistema inicie o processamento
do arquivo carregado. Nesse momento os botões ficarão bloqueados até que o processamento seja
completado.
4.1.2 Importar registros: Etapa de Confirmação
Caso não haja nenhum erro estrutural no arquivo carregado, ao avançar o usuário seguirá para a etapa de
Confirmação onde deverá confirmar a ação que está prestes a realizar.
Nessa tela você poderá ver quantos registros do formulário foram encontrados e lidos no arquivo. Ao clicar
para marcar a caixa de confirmação tenha certeza da ação que está executando, já que a mesma não
poderá ser desfeita.
Note que não será possível avançar sem marcar a caixa sinalizando a confirmação.
21
Após confirmar e clicar em próximo os registros será gravados no sistema. Enquanto isso acontece os
botões de ações ficarão bloqueados até que a operação seja finalizada.
Será possível acompanhar através do contador exibido na tela o progresso da importação dos registros.
22
4.1.3 Importar registros: Etapa de Resumo
Ao prosseguir para a etapa de Resumo será possível visualizar a validação da importação, independente de
ter ocorrido com sucesso ou não.
Caso a importação tenha sido bem sucedida uma mensagem indicando que foi concluida com sucesso será
exibida em tela, além da informação de quantas linhas de registro foram inportadas.
Caso a importação tenha sido bem sucedida, mas alguns erros (erros de linha) tenham ocorrido o sistema
irá indicar que a importação foi concluida com sucesso e logo abaixo irá exibir também a quantidade de
linhas de registros que foram importadas e a quantidade de linhas de registro que foram descartadas
devido a falha na importação.
Em seguida um bloco contendo a lista de linhas e falhas poderá ser visto, sendo este uma espécie de log
para identificar o problema que impediu a linha de ser carregada.
23
Caso ocorrá falha na importação como um todo o sistema irá exibir na tela uma mensagem informando
que houve falha e logo abaixo será possível ver um bloco contendo a lista de linhas e falhas poderá, sendo
este uma espécie de log para identificar o problema que impediu a linha de ser carregada.
Na tabela a seguir é possível visualizar informações sobre os erros de linha que são apresentados no log
24
quando ocorre alguma falha.
Campo de Tipo do erro Mensagem

Formulário
Todos os tipos de Máscara incorreta / O valor do campo {0} não corresponde

campo Valor não suportado ao tipo de campo {0} ou à máscara.
Texto, Número Limite de caracteres O valor do campo {0} excedeu o limite

Inteiro e Número atingido de {0} caracteres.
Decimal
Arquivo Arquivo não encontrado O valor do campo {0} não foi

/ Valor não suportado encontrado ou não corresponde ao
tipo de campo Arquivo.
Arquivo Limite máximo atingido O arquivo do campo {0} excedeu o

tamanho máximo de {0}.
E-form Informação obrigatória O valor do campo obrigatório {0} não

(campos do sistema) foi informado.
E-form Campo chave trazendo Chave simples: O valor informado na

mais de um resultado chave {0} possui mais de um registro e
é necessário que este seja um valor
único.
Chave composta: Os valores

informados nas chaves {0}, {0} e {0}
possuem mais de um registro e é
necessário que estes sejam valores
únicos.
Genérico Frase genérica Não foi possível importar o valor do

campo {0}.
Genérico Campo com O valor do campo {0} já existe no

configuração de valor sistema e é necessário que este seja
único um valor único.
Pode ser que um erro estrutural ocorrá ao fazer a importação, nesse caso nada será importado de fato e o
sistema indicará que houve uma falha.
25
Quando um erro estrutural ocorre a etapa de confirmação é pulada indo direto para a etapa de resumo e
ele pode ocorrer caso:
1. Seja realizado o upload de um arquivo que contenha mais de 50.000 linhas de registros,
ultrapassando o limite do sistema.
2. Seja realizado o upload de um arquivo sem nenhuma informação, ou seja, um arquivo em branco.
3. O arquivo possua erros nos códigos dos campos (colunas) informados. Nesse caso será possível
visualizar o bloco de log para ter mais detalhes sobre os erros e linhas que impediram a importação.
Para o terceiro caso, no log, os erros estruturais serão listados abaixo e poderão ser de 4 tipos:
Tipo do erro Mensagem
Coluna (código do campo) informada no Excel O campo {0} não foi encontrado no
não existe no Fusion. sistema.
Campos E-forms do tipo selecionável que tiverem O campo {0} não possui chave
campos configurados como valor único, sem definida no arquivo enviado.
chave no arquivo enviado.
Lembrando que os campos-chaves são
identificados por um * (asterisco) do lado do
código.
Quando for informado mais de uma coluna com “O campo {0} está duplicado no
o mesmo código. arquivo enviado.”
26
Quando for informado códigos de campos de “O campo {0} não pode ser
processos não mapeados ou campos de E-form importado.”
Tipo de Documento.
4.2 Importador: Solicitações de Processos
No menu Gerenciar modelos de processos ao interagir com um dos modelos através da seta de ações na
lateral será possível acessar a funcionalidade Importar solicitações. Esta opção será visível apenas para
usuários que além de administradores do módulo de processos, também sejam admnistradores gerais do
sistema.
Não será possível fazer a importação em lote, portanto, ao selecionar vários formulários essa opção
aparecerá desativada.
4.2.1 Importar solicitações: Etapa de Configuração
Ao clicar na opção de Importar solicitações o usuário será direcionado para a primeira tela, onde poderá
realizar a etapa de configuração.
27
O primeiro passo na tela de configuração será fazer o upload do arquivo do tipo Excel (.xls ou .xlsx)
contendo os dados que você deseja importar. Você poderá fazer a importação arrastando o arquivo e
soltando na área indicada ou clicando sobre o espaço e buscando pelo arquivo em seu computador.
Ao tentar arrastar e soltar arquivos de tipos não aceitos o sistema irá bloquear o componente de
carregamento de arquivos, já ao navegar em seu computador através da tela aberta pelo sistema para
localizar o arquivo, apenas arquivos do tipo Excel serão exibidos. E ainda, enquanto nenhum arquivo for
carregado não será possível prosseguir para as demais etapas.
Você poderá remover o arquivo clicando no ícone de X e caso haja algum problema no carregamento do
arquivo o sistema irá informar que houve um erro.
28
Após o arquivo ser carregado o sistema irá exibir o segundo passo da etapa de configurações, carregando
em tela três opções para que você habilite/desabilite conforme necessário.
29
Atualizar solicitações: Ao ativar esta opção, as solicitações que possuam códigos já existentes no sistema
serão substituídas pelas informações importadas. Caso a opção esteja desativada, as solicitações não serão
atualizadas.
Note que:
1. Se esta opção estiver desativada toda a linha de registros das solicitações existentes serão descartadas,
mas não gerará log na etapa resumo.
2. Caso seja selecionado a atualização, irá atualizar os dados do processo e os dados do formulário, com
exceção dos campos selecionáveis que necessitam estar com a opção “Atualizar registros dos formulários
relacionados” ativado também. Quando não clicar em atualizar processo vai ser atualizado somente
informações do formulário se o código for informado.
3. Ressaltando que todos os registros serão atualizados, deste modo os registros que estiverem com valor
em branco na planilha, serão incluídos no banco de dados com o valor em branco.
Criar registros nos formulários relacionados: Ao ativar esta opção, os registros cujos campos-chaves
definidos não existam nos formulários relacionados serão criados a partir dos dados importados. Caso a
opção esteja desativada, os registros importados serão descartados.
Note que:
1. Esta configuração refere-se a campos e-forms configurados como selecionáveis, deste modo, se esta
opção estiver desativada e houverem campos-chaves não existentes no sistema, toda a linha de registros
referente ao formulário relacionado será descartada.
2. Caso seja selecionado a criação, mas a linha não possuir todas as informações do registro, será criado
normalmente, mesmo sem informações chaves ou obrigatórias.
3. Em casos de informações de sistema, como usuário, grupo e papel, se na planilha não tiver a coluna de
código do Fusion, o registro não poderá ser criado.
Atualizar registros dos formulários relacionados: Ao ativar esta opção, os registros cujos campos-chaves
definidos já existam nos formulários relacionados serão substituídos pelas informações importadas. Caso a
opção esteja desativada, os registros serão somente vinculados.
Note que:
1. Esta configuração refere-se a campos e-forms configurados como selecionáveis, deste modo se esta
opção estiver desativada toda a linha de registros referente ao formulário relacionado no campo e-form
será descartada.
2. Caso seja selecionado a atualização, todos os registros serão atualizados, deste modo os registros que
estiverem com valor em branco na planilha, serão incluídos no banco de dados com o valor em branco.
Após realizar as configurações necessárias clique em Próximo para que o sistema inicie o processamento
30
do arquivo carregado. Nesse momento os botões ficarão bloqueados até que o processamento seja
completado.
4.2.2 Importar solicitações: Etapa de Confirmação
Caso não haja nenhum erro estrutural no arquivo carregado, ao avançar o usuário seguirá para a etapa de
Confirmação onde deverá confirmar a ação que está prestes a realizar.
Nessa tela você poderá ver quantas solicitações do processo foram encontradas e lidas no arquivo. Ao
clicar para marcar a caixa de confirmação tenha certeza da ação que está executando, já que a mesma não
poderá ser desfeita.
Note que não será possível avançar sem marcar a caixa sinalizando a confirmação.
31
Após confirmar e clicar em próximo as solicitações será gravados no sistema. Enquanto isso acontece os
botões de ações ficarão bloqueados até que a operação seja finalizada.
Será possível acompanhar através do contador exibido na tela o progresso da importação das solicitações.
32
4.2.3 Importar solicitações: Etapa de Resumo
Ao prosseguir para a etapa de Resumo será possível visualizar a validação da importação, independente de
ter ocorrido com sucesso ou não.
Caso a importação tenha sido bem sucedida uma mensagem indicando que foi concluida com sucesso será
exibida em tela, além da informação de quantas linhas de registro foram inportadas.
Caso a importação tenha sido bem sucedida, mas alguns erros (erros de linha) tenham ocorrido o sistema
irá indicar que a importação foi concluida com sucesso e logo abaixo irá exibir também a quantidade de
linhas de registros que foram importadas e a quantidade de linhas de registro que foram descartadas
devido a falha na importação.
Em seguida um bloco contendo a lista de linhas e falhas poderá ser visto, sendo este uma espécie de log
para identificar o problema que impediu a linha de ser carregada.
33
Caso ocorrá falha na importação como um todo o sistema irá exibir na tela uma mensagem informando
que houve falha e logo abaixo será possível ver um bloco contendo a lista de linhas e falhas poderá, sendo
este uma espécie de log para identificar o problema que impediu a linha de ser carregada.
34
Na tabela a seguir é possível visualizar informações sobre os erros de linha que são apresentados no log
quando ocorre alguma falha.
Campo de Tipo do erro Mensagem

Formulário
Todos os tipos de Máscara incorreta / O valor do campo {0} não corresponde

campo Valor não suportado ao tipo de campo {0} ou à máscara.
Texto, Número Limite de caracteres O valor do campo {0} excedeu o limite

Inteiro e Número atingido de {0} caracteres.
Decimal
Arquivo Arquivo não encontrado O valor do campo {0} não foi

/ Valor não suportado encontrado ou não corresponde ao
tipo de campo Arquivo.
Arquivo Limite máximo atingido O arquivo do campo {0} excedeu o

tamanho máximo de {0}.
E-form Informação obrigatória O valor do campo obrigatório {0} não

(campos do sistema) foi informado.
E-form Campo chave trazendo Chave simples: O valor informado na

mais de um resultado chave {0} possui mais de um registro e
é necessário que este seja um valor
único.
Chave composta: Os valores

informados nas chaves {0}, {0} e {0}
possuem mais de um registro e é
necessário que estes sejam valores
únicos.
Genérico Frase genérica Não foi possível importar o valor do

campo {0}.
Genérico Campo com O valor do campo {0} já existe no

configuração de valor sistema e é necessário que este seja
único um valor único.
35
Campo de Processo Tipo do erro Mensagem
Atividade Atividade do processo A atividade {0} não foi encontrada na

não encontrada versão {0} do processo.
Data de Início Data de início com data A data de início {0} não pode ser
futura maior que a data atual.
Data de Início Data de início A data de início da solicitação não foi

obrigatória (quando o informada.
campo estiver vazio)
Data de Finalização Data de finalização A data de conclusão {0} é menor do

menor que a de início que a data de início {0} da solicitação.
Solicitante Solicitante do processo O solicitante com o código {0} não foi

invalido encontrado.
Solicitante Solicitante obrigatório O código do solicitante não foi

(quando campo estiver informado.
vazio)
Pode ser que um erro estrutural ocorrá ao fazer a importação, nesse caso nada será importado de fato e o
sistema indicará que houve uma falha.
36
Quando um erro estrutural ocorre a etapa de confirmação é pulada indo direto para a etapa de resumo e
ele pode ocorrer caso:
1. Seja realizado o upload de um arquivo que contenha mais de 50.000 linhas de registros,
ultrapassando o limite do sistema.
2. Seja realizado o upload de um arquivo sem nenhuma informação, ou seja, um arquivo em branco.
3. O arquivo possua erros nos códigos dos campos (colunas) informados. Nesse caso será possível
visualizar o bloco de log para ter mais detalhes sobre os erros e linhas que impediram a importação.
Para o terceiro caso, no log, os erros estruturais serão listados um embaixo do outro e poderão ser de 5
tipos:
Tipo do erro Mensagem
Coluna (código do campo) informada no Excel O campo {0} não foi encontrado no
não existe no Fusion. sistema.
Campos E-forms do tipo selecionável que tiverem O campo {0} não possui chave
campos configurados como valor único, sem definida no arquivo enviado.
chave no arquivo enviado.
Lembrando que os campos-chaves são
identificados por um * (asterisco) do lado do
código.
Campo #process.requester que é obrigatório O campo solicitante é obrigatório e

para a importação de solicitações de processo não foi definido no arquivo enviado.
não informado.
Quando for informado mais de uma coluna com “O campo {0} está duplicado no
o mesmo código. arquivo enviado.”
Quando for informado códigos de campos de “O campo {0} não pode ser
processos não mapeados ou campos de E-form importado.”
Tipo de Documento.
37
4.2.4 Importar solicitações: Histórico do Processo
Quando uma solicitação é importada, no histórico dessa instancia do processo fica registrado que essa
solicitação foi importada juntamente ao nome do usuário que realizou a importação e a data em que ela
foi feita.
Caso a solicitação já exista no sistema e tenha sido apenas atualizada através da importação, o histórico irá
apresentar em seu registro a informação de que a solicitação foi editada, mencionando o nome do usuário,
data e hora, além do motivo padrão informando que o processo foi editado através da função Importar
solicitações.
Quando uma solicitação existente for reaberta ou movimentada por meio a importação, no Histórico do
processo irá constar um motivo personalizado no evento de reabertura e movimentação com a informação
que aquela solicitação foi movida/reaberta através da função de importação.
E ainda, quando o formulário de uma solicitação existente for atualizado, no Histórico do processo irá
constar um motivo personalizado no evento de edição de formulário com a informação que o formulário
daquela solicitação foi editado através da função de importação.
Atenção!
As permissões de visualização dos dados de um processo seguirão as definidas no modelo de
processo, deste modo após importado, talvez o solicitante vinculado, bem como o autor da
importação não possuam permissão de visualização dos dados do processo, visto que não são
gestores, nem usuários de consulta ou não executaram nenhuma ação no processo.
38
5. Considerações Finais
Esse documento foi elaborado pela equipe de Produto, traduzido e formatado pela equipe de Gestão de
Conteúdo e Conhecimento.
Caso ainda hajam dúvidas, entre em contato com o suporte através do telefone +55 (47) 2101-0969 ou +55
(47) 2101-0971.
39
40

Data Importer - Definições para A Importação de Registros de Formulários e Solicitações de Processos

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Data Importer - Definições para A Importação de Registros de Formulários e Solicitações de Processos

Enviado por

Direitos autorais:

Formatos disponíveis

DATA IMPORTER: DEFINIÇÕES

1. Estrutura do Arquivo ........................................................................................................................................ 3

2. Importação de Registros de Formulários

2.1 Campo do tipo Texto

Máscara Valores aceitos para a importação

Máscara Senha ● Importa desde que não exceda o limite de caracteres.

Máscara Personalizada ● Valores que atendam exatamente a configuração da

Máscara Telefone: ● (52) 3481-2231

Máscara CEP: ● 96040-720

Máscara CPF: ● 070.840.070-16

Máscara CNPJ: ● 03.166.678/0001-37

2.2 Campo do tipo Booleano

Valores no Fusion Valores aceitos para a importação

Sim / Check ● True

Não / Sem Check ● False

2.3 Campo do tipo Número Inteiro

Máscara Valores aceitos para a importação

Número Padrão: 1.234 ● 1.234

Máscara Sem separador de ● 1.234

Máscara Personalizada ● Valores que atendam exatamente a configuração da

Máscara Porcentagem: ● 1234%

Máscara Telefone: ● (52) 3481-2231

Máscara CEP: ● 96040-720

Máscara CPF: ● 070.840.070-16

Máscara CNPJ: ● 03.166.678/0001-37

● Limite de caracteres: Se o valor informado na planilha ultrapassar o limite de caracteres será

2.4 Campo do tipo Número Decimal

Máscara Valores aceitos para a importação

Número Padrão: 1.234,00 ● 1.234,00

Máscara Sem separador de ● 1.234,00

Máscara Monetária Prefixo ou ● 1.234,00

Máscara Porcentagem: ● 1234,00%

1 Casa decimal: 0,0 ● 1,0

Obs.: Este comportamento se aplica a todas as outras máscaras de casas decimais.

● Separadores: Os separadores seguem a configuração de idioma do ambiente (do sistema e não de

2.5 Campo do tipo Data

Máscara Valores aceitos para a importação

Máscara: 00/00/0000 ● 15/05/2018

Máscara: 00/00/00 ● 15/03/18

Máscara: 00/00 ● 15/03

Máscara: 00/00/0000 - 00:00 ● 15/03/2018 - 16:34

Máscara: 00/00/0000 - 00:00:00 ● 15/03/2018 - 16:34:59

2.6 Campo do tipo Hora

Máscara Valores aceitos para a importação

Máscara: 00:00 ● 13:55

Máscara: 00:00:00 ● 13:42:45

2.7 Campo do tipo Arquivo

Servidor Valores aceitos para a importação

Linux ● Exemplo Path: /opt/nomeDoArquivo

Windows ● Exemplo Path: C:\temp\arquivo.xlsx

● Tamanho máximo do arquivo: Se o arquivo ultrapassar o tamanho máximo configurado gerará

2.8 Campo do tipo Lista de Opções

Valores aceitos para a importação Exemplos

2.9 Campo do tipo Usuário e Consenso

2.10 Campo do tipo E-form

- usuario1: Código do campo do formulário principal, do tipo usuário.

- name: Código do campo “nome do usuário”, no e-form NeoUser.

2.10.1 Campo E-form Selecionável

Os campos de formulários relacionados também seguirão as máscaras configuradas no sistema e quando

Configuração Código Informado Resultados esperado na importação

Criação e Atualização Existente no ● Vincula registros existentes e não

Criação e Atualização Novo ● Importa com o campo e-form em

Criação ativada Existente no ● Vincula registros existentes