Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 3 Next »

This document presents the main information on data importation between Vetro and OZmap and provides a pre-importation form as well.

Description

The importation between Vetro and OZmap is conducted via API calls; we execute API calls to import elements into OZmap.

This documentation only addresses an initial import model. Import using different formats or adding more elements may be requested, subject to evaluation by the responsible team.

Once the importation is completed, reports are sent to the client containing all imported elements, and the reasons for any errors during importation, for elements that weren't imported.

Functionalities Summary

Import Settings and Customization

Functionality

Description

System Settings Import

Import POP levels, Boxes, and Cables.

Needed for importing POP types, box types, and cable types.

Tags Import

Import tags to differentiate between clients and buildings.

Tags are used to distinguish a client from a building imported from Vetro.

Fiber Profiles Import

Import all fiber profiles from Vetro.

Needed for importing cable types.

Types Import

Functionality

Description

Box Types Import

Import all box types from Vetro’s Box Layer.

Needed for box importation.

Pole Types Import

Import all pole types from Vetro’s Pole Layer.

Needed for pole importation.

Elements Import

Functionality

Description

Project Import

IImport all or selected projects from Vetro.

The project will be imported as an empty project, not having any elements and with the same area settings as in Vetro.

Pole Import

Import all or selected poles from Vetro projects.

Box Import

Import all or selected boxes from Vetro projects.

Vertical Buildings Import

Import all or selected vertical buildings from Vetro projects.

Properties and Clients Import

Import all or selected properties and clients from Vetro projects.

POP Import

Import all or selected POPs from Vetro projects.

Cables Import

Import all or selected cables from Vetro projects.

Splitter Import

Import all or selected splitters from Vetro projects.

ODFs Import

Import all or selected ODFs from Vetro projects.

Technical Reserves (Spares) Import

Import all or selected technical reserves from Vetro projects.

Boxes Internal Connections Import

Import all or selected internal connections in boxes from Vetro projects.

Functionalities

As follows, we’ll describe the functionalities of the import service between Vetro and OZmap, allowing a better understanding of the importation flow.

Settings and Customization Imports

Settings and customization imports from Vetro are performed to ensure that the data utilizing them (Cable and Box Types, Properties, Clients, Poles, etc.) can be created with identical customizations in OZmap. The imports occur as follows:

  • System Settings: System settings including POP Levels, Box Levels, and Cable Levels, are imported.

    • For each layer concerning box, cable, and POP labels found in Vetro, a corresponding level is created in OZmap if one containing the same name does not already exist.

    • The imported levels in OZmap will be created following the already existing hierarchies in OZmap.

  • Fiber profiles: All fiber profiles from Vetro are fully imported into OZmap, even if identical profiles (name and specificities) already exist.

  • Box Templates: By default, all imported boxes from Vetro will receive an “Empty” template.

  • Tags: Tags named “house” and “office” will be created in OZmap to replace the client type classification used by Vetro.

IMPORTANT: Even if the client selects specific projects for importation from Vetro to OZmap, ALL items described in this section will be imported to OZmap, regardless of their usage in the selected projects.

Types Import

Type imports from Vetro are performed to enable data that utilizes them (Cables, Boxes, Splitters, Poles, etc.) to be created in OZmap. The imports occur as follows:

  • ODF Types: ODF types are imported during ODF importation, with the type name in OZmap defined by the number of ports the ODF has in Vetro.

    • For example, if a ODF has "12" ports in Vetro, a type named "12" will be created in OZmap.

  • POP Types: All POP types from Vetro are fully imported into OZmap, with the type name defined by the Layer name used in Vetro.

    • Includes mandatory importation of:

      • System Settings, as each Vetro Layer has an equivalent POP level in OZmap.

  • Splitter Types: Splitter types are imported during Splitter importation, with the type code in OZmap defined by the "placement" name and the number of ports in Vetro.

  • Pole Types: All pole types from Vetro are fully imported into OZmap, with the type name defined by the Layer name used in Vetro.

  • Box Types: All box types from Vetro are fully imported into OZmap, with the type name defined by the Layer name used in Vetro.

    • Includes mandatory importation of:

      • System Settings, as each Vetro Layer has an equivalent box level in OZmap.

  • Cable Types: Cable types are imported during cable importation, with the type code in OZmap defined by the "placement" name, the "label" name, and the "loose" and "fiber" quantities in Vetro.

    • Includes mandatory importation of:

      • Fiber Profiles, as each Vetro Layer has an equivalent cable level in OZmap.

IMPORTANT: Even if the client selects specific projects for importation from Vetro to OZmap, ALL items described in this section will be imported to OZmap, regardless of their usage in the selected projects.

Elements Import

