Dúvida
Como cadastrar Alunos via REST?
Ambiente
TOTVS Educacional - Educacional - EDU - A partir da versão 12.1.6
Solução
Através do serviço RMSRestDataServer, via RESTful, o usuário poderá acessar o dataserver de Aluno EduAlunoData para a realização de requisições de consulta, inclusão, alteração ou exclusão de dados. Essas requisições são disponibilizadas através dos métodos GET, PUT, POST e DELETE e são sempre utilizados os valores das chaves primárias como índice para que elas sejam realizadas.
Neste exemplo, vamos usar a ferramenta Postman com o método POST para inclusão do Aluno. Dentro dela, vamos selecionar a opção 'POST' e inserir na URL o exemplo http://localhost:8051/RMSRestDataServer/rest/EduAlunoData. No local onde está escrito 'localhost:8051', insira o Servidor ou Hostname (nome da máquina que executa o Host, de acordo com a configuração do ambiente) e a porta utilizada no ambiente conforme print abaixo. Exemplo: 'instituiçãototvs:8051'.
Antes da requisição (SEND), vamos acessar a aba 'Authorization' e selecionar o tipo de Autorização (no exemplo abaixo estou selecionando o 'Basic Auth'). Após selecionar a autorização, precisamos inserir o Username e Password do usuário que fará a inclusão dos dados no RM.
Na aba 'Headers', vamos inserir 4 KEYS Primárias: CODCOLIGADA, CODFILIAL, CODTIPOCURSO e CODSITEMA, que representam respectivamente o Código da Coligada, Código da Filial, Código do Nível de Ensino e o Código do sistema Educacional que é representado pela letra S. Para inserir a KEY, basta digitar os parâmetros acima em cada campo, o sistema colocará automaticamente uma nova linha a cada.
Acesse a aba 'Body' onde colocamos o corpo da estrutura e marque os itens 'raw' e a opção 'JSON' conforme demonstrado no print abaixo.
Vamos utilizar a seguinte estrutura como exemplo. (utilizando apenas alguns dados básicos do Aluno conforme obrigatoriedade de cadastro da base).
{
"CODCOLIGADA": 1,
"CODFILIAL": 1,
"CODSISTEMA": "S",
"NOME": "Cristiano",
"SOBRENOME": "TOTVS",
"DTNASCIMENTO": "1995-01-12",
"NACIONALIDADE": 10,
"ESTADONATAL": "MG",
"NATURALIDADE": "BELO HORIZONTE",
"CODTIPOCURSO": 1,
"RA": "16551690",
}
Após essas ações, com os dados sendo informados corretamente, clique no botão para enviar (SEND).
A requisição será feita com sucesso. Ao final da requisição, o sistema apresentará a estrutura completa que podemos usar no Body com os demais dados a serem cadastrados para os Alunos.
Aluno cadastrado no Educacional.
Saiba mais: Alunos (Rest)
0 Comentários