Integração

De GWiki
Revisão de 16h43min de 6 de fevereiro de 2015 por Vivi (discussão | contribs) (→‎Como utilizar)
Ir para navegaçãoIr para pesquisar

Integração significa trabalho em parceria ou de forma colaborativa entre duas partes.

Em termos de software, integrações dizem respeito a dois ou mais sistemas que "trocam" ou "transferem" dados entre si.

A transferência de dados entre o sistema educacional da Gennera e outros aplicativos utilizados pelas instituições de ensino ocorre através de APIs (Application Programming Interface) na arquitetura REST (Representational State Transfer).

As APIs fornecidas pela Gennera permitem acesso aos dados contidos no banco de dados da instituição através de programação. Portanto, sua utilização requer conhecimento técnico de desenvolvimento WEB.

Como solicitar

As integrações são comercializadas separadamente, desta forma, caso haja interesse, deverá ser aberto um chamado no GSAG - Serviço de Atendimento Gennera para que sejam analisadas a disponibilidade, a viabilidade de implementação, os prazos e os valores para realização deste serviço.

Caso os serviços solicitados já estejam disponíveis, a Gennera irá liberar o acesso da instituição ao menu de integração do sistema, após aprovação.

Como utilizar

Após a liberação de acesso às APIs pela Gennera, o administrador do sistema deverá criar um novo usuário (desenvolvedor WEB) e suas permissões de acesso aos dados da instituição.

De posse de seu login e senha, o usuário (desenvolvedor WEB) deverá acessar o sistema educacional da Gennera em Utilitário\ Integração\ Webservice-Acesso por Usuário ou Segurança\ WebService - Acesso Por Usuário e criar o TOKEN de acesso.

O usuário/desenvolvedor WEB deverá seguir as orientações de uso encontradas na documentação técnica das APIs disponível em http://api.gennera.com.br/.

Esta documentação contém descrições sobre:

  • os serviços disponíveis;
  • as formas de acesso;
  • as entidades relacionadas;
  • exemplos de utilização.

Responsabilidade e segurança

O TOKEN, criado pelo usuário/desenvolvedor no menu do sistema educacional da Gennera, terá o nível de permissão de acesso conforme autorizado pelo administrador do sistema, no momento da criação do usuário (desenvolvedor WEB). Ou seja, todos os dados que o respectivo usuário (desenvolvedor WEB) estiver autorizado a acessar no sistema, estarão visíveis aos serviços das APIs que utilizarem o TOKEN.

Portanto, os administradores do sistema, assim como cuidam do acesso dos usuários ao sistema da Gennera, deverão tomar todos os cuidados necessários com a criação e permissão de acesso de usuários/desenvolvedores WEB que poderão criar TOKENS. E os usuários/desenvolvedores WEB deverão ser responsáveis com seu TOKEN assim como o são com suas SENHAS.