Este tópico explica como obter e preencher a planilha utilizada para importar instâncias de objetos customizados para o sistema.
1. Acesse o módulo customizado.
2. Na seção do objeto customizado, acesse a página de exportação e importação.
O sistema exibe uma tela onde as instâncias do objeto podem ser exportadas e importadas.
3. Na seção Exportar, clique em Exportar Modelo (veja abaixo).
4. Salve o arquivo em seu computador e abra-o.
A planilha contém duas abas: a aba Instruções, que contém informações sobre como o modelo deve ser preenchido, e uma segunda aba, onde as instâncias do objeto podem ser cadastradas (veja abaixo).
A tabela abaixo explica como cada campo da segunda aba deve ser preenchido. Campos que contêm asterisco devem obrigatoriamente ser preenchidos.
Campo |
Instruções |
ID |
Esse campo está desabilitado para edição, pois o ID da instância será criado automaticamente pelo sistema na importação da planilha. |
*Tipo de (Objeto) |
Selecione na lista suspensa o tipo da instância que está sendo criada. Os tipos disponíveis são todos aqueles criados para o objeto na seção Tipos de Objeto do módulo Administração.
Observe que, para instâncias previamente cadastradas no sistema, quaisquer mudanças nesse campo serão ignoradas quando a planilha for importada. Caso uma instância seja criada com um tipo que não exista no sistema, a importação da planilha não será aceita, de modo que você terá que preencher o campo novamente, com um valor válido, para que a planilha possa ser importada. Para instâncias já cadastradas no sistema, os nomes dos tipos excluídos serão acrescidos da tag "(excluído)". |
Atributos de Objeto Customizado |
Os atributos exibidos na planilha foram previamente criados na seção Objetos e Atributos do módulo Administração. Quando um atributo não é aplicável a um determinado tipo de objeto, qualquer dado inserido nesse campo será destacado e ignorado pelo sistema na importação da planilha. Caso os atributos sejam marcados como obrigatórios no sistema, eles deverão ser completados para que a planilha possa ser importada. Esses campos devem ser preenchidos de acordo com o tipo de atributo da seguinte forma: •Anexo: não é possível adicionar um anexo através da planilha. No entanto, você pode visualizar os anexos adicionados através do sistema. Eles serão exibidos entre colchetes e separados por ponto-e-vírgula, por exemplo "[nome do arquivo];[nome do outro arquivo]". Ao criar uma instância através da planilha, este campo será importado em branco para o sistema mesmo se estiver marcado como obrigatório. •Data/Hora: o formato de preenchimento deve ser o definido na configuração do atributo no sistema. Se o atributo tiver sido cadastrado como "Data", o campo deve conter apenas a data, se for "Hora", deve conter apenas a hora e se for "Data/Hora" pode conter qualquer um dos dois, sendo que se você inserir apenas a data no atributo, a hora será, por padrão, 0h:00min e se você inserir apenas a hora, a data será, por padrão, o dia da importação da planilha. A data pode estar em dois formatos: MM/DD/AAAA ou AAAA-MM-DD. A hora deve estar no formato 24 horas: hh:mm. •E-mail: o formato deve ser nome@dominio.com.br e deve conter no máximo 100 caracteres. •Fórmula: por ser um campo somente leitura, não é possível editar os valores inseridos para este atributo ou inserir novos valores. Os valores serão atualizados apenas após a importação da planilha. •Georreferência: Especifique um valor para esse atributo, fornecendo as coordenadas no seguinte formato:
Para definir um ponto: {"type":"Point","coordinates":[-0.09046,51.51095]}
Para definir um conjunto de pontos: {"type":"LineString","coordinates":[[-0.09046,51.51095],[0,07446,44.51095]]}
As coordenadas dos pontos devem ser inseridas entre colchetes, na ordem "Longitude,Latitude". •Imagem: os arquivos dos atributos do tipo imagem são anexados através do sistema e não é possível adicioná-los através da planilha. Os arquivos anexados através do sistema serão exibidos entre colchetes e separados por ponto e vírgula, por exemplo: "[imagem.jpeg];[imagem2.jpeg]".
Ao criar uma instância através da planilha, este campo será importado em branco para o sistema mesmo se estiver marcado como obrigatório. •Link: o formato deve ser http://www.dominio.com.br ou \\servidor\caminho. •Lista de Opções: os atributos desse tipo devem ser preenchidos através da seleção de uma das opções disponíveis para esse campo, separados por ponto e vírgula se mais de um valor for aceito. •Número: nesse tipo de atributo, o separador decimal é a vírgula "," e, opcionalmente, pode ser usado o separador de milhares, que é o ponto ".". Por exemplo, o número 1200,20 deve ser preenchido como "1.200,20". •Parágrafo: esse tipo de atributo deve ser preenchido com texto normal. •Relacionamento: esse tipo de atributo pode ser de seleção única ou múltipla, e o campo deve ser preenchido com um identificador alfanumérico ou com o caminho dos objetos que estão sendo associados. Caso mais de um objeto seja cadastrado no sistema com o mesmo nome, os caminhos desses objetos não poderão ser usados para criar relacionamentos e o sistema não permitirá que a planilha seja importada. Observe que para atributos de seleção múltipla, os caminhos ou os identificadores dos objetos precisam ser separados por ponto e vírgula (;) e sem espaços ao preencher as células. O identificador de cada objeto deve ser precedido pela tag "id:", sem espaços. O identificador de cada objeto está disponível através da API, mas também pode ser encontrado inserindo-se o nome do objeto no campo de busca do sistema e clicando na entrada correspondente. O identificador aparecerá no final da URL. Para componentes de negócio, o caminho deve ser especificado no seguinte formato: nível do componente de negócio > tipo do componente de negócio > nome do componente de negócio. Para perímetros, o caminho deve ser especificado no seguinte formato: nome do perímetro pai > nome do perímetro. Para ativos, o caminho deve ser especificado no seguinte formato: nome do perímetro pai > nome do ativo. Para outros objetos, apenas digite seus nomes. Quando a planilha for exportada, a lista de objetos relacionados pode ficar truncada se o número máximo de caracteres permitidos na célula for excedido. Se a célula não for editada, a planilha será importada e todos os relacionamentos existentes serão mantidos. Para editá-los, as reticências e os colchetes devem ser antes removidos. Note que, nesse caso, o novo relacionamento será importado e todos os anteriores serão removidos. •Texto: esse tipo de atributo deve ser preenchido com texto normal, sendo que o atributo pode ter sido cadastrado com um número mínimo ou máximo de caracteres que deve ser respeitado, além das máscaras com expressão regular, quando configuradas. •Tópicos: atributos desse tipo devem ser preenchidos com os tópicos separados por ponto e vírgula ";" e ter no máximo 100 caracteres. Por exemplo: Tópico 1;Tópico 2;Tópico 3.
Para obter detalhes sobre como criar atributos, veja o Capítulo 17: Administração -> Customizações -> Objetos e atributos. |
Autor |
Este campo está desabilitado para edição e será preenchido automaticamente pelo sistema com o nome e o nome de usuário da pessoa que cadastrou a instância. |
Data de Criação |
Este campo está desabilitado para edição e será preenchido automaticamente pelo sistema com a data na qual a instância foi criada. |
Atualizado por |
Este campo está desabilitado para edição e será preenchido automaticamente pelo sistema com o nome e o nome de usuário da pessoa que atualizou a instância. |
Data de Atualização |
Este campo lista a data em que as informações sobre a instância foram atualizadas. Ele não deve ser preenchido ou editado, e quaisquer alterações feitas nele serão ignoradas pelo sistema. |
Ao terminar, salve o arquivo em seu computador. A planilha deve ser importada para que as alterações sejam salvas no sistema. Para mais informações, veja o Capítulo 18: Módulos customizados -> Seções de objetos customizados -> Exportar/importar instâncias de objetos customizados -> Como importar instâncias de objetos customizados através de uma planilha.