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: 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
destination	a quem se destina a formação
program	programa do curso
objectives	objectivos do curso
guidelines
webarea_code	código da área web
webarea_description	designação da área web
evaluation_method	método de avaliação definida na ficha de curso
default_cost	Valor do curso por omissão
occupational_areas	áreas de ocupação
*Campos que são devolvidos se o parâmetro only_courses não definido ou passado com o valor zero*
id	id da tabela courseactions	courseactions
courseaction_id	id da ação no humantriain
action_number	n.º da ação
laboral	indica se a ação é laboral ou pós-laboral
web_schedule	informação horária da ação. normalmente usado para mostrar no site
courseaction_status	estado da ação (D: decorrer, E: Espera, N: Não se realiza, T: Terminada)
web_pub	indica se a ação está definida para ser publicada no site