Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Essa documentação trata da integração com o sistema ISPGestión ISP Gestión. A integração é realizada através de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.

Table of Contents
minLevel1
maxLevel7

Tipo de Integração

A integração OZmap-ISPGestión ISP Gestión é do tipo Passiva-direta, desenvolvida pela equipe ISPGestiónISP Gestión.

Descrição

O ISPGestión ISP Gestión é um sistema de Gestão (ERP) focado no controle de rede, servidor radius, controle financeiro e múltiplas opções para gerenciamento dos ISPs.

As funcionalidades desta integração entre OZmap e ISPGestión ISP Gestión ocorrem a partir da vinculação de uma rede criada no ISPGestión ISP Gestión com um projeto existente no OZmap, e . A integração tem como foco principal a criação, conexão e cancelamento e conexão de Clientes clientes no OZmap, garantindo que os dados sejam sincronizados entre os dois sistemas.

Resumo de funcionalidades

Funcionalidade

Descrição

Direção da integração

Vinculação de rede

Vincula um projeto OZmap a uma Rede ISP Gestión.

-

Criação de Clientes no OZmap

Criação de Clientes no OZmap, com base na ativação do equipamento no ISPGestiónISP Gestión.

ISPGestión ISP Gestión => OZmap

Cancelamento de Clientes no OZmap

Remoção de clientes no OZmap, através do cancelamento de ou desligamento do equipamento no ISPGestiónISP Gestión.

ISPGestión ISP Gestión => OZmap

Conexão de Cliente Atualização de Caixa, Splitter e Porta de Clientes no OZmap

Replica a informação de caixaCaixa/Splitter/porta Porta do equipamente no ISPGestión ISP Gestión ao Cliente no OZmap.

ISPGestión ISP Gestión => OZmap

Funcionalidades

Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.

...

Vinculação de

...

A criação de Clientes no OZmap a partir do ISPGestión requer, inicialmente, que um equipamento esteja vinculado a um nó de rede no ISPGestión. No contexto do ISPGestión, um nó de rede é uma localização específica dentro de uma rede que pode abrigar diversos equipamentos. Por exemplo, em uma rede de fibra óptica, um nó pode ser um Centro de Processamento de Dados (CPD), onde estão localizados roteadores, switches e a OLT. Em outro cenário, um nó pode ser uma torre que contém múltiplos pontos de acesso (APs).

Para que a criação de um Cliente no OZmap seja possível, o nó de rede no ISPGestión deve estar vinculado a uma rede que, por sua vez, esteja associada a um projeto no OZmap. Esse vínculo entre a rede do ISPGestión e o projeto OZmap pode ser realizado durante a criação da rede no ISPGestión, onde é possível selecionar o projeto OZmap ao qual a rede será vinculada. Alternativamente, é possível editar uma rede já existente no ISPGestión para vinculá-la a um projeto OZmap.

Após garantir que no ISPGestión o nó de rede esteja devidamente vinculado a uma rede associada a um projeto OZmap, o próximo passo é vincular esse nó a um equipamento. A seguir, o passo a passo para realizar essas ações:

...

Rede

Essa funcionalidade é resposável para realizar a vinculação de uma rede ISP Gestión a um Projeto OZmap. Esse vínculo garante que o PON (nodo de red) no ISP Gestión esteja associado corretamente ao ambiente de rede configurado no OZmap.

Existem duas formas de realizar esse vínculo:

  1. Durante a criação da rede no ISP Gestión:

    • Ao criar uma nova rede no ISP Gestión, pode ser selecionado o projeto OZmap ao qual essa rede será vinculada.

  2. Editando uma rede existente no ISP Gestión:

    • Caso a rede já tenha sido criada, é possível editá-la para vinculá-la ao projeto OZmap correspondente.

Passo a passo para vincular uma rede ao projeto OZmap no ISP Gestión:

  1. Acesse o menu relacionado às conexões no ISP Gestión.

  2. Na aba "Redes", dentro da seção "Dados generales", selecione a rede que será vinculada ao projeto OZmap.

  3. Certifique-se de que o PON (nodo de red) no ISP Gestión foi vinculado a essa rede, para que as conexões futuras sejam registradas corretamente no OZmap.

Após garantir que a rede está vinculada a um projeto no OZmap e que o PON está configurado corretamente, será possível prosseguir com a vinculação de equipamentos e, posteriormente, com a criação de Clientes no OZmap.

Criação de Clientes no OZmap

A criação de Clientes no OZmap a partir do ISP Gestión depende da configuração prévia de um equipamento vinculado a um PON no ISP Gestión, o qual já deve estar associado a uma rede vinculada ao projeto OZmap.

  • Para realizar esse vínculo no ISP Gestión, abra o menu referente a conexão e na aba "Redes", dentro da seção "Dados generales", selecione a rede que foi vinculada ao projeto OZmap.

  • Após isso, ainda no ISPGestiónISP Gestión, deve ser realizado o vínculo do equipamento a essa nó de rede que foi vinculada a rede correspondente ao projeto OZmap. Para realizar esse vínculo, abra o menu do Cliente, acesse a aba “General” e na seção “Rede” selecione a conexão que foi vinculada a rede OZmap.

