...
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
...
Importar os níveis de POPs, Caixas e Cabos.
Necessário para a importação de tipos de pop, tipos de caixas e tipos de cabos.
...
Importação de Papéis
...
Importar os papéis de tipos de usuários.
...
Importação de Perfis de Fibra
...
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 | 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. |
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. |
Importação de Tipos de |
Switch | Importar todos |
os tipos de switch da aba Tipos do OZmap. Necessário para |
Tipos
Funcionalidade | Descrição |
|---|---|
a importação de switchs. | |
Importação de Tipos de ConectoresOLT | Importar todos os tipos de conectores olt da aba Tipos do OZmap. Necessário para a importação de conectoresolts. |
Importação de Tipos de PendênciasDIO | Importar todos os tipos de pendências dio da aba Tipos do OZmap. Necessário para a importação de pendênciasdios. |
Importação de Tipos de RegiõesPOP | Importar todos os tipos de regiões pop da aba Tipos do OZmap. Necessário para a importação de regiõespops. |
Importação de Tipos de FusõesSplitter | Importar todos os tipos de fusões splitter da aba Tipos do OZmap. Necessário para a importação de fusõessplitters. |
Importação de Tipos de SwitchsPoste | Importar todos os tipos de switchs poste da aba Tipos do OZmap. Necessário para a importação de switchspostes. |
Importação de Tipos de OLTsCaixa | Importar todos os tipos de olts caixa da aba Tipos do OZmap. Necessário para a importação de oltscaixas. |
Importação de Tipos de DIOsCabo | Importar todos os tipos de dios cabo da aba Tipos do OZmap. Necessário para a importação de dioscabos. |
Importação de Tipos de POPsArmário | Importar todos os tipos de pops armário da aba Tipos do OZmap. Necessário para a importação de pops.armários. |
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 |
Necessário para a importação de caixas.
Importação de Tipos de Cabos
Importar todos os tipos de cabos da aba Tipos do OZmap.
Necessário para a importação de cabos.
Importação de Tipos de Armários
Importar todos os tipos de armários da aba Tipos do OZmap.
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 iguaisregiõ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 PontosCaixas | Importar todos os pontos todas ou apenas caixas de projetos selecionados do OZmap. | |
Importação de ProjetosCondomínios Verticais | Importação de Caixas | Importar todos ou apenas condomínios verticais de 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. | |
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 Splitters | Importar todos ou apenas splitters de projetos selecionados do OZmap. | |
Importação de Condomínios VerticaisDIOs | Importar todos ou apenas condomínios verticais dios de projetos selecionados do OZmap. | |
Importação de Condomínios HorizontaisSwitchs | Importar todos ou apenas condomínios horizontais switchs de projetos selecionados do OZmap. | |
Importação de Imóveis e ClientesConectores | Importar todos ou apenas propriedades e clientes conectores de projetos selecionados do OZmap. | |
Importação de POPs, Armários e OLTsde Fusões | Importar todos todas ou apenas pops, armário e olts fusões de projetos selecionados do OZmap. | |
Importação de CabosPendências | Importar todos todas ou apenas cabos pendências de projetos selecionados do OZmap. | |
Importação de Splittersde Topologia de caixas (conexões e organização interna) | Importar todos todas ou apenas splitters topologias em caixas de projetos selecionados do OZmap. | |
Importação de DIOsConexões Internas de POPs | Importar todos todas ou apenas dios conexões internas em pops de projetos selecionados do OZmap. | |
Importação de SwitchsAdjacências | 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. |
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;
...
as adjacências 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.
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 tag caixa 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.
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 template da caixa projeto junto com a mensagem de que não já existe no OZmap de destino e é passado para o próximo tipo de caixa.
Caso o template projeto não exista no OZmap de destino, o tipo de caixa mesmo é criado com as mesmas informações do OZmap de origem.
Importação dos
...
Usuários
A importação dos projetos usuários 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;
...
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 ja já foi importado anteriormente. Caso já tenha sido importado, é exibido uma mensagem de erro informando o nome do projeto usuário 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 importadonã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 já a permissão não 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
...
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 |
|---|---|---|
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. |
Personalizações
Parâmetro
Descrição
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. |
Tipos
Parâmetro | Descrição | Padrão|
|---|---|---|
Importar Tipos de PostesDIO | Usar a funcionalidade de importar todos os postes existentes no OZmap de origem para o OZmap destinode importação de tipos de dio. | Desativado. |
Importar Tipos de CaixasPOP | 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émimportação de tipos de pop. | Desativado. |
Importar Tipos de Splitter | Usar a funcionalidade de importação de tipos de splitter. | Desativado. |
Importar Tipos de CabosPoste | 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émimportação de tipos de poste. | Desativado. |
Importar Tipos de Caixa | Usar a funcionalidade de importação de tipos de caixa. | Desativado. |
Importar Tipos de SplittersCabo | Usar a funcionalidade de importação de importar todos os tipos de splitters do OZmap de origem para o OZmap destinocabo. | Desativado. |
Importar Tipos de OLTsArmário | Usar a funcionalidade de importação de importar todos os tipos de OLTs do OZmap de origem para o OZmap destino.tipos de armário. | Desativado. |
Elementos
Parâmetro | Descrição | Padrão |
|---|---|---|
Importar Postes | Desativado. | |
Importar Pontos | Desativado. | |
Importar Projetos | Desativado. | |
Importar Regiões | Desativado. | |
Importar Usuários | Desativado. | |
Importar Caixas | Desativado. | |
Importar Condomínios Verticais | Desativado. | |
Importar Condomínios Horizontais | Desativado. | |
Importar |
Desativado. | ||
Importar | Desativado. | |
Importar |
Desativado. | ||
Importar | Desativado. | |
Importar |
Desativado. | ||
Importar | Desativado. | |
Importar |
Usar a funcionalidade de importar todos os tipos de fusões do OZmap de origem para o OZmap destino.
Desativado. | ||
Importar | Desativado. | |
Importar |
Usar a funcionalidade de importar todos os tipos de Regiões do OZmap de origem para o OZmap destino.
Desativado. | ||
Importar | Desativado. | |
Importar |
Usar a funcionalidade de importar todos os tipos de pendencias do OZmap de origem para o OZmap destino.
Desativado.
Geral
Parâmetro | Descrição | PadrãoDesativado. | ||
|---|---|---|---|---|
Importar | Desativado. | |||
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
...