Open

Tipo de Integração

A integração OZmap-INT6 é do tipo Híbrida.

Descrição

O INT6 é um sistema de monitoramento e provisionamento de equipamentos GPON, bem com suporte para redes neutras.

A integração OZmap x INT6 é feita em duas direções e via API, com o OZmap buscando informações de potência do INT6 e INT6 buscando informações de rede do OZmap.

OBS: Por padrão, o gpon_client_id no INT6 deve ser igual ao “código” do cliente no OZmap para ser encontrado e tratado pelos dois lados da integração, sendo necessariamente, um valor numérico. Porém, também é possível usar o pppoe_username do INT6 como código, via configuração específica, devendo ser ajustado nos dois lados da integração (OZmap e INT6).

Resumo das funcionalidades - Serviço de integração OZmap

Resumo das funcionalidades - Serviço de integração INT6

Serviço de integração OZmap

Funcionalidades

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

Atualização de Status de Conexão dos Clientes OZmap

Sincronização dos status de conexão dos clientes INT6 existentes no OZmap:

• São lidos todos os clientes OZmap;

• É feita a busca de clientes no INT6 de acordo com o parâmetro “Código INT6 a ser considerado na integração”, ocorrendo da seguinte forma:

  • Caso seja o gpon_client_id:

    • Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;

  • Case seja o pppoe_username:

    • Para cada cliente OZmap, é buscado um cliente com “pppoe_username” igual no INT6;

  • Caso seja o circuit_id_integration:

    • Para cada cliente OZmap, é buscado um cliente com “circuit_id_integration" igual no INT6;

• Para cada cliente OZmap encontrado no INT6 que possua algum valor de potência, é feito o seguinte tratamento:

  • Se a nova potência do INT6 for um valor numérico positivo ou negativo, o status de conexão do cliente no OZmap é atualizado para OK;

  • Se a nova potência for zero ou textual, o status de conexão é atualizado para ERROR no OZmap;

Atualização de Potência dos Clientes OZmap

Sincronização de potência dos clientes INT6 existentes no OZmap:

• São lidos todos os clientes OZmap;

• É feita a busca de clientes no INT6 de acordo com o parâmetro “Código INT6 a ser considerado na integração”, ocorrendo da seguinte forma:

  • Caso seja o gpon_client_id:

    • Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;

  • Case seja o pppoe_username:

    • Para cada cliente OZmap, é buscado um cliente com “pppoe_username” igual no INT6;

• Para cada cliente OZmap encontrado no INT6 que possua algum valor de potência, é feito o seguinte tratamento:

  • Se a potência do cliente no INT6 divergir da potência no cliente OZmap (considerando o parâmetro “Limite de alteração de potência“), é atualizado o campo de potência lida da ONU no OZmap com o valor encontrado no INT6. Abaixo uma tabela exemplificando os casos de atualização de potência, considerando o “Limite de alteração de potência“ sendo 0.5:

Atualização do Estado de Implantação dos Clientes OZmap

Sincronização dos status de conexão dos clientes INT6 existentes no OZmap:

• São lidos todos os clientes OZmap;

• É feita a busca de clientes no INT6 de acordo com o parâmetro “Código INT6 a ser considerado na integração”, ocorrendo da seguinte forma:

  • Caso seja o gpon_client_id:

    • Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;

  • Case seja o pppoe_username:

    • Para cada cliente OZmap, é buscado um cliente com “pppoe_username” igual no INT6;

• Para cada cliente OZmap encontrado no INT6 que possua algum valor de potência, é feito o seguinte tratamento:

  • Se a nova potência for um valor numérico positivo ou negativo, e o cliente estiver como “não implantado” no OZmap, o estado de implantação dele é mudado para “implantado” no OZmap.

Atualização dos Dados da ONU OZmap

Atualização dos dados da ONU OZmap com base na leitura da ONU do INT6:

• São lidos todos os clientes OZmap;

• É feita a busca de clientes no INT6 de acordo com o parâmetro “Código INT6 a ser considerado na integração”, ocorrendo da seguinte forma:

  • Caso seja o gpon_client_id:

    • Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;

  • Case seja o pppoe_username:

    • Para cada cliente OZmap, é buscado um cliente com “pppoe_username” igual no INT6;

• Para cada cliente OZmap encontrado no INT6 que possua algum valor de potência, é feito o seguinte tratamento:

  • É verificado se há divergência entre os dados de serial number, user pppoe e mac address no OZmap e no INT6, e havendo divergência, os dados da ONU no OZmap são atualizados com as informaçoes encontradas no INT6;

    • Nessa atualização de dados, é possível habilitar a configuração de utilizar no OZmap o short serial number do INT6, ao invés do serial number completo;

