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.
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:
Caixa → Tipos de Caixa → Templates de Caixa
Então, caso seja solicitado, por exemplo, a importação das caixas, a importação dos tipos e os templates também serão importados do OZmap de origem.
A importação ocorre com todos os elementos encontrados no OZmap, tendo um OZmap de Origem (aquele que serão buscados os dados) e um OZmap de Destino (onde serão importados os dados).
Abaixo descreveremos como funciona cada importação, vale lembrar que estamos falando de elementos separadamente, por exemplo, em uma importação de projetos, iremos importar o projeto em si, sem nenhum outro elemento dentro dele.
Resumo das Funcionalidades
Importações de Configurações e Personalizações
Funcionalidade | Descrição |
|---|---|
Importação de Configurações do Sistema | Importar os níveis de POPs, Caixas e Cabos. Necessário para a importação de tipos de pop, tipos de caixa e tipos de cabo. |
Importação de Papéis | Importar os papéis de tipos de usuário. |
Importação de Perfis de Fibra | Importar todos os perfis de fibra que se encontram na aba “personalizações” do OZmap. Necessário para a importação de tipos de cabo. |
Importação de Templates de Caixa | Importar todos os templates de caixa que se encontram na aba “personalizações” do OZmap. Necessário para a importação de tipos de caixa. |
Importação de Cores | Importar todas as cores que se encontram na aba “personalizações” do OZmap. Necessário para a importação de qualquer elemento que possua uma cor diferente do padrão do seu tipo. |
Importação de Tags | Importar todos as tags que se encontram na aba “personalizações” do OZmap. Necessário para replicar as tags aplicadas a elementos do mapa, como clientes, caixas, cabos, postes, entre outros. |
Importações de Tipos
Funcionalidade | Descrição |
|---|---|
Importação de Tipos de Conector | Importar todos os tipos de conector da aba Tipos do OZmap. Necessário para a importação de conectores. |
Importação de Tipos de Pendência | Importar todos os tipos de pendência da aba Tipos do OZmap. Necessário para a importação de pendências. |
Importação de Tipos de Região | Importar todos os tipos de região da aba Tipos do OZmap. Necessário para a importação de regiões. |
Importação de Tipos de Fusão | Importar todos os tipos de fusão da aba Tipos do OZmap. Necessário para a importação de fusões (elemento). |
Importação de Tipos de Switch | Importar todos os tipos de switch da aba Tipos do OZmap. Necessário para a importação de switches. |
Importação de Tipos de OLT | Importar todos os tipos de olt da aba Tipos do OZmap. Necessário para a importação de olts. |
Importação de Tipos de DIO | Importar todos os tipos de dio da aba Tipos do OZmap. Necessário para a importação de dios. |
Importação de Tipos de POP | Importar todos os tipos de pop da aba Tipos do OZmap. Necessário para a importação de pops. |
Importação de Tipos de Splitter | Importar todos os tipos de splitter da aba Tipos do OZmap. Necessário para a importação de splitters. |
Importação de Tipos de Poste | Importar todos os tipos de poste da aba Tipos do OZmap. Necessário para a importação de postes. |
Importação de Tipos de Caixa | Importar todos os tipos de caixa da aba Tipos do OZmap. Necessário para a importação de caixas. |
Importação de Tipos de Cabo | Importar todos os tipos de cabo da aba Tipos do OZmap. Necessário para a importação de cabos. |
Importação de Tipos de Armário | Importar todos os tipos de armário da aba Tipos do OZmap. Necessário para a importação de armários. |
Importações de Elementos
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 Switches | Importar todos ou apenas switches 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 (elemento) de projetos selecionados do OZmap. |
Importação de Pendências | Importar todas ou apenas pendências de projetos selecionados do OZmap. |
Importação de Topologias de caixas | Importar todas ou apenas topologias em caixas de projetos selecionados do OZmap. As topologias de caixas incluem as conexões entre elementos dentro da caixa e a organização visual dos elementos. |
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. |
Importação de Prospects | Importar todos os prospects do OZmap. |
Funcionalidades
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ções de Configurações e Personalizações
A importação de configurações e personalizações do 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 tenham personalizações iguais no OZmap destino. As importações ocorrem da seguinte forma:
Importação de Configurações do Sistema: Sobre as configurações do sistema, são importados os Níveis-POP, Níveis-Caixa e Níveis-Cabo.
Cada nível do OZmap origem será criado no OZmap destino caso ainda não exista um nível de mesmo nome no OZmap destino.
Os níveis importados para o OZmap destino seguirão a hierarquia do OZmap origem, porém serão criados logo a seguir das hierarquias previamente existentes no OZmap destino.
Importação de Papéis: A importação de papéis cria papéis de tipos de usuário do OZmap origem no OZmap destino, caso ainda não exista um papel com mesmo nome.
Importação de Perfis de Fibra: Todos os perfis de fibra do OZmap origem são importados por completo para o OZmap destino, mesmo que já existam um perfil de fibra com mesmo nome e especificações no OZmap destino.
Importação de Templates de Caixa: Todos os templates de caixa do OZmap origem são importados por completo para o OZmap destino, mesmo que já existam um template de caixa com mesmo nome e especificações no OZmap destino.
Importação de Cores: Todas as cores do OZmap origem são importadas por completo para o OZmap destino, mesmo que já existam uma cor com mesmo nome e especificações no OZmap destino.
Importação de Tags: Todas as tags do OZmap origem são importadas por completo para o OZmap destino, mesmo que já existam uma tag com mesmo nome e especificações no OZmap destino.
Importações de Tipos
A importação dos tipos OZmap é feita para permitir que os dados que as utilizam (Cabos, Caixas, Splitters, Postes, Switches 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ções de Elementos
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-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 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
Geral
Parâmetro | Descrição | Padrão |
|---|---|---|
Senha padrão para usuários importados | Senha padrão a ser atribuída para usuários importados do OZmap origem para o OZmap destino. | - |
Configurações e Personalizações
Parâmetro | Descrição | Padrão |
|---|---|---|
Importar Configurações do Sistema | Usar a funcionalidade de importação de configurações do sistema. | Desativado. |
Importação de Papéis | Usar a funcionalidade de importação de papéis de tipos de usuário. | Desativado. |
Importar Perfis de Fibra | Usar a funcionalidade de importação de perfis de fibra. | Desativado. |
Importar Templates de Caixa | Usar a funcionalidade de importação de templates de caixa. | Desativado. |
Importar Cores | Usar a funcionalidade de importação de cores. | Desativado. |
Importar Tags | Usar a funcionalidade de importação de tags. | Desativado. |
Tipos
Parâmetro | Descrição | Padrão |
|---|---|---|
Importar Tipos de Conector | Usar a funcionalidade de importação de tipos de conector. | Desativado. |
Importar Tipos de Pendência | Usar a funcionalidade de importação de tipos de pendência. | Desativado. |
Importar Tipos de Região | Usar a funcionalidade de importação de tipos de região. | Desativado. |
Importar Tipos de Fusão | Usar a funcionalidade de importação de tipos de fusão. | Desativado. |
Importar Tipos de Switch | Usar a funcionalidade de importação de tipos de switch. | Desativado. |
Importar Tipos de OLT | Usar a funcionalidade de importação de tipos de olt. | Desativado. |
Importar Tipos de DIO | Usar a funcionalidade de importação de tipos de dio. | Desativado. |
Importar Tipos de POP | Usar a funcionalidade de importação de tipos de pop. | Desativado. |
Importar Tipos de Splitter | Usar a funcionalidade de importação de tipos de splitter. | Desativado. |
Importar Tipos de Poste | Usar a funcionalidade de importação de tipos de poste. | Desativado. |
Importar Tipos de Caixa | Usar a funcionalidade de importação de tipos de caixa. | Desativado. |
Importar Tipos de Cabo | Usar a funcionalidade de importação de tipos de cabo. | Desativado. |
Importar Tipos de Armário | Usar a funcionalidade de importação de tipos de armário. | Desativado. |
Elementos
Parâmetro | Descrição | Padrão |
|---|---|---|
Importar Postes | Usar a funcionalidade de importação de postes. | Desativado. |
Importar Pontos | Usar a funcionalidade de importação de pontos. | Ativado. |
Importar Projetos | Usar a funcionalidade de importação de projetos. | Ativado. |
Importar Regiões | Usar a funcionalidade de importação de regiões. | Desativado. |
Importar Usuários | Usar a funcionalidade de importação de usuários. | Desativado. |
Importar Caixas | Usar a funcionalidade de importação de caixas. | Desativado. |
Importar Condomínios Verticais | Usar a funcionalidade de importação de condomínios verticais. | Desativado. |
Importar Condomínios Horizontais | Usar a funcionalidade de importação de condomínios horizontais. | Desativado. |
Importar Imóveis e Clientes | Usar a funcionalidade de importação de imóveis e clientes. | Desativado. |
Importar POPs, Armários e OLTs | Usar a funcionalidade de importação de pops, armários e olts. | Desativado. |
Importar Cabos | Usar a funcionalidade de importação de cabos. | Desativado. |
Importar Splitters | Usar a funcionalidade de importação de splitters. | Desativado. |
Importar DIOs | Usar a funcionalidade de importação de dios. | Desativado. |
Importar Switches | Usar a funcionalidade de importação de switches. | Desativado. |
Importar Conectores | Usar a funcionalidade de importação de conectores. | Desativado. |
Importar Fusões | Usar a funcionalidade de importação de fusões (elemento). | Desativado. |
Importar Pendências | Usar a funcionalidade de importação de pendências. | Desativado. |
Importar Topologias de Caixas | Usar a funcionalidade de importação de topologias de caixas. | Desativado. |
Importar Conexões internas de POPs | Usar a funcionalidade de importação de conexões internas de pops. | Desativado. |
Importar Adjacências | Usar a funcionalidade de importação de adjacências. | Desativado. |
Importar Prospects | Usar a funcionalidade de importação de prospects. | 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 | 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 importação cadastrado no OZmap que fornecerá os dados para a importação. (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 |
Dúvidas frequentes
Pergunta | Resposta | Funcionalidade |
|---|---|---|
Alguma das funcionalidades do serviço de importação OZmap é opcional? | Sim. | Todas as funcionalidades do serviço de importação são opcionais, porém, importações de alguns elementos e tipos dependem umas das outras. |
É possível importar somente postes de projetos específicos do OZmap de origem? | Não, atualmente todos os postes são importados para o OZmap destino, independente do projeto selecionado para importação. | Importação de Postes |
É possível importar somente pontos de projetos específicos do OZmap de origem? | Não, atualmente todos os pontos são importados para o OZmap destino, independente do projeto selecionado para importação. | Importação de Pontos |
É possível importar somente regiões de projetos específicos do OZmap de origem? | Não, atualmente todas as regiões são importadas para o OZmap destino, independente do projeto selecionado para importação. | Importação de Regiões |
É possível importar somente tipos de elementos específicos do OZmap de origem? | Não, atualmente todos os tipos dos elementos selecionados serão importados para o OZmap destino, independente de serem usados ou não. | - |
É possível realizar a tradução de tipos do OZmap origem para usar tipos já existentes no OZmap destino? | Não, atualmente não é possível traduzir tipos de elementos, somente importar os tipos originais do OZmap origem para o OZmap destino. | - |
0 Comments