...
As funcionalidades da integração entre OZmap e Integrator se baseiam na busca de clientes Integrator via API, e criação, implantação e cancelamento destes clientes no OZmap. O vínculo de clientes entre o Integrato e OZmap se baseia nas informações de código do cliente-numero do plano (Ex.: 777-888) no integrator ser igual ao codigo do cliente no OZmap.
Dados Acesso
Integrator
Dados de acesso necessários para buscar informações via API no sistema Integrator. (Estes dados devem ser fornecidos no questionário inicial)
...
Parâmetro | Descrição | Padrão |
|---|---|---|
Tempo entre Sincronizações | Tempo aguardado entre as sincronizações realizadas pela integração | 15 minutos |
Configurações Específicas - Geral
Parâmetro | Descrição | Padrão |
|---|---|---|
Código de usuário integrator | ? | 01 |
Usar porta e splitter Integrator | Tentar buscar no OZmap um splitter e porta correspondentes ao dado no serviço Integrator do cliente. | Desativado |
Expressão regular para identificação de nome de caixa no Integrator | Expressão utilizada para extrair o nome da caixa no serviço Integrator para buscar caixa correspondente no OZmap. |
|
Expressão regular para identificação de nome de projeto no Integrator | Expressão utilizada para extrair o nome do projeto no serviço Integrator para buscar caixa em projeto correspondente no OZmap. |
|
Considerar projeto na busca de caixas | Ao buscar uma caixa Integrator no OZmap, o projeto para a caixa Integrator deve ser correspondente ao projeto da caixa encontrada no OZmap. | Desativado |
Considerar cidade no Integrator como nome de projeto OZmap | Na busca de caixas considerando o projeto Integrator, será considerado o nome da cidade como nome de projeto para a busca da caixa no OZmap. | Desativado |
Configurações Específicas - Funcionalidades
Parâmetro | Descrição | Padrão |
|---|---|---|
Cancelamento de clientes | Utilizar a funcionalidade de cancelamento de clientes em cada sincronização. | Desativado |
Criação de clientes | Utilizar a funcionalidade de criação de clientes em cada sincronização. | Ativado |
Logs
Os logs da integração são disponibilizados no endereço: https://$cliente.ozmap.com.br/integrations/integrator/logs
...
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
...
Criação de
...
clientes
Atualização do valor Criação de status do cliente no OZmap baseado na leitura informada pelo SmartOLT. O campo “status” é atualizado no OZmap respeitando as regras abaixo.de clientes que existem no Integrator mas ainda não existem no OZmap:
São lidos os valores de status de todas as ONUs encontradas no SmartOLT.
Para cada ONU, buscamos no OZmap um cliente que possua a ONU com Serial Number semelhante.
Caso seja encontrado, e o valor presente no OZmap seja diferente do valor trazido pelo SmartOLT, o campo do OZmap é atualizado. O valor de status segue o seguinte padrão:
...
Status SmartOLT
...
Status OZmap
...
Online
...
OK (0)
...
Offline
...
ERROR (1)
...
Power fail
...
ERROR (1)
Atualização de potência
Atualização do valor de potência lida no OZmap baseado na leitura informada pelo SmartOLT. O campo “Potência lida” é atualizado no OZmap respeitando as regras abaixo.
São lidos os valores de potência de todas as ONUs encontradas no SmartOLT.
Para cada ONU, buscamos no OZmap um cliente que possua a ONU com Serial Number semelhante.
Caso seja encontrado, e o valor presente no OZmap seja diferente do valor trazido pelo SmartOLT, o campo “Potência lida” do OZmap é atualizadotodos os clientes Integrator.
Para cada cliente integrator que possua a descrição de serviço diferente de “Cancelado”, é buscado um cliente no OZmap cujo código seja igual ao código de cliente-numero de plano do cliente Integrator (Ex.: 777-888).
Caso não seja encontrado um cliente correspondente no OZmap, será feita a criação do cliente seguindo as regas:
Cliente deve ter uma caixa atribuída no serviço Integrator.
Integração busca no OZmap um caixa correspondente a caixa no serviço Integrator, utilizando expressão regular para extrair o nome da caixa no Integrator.
Caso a caixa não seja encontrada no OZmap, o cliente não será criado.
Caso a caixa seja encontrada no OZmap, e se a opção de usar a porta de serviço integrator estiver ativa, será buscado o splitter e porta correspondentes no OZmap.
Se a integração encontrar splitter e porta do serviço Integrator correspondentes no OZmap, o cliente será criado no OZmap com estas informações.
Caso não se ja encontrado splitter e porta correspondentes, o cliente será criado na caixa encontrada anterioremente, e conectado no primeiro splitter de atendimento e porta disponíveis nessa caixa no OZmap.
Cancelamento de clientes
Remoção de cliente no OZmap baseado na leitura de serviço cancelado do cliente no Integrator:
São lidos todos os clientes Integrator.
Para cada cliente integrator que possua a descrição de serviço “Cancelado”, é buscado um cliente no OZmap cujo código seja igual ao código de cliente-numero de plano do cliente Integrator (Ex.: 777-888).
Caso seja encontrado, o cliente é removido do OZmap, seguindo as regras:
Se o cliente estiver como “Implantado” no OZmap, o cliente é excluído e o imóvel é mantido e permace conectado ao splitter.
Se o cliente estiver como “Não implantado” no OZmap, o cliente e o imóvel são excluído do OZmap.
Implantação de clientes
Atualização do estado de implantação do cliente no OZmap baseado na leitura de potência informada pelo SmartOLT.serviço ativo do cliente no Integrator:
São lidos os valores de potência de todas as ONUs encontradas no SmartOLTtodos os clientes Integrator.
Para cada ONU com potência válida (ou seja, que possuam potência de valor numérico diferente de 0), buscamos no OZmap um cliente que possua a ONU com Serial Number semelhantecliente integrator que possua a descrição de serviço diferente de “Cancelado”, é buscado um cliente no OZmap cujo código seja igual ao código de cliente-numero de plano do cliente Integrator (Ex.: 777-888).
Caso seja encontrado, se no Integrator a descrição de serviço for igual a “Serviço Habilitado” e no OZmap o cliente esteja com estiver como “Não implantado”, o estado de implantação “Não implantado” no OZmap , o campo é atualizado alterado para “Implantado”.
Questionário
Pergunta | Resposta | Funcionalidade | |||
|---|---|---|---|---|---|
É possível utilizar apenas algumas das funcionalidades acima? | Não, no momento ainda não é possível escolher executar apenas uma ou mais das funcionalidades descritas. | - | É possível alterar o status do cliente no OZmap com base na potência recebida do SmartOLT? | Não, no momento a atualização de status no OZmap ocorre somente pelo valor de status lido no SmartOLTSim, as funcionalidades de criação e cancelamento de clientes são opcionais. | Criação de clientes Cancelamento de clientes |
É possível atualizar dados dos clientes pela integração (como nome / caixa / porta)? | Não, atualmente a integração não realizar atualização destas informações no OZmap e nem no Integrator. | - |
//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.