Publicação de cursos/ações de formação
Link: api/courses/get.json
Devolve informação sobre cursos/ações de formação. A informação devolvida estará restringida pelos filtros definidos no ecrã "Configurações do site" (isto se o parâmetro only_courses = 0 ou não definido).
Parâmetros suportados para filtrar informação:
- @param int page: informação relativa a paginação: número da página;
- @param int item_per_page: informação relativa a paginação: número de registos por página;
- @param bit only_courses: indica se devolve apenas informação dos cursos (ignora ações de formação);
- @param string course_type: filtra por tipo de curso;
- @param bit web_pub: filtra pelo campo "Pub.Web" na ficha de curso ou ação de formação, dependendo do parâmetro only_courses;
- @param bit modules: indica se devolve os módulos de cada ação de formação;
- @param bit planning: indica se devolve a planificação dos módulos de cada ação de formação. Apenas funciona se o parâmetro modules for passado com o valor 1;
- @param bit trainers: indica se devolve informação sobre os formadores de cada ação de formação;
- @param bit tolerances: indica se filtra pelas tolerâncias de inscrições;
- @param date evt_start: filtra por ações de formação que iniciam depois desta data. As datas a ter em conta são data de inicio na planificação, e quando esta não está definida, data de inicio da ação definida em candidatura;
- @param string keywords: filtro que será aplicado tendo em conta os campos definidos no ecrã "Configurações do site" em "Selecione os campos que pretende que sejam usados na pesquisa de texto livre";
- @param bit functions: indica se devolve a informação relativa às funções associadas a cada ação de formação.
-
@param date updated_since: quando passada, apenas são devolvidos os cursos que foram alterados a partir daquela data. Se omisso ou null, esta validação não é efetuada. O formato deve ser YYYY-mm-dd HH:mi.Quando se usa esta funcionalidade (solicitar apenas cursos alterados a partir daquela data), aconselha-se a efetuar, pelo menos uma vez por dia, uma chamada a este método (durante uma hora com pouco trafégo - geralmente à noite), para atualização de todos os cursos. Isto porque este método não tem em conta informação de dados eliminados.
-
@param bit
cf_courses:cf_courses: indica que deve devolver os campos de utilizador referentes ao curso
Configurações do site
Este método devolve a seguinte informação:
campo
|
designação | tabela |
course_id
|
id do curso | courses |
course_code
|
código do curso no humantrain | courses |
course
|
designação do curso | courses |
area_code | código da área (da tabela de áreas do humantrain) associado ao curso | courses |
area
|
designação da área | courses |
duration_effect
|
duração do curso em horas | courses |
edition | edição do curso | |
course_type
|
código do tipo de curso | |
course_type_description
|
designação do tipo de curso | |
mode_code
|
código da modalidade de curso | |
mode_code_description
|
designação da modalidade do curso | |