Configurações Base OZmap

Configurações Específicas OZmap

Dados Acesso - Serviço de integração OZmap

https://docs.google.com/forms/d/1Ma6wF8XOaeKOSetxfbcR0Qkv6N4iJ4CAraxyyZpj2-0/edit

INT6

Dados de acesso necessários para buscar informações via API no sistema INT6. (Estes dados devem ser fornecidos no questionário inicial)

OZmap

Liberação de IPs

Para validação e execução da integração no ambiente de produção, é necessário serem liberados no servidor do cliente os IPs utilizados pelo OZmap:

• Servidor OZmap do cliente (ping cliente.ozmap.com.br)

Logs

No momento a integração OZmap INT6 não possui logs.

Serviço de integração INT6

Funcionalidades INT6

Abaixo serão descritas as funcionalidades do INT6, apresentadas no resumo para entender como funciona o fluxo das funcionalidades.

Consulta de Potência Calculada do Cliente OZmap

A consulta de informações de potência do cliente OZmap é realizado na seguinte forma:

• No momento do provisionamento, INT6 busca no OZmap as informações de potência calculada, slot, pon e olt do cliente;

• Essa potência calculada do OZmap é comparada com a potência lida da ONU no INT6, e caso a diferença seja maior que o limite definido no INT6, essa ativação não é autorizada;

Consultar CTOs OZmap Disponíveis para Provisionamento

A consulta das CTOs OZmap disponíveis para realizar provisionamento é dada da seguinte forma:

• A partir da coordenada do cliente no INT6, é feito uma consulta no OZmap por splitters de CTOs e condomínios próximos ao cliente no OZmap;

• Uma lista de splitters OZmap disponíveis é exibida para ser escolhido para realizar provisionamento da ONU no INT6;

Ativação e Atualização dos Dados do Cliente no OZmap

A atualização de dados dos clientes no OZmap é feito da seguinte forma:

• No momento do provisionamento, é buscado um cliente no OZmap com código igual ao gpon_client_id, pppoe_username ou circuit_id_integration da ONU no INT6 (dependendo de como estiver configurado no serviço INT6);

• Se o cliente for encontrado no OZmap, os dados de CTO, splitter, porta e coordenada são atualizados no OZmap com base nos dados definidos na hora do provisionamento no INT6;

• Caso o estado de implantação do cliente esteja como “não implantado” no OZmap, é atualizado para “implantado”;

Criar Cliente no OZmap

A criação de clientes no OZmap é dada da seguinte forma:

• No momento do provisionamento, é buscado um cliente no OZmap com código igual ao gpon_client_id ou pppoe_username da ONU no INT6 (dependendo de como estiver configurado no serviço INT6);

• Se o cliente não for encontrado no OZmap, é feita a criação de um novo cliente no OZmap, com os dados de CTO, splitter, porta e coordenadas definidos na hora do provisionamento no INT6;

• O cliente é criado no OZmap já com o estado de implantação “implantado”

Cancelar Cliente no OZmap

O cancelamento de clientes no OZmap é dado da seguinte forma:

• No momento do desprovisionamento de um cliente no INT6, é buscado um cliente no OZmap com código igual ao gpon_client_id ou pppoe_username da ONU no INT6 (dependendo de como estiver configurado no serviço INT6);

• Se o cliente for encontrado no OZmap, o INT6 remove o cliente por completo do OZmap (cliente, imóvel e drop são excluídos).

Sincronização de Caixas

A sincronização de caixas no INT6 é dada da seguinte forma:

• O INT6 busca OLTs OZmap com etiqueta OZmap igual ao ID de integração da OLT INT6

• A partir destas OLTs, são buscadas todas as caixas, splitters e suas conexões.

• A partir de todas as conexões de cada OLT, é preparado uma árvore de elementos relacionados a esta, que é então retornada ao INT6 para processamento e atualização de dados.

Sanitização de Caixas

A sanitização de Caixas é um procedimento realizado por técnicos em campo utilizando o aplicativo móvel do INT6. Esse processo garante a correta identificação e atualização das informações das CTOs refletindo essas alterações no OZmap para manter a consistência dos dados entre os sistemas.

A seguir, detalhamos o fluxo no aplicativo do INT6, as etapas envolvidas na sanitização e a forma como as alterações são replicadas para o OZmap.

Etapas do Processo:

• Acesso à Funcionalidade:

  • Se da início ao processo acessando a opção "Sanitização" no app do INT6.

