Layout de requisição
A requisição de dados ao webservice da Plataforma Badiu.Net deve ser feita seguindo os seguintes padrão:
|
URL |
URL_INSTALL/system/service/process |
|
Método |
POST |
|
Formato de dados |
JSON |
|
Parâmetros básicos |
Todas as requisições devem ter os três parâmetros, especificados a seguir: {"_service": "xxx","_function": "xxx","_stoken": "xxx"} As requisições de consulta de relatório, além dos parâmetros acima, deve adicionar novos parâmetros obrigatórios: {"_dkey": "xxx","_key": "xxx"} Os relatórios que processam serviços externo como no caso do módulo MReport que processa consulta na base de dados externo do Moodle deve adicionar novos parâmetros obrigatórios além dos já mencionados acima: {"parentid": "xxx","_serviceid": "xxx","_datasource": "xxx"} |
Parâmetros básicos de requisição
|
Parâmetro |
Descrição |
|
_service |
Endereço de serviço a ser acionado. Cada serviço é Em caso de consulta de relatório, o valor padrão é: badiu.system.core.functionality.factoryreportwebservice |
|
_function |
Função a ser acionado na classe. Se o parâmetro não for definido o sistema usa a função exec como padrão. Em caso de consulta de relatório, não precisa definir a função. |
|
_stoken |
Token de autenticação |
Parâmetros básicos adicionais de requisição para relatório
|
Parâmetro |
Descrição |
|
_dkey |
Define a chave da classe sobre o tipo de relatório que irá ser processado. É um parâmetro obrigatório. Deve receber os seguintes valores: badiu.system.core.report.dynamic.index badiu.system.core.report.dynamicp.index badiu.system.core.report.dynamicd.dashboard badiu.system.core.report.dynamicdp.dashboard |
|
_key |
Chave única de identificação da cada relatório. É um parâmetro obrigatório. |
|
parentid |
Parâmetro de identificação do elemento pai do relatório que está sendo gerado. Trata-se de registros que devem ser filtrados com base numa chave de filtro básico. |
|
_serviceid |
Traservicesqlta-se da identificação do serviço externo a ser consultado. O módulo MReport faz consulta em Moodle externo. Cada Plataforma Moodle tem um id de identificação. Esse parâmetro é obrigatório em caso de consulta de relatórios do MReport |
|
_datasource |
Trata-se de método de conexão para cada fonte de dados. Recebe dois valores: - dbdoctrine - Consulta realizada pelo API do badiunet na base local - servicesql - Para consulta usando serviço SQL. Isso é usado para fonte externa no caso das consultas realizadas pelo MReport dbdoctrine é o valor padrão, caso não for definido. Para consultas que envolvem o módulo MReport o valor deve ser servicesql. |
|
_freportid |
Esse parâmetro é usado para os relatórios gerados de forma dinâmica pelo módulo SyncFreport |