...
Este documento tem como objetivo apresentar as principais informações sobre a importação de dados entre duas bases OZmap, bem como disponibilizar um formulário pré-importação.
| Table of Contents | ||||
|---|---|---|---|---|
|
Descrição
No OZmap, alguns elementos possuem dependência de outros elementos, exemplo:
...
Este documento tem como objetivo apresentar as principais informações sobre a importação de dados entre duas bases OZmap, bem como disponibilizar um formulário pré-importação.
| Table of Contents | ||||
|---|---|---|---|---|
|
Descrição
No OZmap, alguns elementos possuem dependência de outros elementos, exemplo:
Para criarmos uma caixa, é necessário informar o tipo da caixa, que, em sequencia é necessário informar o template padrão desse tipo de caixa. Com isso, temos a seguinte estrutura:
...
Funcionalidade | Descrição |
|---|---|
Importação de Postes | Importar todos os postes do OZmap. Caso já exista um poste com mesmo nome no OZmap destino, o poste não será importado, devido ao OZmap não permitir postes com nomes iguais. |
Importação de Pontos | Importar todos os pontos do OZmap. |
Importação de Projetos | Importar todos ou apenas projetos selecionados do OZmap. O projeto será importado sem nenhum elemento dentro dele, será apenas um projeto vazio com as configurações de área e projeto pai idênticas as do OZmap de origem. Caso já exista um projeto com mesmo identificador no OZmap destino, o projeto não será importado, devido ao OZmap não permitir projetos com identificadores iguais. |
Importação de Regiões | Importar todas as regiões do OZmap. Caso já exista uma região com mesmo nome e tipo no OZmap destino, a região não será importada, devido ao OZmap não permitir regiões repetidas com nome e tipo iguais. |
Importação de Usuários | Importar todos os usuários do OZmap. O usuário será importado com as mesmas permissões da aba Na importação dos usuários, será necessário “redefinir” a senha e, para isso, deve ser necessário informar a senha padrão para todos os usuários que serão importados. |
Importação de Caixas | Importar todas ou apenas caixas de projetos selecionados do OZmap. |
Importação de Condomínios Verticais | Importar todos ou apenas condomínios verticais de projetos selecionados do OZmap. |
Importação de Condomínios Horizontais | Importar todos ou apenas condomínios horizontais de projetos selecionados do OZmap. |
Importação de Imóveis e Clientes | Importar todos ou apenas propriedades e clientes de projetos selecionados do OZmap. |
Importação de POPs, Armários e OLTs | Importar todos ou apenas pops, armário e olts de projetos selecionados do OZmap. |
Importação de Cabos | Importar todos ou apenas cabos de projetos selecionados do OZmap. |
Importação de Splitters | Importar todos ou apenas splitters de projetos selecionados do OZmap. |
Importação de DIOs | Importar todos ou apenas dios de projetos selecionados do OZmap. |
Importação de Switchs | Importar todos ou apenas switchs de projetos selecionados do OZmap. |
Importação de Conectores | Importar todos ou apenas conectores de projetos selecionados do OZmap. |
Importação de Fusões | Importar todas ou apenas fusões de projetos selecionados do OZmap. |
Importação de Pendências | Importar todas ou apenas pendências de projetos selecionados do OZmap. |
Importação de Topologia de caixas (conexões e organização interna) | Importar todas ou apenas topologias em caixas de projetos selecionados do OZmap. |
Importação de Conexões Internas de POPs | Importar todas ou apenas conexões internas em pops de projetos selecionados do OZmap. |
Importação de Adjacências | Importar todos as adjacências do OZmap. |
...
Abaixo serão descritas as funcionalidades do serviço de importação OZmap apresentadas no resumo de forma a entender como funciona o fluxo de importação.
Importação das Personalizações
A importação das personalizações OZmap é feita para permitir que os dados que as utilizam (Tipos de Cabos e Caixas, Pendencias, Imóveis, Clientes, Postes, etc.) possam ser criados e serem trabalhadas.
Abaixo iremos utilizar como exemplo a importação das TAGs, mas é o mesmo padrão utilizado na importação de todas as personalizações, ocorrendo da seguinte forma:
É feito a busca no OZmap de origem de todas as tags existentes;
Para cada tag encontrada, é analisado se a mesma ja foi importada anteriormente, caso ja tenha sido importada, é exibido uma mensagem de erro informando o nome da tag junto com a mensagem de que já existe no OZmap de destino.
Caso a tag não exista no OZmap destino, a mesma é criada com as mesmas informações do OZmap de origem.
Importação dos Tipos
A importação dos tipos OZmap é feita para permitir que os dados que as utilizam (Cabos, Caixas, Splitters, Postes, Switchs e etc.) possam ser criados e serem trabalhadas.
Abaixo iremos utilizar como exemplo a importação dos tipos de caixa, mas é o mesmo padrão utilizado na importação de todos os tipos, ocorrendo da seguinte forma:
OBS: Os tipos de caixas e tipos de cabos possuem como parâmetro obrigatório o template padrão e o perfil de fibra, que é encontrado na aba personalização, então, caso seja escolhido importar algum dos dois tipos, obrigatoriamente a personalização templates de caixa ou perfis de fibras também vai ser importada.
Caso seja uma importação de tipos de caixa ou cabos, é feito inicialmente a importação das suas personalizações, seguindo o passo a passo determinado anteriormente aqui. Após concluir essa etapa, faremos:
Uma busca no OZmap de origem de todos os tipos de caixas existentes;
Para cada tipo de caixa encontrado, é verificado se o mesmo já foi importado anteriormente. Caso já tenha sido importado, é exibido uma mensagem de erro informando o nome do tipo da caixa junto com a mensagem de que já existe no OZmap de destino.
Caso o tipo de caixa não exista no OZmap de destino, é feito a busca do seu template de caixa no OZmap de destino.
Se o template de caixa não existir no OZmap de destino, é exibido uma mensagem de erro informando o nome do template da caixa junto com a mensagem de que não existe no OZmap de destino e é passado para o próximo tipo de caixa.
Caso o template exista no OZmap de destino, o tipo de caixa é criado com as mesmas informações do OZmap de origem.
Importação dos Projetos
A importação dos projetos OZmap é feita para permitir que os elementos possam ser criados dentro dele ( imóveis, caixas, pops e etc.) e trabalhados, ocorrendo da seguinte forma:
O cliente decide se vai querer realizar a importação de todos os projetos ou apenas projetos selecionados. Caso seja apenas projetos selecionados, os nomes devem ser enviados no formulário.
Após isso, é feito a busca dos projetos no OZmap destino;
Para cada projeto encontrado, é verificado se o mesmo ja foi importado anteriormente. Caso já tenha sido importado, é exibido uma mensagem de erro informando o nome do projeto junto com a mensagem de que já existe no OZmap de destino.
Caso o projeto não exista no OZmap de destino, o mesmo é criado com as mesmas informações do OZmap de origem.
Importação dos Usuários
A importação dos usuários OZmap é feita para permitir que os mesmos possam acessar o sistema e, caso tenha integração, ela mantenha sua funcionalidade sem erros.
O usuário no OZmap é dependente dos papéis no campo configurações do OZmap, com isso, caso seja escolhido importar usuários, os papéis também serão importados obrigatoriamente.
Caso o papel já exista no OZmap destino, ele não sofrerá alterações, caso não exista, o mesmo é criado com as mesmas permissões do OZmap de origem.
A importação dos usuários ocorre da seguinte forma:
É feito a busca de todos os usuários existentes no OZmap de origem;
Para cada usuário encontrado, é verificado se o mesmo já foi importado anteriormente. Caso já tenha sido importado, é exibido uma mensagem de erro informando o nome do usuário junto com a mensagem de que já existe no OZmap de destino.
Caso não exista no OZmap de destino, é verificado se o usuário possui e-mail, pois, para criar um usuário via API é obrigatório passar a informação de e-mail. Caso não possua e-mailobrigatório passar a informação de e-mail. Caso não possua e-mail, é exibido uma mensagem de erro informando o nome do usuário junto com a mensagem de que o usuário está sem e-mail e é passado para a importação do próximo usuário.
Com o e-mail validado, é feito a validação da permissão do usuário, caso não exista no OZmap de destino, é exibido uma mensagem de erro informando o nome do usuário junto com a mensagem de que o usuário está sem e-mail a permissão não existe no OZmap de destino e é passado para a importação do próximo usuário.
Com o e-mail validado, é feito a validação da permissão do usuário, caso não exista no OZmap de destino, é exibido uma mensagem de erro informando o nome do usuário junto com a mensagem de que a permissão não existe no OZmap de destino e é passado para a importação do próximo usuário.
Com sucesso na validação de todos os dados, o usuário é criado com as mesmas informações do OZmap de origem.
Configurações Base
Configurações do Sistema
...
Parâmetro
...
Descrição
...
Padrão
...
Importar Configurações Sistema
...
Usar a funcionalidade de importar as configurações do sistema do OZmap de origem, importando os níveis de caixa e cabo apenas.
...
Desativado.
...
Importar Configurações Papeis
...
a importação do próximo usuário.
Com sucesso na validação de todos os dados, o usuário é criado com as mesmas informações do OZmap de origem.
Configurações Base
Configurações do Sistema
Parâmetro | Descrição | Padrão |
|---|---|---|
Importar Configurações Sistema | Usar a funcionalidade de importar as configurações do sistema do OZmap de origem, importando os níveis de caixa e cabo apenas. | Desativado. |
Importar Configurações Papeis | Usar a funcionalidade de importar as configurações dos papéis do OZmap de origem, importando os papéis que ainda não existem no OZmap destino. | Desativado. |
Personalizações
Parâmetro | Descrição | Padrão |
|---|---|---|
Importar Tags | Usar a funcionalidade de importar todas as tags do OZmap de origem para o OZmap destino. | Desativado. |
Importar Cores | Usar a funcionalidade de importar todas as cores do OZmap de origem para o OZmap destino. | Desativado. |
Importar Templates de Caixa | Usar a funcionalidade de importar todos os templates de caixa do OZmap de origem para o OZmap destino. | Desativado. |
Importar Perfis de Fibra | Usar a funcionalidade de importar todos os perfis de fibra do OZmap de origem para o OZmap destino. | Desativado. |
...
Tipos
Parâmetro | Descrição | Padrão |
|---|---|---|
Importar |
Tipos de Postes | Usar a funcionalidade de importar |
todos os postes existentes no OZmap de origem para o OZmap destino. | Desativado. |
Importar |
Tipos de Caixas | Usar a funcionalidade de importar |
todos os tipos de caixas do OZmap de origem |
. Quando essa funcionalidade for ativada, automaticamente a funcionalidade de importar as configurações do sistema e, os templates de caixas serão ativadas também. | Desativado. |
Importar |
Tipos de |
Cabos | Usar a funcionalidade de importar todos os |
tipos de |
cabos do OZmap de origem |
. Quando essa funcionalidade for ativada, automaticamente a funcionalidade de importar as configurações do sistema e, os perfis de fibras serão ativadas também. | Desativado. |
Importar |
Tipos de |
Splitters | Usar a funcionalidade de importar todos os |
tipos de |
splitters do OZmap de origem para o OZmap destino. | Desativado. |
Tipos
Parâmetro | DescriçãoPadrão | |
|---|---|---|
Importar Tipos de PostesOLTs | Usar a funcionalidade de importar todos os postes existentes no tipos de OLTs do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de CaixasDIOs | Usar a funcionalidade de importar todos os tipos de caixas DIOs do OZmap de origem .Quando essa funcionalidade for ativada, automaticamente a funcionalidade de importar as configurações do sistema e, os templates de caixas serão ativadas tambémpara o OZmap destino. | Desativado. |
Importar Tipos de CabosSwitch | Usar a funcionalidade de importar todos os tipos de cabos do OZmap de origem.Quando essa funcionalidade for ativada, automaticamente a funcionalidade de importar as configurações do sistema e, os perfis de fibras serão ativadas tambémtipos de switch do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de SplittersConector | Usar a funcionalidade de importar todos os tipos de splitters conector do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de OLTsFusões | Usar a funcionalidade de importar todos os tipos de OLTs fusões do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de DIOsRegiões | Usar a funcionalidade de importar todos os tipos de DIOs Regiões do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de SwitchPendencias | Usar a funcionalidade de importar todos os tipos de switch pendencias do OZmap de origem para o OZmap destino. | Desativado. |
Geral
Parâmetro | Descrição | Padrão |
|---|---|---|
Importar |
Projetos | Usar a funcionalidade de importar todos |
os projetos ou apenas projetos selecionados do OZmap de origem. Após a finalização da importação de projeto, o resultado será um projeto vazio, com mesmo nome, area, identificador e projetos pai do OZmap de origem |
. | Desativado. |
Importar |
Usuários | Usar a funcionalidade de importar |
usuários do OZmap de origem |
Desativado.
Importar Tipos de Regiões
. Quando essa funcionalidade for ativada, automaticamente a funcionalidade de importar |
Desativado.
Importar Tipos de Pendencias
Usar a funcionalidade de importar todos os tipos de pendencias do OZmap de origem para o OZmap destino.
Desativado.
...
as configurações dos papéis será ativa também. OBS: É necessário informar uma nova senha para todos os usuários que serão importados. | Desativado. | |
Importar Postes | Desativado. |
Dados Acesso
https://docs.google.com/forms/d/1lBM85j4NxaqHEx1yMyKgpgu_NswuCpKZwueqv6USNas/edit
Dados de acesso necessários para buscar informações via API nos sistemas OZmap. (Estes dados devem ser fornecidos no questionário inicial).
OZmap de Destino e Origem
Parâmetro | Descrição |
|---|
Padrão
Importar Projetos
Usar a funcionalidade de importar todos os projetos ou apenas projetos selecionados do OZmap de origem.
Após a finalização da importação de projeto, o resultado será um projeto vazio, com mesmo nome, area, identificador e projetos pai do OZmap de origem.
Desativado.
Importar Usuários
Usar a funcionalidade de importar usuários do OZmap de origem.
Quando essa funcionalidade for ativada, automaticamente a funcionalidade de importar as configurações dos papéis será ativa também.
OBS: É necessário informar uma nova senha para todos os usuários que serão importados.
Desativado.
Importar Postes
Desativado.
Dados Acesso
https://docs.google.com/forms/d/1lBM85j4NxaqHEx1yMyKgpgu_NswuCpKZwueqv6USNas/edit
Dados de acesso necessários para buscar informações via API no sistema OZmap. (Estes dados devem ser fornecidos no questionário inicial).
OZmap de Origem e Destino
Parâmetro | Descrição | Exemplo |
|---|---|---|
Token | Token Exemplo | |
URL OZmap de Destino | Endereço do OZmap que receberá os elementos importados. | |
Token OZmap de Destino | Token associado a conta do usuário de importação cadastrado no OZmap que receberá os elementos importados. (O usuário deve ter acesso aos projetos que a importação irá trabalhar (Escolha do usuário). Tutorial de como gerar usuário/chave.) | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE |
URL OZmap de Origem | Endereço do OZmap que fornecerá os dados para a importação. | |
Token OZmap de Origem | Token associado a conta do usuário de integração importação cadastrado no ozmapOZmap que fornecerá os dados para a importação. (O usuário deve ter acesso aos projetos que a integração importação irá trabalhar (Escolha do usuário). Tutorial de como gerar usuário/chave.) | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE |
...
Dúvidas frequentes
Pergunta | Resposta | Funcionalidade |
|---|---|---|
Alguma das funcionalidades do serviço de importação OZmap é opcional? | Sim. | Todas as funcionalidade funcionalidades do serviço de importação são opcionais, porém, importações de alguns elementos e tipos dependem umas das outras. |