Como criar instâncias de objetos customizados através de uma planilha

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.