Resumo
Para dar suporte ao Centro de ILT por meio da API, a LearnUpon está alterando seus parâmetros de endpoint do module
. Saiba mais sobre o Centro de ILT: visão geral e recursos.
Os recursos do Centro de ILT estão disponíveis para todos os clientes. A API está disponível dependendo do seu plano da LearnUpon.
Para habilitar recursos de API em módulos do Centro de ILT, a LearnUpon:
- adiciona parâmetros para representar treinamento e sessões
- altera o funcionamento do
id
do módulo
A partir de 7 de março de 2022: nos módulos criados no Centro de ILT, o id
do módulo não é mais exclusivo para um único módulo de ILT, mas está associado a tantas sessões de ILT quanto forem criadas no módulo.
Essa alteração pode afetar integrações personalizadas que atualmente dependem de um id
exclusivo para cada módulo de ILT.
Essa alteração se aplica somente aos módulos do Centro de ILT, nenhum outro id
do módulo está sendo alterado.
Você pode continuar usando os módulos de ILT legados dentro dos cursos. Não é possível adicionar módulos legados e do Centro de ILT ao mesmo curso.
Os exemplos práticos a seguir são do mesmo portal de demonstração. Eles ilustram como o id
do módulo funciona de forma diferente com diferentes módulos de ILT.
Exemplo de módulo do Centro de ILT
O exemplo a seguir mostra:
id
do módulo associado a várias sessõestraining_id
identifica o “bloco” que hospeda sessões, associadas a várias sessõessession_id
é o identificador exclusivo para sessões individuais
Exemplo de resposta para o módulo do Centro de ILT com várias sessões usando o mesmo id
do módulo
{
"modules": [
{
"id": 405223,
"title": "Use APIs para aproveitar a automação ao máximo",
"number_of_linked_courses": 4,
"tags": null,
"training_id": 14307,
"session_id": 12222,
"created_at": "2021-11-17T13:54:22Z",
"updated_at": "2021-12-23T11:51:41Z",
"exam_id": null,
"component_type": "ilt session",
"description_html": "Use a API da LearnUpon para facilitar ainda mais a criação de usuários e inscrições.",
"description_text": "Use a API da LearnUpon para facilitar ainda mais a criação de usuários e inscrições.",
"creator_id": 240669,
"creator_first_name": "Elsa",
"creator_last_name": "Bouvier",
"creator_email": "elsa.bouvier@suaempresa.com",
"assignment_passing_percentage": "",
"assignment_question_html": "",
"assignment_question_text": "",
"location_id": -1,
"location": "",
"address_1": "",
"address_2": null,
"address_3": "",
"location_country_code": "",
"location_state_code": "",
"start_at": "2022-01-05T11:00:00Z",
"end_at": "2022-01-05T12:30:00Z",
"timezone": "Dublin",
"number_enrolled_on_session": 8,
"max_capacity": 10,
"session_tutor_id": 240669,
"tutor_first_name": "Elsa",
"tutor_last_name": "Bouvier",
"tutor_email": "elsa.bouvier@suaempresa.com"
},
{
"id": 405223,
"title": "Use APIs para aproveitar a automação ao máximo",
"number_of_linked_courses": 4,
"tags": null,
"training_id": 14307,
"session_id": 12333,
"created_at": "2021-11-23T10:54:02Z",
"updated_at": "2021-11-23T12:32:09Z",
"exam_id": null,
"component_type": "ilt session",
"description_html": "Use a API da LearnUpon para facilitar ainda mais a criação de usuários e inscrições.",
"description_text": "Use a API da LearnUpon para facilitar ainda mais a criação de usuários e inscrições.",
"creator_id": 240669,
"creator_first_name": "Elsa",
"creator_last_name": "Bouvier",
"creator_email": "elsa.bouvier@suaempresa.com",
"assignment_passing_percentage": "",
"assignment_question_html": "",
"assignment_question_text": "",
"location_id": -1,
"location": "",
"address_1": "",
"address_2": null,
"address_3": "",
"location_country_code": "",
"location_state_code": "",
"start_at": "2021-11-24T11:00:00Z",
"end_at": "2021-11-24T12:30:00Z",
"timezone": "Dublin",
"number_enrolled_on_session": 3,
"max_capacity": 3,
"session_tutor_id": 240669,
"tutor_first_name": "Elsa",
"tutor_last_name": "Bouvier",
"tutor_email": "elsa.bouvier@suaempresa.com"
},
{
"id": 405223,
"title": "Use APIs para aproveitar a automação ao máximo",
"number_of_linked_courses": 4,
"tags": null,
"training_id": 14307,
"session_id": 12355,
"created_at": "2021-11-23T15:47:21Z",
"updated_at": "2021-11-24T12:20:56Z",
"exam_id": null,
"component_type": "ilt session",
"description_html": "Use a API da LearnUpon para facilitar ainda mais a criação de usuários e inscrições.",
"description_text": "Use a API da LearnUpon para facilitar ainda mais a criação de usuários e inscrições.",
"creator_id": 240669,
"creator_first_name": "Elsa",
"creator_last_name": "Bouvier",
"creator_email":"elsa.bouvier@suaempresa.com",
"assignment_passing_percentage": "",
"assignment_question_html": "",
"assignment_question_text": "",
"location_id": -1,
"location": "",
"address_1": "",
"address_2": null,
"address_3": "",
"location_country_code": "",
"location_state_code": "",
"start_at": "2021-11-25T13:00:00Z",
"end_at": "2021-11-25T14:30:00Z",
"timezone": "Dublin",
"number_enrolled_on_session": 2,
"max_capacity": 2,
"session_tutor_id": 291141,
"tutor_first_name": "Berengar",
"tutor_last_name": "Hesse",
"tutor_email": "demouser1@suaempresa.com"
},
]
}
Exemplo de módulo de ILT legado
Para módulos de ILT legados, cria-se uma única sessão por módulo.
O exemplo a seguir mostra:
- o
id
do módulo é exclusivo para cada módulo training_id
nulosession_id
nulo
Exemplo de resposta para o módulo de ILT legado, com exclusivo id
do módulo por módulo de ILT
{
"modules": [
{
"id": 552896,
"title": "New course with live training",
"number_of_linked_courses": 1,
"tags": null,
"training_id": null,
"session_id": null,
"created_at": "2022-02-02T14:52:54Z",
"updated_at": "2022-02-02T14:52:54Z",
"exam_id": null,
"component_type": "ilt session",
"description_html": null,
"description_text": null,
"creator_id": 240669,
"creator_first_name": "Elsa",
"creator_last_name": "Bouvier",
"creator_email": "elsa.bouvier@suaempresa.com",
"assignment_passing_percentage": "",
"assignment_question_html": "<p>Aprenda a melhor maneira de usar APIs para criar usuários e inscrições na LearnUpon.</p>",
"assignment_question_text": "Aprenda a melhor maneira de usar APIs para criar usuários e inscrições na LearnUpon.",
"location_id": Nulo,
"local": "",
"address_1": "",
"address_2": "",
"address_3": "",
"location_country_code": "",
"location_state_code": "",
"start_at": "2022-02-08T13:00:00Z",
"end_at": "2022-02-08T14:00:00Z",
"timezone": "Dublin",
"number_enrolled_on_session": 0,
"max_capacity": 5,
"session_tutor_id": null,
"tutor_first_name": "",
"tutor_last_name": "",
"tutor_email": ""
},
{
"id": 552897,
"title": "New course with live training",
"number_of_linked_courses": 1,
"tags": null,
"training_id": null,
"session_id": null,
"created_at": "2022-02-02T14:54:20Z",
"updated_at": "2022-02-02T14:54:20Z",
"exam_id": null,
"component_type": "ilt session",
"description_html": null,
"description_text": null,
"creator_id": 240669,
"creator_first_name": "Elsa",
"creator_last_name": "Bouvier",
"creator_email": "elsa.bouvier@suaempresa.com",
"assignment_passing_percentage": "",
"assignment_question_html": "<p>Aproveite ao máximo as APIs para criar usuários na LearnUpon.</p>",
"assignment_question_text": "Aproveite ao máximo as APIs para criar usuários na LearnUpon.",
"location_id": Nulo
, "location": "",
"address_1": "",
"address_2": "",
"address_3": "",
"location_country_code": "",
"location_state_code": "",
"start_at": "2022-02-11T20:00:00Z",
"end_at": "2022-02-11T21:00:00Z",
"timezone": "Central Time (US & Canada)",
"number_enrolled_on_session": 0,
"max_capacity": 5,
"session_tutor_id": null,
"tutor_first_name": "",
"tutor_last_name": "",
"tutor_email": ""
}
]
}
Consulte: