Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 4 Next »

cropped-logo-isp-1-1.png

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

Tipo de Integração

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

Descrição

O ISPGestió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 ocorrem a partir da vinculação de uma rede criada no ISPGestión com um projeto existente no OZmap, e tem como foco principal a criação, cancelamento e conexão de Clientes no OZmap.

Resumo de funcionalidades

Funcionalidade

Descrição

Direção da integração

Criação de Clientes no OZmap

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

ISPGestión => OZmap

Cancelamento de Clientes no OZmap

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

ISPGestión => OZmap

Conexão de Cliente no OZmap

Replica a informação de caixa/porta do equipamente no ISPGestión ao Cliente no OZmap.

ISPGestión => OZmap

Funcionalidades

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

Criação de Clientes no OZmap

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:

  • Para realizar esse vínculo no ISPGestió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ó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 entre um equipmaneto e um nó de rede, o processo para criação do Cliente no OZmap ocorre da seguinte forma:

  • Obrigatoriamente deve ser preenchido no ISPGestió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ón.

  • Após registrar as coordenadas do equipamento no ISPGestión, será possível acessar a aba “OZmap” no seu menu, nesta aba será possível ativar o equipamente ao clicar no botão “Alta equipo”. Ao ativar o equipamente o Cliente será criado no OZmap e será possível visualizar seu ID na aba "OZmap” do ISPGestión.

  • Com o Cliente OZmap já criado e o equipamento ativo no ISPGestió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ón, basta clicar no botão “ALTA DE PROPRIEAD” para que seja criada a propriedade no OZmap. 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

    • O cliente deve remover a propriedade no ISPGestión, no menu do Cliente acessando a aba “OZmap” e clicando no botão “BAJA DE PROPRIEDAD”. Ao realizar isso será desconectado o equipamento no ISPGestión, e a propriedade e o cliente serão removidos no OZmap.

Conexão de Cliente no OZmap

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

Após a seleção das informações de CTO no ISPGestión, os dados serão replicados no OZmap. Consequentemente, 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 OZmap.

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ó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 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

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.