Após realizar esse vínculo no ISPGestión ISP Gestión entre um equipmaneto equipamento e um nó de redePON, o processo para criação do Cliente no OZmap ocorre da seguinte forma:

  • Obrigatoriamente deve ser preenchido no ISPGestión ISP Gestión as coordeandas de instalação do equipamento, no menu do equipamento na aba “Datos instalación", na seção “COORDENADAS DE INSTALACIÓN", para que ao realizar a criação do Cliente no OZmap o mesmo seja criado nas coordenadas registradas no ISPGestiónISP Gestión.

  • Após registrar as coordenadas do equipamento no ISPGestiónISP Gestión, será possível acessar a aba “OZmap” no seu menu, nesta aba será possível ativar o equipamente a partir do “Alta equipo”. Ao ativar o equipamente o Cliente será criado no OZmap e será possível visualizar seu ID na aba "OZmap” do ISPGestiónISP Gestión (o vínculo entre entre os Clientes de cada sistema se dará pelo ID do cliente OZmap armazenado no ISP Gestión).

  • Com o Cliente OZmap já criado e o equipamento ativo no ISPGestiónISP Gestión, será possível realizar a criação de sua propriedade no OZmap, com isso, na mesma aba "OZmap” no menu do equipamento no ISPGestiónISP Gestión, a partir do botão “ALTA DE PROPRIEAD”. Ao ser criada a propriedade, também será possível visualizar seu ID nessa mesma aba.

Cancelamento de Clientes no OZmap

Remoção do Cliente no OZmap pode ocorrer de duas formas:

...

Removendo apenas a propriedade no OZmap

  • Ao desligar o equipamento do cliente no ISPGestión, a propriedade será removida do OZmap mantendo apenas o cliente.

Removendo a proprieadede e o cliente no OZmap

...

A remoção de Clientes e Propriedades no OZmap ocorre a partir das ações realizadas no ISP Gestión. Existem duas opções disponíveis, cada uma com impactos específicos:

  • Desativando a Propriedade no ISP Gestión

    • No menu do Cliente, ao acessar a aba "OZmap", estará disponível a opção "BAJA DE PROPRIEDAD". Ao acioná-la, o equipamento será desconectado no ISP Gestión. Consequentemente, a Propriedade e o Cliente serão identificados no OZmap por meio de seus respectivos IDs e removidos do sistema.

  • Desvinculando o equipmaneto da Proprieade no ISP Gestión

    • Utilizando a opção “Baja de equipo” no menu do Cliente, o equipamento será desvinculado da Propriedade no ISP Gestión. Essa ação resulta na remoção automática do Cliente com ID correspondente no OZmap, mas a Proprieade permanecerá existindo no OZmap.

Conexão de Cliente no OZmap

Quando um equipamento no ISPGestión ISP Gestión está vinculado a um Cliente e a uma Propriedade no OZmap, é possível associar uma Caixa e uma Porta a esse equipamento a partir do ISPGestióndiretamente no ISP Gestión. Durante a edição das informações de CTO no ISPGestión, o sistema exibirá, pelo nome, todas as Caixas disponíveis no OZmap. Ao selecionar uma dessas Caixas, serão listados os Splitters correspondentes e as portas disponíveis serão mostrados para seja possível escolher a Portas disponíveis, permitindo a escolha da conexão desejada.

Após a seleção das , as informações de CTO no ISPGestión, os dados serão replicados no OZmap. Consequentemente, configuradas no ISP Gestión serão automaticamente sincronizadas com o OZmap, conectando a Propriedade vinculada ao equipamento será conectada automaticamente à Caixa, ao Splitter , e à Porta selecionados no ISPGestión. Com a conexão já estabelecida no OZmap, nos dados de CTO no ISPGestión também será possível visualizar o valor do sinal de potência a partir das informações do OZmapespecificados.

Dados Acesso

Dados de acesso necessários para as operações realizadas pelo integrador são:

Saiba mais como configurar esses dados acionando o suporte do ISPGestiónISP Gestión.

OZmap

Parâmetro

Descrição

Exemplo

API URL

Endereço da API OZmap

https://cliente.ozmap.com.br:9994/api/v2

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

Liberação de IPs

Caso o servidor OZmap esteja em ambiente ON-Premisses, é necessário liberar nos firewalls o IP do servidor onde está o ISPGestión ISP Gestión para acessar as portas 80 e 9994 no ambiente do OZmap.

Caso seu servidor seja hospedado pelo OZmap, essas portas já estarão liberadas para o integrador.

Questionário

Pergunta

Resposta

Funcionalidade

...