...
Resumo das funcionalidades - Serviço de integração OZmap
Funcionalidade | Descrição | Direção da integração |
---|---|---|
Atualização de Status de Conexão dos Clientes OZmap | O status dos clientes OZmap é atualizado conforme a leitura de potência verificada no INT6. | INT6 => OZmap |
Atualização de Potência dos Clientes OZmap | A potência dos clientes OZmap é atualizada conforme a leitura de potência verificada no INT6. | INT6 => OZmap |
Atualização de Estado de Implantação dos Clientes OZmap | O estado de implantação dos clientes OZmap é atualizado conforme a leitura de potência verificada no INT6. | INT6 => OZmap |
Atualização dos Dados da ONU OZmap | Os dados da ONU OZmap são atualizados conforme a leitura dos dados da ONU no INT6. | INT6 => OZmap |
Resumo das funcionalidades - Serviço de integração INT6
Funcionalidade | Descrição | Direção da integração |
---|---|---|
Consulta de Potência do Cliente OZmap | A INT6 busca no OZmap a potência calculada de um cliente. | OZmap => INT6 |
Consultar CTOs OZmap Disponíveis para Provisionamento | A INT6 realiza busca de CTOs OZmap próximas do cliente OZmap e disponibiliza para provisionamento. | OZmap => INT6 |
Ativação e Atualização dos Dados do Cliente no OZmap | A INT6 atualiza no OZmap os dados de splitter, porta, coordenada e estado de implantação do cliente com base no que foi escolhido para provisionamento no INT6. | INT6 => OZmap |
Criar Cliente no OZmap | A INT6 verifica se o cliente existe no OZmap, se não existir, ele é criado com as informações de splitter e porta escolhidos no provisionamento. | INT6 => OZmap |
Cancelar Cliente no OZmap | A INT6 remove do OZmap os clientes desprovisionados no seu sistema. | INT6 => OZmap |
Serviço de integração 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 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;
Valor Potência INT6 | Status Conexão OZmap |
---|---|
0 | ERROR |
0.1, 1, 1.5 … | OK |
-0.5, -1, -1.5 … | OK |
Atualização de Potência dos Clientes 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:
Valor Potência INT6 | Potência lida no OZmap | Potência será atualizada no OZmap? |
---|---|---|
-20.50 | -20.80 | Não |
-21.00 | -20.80 | Não |
-21.35 | -20.80 | Sim |
-20.25 | -20.80 | Sim |
Atualização do Estado de Implantação dos Clientes 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:
É 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
Parâmetro | Descrição | Padrão | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Tempo entre Sincronizações | Tempo aguardado entre as sincronizações realizadas pela integração. |
|
Configurações Específicas OZmap
Parâmetro | Descrição | Padrão |
---|---|---|
Código INT6 a ser considerado na integração | Atributo das ONUs no INT6 que será comparado com código de clientes no OZmap, para encontrar correspondentes e aplicar funcionalidades da integração. Atualmente, podem ser usados o | gpon_client_id |
Limite de alteração de potência | Limite mínimo de alteração da potência no INT6 para que a potência lida do cliente no OZmap seja atualizada. | 0.5 |
Atualizar os Dados da ONU no OZmap | Se o serial number, user pppoe ou mac de uma ONU no OZmap divergir do INT6, são atualizados os dados da ONU no OZmap, com base nos dados lidos do INT6. | Desativado. |
Utilizar o Short Serial Number na ONU OZmap | Na ONU OZmap, pode ser utilizado o short serial number ao invés do serial number completo, lido da ONU INT6. Essa funcionalidade só pode ser ativa, caso a funcionalidade de atualizar os dados da ONU também estiver ativa. | Desativado. |
Dados Acesso - Serviço de integração OZmap
...
Dados de acesso necessários para buscar informações via API no sistema INT6. (Estes dados devem ser fornecidos no questionário inicial)
Parâmetro | Descrição | Exemplo |
---|---|---|
URL | URL do servidor que contém o serviço externo para conexão. | |
Email provido pelo cliente para acessar o serviço. | ||
Token | Token provido pelo cliente para acessar o serviço. | aMshEhZtyK-7AyQTZM5v |
OZmap
Insert excerpt | ||||||||
---|---|---|---|---|---|---|---|---|
|
...
A consulta das CTOs OZmap disponíveis para realizar provisionamento , é dado 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;
...
A atualização de dados dos clientes no OZmap , é feito da seguinte forma:
...
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
oupppoe_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
oupppoe_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).
Dados Acesso - Serviço de integração INT6
Dados de acesso necessários para as operações realizadas pelo integrador são:
OZmap
Parâmetro | Descrição | Exemplo |
---|---|---|
URL | Endereço do OZmap, com a porta de serviço padrão. | https://cliente.ozmap.com.br:9994 |
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 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
Pergunta | Resposta | Funcionalidade |
---|---|---|
É possível utilizar apenas algumas das funcionalidades do Serviço de integração OZmap? | Sim, atualmente são opcionais algumas funcionalidades | Atualizar os Dados da ONU, Utilizar Short Serial Number na ONU. |