...
Essa documentação trata do serviço externo Ravi. O serviço externo é acessado via API. As funcionalidades descritas aqui indicam as capacidades e os requisitos da integração, bem como o questionário e as funcionalidades relacionadas.
| Table of Contents | ||||
|---|---|---|---|---|
|
Tipo de Integração
A integração OZmap-Ravi é do tipo Ativa.
Descrição
O Ravi é um sistema de monitoramento e provisionamento de equipamentos FTTH, bem com infraestrutura de TI.
Dados Acesso
...
Dados de acesso necessários para buscar informações via API no sistema Ravi. (Estes dados devem ser fornecidos no questionário inicial)
...
Parâmetro
...
Descrição
...
Exemplo
...
IP
...
IP da máquina que contém o serviço externo para conexão.
...
192.168.0.2
...
Token
...
Token provido pelo cliente para acessar o serviço. Localizado em Configurações > Registro Ravi
...
Po9eebairai1bo-CaoH2eo2iaVohp-beM7EiThemahph-Aeb6wah2hei8ah
...
Usuário
...
Nome usuário do sistema criado para a integração.
...
ozmap
...
Senha
...
Senha de acesso do usuário
...
-
OZmap
...
Parâmetro
...
Descrição
...
Exemplo
...
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
Para validação e execução da integração no ambiente de produção, é necessário que sejam liberados no servidor do cliente os IPs utilizados pelo OZmap:
Servidor OZmap do cliente (ping cliente.ozmap.com.br)
...
Configurações Base
...
Parâmetro
...
Descrição
...
Padrão
...
Tempo entre Sincronizações
...
Tempo aguardado entre as sincronizações realizadas pela integração
...
15 minutos
...
Código de vinculo
...
Atributo utilizado para vincular os clientes do OZmap com onus no Ravi
...
Serial Number
Logs
Os logs da integração são disponibilizados no endereço: https://$cliente.ozmap.com.br/integrations/ravi/logs.
Resumo de funcionalidades
...
São lidas todas as ONUs reconhecidas pelo Ravi
Para cada ONU com potência lida válida, buscamos no OZmap um cliente que possua a ONU com Serial Number semelhante.
Caso seja encontrado, e o cliente no OZmap esteja em status “Não implantado” o campo do OZmap é atualizado para “implantado”.
Configurações Base
Parâmetro | Descrição | Padrão |
|---|---|---|
Tempo entre Sincronizações | Tempo aguardado entre as sincronizações realizadas pela integração | 15 minutos |
Código de vinculo | Atributo utilizado para vincular os clientes do OZmap com onus no Ravi | Serial Number |
Dados Acesso
Não possui questionário.
Ravi
Dados de acesso necessários para buscar informações via API no sistema Ravi. (Estes dados devem ser fornecidos no questionário inicial)
Parâmetro | Descrição | Exemplo |
|---|---|---|
IP | IP da máquina que contém o serviço externo para conexão. | 192.168.0.2 |
Token | Token provido pelo cliente para acessar o serviço. Localizado em Configurações > Registro Ravi | Po9eebairai1bo-CaoH2eo2iaVohp-beM7EiThemahph-Aeb6wah2hei8ah |
Usuário | Nome usuário do sistema criado para a integração. | ozmap |
Senha | Senha de acesso do usuário | - |
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
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
Para validação e execução da integração no ambiente de produção, é necessário que sejam liberados no servidor do cliente os IPs utilizados pelo OZmap:
Servidor OZmap do cliente (ping cliente.ozmap.com.br)
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
Logs
Os logs da integração são disponibilizados no endereço: https://cliente.ozmap.com.br/integrations/ravi/logs
Questionário
Pergunta | Resposta | Funcionalidade |
|---|---|---|
É possível utilizar apenas algumas das funcionalidades acima? | Não, até a presente versão todas as funcionalidades são executadas, sem distinção ou configuração que pause uma delas. | - |
É possível alterar o mapeamento de status definidos? Ex: “Online sem dados” ser OK no OZmap | Não, até a presente versão o mapeamento de status é fixo, é algo possível de ser feito mediante pedido de melhoria. | Atualização de Status |
...