...
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:
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
Configurações e Personalizações
...
Funcionalidade
...
Descrição
...
Importação de Configurações do Sistema
...
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:
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 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 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 a importação de tipos de cabo.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 |
Tipos
Funcionalidade | Descrição |
|---|---|
a importação de regiões. | |
Importação de Tipos de ConectorFusão | Importar todos os tipos de conector fusão da aba Tipos do OZmap. Necessário para a importação de conectoresfusões (elemento). |
Importação de Tipos de PendênciaSwitch | Importar todos os tipos de pendência switch da aba Tipos do OZmap. Necessário para a importação de pendênciasswitches. |
Importação de Tipos de RegiãoOLT | Importar todos os tipos de região olt da aba Tipos do OZmap. Necessário para a importação de regiõesolts. |
Importação de Tipos de FusãoDIO | Importar todos os tipos de fusão dio da aba Tipos do OZmap. Necessário para a importação de fusões (elemento)dios. |
Importação de Tipos de SwitchPOP | Importar todos os tipos de switch pop da aba Tipos do OZmap. Necessário para a importação de switchespops. |
Importação de Tipos de OLTSplitter | Importar todos os tipos de olt splitter da aba Tipos do OZmap. Necessário para a importação de oltssplitters. |
Importação de Tipos de DIOPoste | Importar todos os tipos de dio poste da aba Tipos do OZmap. Necessário para a importação de diospostes. |
Importação de Tipos de POPCaixa | Importar todos os tipos de pop caixa da aba Tipos do OZmap. Necessário para a importação de popscaixas. |
Importação de Tipos de SplitterCabo | Importar todos os tipos de splitter cabo da aba Tipos do OZmap. Necessário para a importação de splitterscabos. |
Importação de Tipos de PosteArmário | Importar todos os tipos de poste armário da aba Tipos do OZmap. Necessário para a importação de postesarmá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. |
Necessário para a importação de cabos.
Importação de |
Projetos | Importar todos |
Necessário para a importação de armários.
Elementos
Funcionalidade | Descrição | ||
|---|---|---|---|
Importação de Postes | Importar todos os postes 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 um poste uma região com mesmo nome e tipo no OZmap destino, o poste a região não será importadoimportada, devido ao OZmap não permitir postes com nomes regiões repetidas com nome e tipo iguais. | ||
Importação de PontosUsuários | Importar todos os pontos usuários 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 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 RegiõesCaixas | 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 iguaisou apenas caixas de projetos selecionados do OZmap. | ||
Importação de UsuáriosCondomínios Verticais | Importar todos os usuários ou apenas condomínios verticais de projetos selecionados 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 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 Condomínios VerticaisSplitters | Importar todos ou apenas condomínios verticais splitters de projetos selecionados do OZmap. | ||
Importação de Condomínios HorizontaisDIOs | Importar todos ou apenas condomínios horizontais dios de projetos selecionados do OZmap. | ||
Importação de Imóveis e ClientesSwitches | Importar todos ou apenas propriedades e clientes switches de projetos selecionados do OZmap. | ||
Importação de POPs, Armários e OLTsConectores | Importar todos ou apenas pops, armário e olts conectores de projetos selecionados do OZmap. | ||
Importação de CabosFusões | Importar todos todas ou apenas cabos fusões (elemento) de projetos selecionados do OZmap. | ||
Importação de SplittersPendências | Importar todos todas ou apenas splitters pendências de projetos selecionados do OZmap. | ||
Importação de Topologias de DIOscaixas | Importar todos todas ou apenas dios 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 SwitchesConexões Internas de POPs | Importar todos todas ou apenas switches conexões internas em pops de projetos selecionados do OZmap. | ||
Importação de ConectoresAdjacências | Importar todos ou apenas conectores de projetos selecionados as adjacências do OZmap. | ||
Importação de FusõesProspects | Importar todas ou apenas fusões (elemento) de projetos selecionados todos os prospects 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çã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.
...
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. |
...