Importação de documentos ou imagens

O processo “Importação de Documentos ou Imagens” tem o objetivo de importar documentos ou imagens, associando-as aos cadastros existentes no sistema. Um exemplo é associação de Recursos às suas imagens.

Fluxo Operacional

Para realizar a importação, devem ser seguidos os passos abaixo:

1. Acessar o processo Admin > Importação de Documentos ou Imagens.
2. Preencher o tipo de importação (classe onde foram configurados os campos que definem o formato do nome do arquivo).
3. Selecionar o diretório que contém os documentos que serão importados para o sistema.
4. Selecionar os campos ou expressões com formato do nome do arquivo.
5. Preencher o separador que será usado para dividir o nome do arquivo nos segmentos que serão relacionados aos campos ou expressões do formato escolhido. É utilizado “_” (underscore) por padrão.
6. Na interação seguinte, confira os documentos que não serão importados e os documentos que são passíveis de importação, selecione os que deseja importar e avance.
7. Na interação seguinte, selecione os relacionamentos entre documento e cadastro que deseja criar e efetue a gravação. Neste passo, caso o tipo de importação admita marcar relacionamentos como principais, você pode escolher para cada relacionamento se o tornará principal, sendo esta marcação limitada a um relacionamento por cadastro.

Observações:

• O diretório deve ter somente os documentos que serão importados.

• O nome do arquivo deve conter as informações que os campos ou expressões selecionados guardam, para que seja feita uma pesquisa no intuito de relacionar os registros com os arquivos.

  Ex.:

  Exemplo de Registro:
      - REFFABRICA: 0001
      - COR (chave): -12345678
      - COR.NOME (expressão): Azul
  
  Formato: REFFABRICA;COR.NOME
  Separador: _
  Formatação do nome do arquivo: "[REFFABRICA]_[COR.NOME].jpg"
  Exemplo de nome do arquivo para o registro: "0001_Azul.jpg"
  
  ou
  
  Formato: REFFABRICA;COR
  Separador: ~~
  Formatação do nome do arquivo: "[REFFABRICA]~~[COR].jpg"
  Exemplo de nome do arquivo para o registro: "0001~~-12345678.jpg"
  

• Lembre-se de utilizar um separador que não coincida com sequências de caracteres presentes nos segmentos do nome do arquivo que você queira relacionar aos campos/expressões do formato desejado.

  Ex.: No exemplo acima, caso queira utilizar o formato REFFABRICA;COR, o separador não pode ser “-”, já que a informação de cor possui esse caractere, pois é chave negativa (-12345678).

  De maneira semelhante, “-” não poderia ser utilizado com o formato REFFABRICA;COR.NOME caso o nome da cor seja “Azul-Marinho”, pois “0001-Azul-Marinho.jpg” seria um nome inválido.

Formatos dos arquivos a serem importados

Na importação de arquivos para uma determinada classe, são sugeridos alguns formatos de nomes dos arquivos a serem importados. Esses formatos são pré-configurados dentro da classe.

Isso é necessário para que o processo de Importação de Documentos ou Imagens realize uma pesquisa para relacionar os registros com os documentos ou imagens.

Configurar os campos necessários para realizar a importação dos documentos é uma tarefa a ser realizada por um desenvolvedor, onde serão configurados os campos de formatação do nome do arquivo na propriedade formatFileName do x-model da classe filha de “Relações entre Cadastros e Arquivos”. Exemplo:

this.formatFileName.push('COR'); // incluir campo COR da tabela`

Para mais detalhes sobre a configuração para a importação de documentos ou imagens, acesse a documentação Vincular arquivos a cadastros.