Sytex

Essa documentação trata da integração com o sistema Sytex. A integração é realizada através de chamadas API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.

Tipo de Integração

A integração OZmap-Sytex é do tipo Passiva-direta.

Descrição

O Sytex é uma plataforma de gerencimaneto de atividades de implantação e manutenção de tecnologia, que agiliza a gestão de processos e trabalhos em capo. É responsavel por integrar as etapas do projeto, planejamento, logística e execução da rede FTTH.

Existem dois tipos de integração Sytex e são divididas em módulos com funcionalidades distintas.

Resumo de funcionalidades

Módulo I

Funcionalidade	Descrição	Direção da integração
Atualização e Criação de Caixas	Atualização e Criação no Sytex de todas as caixas que se encontram cadastradas no OZmap. Esse processo é realizado apenas uma vez ao dia às 21hrs.	OZmap => Sytex

Módulo II

Funcionalidade	Descrição	Direção da integração
Criação de Projetos	Criação dos projetos OZmap no Sytex por meio de um serviço	OZmap => Sytex
Criação de Elementos de Rede	Criação dos elementos de rede no Sytex	OZmap => Sytex
Atualização de Elementos de Rede	Atualização dos elementos de rede que não existem na base de dados Sytex a partir dos elementos existentes no OZmap	Sytex => OZmap
Atualização do Estado de Implantação	A integração Sytex enviará o estado de implantação ao OZmap para atualizar as caixas com estado “Implantado”	Sytex => OZmap
Atualização de Informação de outros Projetos	Adicionar como informações adicionais no OZmap, outros projetos presentes no Sytex. Exemplo: projetos de manutenção	Sytex => OZmap

Funcionalidades

Abaixo serão descritas as funcionalidades referente apenas a integração Módulo II apresentada no resumo de forma a entender como funciona o fluxo de sincronização.

Sincronização de Projetos

São criados todos os projetos definidos no OZmap no Sytex através de um serviço.

Sincronização de Caixas

São criadas no Sytex todas as caixas OZmap com estado diferente de “draft”. Na criação da caixa é passado o nome no OZmap como código no Sytex, são passados as coordenadas (lat, lng) e registradas no campo “NetworkElementoCoordinate” no Sytex e o tipo de elemento de rede (box-type).

Caso a caixa já existe no Sytex é apenas realizado a sua atualização levando em consideração a sua última atualização que pode ser observada na propriedade “updatedAt” no OZmap, se a caixa tiver um updatedAt maior que o presente na base de dados do Sytex é feita a sua atualização.

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

Dados Acesso

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

Saiba mais como configurar esses dados acionando o suporte do Sytex.

OZmap

Parâmetro	Descrição	Exemplo
URL API	Endereço do OZmap, com a porta de serviço padrão.	https://cliente.ozmap.com.br:9994/api/v2
Chave API	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 Matrix 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

//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.