...
| Table of Contents | ||||
|---|---|---|---|---|
|
Descrição
A importação entre Geogrid e OZmap acontece via arquivos CSV, nós realizamos a leitura desses arquivos para realizar a importação dos elementos no OZmap.
Essa documentação trata apenas de um modelo inicial de importação, podendo ser solicitada a importação em formato diferente ou de mais elementos, a ser avaliado pela equipe responsável.
Antes do início da importação, são enviados ao cliente os relatórios pré importação contendo todos os elementos que serão importados e como os dados ficarão no OZmap. A importação só é iniciada de fato após a aprovação dos relatórios enviados, pelo cliente.
Resumo das Funcionalidades
Importações de Tipos
Funcionalidade | Descrição |
|---|---|
Importação de Tipos de Caixa | Importar todos os tipos de caixa a partir do arquivo de caixas do Geogrid. Necessário para a importação de caixas. |
Importação de Tipos de Cabos | Importar todos os tipos de postes a partir do arquivo de cabos do Geogrid. Necessário para a importação de cabos. |
Importação de Tipos de Splitters | Importar todos os tipos de caixa a partir do arquivo de equipamentos do Geogrid. Necessário para a importação de splitters. |
Importação de Tipos de Switches | Importar todos os tipos de caixa a partir do arquivo de equipamentos do Geogrid. Necessário para a importação de switches. |
Importação de Tipos de DIOs | Importar todos os tipos de caixa a partir do arquivo de equipamentos do Geogrid. Necessário para a importação de DIOs. |
Importação de Tipos de OLTs | Importar todos os tipos de caixa a partir do arquivo de equipamentos do Geogrid. Necessário para a importação de OLTs. |
Importações de Elementos
Funcionalidade | Descrição |
|---|---|
Importação de Projetos | Importar as pastas do Geogrid como projeto no OZmap. No Geogrid os elementos são organizados em pastas e cidades. E também permite a criação de “subpastas” equivalente ao que seria o projeto filho no OZmap. |
...
Importamos as pastas como projetos no OZmap e importamos os elementos dentro dos respectivos projetos. As pastas da raiz do Geogrid são importadas como projetos “pai”, e “subspastas” como projeto “filho”. Dessa forma caso tenha algum cabo que ligue dois projetos “pai”, não será possível importar este cabo, pois não é possível relacionar dois ou mais projetos pai. |
Mais informações sobre projetos backbone, vide artigo: https://ajuda.ozmap.com.br/pt-BR/support/solutions/articles/44001820628-backbone .
Importação dos Elementos
Base de dados e elementos importados
A importação é feita a partir de um backup da rede do cliente enviado em formato CSV, e utilizamos também o acesso a interface para validação da importação. Na tabela abaixo mostramos quais elementos trazemos de cada uma das bases enviadas:
...
Nome da tabela
...
Elementos importados
...
postes
...
Postes
...
caixa
...
Caixas de emenda (CE) e tipos de caixa
...
terminal
...
Caixa de Terminação (CTO) e tipos de caixa
...
pontoAcesso
...
Clientes
...
grupoAcesso
...
Condomínios
...
estacao
...
POPs
...
rack
...
Armários
...
equipamentosTipos
...
Tipos dos equipamentos
...
equipamentos
...
Splitters, OLT, switch, DIO e conectores
...
cabos
...
Cabos, tipo e perfil dos cabos
...
cabosPontos
...
Pontos dos cabos
...
reserva
...
Reservas
...
fibras
...
Conexões entre cabos e equipamentos, e comentários das fibras
...
portas
...
Conexões entre equipamentos, clientes internos e bloqueios de portas de splitters
Definição dos tipos
No OZmap, assim como no Geogrid, é possível definir tipos para cabos, caixas e equipamentos. E em relação à isso, existem duas opções disponíveis:
Importar os nomes dos tipos do Geogrid;
Nesse caso serão criados novos tipos no OZmap com base no nome dos tipos existentes no Geogrid.
Cores, espessura e outras informações de estilo para cabos, por exemplo, serão definidos por um valor padrão do OZmap, mas podem ser alterados via interface de forma simples pelo cliente após a importação.
Caso o cliente não queira o estilo padrão para os tipos ele terá duas opções:
Criar esses tipos via interface e se enquadrar na segunda forma de definição de tipos;
Solicitar orçamento de uma manipulação para criação dos tipos de acordo com seus requisitos após a importação.
Converter os tipos do Geogrid para tipos existentes no OZmap do cliente.
Caso já existam tipos no OZmap do cliente que ele queira utilizar nos elementos à serem importados, é possível utilizar esses tipos, que serão atribuídos com base na planilha de tradução.
ATENÇÃO: para as duas maneiras será obrigatório preencher uma tabela de tradução de tipos.
Essa planilha será criada pelo time de manipulação e direcionada ao cliente após o envio da base de dados.
Na planilha há três campos, sendo que um deles será preenchido pelo time de manipulação e os outros dois será de responsabilidade do cliente.
Nome Tipo Geogrid - preenchido pelo time de manipulação:
Iremos mapear todos os tipos existentes no Geogrid, a partir da base de dados enviada pelo cliente, e preencher a coluna correspondente com esses valores;
Nome Tipo OZmap - preenchido pelo cliente:
Deverá ser o nome correspondente ao tipo do Geogrid, que será criado no OZmap ou convertido;
Ex. 1: O tipo de cabo ALFA B2 do Geogrid deve ser criado como tipo ALFA B2 no OZmap;
Ex. 2: O tipo de cabo ALFA B2 do Geogrid deve ser considerado como o tipo TIPO-CABO-1 no OZmap;
Nível (para cabos) - preenchido pelo cliente:
Definição de qual será o nível para o tipo no OZmap;
Ex.: O tipo do cabo ALFA B2 será do nível primário (colocar 1 na tabela) no OZmap.
Ex.: O tipo do cabo ALFA B3 será do nível secundário (colocar 2 na tabela) no OZmap.
Aqui está um exemplo da planilha que será enviada: https://docs.google.com/spreadsheets/d/1HMx9i5HqkK4usFUCZDfEZfoC1zBxGTRaoVliRtECXo4/edit#gid=0
Caso o cliente tenha dificuldades para elaborar a tabela de tradução, o setor de manipulação pode auxiliar nessa elaboração.
Obs.: Até dado momento o Geogrid fornece apenas os tipos de Cabos, equipamentos, caixas e terminais.
Importação dos equipamentos
Roteadores, conversores e ONU não são importados por padrão, caso o cliente queira importar como outro tipo de elemento, tem que ser comunicado ao setor de manipulação essa mudança.
As OLT’s que estiverem em postes serão criados POPs e armários com mesmo nome para acomodação.
Equipamentos dentro de clientes não são importados.
Importarção de cabos
Será realizada a importação de cabos nos arquivos referentes à esses elementos;
No geogrid é possível passar um cabo por várias caixas diferentes sem que haja um quebra em suas pontas:
Por exemplo:
O cabo CB-01 tem como ponta A a caixa CE-01 e ponta B CE-05;
Porém no caminho da CE-01 até a CE-05 ele passa pelas caixas CE-02, CE-03 e CE-04;
No OZmap o cabo poderá realizar o mesmo percurso, porém para cada uma das caixas que deverá passar, ele será quebrado/sangrado. Isso acontece pois no ozmap não é possível apenas passar um cabo por uma caixa, cabos obrigatoriamente precisam conter terminações;
Com isso seu nome é alterado, seguindo o padrão do OZmap, que é sendo adicionado um sufixo para diferenciar os elementos contendo uma Letra. Entretando, existem exceções onde esse padrão necessitará obrigatóriamente ser alterado, adicionando também o nome das pontas A e B. A fim de garantir que todas as quebras de cabos sejam feitas corretamente:
Utilizando o exemplo anterior, serão criados os seguintes cabos:
CB-01-A-CE-01-CE-02;
CE-01-A;
CB-01-B;
CB-01-C-CE-04-CE-05;
Importação das conexões
Importamos as conexões internas das caixas, condomínios, POPs e dos clientes.
Importamos os comentários das fibras no Geogrid como nome da fibra no OZmap.
Importação de bloqueiosde splitters
No Geogrid é possível bloquear portas de splitters. Tais bloqueios constam na planilha portas.csv. Na importação, para o OZmap simulamos esse bloqueio conectando as portas bloqueadas a uma fusão, por meio de um cordão.
Importação de clientes internos
...
Importação de Postes | Importar todos os postes do Geogrid. |
Importação de Caixas | Importar todas as caixas do Geogrid. |
Importação de Condomínios Verticais | Importar todos os condomínios verticais do Geogrid. |
Importação de POPs | Importar todos os POPs do Geogrid. |
Importação de Armários | Importar todos os armários do Geogrid. |
Importação de Imóveis dentro de Caixas | Importar todos os imóveis que estão dentro de caixas do Geogrid. |
Importação de Imóveis e Clientes | Importar todos ou apenas propriedades e clientes de projetos selecionados do Geogrid. |
Importação de Cabos | Importar todos os cabos do Geogrid. |
Importação de Conexões | Importar todas as conexões do Geogrid. |
Funcionalidades
Abaixo serão descritas as funcionalidades do serviço de importação entre Geogrid e OZmap apresentadas no resumo de forma a entender como funciona o fluxo de importação.
Importações de Tipos
As importações de tipos do Geogrid é feita para permitir que os dados que as utilizam (Cabos, Caixas, Splitters, Postes, etc.) possam ser criados no OZmap. As importações ocorrem da seguinte forma:
Tipos de Caixa: Todos os tipos de caixas do Geogrid são importados por completo para o OZmap, o nome do tipo da caixa no OZmap é definido pelo nome do tipo da caixa no Geogrid;
Tipos de Cabo: Os tipos de cabos são importados por completo para o OZmap, o código do tipo de cabo no OZmap é definido pelo nome do seu tipo de cabo no Geogrid.
Tipos de Splitter: Os tipos de splitters são importados por completo para o OZmap, o código do tipo de splitter no OZmap é definido pelo nome do seu tipo de splitter no Geogrid.
Tipos de Switch: Os tipos de switches são importados por completo para o OZmap, o código do tipo de switches no OZmap é definido pelo nome do seu tipo de switch no Geogrid.
Tipos de DIO: Os tipos de DIOs são importados por completo para o OZmap, o código do tipo de DIOs no OZmap é definido pelo nome do seu tipo de DIO no Geogrid.
Tipos de OLT: Os tipos de OLTs são importados por completo para o OZmap, o código do tipo de OLTs no OZmap é definido pelo nome do seu tipo de OLT no Geogrid.
Importações de Elementos
As importações de elementos do Geogrid é feita com o objetivo de replicar os elementos de documentação, total ou parcial. As importações de elementos do Geogrid ocorrem da seguinte forma:
...
Projetos: Todos os projetos do Geogrid são importados para o OZmap, replicando as características no OZmap.
A importação de projetos compreende somente as informações do elemento projeto. Todos os itens presentes dentro de um projeto do Geogrid, são importados separadamente pelas demais importações de elementos.
O nome do projeto OZmap será o mesmo do Geogrid.
A latitude e longitude do projeto OZmap serão os mesmos do Geogrid.
A area de coordenadas do projeto OZmap serão geradas automaticamente a partir das coordenadas de latitude e longitude.
Postes: Todos os postes do Geogrid são importados para o OZmap a partir do arquivo de postes, replicando as características no OZmap.
Postes são elementos que não possuem projeto no OZmap, então os postes serão importados sem vinculo com projetos no OZmap.
O nome do poste OZmap será a sigla do poste no Geogrid. Caso exista mais de um poste com o mesmo nome, o mesmo não será importado para o OZmap, pois não é permitido postes com nomes iguais.
A coordenada do poste OZmap serão as mesmas do Geogrid.
A observação do poste OZmap será a sua observação do Geogrid.
Caixas: Todas as caixas do Geogrid são importadas para o OZmap a partir do arquivo de caixas, replicando as características no OZmap.
O nome da caixa OZmap será definida pela sigla no Geogrid.
O tipo da caixa OZmap será o mesmo do Geogrid.
As coordenadas da caixa OZmap serão as mesmas do Geogrid.
Por padrão, todas as caixas serão criadas como implantadas no OZmap.
A observação da caixa OZmap será a observação do Geogrid.
O projeto da caixa OZmap será o mesmo do Geogrid.
Inclui obrigatoriamente as importação de:
Tipos de Caixa
Condomínios Verticais: Todos os condomínios do Geogrid são importados para o OZmap a partir do arquivo de grupo acesso, replicando as características no OZmap.
O nome do condomínio OZmap será definido pela sigla no Geogrid.
As coordenadas do condomínio OZmap serão as mesmas do Geogrid.
Por padrão, todos os condomínios serão criados como implantados no OZmap.
A observação do condomínio no OZmap será a observação do Geogrid.
O projeto do condomínio OZmap será o mesmo do Geogrid.
O endereço do condomínio OZmap será o mesmo do Geogrid.
POPs: Todas as POPs do Geogrid são importadas para o OZmap a partir do arquivo de estação, replicando as características no OZmap.
O nome da POP OZmap será definido pela sigla no Geogrid.
As coordenadas da POP no OZmap serão as mesmas do Geogrid.
Por padrão, todas as POPs serão criadas como implantadas no OZmap.
A observação da POP no OZmap será a observação do Geogrid.
O projeto da POP OZmap será o mesmo do Geogrid.
Por padrão, todas as POPs importadas terão o tipo Comum no OZmap.
Armários: Todos os Armários do Geogrid serão importados para o OZmap a partir do arquivo de rack, replicando as características no OZmap.
O nome do armário OZmap será definido pela sigla no Geogrid.
As coordenadas do armário no OZmap serão as mesmas do Geogrid.
Por padrão, todos os armários serão criados como implantados no OZmap.
A observação do armário no OZmap será a observação do Geogrid.
O POP do armário OZmap será o mesmo do Geogrid.
Imóveis Dentro de Caixas: Todos os clientes do Geogrid que estão dentro das caixas serão importados para o OZmap a partir do arquivo de portas, replicando as características no OZmap.
O nome do cliente OZmap será definido pelo nome no Geogrid.
A caixa OZmap será a mesma do Geogrid.
O Splitter OZmap será o mesmo do Geogrid.
A porta que o cliente OZmap será conectado será a mesma do Geogrid.
O código do cliente OZmap será definido automaticamente no momento da criação, sendo algo semelhante a “DESC-X”, sendo “X” um numero inteiro que será criado incrementalmente.
Esses clientes recebem uma tag que os diferenciem dos demais e, devido a ausência de coordenadas, são importados ao redor da caixa a qual estão conectados.
Importação de projetos específicos
É possível realizar a importação de pastas específicas do Geogrid no OZmap, ou ainda não importar elementos (postes, caixas, cabos e clientes) de uma pasta específica. Para tal, os aquivos fornecidos devem permitir a distinção clara entre os elementos de cada pasta.
Caso solicitada a importação de projetos específicos, a equipe de manipulação de dados irá analisar os arquivos e alinhar a possibilidade de se realizar ou não.
Informações complementares
Importamos o ‘id’ de cada elemento no Geogrid no campo de “observações” do OZmap.
Caixas internas que ficam dentro de condomínios no Geogrid não são importadas
Cabos que terminam em postes no Geogrid terminarão em uma caixa no OZmap. Essas caixas terão um tipo e nível separado.
Questionário e base de dados modelo
Imóveis: Todos os clientes do Geogrid que estão dentro das caixas serão importados para o OZmap a partir do arquivo de ponto acesso, replicando as características no OZmap.
O nome do cliente OZmap será definido pela sua sigla no Geogrid.
A descrição do cliente OZmap será a observação no Geogrid.
O endereço do cliente OZmap será o mesmo do Geogrid.
As coordenadas do cliente OZmap serão as mesmas do Geogrid.
O projeto do cliente OZmap será o mesmo do Geogrid.
Cabos: Todos os cabos do Geogrid são importadas para o OZmap a partir do arquivo de cabos, replicando as características no OZmap.
O nome do cabo OZmap será definido pela sua sigla no Geogrid.
Os pontos do cabo OZmap serão os mesmos do Geogrid.
Por padrão, todos os cabos serão criados como implantados no OZmap.
As pontas dos cabos OZmap serão as mesmas pontas do Geogrid, caso não seja encontrado alguma das pontas, será criado uma caixa fim de cabo com o tipo e nível diferentes para facilitar a visualização.
Inclui obrigatoriamente as importação de:
Tipos de Cabo
Pode depender da importação de:
Caixas, Condomínios, POPs e Imóveis
Equipamentos: Todos os equipamentos do Geogrid são importadas para o OZmap a partir do arquivo de equipamentos, replicando as características no OZmap. Todos os equipamentos são importados para o OZmap no decorrer da importação dos outros elementos, como por exemplo Caixas, Armários, Pops e etc. Os equipamentos importados são Switches, Splitters, DIOs e OLTs.
O nome do equipamento OZmap será a sigla do Geogrid.
A caixa do equipamento OZmap sera a mesma do Geogrid.
A observação do equipamento OZmap será a observação do Geogrid.
O tipo do equipamento OZmap será o mesmo do Geogrid. Caso seja realizada a tradução de tipos, o tipo do equipamento OZmap será o definido no arquivo de traduções.
Inclui obrigatoriamente as importação de:
Tipos de Splitter, Tipos de Switches, Tipos de OLTs e Tipos de DIOs
Pode depender da importação de:
Caixas, Condomínios e POPs
Conexões: Todas as conexões são importadas para o OZmap a partir do arquivo de .
As conexões se referem as ligações entre elementos dentro de uma caixa, condomínio ou POPs, como conexões entre cabos, splitters e clientes, cabos e equipamentos como dios, olts, switches e splitters por exemplo.
Pode depender da importação de:
Cabos, Splitters, DIOs, Switches e OLTs
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 Geogrid, 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 |
|---|---|---|
Importar observações das fibras | No Geogrid é possível adicionar observações nas fibras. Ao serem importadas, cada fibra receberá em seu nome OZmap a observação do Geogrid. | Desativado. |
Dados Acesso
https://docs.google.com/forms/d/e/1FAIpQLSdRjrobAHc1z_pt3k26hrFxblKU4OqEmt1wmJc1exbbCl1kxw/viewform
Base de dados Modelo:
| View file | ||
|---|---|---|
|
...
Dados de acesso necessários para buscar informações via API nos sistemas Geogrid 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. |
Geogrid
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL Geogrid | Endereço do Geogrid que será utilizado para consultar os elementos |
|
Usuário Geogrid | Usuário responsável por ter acesso a interface e a chamadas API para o Geogrid. |
|
Senha Usuário Geogrid | Senha do usuário do Geogrid; |
|
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 Geogrid? | Sim, os postes no Geogrid 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 Geogrid? | 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 Geogrid para usar tipos já existentes no OZmap? | Não, atualmente não é possível traduzir tipos de elementos, somente importar os tipos originais do Geogrid para o OZmap. | - |
Pergunta | Resposta |
|---|---|
É possível importar projetos separados do Geogrid em um único projeto no OZmap? | Não é possível via processo de importação. Podemos realizar isso através de uma manipulação de dados, sendo necessário solicitar um orçamento para o serviço de juntar os projetos no OZmap após a importação. Outras alternativas são:
|
...