Este documento tem como objetivo apresentar as principais informações sobre a importação de dados do OZmap para o 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á buscado as informações) e um OZmap de Destino (onde serão criados as informações)
Obs: Abaixo descreveremos como funciona cada importação, vale lembrar que estamos falando de um elemento, por exemplo, em uma importação de projetos, iremos importar o projeto, sem nenhum elemento dentro dele.
Resumo das Funcionalidades
Personalizações
Funcionalidade | Descrição |
|---|---|
Importação dos Perfis de Fibra | Importar todos os perfis de fibra que se encontram na aba “personalizações” do OZmap. O perfil de fibra é utilizado nos tipos de cabos, que posteriormente é utilizado na criação de cabos. |
Importação dos Templates de Caixa | Importar todos os templates de caixa que se encontram na aba “personalizações” do OZmap. O template de caixa é utilizado nos tipos de caixas, que posteriormente é utilizado na criação das caixas. |
Importação das Cores | Importar todas as cores que se encontram na aba “personalizações” do OZmap. A cor é utilizada nas pendências dentro do projeto OZmap. |
Importação das Tags | Importar todos as tags que se encontram na aba “personalizações” do OZmap. A tag é utilizada nos imóveis, postes, clientes e diversos outros elementos dentro do OZmap. |
Tipos
Funcionalidade | Descrição |
|---|---|
Importação dos Tipos de Postes | Importar todos os tipos de postes da aba Tipos do OZmap. O tipo de poste é utilizado na criação de postes dentro do projeto OZmap. |
Importação dos Tipos de Caixas | Importar todos os tipos de caixas da aba Tipos do OZmap. O tipo de caixa é utilizado na criação de caixas dentro do projeto OZmap. |
Importação dos Tipos de Cabos | Importar todos os tipos de cabos da aba Tipos do OZmap. O tipo de cabo é utilizado na criação de cabos dentro do projeto OZmap. |
Importação dos Tipos de Splitters | Importar todos os tipos de splitters da aba Tipos do OZmap. O tipo de splitter é utilizado na criação de splitters dentro do projeto OZmap. |
Importação dos Tipos de OLTs | Importar todos os tipos de olts da aba Tipos do OZmap. O tipo de olt é utilizado na criação de olts dentro do projeto OZmap. |
Importação dos Tipos de DIOs | Importar todos os tipos de dios da aba Tipos do OZmap. O tipo de dio é utilizado na criação de dio dentro do projeto OZmap. |
Importação dos Tipos de Switchs | Importar todos os tipos de switchs da aba Tipos do OZmap. O tipo de switch é utilizado na criação de switch dentro do projeto OZmap. |
Importação dos Tipos de Conectores | Importar todos os tipos de conectores da aba Tipos do OZmap. O tipo de conector é utilizado na criação de conectores dentro do projeto OZmap. |
Importação dos Tipos de Fusões | Importar todos os tipos de fusões da aba Tipos do OZmap. O tipo de fusão é utilizado na criação de fusões dentro do projeto OZmap. |
Importação dos Tipos de Regiões | Importar todos os tipos de regiões da aba Tipos do OZmap. O tipo de região é utilizado na criação de regiões dentro do projeto OZmap. |
Importação dos Tipos de Pendências | Importar todos os tipos de pendencias da aba Tipos do OZmap. O tipo de pendencia é utilizado na criação de pendências dentro do projeto OZmap. |
Projetos, Usuários e Postes
Funcionalidade | Descrição |
|---|---|
Importação dos Projetos | Importar todos ou apenas projetos exclusivos do OZmap. O projeto será importado sem nenhum elemento dentro dele, será apenas um projeto vazio com as configurações de area e projeto pai idênticas do OZmap de origem. |
Importação dos 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 Postes | Importar todos os postes do OZmap. Todos os postes disponíveis no OZmap serão importados, porém, caso haja um poste no OZmap origem com o mesmo nome no OZmap destino, o mesmo não será importado, devido o OZmap não permitir postes com nomes iguais. |
Funcionalidades
Abaixo serão descritas as funcionalidades do serviço de importação OZmap, apresentadas no resumo para 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-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
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. |
Importar Tipos de OLTs | Usar a funcionalidade de importar todos os tipos de OLTs do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de DIOs | Usar a funcionalidade de importar todos os tipos de DIOs do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de Switch | Usar a funcionalidade de importar todos os tipos de switch do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de Conector | Usar a funcionalidade de importar todos os tipos de conector do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de Fusões | Usar a funcionalidade de importar todos os tipos de fusões do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de Regiões | Usar a funcionalidade de importar todos os tipos de Regiões do OZmap de origem para o OZmap destino. | Desativado. |
Importar Tipos de Pendencias | 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ã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 associado a conta do usuário de integração cadastrado no ozmap. (O usuário deve ter acesso aos projetos que a integração irá trabalhar (Escolha do usuário). Tutorial de como gerar usuário/chave.) | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE |
Questionário
Pergunta | Resposta | Funcionalidade |
|---|---|---|
Alguma das funcionalidades do serviço de importação OZmap é opcional? | Sim. | Todas as funcionalidade do serviço de importação são opcionais. |
0 Comments