Sytex
- Leonardo Brandão
- Leonardo Rosa Bittencourt
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 gerenciamento de atividades de implantação e manutenção de tecnologia, que agiliza a gestão de processos e trabalhos em campo.
A integração com o OZmap se baseia em uma consulta realizada uma vez ao dia nas caixas OZmap, para realizar a sincronização dessas caixas no Sytex.
Resumo de funcionalidades
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Sincronização de Caixas | Atualização e criação de caixas OZmap no Sytex | OZmap => Sytex |
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
Sincronização de Caixas
O processo de sincronização de caixas ocorre da seguinte maneira:
Uma vez por dia, às 21 horas, é realizada uma consulta no OZmap para obter informações sobre todas as caixas que não estejam em estado de implantação “Em projeto”.
Após a consulta, é feita uma verificação no Sytex para determinar quais caixas precisam ser atualizadas ou criadas.
O Sytex verifica cada caixa encontrada no OZmap pelo nome, checando se existe uma caixa no Sytex com mesmo nome.
Se não existir, a caixa OZmap é criada no Sytex;
Se existir, a caixa Sytex é atualizada com os dados mais recentes da caixa OZmap.
No Sytex, as caixas OZmap são criadas como Elementos de Rede (EdR), com seu nome, tipo e coordenadas preenchidos e atualizados com os dados obtidos do OZmap.
Além disso, no Sytex, cada caixa representa um ponto de localização, onde o técnico que precisa realizar alguma tarefa no Sytex, pode atribuir a ela uma nova atividade, como um formulário de implantação/manutenção, por exemplo.
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. | |
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 Sytex 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 |
|---|---|
Caso uma caixa seja excluída no OZmap, ela será excluída no Sytex? | Não, atualmente a integração somente cria e atualiza caixas OZmap no Sytex. |