• Localização de CTOs:

  • A busca pelas CTOs ocorre com base na geolocalização do dispositivo móvel. Por padrão é realizado uma consulta no OZmap para encontrar Caixas que não estejam em projeto e possuem Splitters de atendimento dentro de um raio de 300 metros, sendo esse valor configurável conforme a necessidade do cliente.

  • As CTOs encontradas podem ser exibidas de duas formas:

    • Lista: Exibe as CTOs com informações como nome, ocupação e OLT associada.

    • Mapa: Apresenta as CTOs em um mapa interativo, permitindo a seleção visual.

• Detalhes da CTO:

  • Ao selecionar uma CTO, é exibido um página de detalhes da CTO com as informações obtidas do OZmap, que incluem:

    • Nome da CTO

    • Quantidade total de portas

    • Ocupação (número de portas em uso)

    • OLT (Optical Line Termination) associada

    • PON link (Passive Optical Network link)

  • Nessa página é possível editar as seguintes informações da CTO, e que caso alteradas serão replicadas ao OZmap:

    • Nome

    • Observações

    • Localização (coordenadas)

• Detalhes das portas da CTO:

  • Além das informações gerais da CTO também é listado suas respectivas portas, exibindo as seguintes informações para cada porta:

    • ERP_ID (código do cliente OZmap conectado a porta)

    • Serial (Número de Série da ONU, se aplicável)

    • Status atual (ex: Em Uso, Cabo Danificado, Disponível, Sanitizada)

    • Informações adicionais: Assinante associado (se houver), PON link, ONU, OLT, endereço e observações.

• Ações de Sanitização das Portas:

  • Ao selecionar uma porta específica, pode ser realizada diversas ações de sanitização nas portas de uma CTO:

    • Auto Detecção: Inicia um processo de detecção automática da ONU conectada à porta. O aplicativo do INT6 guia o técnico através de um passo a passo para identificar as informações da ONU, e com isso por meio dos dados GPON/localização é estimada a porta mais provável.

    • Vincular Manualmente: Permite a vinculação manual de um assinante à porta, digitando o número do contrato ou as informações da ONU.

    • Disponível: Marca a porta como disponível para uso.

    • Cabo Desconhecido: Indica que há um cabo conectado à porta, mas a ONU não pode ser identificada (possivelmente desligada ou desconectada).

    • Danificada: Marca a porta como danificada e inutilizável.

    • Bloqueada: Indica que a porta está bloqueada e não pode ser usada.

    • Adicionar Observações: Permite adicionar ou editar observações relevantes sobre a porta.

    • Reservada: Indica que a porta está reservada para um assinante específico.

    • Não Sanitizada: Retorna a porta para o status "Não Sanitizada", revertendo qualquer ação de sanitização anterior.

• Confirmação e Sincronização com OZmap:

  • Após a execução de uma ação de sanitização, o aplicativo exibe uma página de confirmação com os detalhes da alteração. Ao confirmar, o sistema realiza uma chamada para o OZmap, garantindo que a modificação seja replicada corretamente.

  • Cada status atribuído a uma porta no aplicativo corresponderá a uma TAG específica no OZmap. Por exemplo:

    • Ao marcar uma porta como "Disponível", uma TAG "Disponível" será adicionada à porta no OZmap.

    As TAGs utilizadas são definidas e criadas no OZmap pelo INT6 e tem como objetivo garantir a correta identificação do status de cada porta. Segue exemplo do nome de algumas TAGs: “Disponível”, “Sanitizada“, “Não sanitizada” e etc.

Atualização de Porta dos Clientes

A atualização de porta dos clientes no INT6 ocorre por meio do processo de realocação do cliente. Essa realocação pode ser feita estimando a porta do cliente através de uma ánalise de dados do ponlink, e com isso o sistema estima a porta mais provável para o cliente, ou por meio de uma verificação in loco realizada pelo técnico em campo, que identifica que o cliente não está na porta correta e determina a porta correta.

Após essa determinação dentro do INT6, as informações de Caixa e porta do cliente são replicadas para o OZmap.

Estimação e Atualização da Caixa dos Clientes

O INT6 também possui uma funcionalidade de estimação da Caixa mais provável para o cliente, garantindo que o equipamento esteja vinculado à Caixa correta. Essa análise se baseia em dados do ponlink, abrangendo as CTOs e clientes conectados, além de dados GPON (potência, eventos massivos, etc.) e geolocalização, e a partir disso é determinado a Caixa mais provável para o cliente.

Após a estimação da Caixa do cliente, essa informação é enviada ao OZmap, conectando o cliente à Caixa estimada e à primeira porta livre do splitter, ou na primeira porta não sanitizada (sobreescrevendo a conexão da porta não sanitizada).

Se não for possível estimar uma Caixa para o cliente devido à falta de dados suficientes, ele será desconectado do OZmap para evitar inconsistências na rede.

Dados Acesso - Serviço de integração INT6

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

OZmap

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