...
Resumo das funcionalidades
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Implantação e Sincronização de Clientes | Implantação e Atualização de Informações de clientes OZmap com base na leitura do IXC. | IXC => OZmap |
Cancelamento de Clientes | Remoção no OZmap de clientes que se encontram cancelados no IXC. | IXC => OZmap |
Atualização da Porta de Clientes | Ao trocar um cliente de porta no sistema escolhido como fonte, replica essa alteração no sistema oposto. | OZmap => IXC ou IXC => OZmap |
Atualização das Coordenadas de Clientes | Atualização dos atributos de latitude e longitude de clientes, com base na leitura do sistema escolhido como fonte no sistema oposto. | OZmap => IXC ou IXC => OZmap |
Sincronização de Condomínios | Criação de caixas no IXC para representar os splitters de um condomínio OZmap. | OZmap => IXC |
Criação de Clientes | Criação no OZmap de clientes que se encontram cadastrados no IXC mas não existem no OZmap. | IXC => OZmap |
Atualização e Criação de Caixas | Atualização e Criação de caixas que se encontram cadastradas no OZmap mas não existem no IXC. É possível também utilizar splitters OZmap como caixas no IXC, para essa função, cada splitter no OZmap será criado como caixa no IXC. | OZmap=> IXC |
Funcionalidades
Implantação e Sincronização de Clientes IXC no OZmap
...
É feito a leitura de todos os clientes no IXC que possuem o tipo de conexão fibra (tipo_conexao_mapa = “f”) e o status de login ativo (ativo = “s”);
A integração busca clientes no OZmap com código igual ao atributo de login IXC definido para a integração;
Caso seja encontrado, se a configuração “Implantar Clientes Automaticamente no OZmap“ estiver ativada e o cliente IXC possuir uma ONU, o estado de implantação deste cliente no OZmap é atualizado para “implantado”;
Se o parâmetro ”Atualização de status dos Clientes OZmap” estiver ativo, e o status de conexão do cliente no IXC esteja diferente do OZmap, é atualizado o valor do status da conexão no OZmap com base no valor lido no atributo “online” no IXC seguindo a seguinte tabela.
Online IXC | Status OZmap |
|---|---|
S (Sim) | OK |
N (Não) | ERRO |
SS (Sem Status) | ERRO |
Se o parâmetro “Atualização de potência dos Clientes OZmap” estiver ativo, e a potência do cliente no IXC 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 IXC. 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 IXC | 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 |
Caso o cliente não possuir nome no OZmap ou o valor diferir do IXC, é atualizado o nome do cliente no OZmap com o valor encontrado no IXC. O campo de nome utilizado no IXC para a verificação é o “razão”;
Se o parâmetro “Atualização de endereço dos Clientes OZmap” estiver ativo, e o campo de endereço da propriedade do cliente no OZmap estiver diferente do endereço lido para o cliente no IXC, o endereço da propriedade do cliente no OZmap é atualizado com os dados de endereço do IXC.
...
São buscados no OZmap as caixas que foram criadas ou sofreram alteração desde o ultimo intervalo de sincronização e, além disso, a caixa OZmap deve possuir a capacidade para atender clientes, não pode estar em projeto e, serão considerados para criação/atualização somente splitters que permitam conexão de cliente;
Caso a caixa não existir no IXC, a mesma será criada no IXC com as informações obtidas na sincronização, essas informações se encontra na tabela abaixo, mostrando qual o valor será pego do OZmap e atribuido no IXC. Por padrão, o OZmap cria apenas uma caixa no IXC e soma a quantidade de portas considerando o total de portas de splitters de atendimento na caixa OZmap e atribui essa informação no IXC;
Atributo da Caixa no IXC | Atributo da Caixa no OZmap | Exemplo |
|---|---|---|
Descrição | Nome | AL1-CTO-4-8 |
Capacidade | Quantidade de Portas de Splitter de Atendimento | 16 |
ID do Projeto | ID do Projeto | 0 |
ID do Transmissor | ID do Transmissor | 0 |
Latitude e Longitude | Latitude e Longitude | -3.010164, -59.959736 |
Endereço | Endereço | - |
Observação | Observação | - |
Caso seja uma caixa existente no IXC que teve alteração no OZmap, essa alteração é replicada na caixa IXC;
É possível habilitar a configuração de utilizar os splitters OZmap como caixas no IXC, onde cada splitter de atendimento presente dentro de uma caixa no OZmap que não esteja “Em projeto” ou dentro de um condomínio vertical, é criado como caixa no IXC. Isso se dá ao fato do IXC não reconhecer o conceito de splitters, então, cada splitter no OZmap equivale a uma caixa no IXC com essa configuração.
Atributo da Caixa no IXC | Atributo do Splitter no OZmap | Exemplo |
|---|---|---|
Nome | Utilizado o Identificador do projeto, nome do splitter e nome da caixa | [Exemplo] Splitter 01 [AL1-CTO-4-8] |
Capacidade | Quantidade de Portas do Splitter | 16 |
ID do Projeto | ID do Projeto da Caixa | 0 |
ID do Transmissor | ID do Transmissor da Caixa | 0 |
Endereço | Endereço da Caixa | - |
Latitude e Longitude | Latitude e Longitude da Caixa | -3.010164, -59.959736 |
Observação | Utilizado o nome da caixa e a observação do splitter. | Caixa: AL1-CTO-4-8 |
Se for uma caixa existente no IXC, e que foi removida do OZmap (caixa removida no OZmap para quem usa caixas OZmap como caixas IXC, ou caso o cliente use splitters OZmap como caixas IXC, seja o splitter ou caixa do splitter removida no OZmap) é feita uma atualização do status da caixa IXC para inativo (status = “i”) e adicionado um prefixo de (INATIVA).
Se a configuração ‘Remover caixas IXC que foram deletadas no OZmap’ estiver ativa, a caixa é então removida no IXC.
Configurações Base
Parâmetro | Descrição | Padrão | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tempo entre Sincronizações | Tempo aguardado entre as sincronizações realizadas pela integração. |
|
Configurações Específicas - Caixas
Parâmetro | Descrição | Padrão |
|---|---|---|
Considerar OLT | Busca um transmissor IXC com IP correspondente ao da OLT OZmap. Caso não seja encontrado, a caixa será criada no IXC com id_transmissor=0. | Desativado |
Transmissor IXC obrigatório para caixas | Quando a opção de considerar OLTs estiver ativa, uma caixa ou condomínio OZmap só serão atualizados/criados no IXC, se existir transmissor no IXC com IP correspondente ao da IP da OLT OZmap, caso contrário, não serão atualizados/criados. | Desativado |
Considerar Projeto | Uma caixa ou condomínio OZmap só serão atualizados/criados no IXC, se o nome do projeto no IXC for exatamente o mesmo nome do projeto no OZmap (Ex. Projeto e PROJETO são diferentes), caso contrário, não serão atualizados. | Desativado |
Utilizar o Splitter OZmap como Caixa no IXC | Criar caixas no IXC para cada splitter no OZmap. Se tiver desabilitado, para cada caixa no OZmap é criada uma caixa no IXC, e a disponibilidade é a soma de todas as portas de todos os splitters da caixa no OZmap. | Desativado |
Sincronização de Condomínios | Criar caixas no IXC para cada splitter em um condomínio no OZmap. | Desativado |
Remover caixas IXC que foram deletadas no OZmap | Caixas deletadas no OZmap também são removidas do IXC. | Ativado |
Configurações Específicas - Clientes
Parâmetro | Descrição | Padrão |
|---|---|---|
Código de vínculo entre clientes | Atributo do login IXC que será usado como código de cliente OZmap na busca de clientes entre os dois sistemas, para execução de todas as funcionalidades ligadas a login IXC / cliente OZmap. Deve ser um código único no IXC. | login |
Implantar Clientes Automaticamente no OZmap | Todos os clientes IXC que não estão implantados no OZmap, mas possuem o status ativo no IXC, serão implantados no OZmap. | Desativado |
Criar Clientes Automaticamente no OZmap | Clientes que existem no IXC porém não existem no OZmap serão criados no OZmap caso a caixa do cliente no IXC seja encontrada pelo nome no OZmap. | Desativado |
Atualizar Porta de Clientes | Ao trocar um cliente de porta no sistema escolhido como fonte, replica essa alteração no sistema oposto | Desativado |
Fonte de informações de portas para sincronização de portas entre os sistemas OZmap e IXC | O sistema fonte que contém os dados de portas corretos e que serão propagados ao sistema oposto. | ozmap |
Atualizar Coordenadas de Clientes | Atualização dos atributos de latitude e longitude de clientes, com base na leitura do sistema escolhido como fonte. | Desativado |
Fonte de coordenadas para sincronização de coordenadas entre os sistemas | O sistema fonte que contém os dados de coordenadas corretos e que serão propagados ao sistema oposto. | ozmap |
Desconectar Automaticamente Cliente Inativo IXC do Splitter OZmap | Quando um cliente tem o status de login mudado para inativo no IXC, ele é excluído do OZmap e desconectado automaticamente da porta que ele está ocupando no splitter OZmap. | Desativado |
Criar Cliente IXC na Caixa OZmap | Ao criar um novo cliente no OZmap, caso não seja encontrado o splitter OZmap que o cliente está no IXC, ele é criado dentro da caixa, mas, sem ligação com o splitter de atendimento. OBS: Essa configuração só tem validade, caso a configuração de utilizar splitters OZmap como caixas no IXC estiver desabilitada. | Desativado |
Atualização de endereço dos Clientes OZmap | Atualização do campo de endereço na propriedade do cliente no OZmap, com base na leitura de endereço do cliente no IXC, caso esses valores sejam divergentes entre os sistemas. | Ativado |
Atualização de potência dos Clientes OZmap | Atualização do campo de potência na propriedade do cliente no OZmap, com base na leitura da potência do cliente no IXC, caso esses valores sejam divergentes entre os sistemas. | Ativado |
Limite de alteração de potência | Limite mínimo de alteração da potência no IXC para que a potência lida do cliente no OZmap seja atualizada. | 0.5 |
Atualização do status dos Clientes OZmap | Atualização do status do cliente no OZmap, com base na leitura de status do cliente no IXC, caso esses valores sejam divergentes entre os sistemas. | Ativado |
Desconexão de clientes em trocas de porta caso não tenham informações de conexão no sistema fonte | Decide se a desconexão de clientes e também a falta de conexão de clientes no sistema fonte será propagada para o sistema oposto. | Desativado |
Dados Acesso
https://docs.google.com/forms/u/2/d/1ujtHdsXTYYTD1mH8jzikW6eK6TVuVdfNqeTSRtEvtnw/edit?usp=drive_web
...
Dados de acesso necessários para buscar informações via API no sistema IXC. (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. | https://ixc.cliente.com.br |
Token | Token provido pelo cliente para acessar o serviço. | 10:cb582f30dadd4a3311f8ebafbd045884ad9e51249d03fcd481050141b1325b78 |
OZmap
| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
Os logs desta integração estão disponíveis no endereço:
https://cliente.ozmap.com.br/integrations/ixc/logs
Questionário
Pergunta | Resposta | Funcionalidade |
|---|---|---|
É possível utilizar apenas algumas das funcionalidades acima? | Sim, atualmente são opcionais algumas funcionalidades | Criar Cliente, Atualizar Porta do Cliente, Desconectar Automaticamente Cliente do Splitter, Implantar Cliente, Atualizar potência do Cliente, Atualizar status do Cliente. |
Caso a configuração de considerar o projeto esteja desativada, para realizar a sincronização de um novo projeto do OZmap no IXC, é necessário criar o projeto no IXC ou apenas criando no OZmap ele já cria o projeto e sincroniza os elementos? | É necessário criar também o projeto no IXC com o mesmo nome do projeto OZmap. Caso contrário, o projeto e os elementos dele não serão sincronizados. | Considerar o Projeto. |
Quais atributos de login IXC podem ser usados como código de cliente OZmap? | Qualquer atributo do login IXC que seja único no sistema (só exista um para cada login). Por exemplo: id_contrato, deve ser um contrato para um login, se houver mais de um login com esse id_contrato, não pode ser usado como código. O mesmo vale para os demais atributos de login IXC. | Criar Cliente, Cancelar cliente e todas as atualizações de clientes no OZmap e no login IXC. |
Quando não é utilizada a configuração específica “Considerar Projeto”, qual id de projeto é utilizado nas caixas OZmap criadas/editadas no IXC? | Por padrão, a caixa é criada/editada no IXC utilizando como id de projeto “0” . | Atualização e Criação de Caixas |
Quando não é utilizada a configuração específica “Considerar OLT”, qual id de transmissor é utilizado nas caixas OZmap criadas/editadas no IXC? | Por padrão, a caixa é criada/editada no IXC utilizando como id de transmissor “0”. | Atualização e Criação de Caixas |
Quando utilizada a configuração “Considerar OLT” e não for encontrado um transmissor IXC correspondente à OLT OZmap, a caixa OZmap será criada/editada no IXC? | Caso a configuração “Transmissor IXC obrigatório para caixas” esteja desabilitada, a caixa será criada/editada no IXC com id de transmissor “0”. | Atualização e Criação de Caixas |
Há alguma funcionalidade na integração para atualização de coordenadas dos clientes no OZmap com base nesse dado do IXC? | Sim, agora contamos com uma funcionalidade que permite fazer ou a alteração do OZmap para o IXC ou a alteração do IXC para o OZmap. | Atualizar Coordenadas de Clientes |
A integração realiza atualização de portas/splitter/caixa do IXC para o OZmap? | Sim, agora contamos com uma funcionalidade que permite fazer ou a alteração do OZmap para o IXC ou a alteração do IXC para o OZmap. | Atualizar Porta de Clientes |
Ao excluir um cliente no OZmap, ele será removido no IXC? | Não, a integração não cria ou remove clientes do IXC. | - |
Ao excluir um cliente no IXC, ele será removido do OZmap? | Não, a única condição para um cliente ser removido no OZmap é por cancelamento de conexão no IXC. | Cancelamento de Clientes |
//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.