Mudanças entre as edições de "Integração"

De GWiki
Ir para navegaçãoIr para pesquisar
Linha 1: Linha 1:
'''Integração''' significa trabalho em parceria ou de forma colaborativa entre duas ou mais partes.
+
'''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 utilizados pela instituição, que devem de alguma forma "conversar" entre si. Seja utilizando informações, rotinas ou ainda complementando processos um do outro.
+
Em termos de software, integrações dizem respeito a dois ou mais sistemas que "trocam" ou "transferem" dados entre si.
  
A integração do [[Gennera]] com sistemas externos/legados pode ocorrer de 3 maneiras:
+
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).
* Através de [[web service]]s disponíveis;
 
* Através do envio e retorno de arquivo, conforme layout definido pela instituição na [[Apostila, Exportação genérica | exportação manual de dados]];
 
* Através do envio e retorno de [[Auxílio, Troca de arquivo | arquivo, conforme layout pré-definido]] pela Gennera e enviado ao email da instituição na periodicidade desejada.
 
  
==Sistemas integrados==
+
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.
  
A [[Gennera]] já possui integração com alguns sistemas, conforme disposto no site: http://www.gennera.com.br/integracao-com-outros-sistemas.
+
==Como solicitar==
  
==Dica==
+
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''''' e criar o [[Token | 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 | 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.
  
* As '''integrações''' são comercializadas separadamente do [[Portal acadêmico e financeiro]], desta forma, caso haja interesse, deverá ser aberto um chamado no '''GSAG - Serviço de Atendimento Gennera''' para que seja analisada a viabilidade de implementação e os valores para realização deste processo.
 
  
 
[[Categoria:Educação Corporativa]]
 
[[Categoria:Educação Corporativa]]

Edição das 14h57min de 30 de janeiro de 2015

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 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.