Element imports from Vetro aim to replicate documentation elements, either fully or partially. Element imports from Vetro occur as follows:

  • Projects: All selected projects from Vetro are imported into OZmap, replicating their characteristics in OZmap.

    • A importação de projetos compreende somente as informações do elemento projeto. Todos os itens presentes dentro de um projeto do Vetro, são importados separadamente pelas demais importações de elementos.

    • O nome do projeto OZmap será o mesmo do Vetro.

    • A latitude e longitude do projeto OZmap serão os mesmos do Vetro.

    • A area de coordenadas do projeto OZmap serão as mesmas do Vetro.

  • Postes: Todos os postes do Vetro são importados para o OZmap a partir da layer de postes, replicando as características no OZmap.

    • Postes são elementos que não possuem projeto no OZmap, porém, no Vetro eles possuem projetos, então caso o cliente deseje realizar uma importação apenas de projetos selecionados, serão importados apenas os postes do projeto selecionado.

    • O nome do poste OZmap será o ID do poste no Vetro. Caso exista mais de um poste com o mesmo nome no Vetro, adicionaremos um número após o nome do poste no OZmap, para evitar erros de nomes duplicados.

    • A coordenada do poste OZmap serão as mesmas do Vetro.

    • A observação do poste OZmap será a nota do Vetro.

    • Inclui obrigatoriamente as importação de:

      • Tipos de Poste

  • Caixas: Todas as caixas do Vetro são importadas para o OZmap a partir da layer de caixas, replicando as características no OZmap.

    • O nome da caixa OZmap será definida pelo ID caso exista, ou nome existente no Vetro. Caso exista mais de uma caixa com o mesmo nome no Vetro, adicionaremos um número após o nome da caixa no OZmap, para evitar erros de nomes duplicados.

    • O tipo da caixa OZmap será o mesmo do Vetro.

    • As coordenadas da caixa OZmap serão as mesmas do Vetro.

    • Se a caixa estiver em “build” no Vetro, ela será criada como implantada no OZmap. Caso contrário, a caixa será criada como não implantada no OZmap.

    • A observação da caixa OZmap será a nota do Vetro.

    • Inclui obrigatoriamente as importação de:

      • Tipos de Caixa

  • Condomínios Verticais: Todos os condomínios do Vetro são importados para o OZmap a partir da layer de customer sendo identificado pelo tipo de edifício, replicando as características no OZmap.

    • O nome do condomínio OZmap será o ID caso exista, ou o nome da companhia no Vetro. Caso exista mais de um condomínio com o mesmo nome no Vetro, adicionaremos um número após o nome no OZmap, para evitar erros de nomes duplicados.

    • As coordenadas do condomínio OZmap serão as mesmas do Vetro.

    • Se o condomínio estiver em “build” no Vetro, ele será criado como implantado no OZmap. Caso contrário, o condomínio será criado como não implantado no OZmap.

    • A observação do condomínio no OZmap será a nota do Vetro.

  • Imóveis e Clientes: Todos os imóveis e clientes do Vetro são importados para o OZmap a partir da layer de customer, replicando as características do OZmap.

    • O código do cliente OZmap será o ID Vetro. Caso exista mais de um cliente com o mesmo código no Vetro, adicionaremos um número após o código no OZmap, para evitar erros de códigos duplicados.

    • O nome do cliente OZmap será o nome da companhia do imóvel no Vetro.

    • Se o imóvel estiver em “build” no Vetro, ele será criado como implantado no OZmap. Caso contrário, o imóvel será criado como não implantado no OZmap.

    • As coordenadas do imóvel no OZmap serão as mesmas do Vetro.

    • A observação do imóvel no OZmap serãoo a nota do Vetro.

  • POPs: Todas as POPs do Vetro são importadas para o OZmap a partir da layer de pops, replicando as características no OZmap.

    • O nome da POP OZmap será o ID caso exista, ou o nome da POP no Vetro. Caso exista mais de uma POP com o mesmo nome no Vetro, adicionaremos um número após o nome no OZmap, para evitar erros de nomes duplicados.

    • As coordenadas da POP no OZmap serão as mesmas do Vetro.

    • Se a POP estiver em “build” no Vetro, ela será criada como implantada no OZmap. Caso contrário, a POP será criada como não implantada no OZmap.

    • A observação da POP no OZmap será a nota do Vetro.

    • Inclui obrigatoriamente as importação de:

      • Tipos de POP

  • Cabos: Todos os cabos do Vetro são importadas para o OZmap a partir da layer de cabos, replicando as características no OZmap.

    • O nome do cabo OZmap será o ID caso exista, ou o nome do cabo no Vetro.

    • Os pontos do cabo OZmap serão os mesmos do Vetro.

    • Se o cabo estiver em “build” no Vetro, ele será criado como implantado no OZmap. Caso contrário, o cabo será criado como não implantado no OZmap.

    • As pontas dos cabos OZmap serão as mesmas pontas do Vetro.

    • Inclui obrigatoriamente as importação de:

      • Tipos de Cabo

    • Pode depender da importação de:

      • Caixas, Condomínios, POPs e Imóveis

  • Splitters: Todos os splitters do Vetro são importadas para o OZmap a partir da layer de splitters, replicando as características no OZmap.

    • O nome do splitter OZmap será o ID do Vetro.

    • A caixa do splitter OZmap sera a mesma do Vetro.

    • A observação do splitter OZmap será a nota do Vetro.

    • Se o splitter estiver em “build” no Vetro, ele será criado como implantado no OZmap. Caso contrário, o splitter será criado como não implantado no OZmap.

    • Por padrão, os splitters serão criados no OZmap com o atributo “Permitir Conexões de Clientes” sendo falso.

    • Inclui obrigatoriamente as importação de:

      • Tipos de Splitter

    • Pode depender da importação de:

      • Caixas, Condomínios e POPs

  • DIOs: Todos os DIOs do Vetro são importadas para o OZmap a partir da layer de dios, replicando as características no OZmap.

    • O nome do DIO OZmap será o ID do Vetro.

    • A caixa ou a POP do DIO OZmap sera a mesma do Vetro.

    • A observação do DIO OZmap será a nota do Vetro.

    • Se o DIO estiver em “build” no Vetro, ele será criado como implantado no OZmap. Caso contrário, o DIO será criado como não implantado no OZmap.

    • Inclui obrigatoriamente as importação de:

      • Tipos de DIO

    • Pode depender da importação de:

      • Caixas

  • Conexões Internas de Caixas: Todas as conexões internas de caixas do Vetro são importadas para o OZmap.

    • As conexões internas de caixas se referem as ligações entre elementos dentro de uma caixa, como conexões entre cabos, entre splitters e cabos, e entre splitters e splitters por exemplo.

    • Pode depender da importação de:

      • Cabos e Splitters

  • Reservas Técnicas: Todos as reservas técnicas do Vetro são importadas para o OZmap a partir da layer de reservas tecnicas, replicando as características no OZmap.

    • Pode depender da importação de:

      • Cabos

LEGENDA:

“Inclui obrigatoriamente as importação de” - São outros elementos que também precisarão ser importados juntamente com o elemento selecionado pelo cliente no questionário.

“Pode depender da importação de” - São outros elementos que, caso não ser sejam importados, podem impedir a criação dos elementos em questão. Por exemplo: Na importação de caixas, caso uma caixa esteja alocada em um poste no Vetro, e esse poste não tiver sido importado previamente para o OZmap por algum motivo, a caixa não poderá ser criada no OZmap também.

Configurações Base

Elementos

Parâmetro

Descrição

Padrão

Projetos a serem importados

Usar uma lista somente de projetos a serem importados para o OZmap.

Desativado.

Por padrão serão importados todos os projetos do Vetro.

Dados Acesso

https://forms.gle/dSzz7Mcyiy9uUDJt9

Dados de acesso necessários para buscar informações via API nos sistemas Vetro e OZmap. (Estes dados devem ser fornecidos no questionário inicial).

OZmap

Parâmetro

Descrição

Exemplo

URL OZmap

Endereço do OZmap que receberá os elementos importados.

https://cliente1.ozmap.com.br

Vetro

Parâmetro

Descrição

Exemplo

URL Vetro

Endereço do Vetro que será utilizado para consultar os elementos

https://vetro.io/v2

Usuário Vetro

Usuário responsável por ter acesso a interface e a chamadas API para o Vetro.

user@vetro.com

Senha Usuário Vetro

Senha do usuário do Vetro;

gXv3tr0

Dúvidas frequentes

Pergunta

Resposta

Funcionalidade

Alguma das funcionalidades do serviço de importação OZmap é opcional?

Não. Atualmente na versão atual, é feito a importação de todos os elementos descritos.

Todas.

É possível importar somente postes de projetos específicos do Vetro?

Sim, os postes no Vetro são separados por projetos. Com isso, caso seja solicitado a importação de um único projeto, apenas postes daquele projeto serão importados.

Importação de Postes

É possível importar somente tipos de elementos específicos do Vetro?

Não, atualmente todos os tipos dos elementos selecionados serão importados para o OZmap, independente de serem usados ou não.

-

É possível realizar a tradução de tipos do Vetro para usar tipos já existentes no OZmap?

Não, atualmente não é possível traduzir tipos de elementos, somente importar os tipos originais do Vetro para o OZmap.

-

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.