Категории

Идентификаторы

Вопрос: В качестве идентификатора можем ли мы передавать наш внутренний id или необходимо передавать url-адрес?

Ответ: Если в конкретном шаблоне не указано иное, то в качестве идентификатора рекомендуется указывать url. Если в LMS Провайдера формирование идентификатора в таком формате затруднительно, можно указывать внутренний id.

Вопрос: Можно ли unti id методиста ставить в instructor, если там тот же ответственный?

Ответ: Да, такое может быть. Смысл поля в том, чтобы был известен человек, ответственный за то, как формировались и собирались эти данные. Человек, к которому в дальнейшем можно будет обратиться, если возникнут вопросы по этой части.

Вопрос: В "1.1.4_ЦС_Гражданина__прохождение промежуточной аттестации_в_теор_блоке" есть поле "UUID попытки прохождения теста". Возможна ли для данного поля передача идентификатора попытки не в формате UUID?

Ответ: В этом случае придется реализовывать генерацию валидного UUID. К сожалению, вариант иного формата либо вообще отсутствие UUID не подойдет - наша LRS не примет такой ЦС.

Вопрос: Когда мы отправляем цифровой след, то в теле ответа с кодом 200 получаем uuid цифрового следа. Но ранее говорилось, что UUID генерируется на стороне Провайдера. Что из этого корректно?

Ответ: ID цифрового следа, который указан в шаблонах - это UUID цифрового следа, который вы получаете после успешной отправки цифрового следа. Т.е. получен код ответа "200", и в теле ответа будет UUID цифрового следа. Допустимо, если вы будете самостоятельно формировать и передавать этот атрибут в теле цифрового следа.

Вопрос: В элементах ЦС появился ID, ранее в ЦС (других проектов УНТИ) его не было. Теперь непонятно, что нужно делать в случае повторной передачи ЦС?

Ответ: ID будет зависеть от причин для повторной передачи ЦС.

1) Если причина в неуспешной передаче ЦС (любого ЦС - Методиста или Гражданина), то речь идет об отправке одного и того же ЦС, у него не должен меняться ID.
2) Для ЦС Методиста. Если необходимость повторной отправки связана с отменой запланированных активностей либо какими-либо изменениями в ранее переданных плановых данных, то для этого используется шаблон ЦС Методиста "2.4_ЦС_Методиста__отмена_запланированных_занятий,_событий". Такая отмена также должна быть запротоколирована, т.е. этот шаблон ЦС также предусматривает и вложение - письмо Провайдера с обоснованием необходимости отмены.
После отправки ЦС в соответствии с данным шаблоном предыдущий ЦС Методиста (со старым ID) потеряет актуальность и уже не будет учитываться. После последующей отправки актуального ЦС Методиста (с новым ID) будет учитываться только этот актуальный ЦС с новым ID.

3) Для ЦС Гражданина. Если необходимость повторной отправки связана с ранее допущенными в LMS ошибками или неточностями, то после отправки нового ЦС (с новым ID) предыдущий ЦС Гражданина (со старым ID) потеряет актуальность и уже не будет учитываться, будет учитываться только этот актуальный ЦС с новым ID.

Вопрос: Какой id должен быть в ЦС Гражданина, в поле object.id? Должен ли object.id в ЦС гражданина быть равен object.id из ЦС Методиста? Или object.id ЦС гражданина должен быть равен id из ЦС Методиста?

Ответ: В object.id указывается uuid ЦС Методиста, к которому относится данный ЦС Гражданина.

Вопрос: В шаблонах цифрового следа необходимо передавать UNTI ID Методиста. Необходимо ли нам регистрировать нашего методиста в ЛК нашей Организации на сайте 2035 и если да, то как именно?

Ответ: Регистрация Методиста для получения UNTI ID обязательна.

Сначала выполните указанные здесь шаги: https://leader-id.usedocs.com/article/42737

После прохождения регистрации (авторизации) перейдите по ссылке https://cat.2035.university/rall/

После этого остается записать (или запомнить) идентификатор (UNTI). Его можно найти в правом верхнем углу экрана.


Вопрос: Допустимо ли проводить в теоретическом блоке общие вебинары для разных программ и использовать один и тот же идентификатор платформы несколько раз в ЦС программ?

Ответ: Идентификатор видеоконтента, к которому обращаются в рамках разных программ и потоков, в данном случае должен быть один и тот же (если это реально один и тот же видеоконтент, а не его дубли, размещенные в разных местах платформы провайдера или не "аналогичные вебинары", трансляции которых запланированы в разное время).

Таким образом, в ЦС Методиста/Гражданина будут:

  • совпадающий id проекта,
  • id своей программы,
  • id своего потока,
  • свой номер блока (если у всех это будет теоретический блок - это у всех блок номер 1),
  • id своего модуля,
  • совпадающий id видеоконтента.

Вопрос: В каждом из шаблонов следа есть "Уникальный идентификатор следа, UUID". Этот параметр нужно формировать на стороне Сайта (вашей системы) или мы получаем его ответом из Сервиса (нашей системы)?

Ответ: ID цифрового следа, который указан в шаблонах - это UUID цифрового следа, который вы получаете после успешной отправки цифрового следа. Т.е. получен код ответа "200", и в теле ответа будет UUID цифрового следа. Допустимо, если вы будете самостоятельно формировать и передавать этот атрибут в теле цифрового следа.

Вопрос: В ЦС Гражданина в прохождении активностей нужно указать UUID попытки прохождения теста. Что нам нужно передавать в этом параметре? Наш внутренний id записи о прохождении теста или генерировать UUID для текущего стейтмента?

Ответ: Должен быть именно UUID, чтобы LRS приняла запись. Если у вас внутренний id — это UUID, можно передавать его. Если нет — генерировать. Можно на основе вашего внутреннего id, есть алгоритмы генерации UUID как на основе числа, так и на основе строки. Можно сформировать новый.

Вопрос: При отправке тестового ЦС программ выскакивает ошибка по "id": "78afc292-1284-4111-b790-dfd60825a3aa",* // Уникальный идентификатор следа, UUID. Где нужно брать уникальный идентификатор ЦС?

Ответ: Здесь указан полный текст запроса и ответа сервера с указанием кода ошибки. В вашем элементе пустой идентификатор Id: "".

UUID (A Universally Unique Identifier) — стандарт идентификации, используемый в создании ПО, стандартизированный Open Software Foundation как часть DCE — среды распределённых вычислений. Основное назначение UUID — это позволить распределённым системам уникально идентифицировать информацию без центра координации (цитата из Википедии).

Идентификатор имеет подобный вид:

0191c6c3-f722-75ff-a948-db1ce212e686

0191c6c4-95f1-7ed8-93f0-e75d6cb5fc6c

0191c6c4-a8a4-759f-8fbb-720c56eec5c4

9c55eb7b-b75b-4fef-948e-563614779a43

В нашем проекте id должен формироваться на стороне LMS Провайдера, с соблюдением спецификации UUID, что обеспечивает его уникальность.

Вопрос: В старом ЦС [других проектов Университета 2035] мы передавали значения:
https://api.2035.university/module_num
https://api.2035.university/module_id
https://api.2035.university/flow_num
https://api.2035.university/project_id
Теперь в новом ЦС в шаблонах этих значений нет. Они перестали быть актуальны?

Ответ: В данном проекте предусмотрен следующий набор идентификаторов, которые относятся к структурным элементам программы:

"https://api.2035.university/module_num": 1,* // Порядковый номер модуля
"https://api.2035.university/flow_id": 234,* // ID потока на платформе УНТИ 2035
"https://api.2035.university/parent_course_id": 12345,* // ID программы (курса) на платформе УНТИ 2035
"https://api.2035.university/project": "БАС",* // ID проекта (константа) на платформе УНТИ 2035

Идентификаторы других проектов Университета 2035 и их структурных элементов в данном проекте не используются.

Вопрос: В расширениях встречаются следующие параметры:
"https://api.2035.university/parent_course_id": 12345,* // ID программы (курса) на платформе УНТИ 2035
"https://api.2035.university/flow_id": 234,* // ID потока на платформе УНТИ 2035
"type": "http://adlnet.gov/expapi/activities/course"* // Тип объекта (константа шаблона)
Откуда брать эти идентификаторы? Или их нужно генерировать самостоятельно и направлять вам?

Ответ: 1. Касательно "https://api.2035.university/parent_course_id": 12345,* // ID программы (курса) на платформе УНТИ 2035

ID программы можно увидеть в вашем ЛК на платформе Университета 2035. Для этого нужно перейти в карточку вашей программы в разделе "Управление курсами", далее обратить внимание на ссылку - 5 цифр и будут являться ID программы.


2. Касательно "https://api.2035.university/flow_id": 234,* // ID потока на платформе УНТИ 2035

ID потока вы сможете увидеть в разделе "Потоки". ID каждого потока написан в карточке потока.


По умолчанию Провайдеры создавали один произвольный поток, с произвольными датами (таковы технические ограничения Платформы Университета 2035). Далее Провайдеры сами будут создавать новые реальные потоки, и ID потока будет появляться именно на стороне Провайдера.

3. Касательно "type": "http://adlnet.gov/expapi/activities/course"* // Тип объекта (константа шаблона)

Данный идентификатор в шаблоне является константой, значение этого поля менять не нужно.

Вопрос: Почему поле "порядковый номер блока" может содержать всего два значения? "https://api.2035.university/block_num": 1,* // порядковый номер блока (1 - теоретический блок, 2 - практический блок). Можно ли воспринимать это поле как "тип блока"? Если в программе подготовки много теоретических блоков, их передавать все с порядковым номером "1"?

Ответ: Обратите внимание на схему, включенную в атрибутивный состав ЦС в договорной документации (на скриншоте).
В образовательной программе предусмотрен один большой теоретический блок (в шаблонах у него порядковый номер 1), один большой практический блок (в шаблонах у него порядковый номер 2) и итоговая аттестация, не входящая ни в один из блоков.
Это влияет на соответствующую строку в шаблоне ЦС "https://api.2035.university/block_num": 1,* // порядковый номер блока (1 - теоретический блок, 2 - практический блок)


Возможно, вашей сущности "Блок" соответствует указанная на нашей схеме сущность "Тема". Если это так, тогда вы можете передавать ваши "Блоки" как тип элемента "Тема" (чтобы не возникло одноименных сущностей, означающих разное).
Можем предложить следующую иерархию элементов в вашем случае:

Программа -> Модуль -> Тема -> Видеоконтент / Текстовый контент / Теоретические либо практические активности.

Тогда для типа элемента "Тема" заполняется шаблон "2.1.4_ЦС_Методиста__иные_структурные_элементы программы". Родительской активностью для "Темы" будет "Модуль".
"Тема" будет родительской активностью для видеоконтента (записей либо онлайн-трансляций), домашних заданий либо подготовительных материалов, которые относятся к данному занятию и являются его частью.
Для них будут нужны следующие шаблоны:

Вопрос: Что подразумевается под IFI на платформе Университета?

Ответ: Это данные, которые позволяют идентифицировать пользователя.
В строке, где находился комментарий про IFI, вам ничего не указывать не нужно (в примере этот комментарий уже убран).


Достаточно знать, что в этих полях в ЦС указываются значения, как на скриншоте (кроме UNTI ID - там вы должны указать реальный UNTI ID конкретного человека). Также обратите внимание, что в шаблоне в примере речь шла о Методисте, но в других шаблонах могут быть и другие пользователи (Гражданин или др.).

Вопрос: В "2.1.1_ЦС_Методиста__программа" есть переменная "Идентификатор программы на платформе Провайдера" id. Значением этой переменной должна быть ссылка на курс?

Ответ: В качестве идентификатора рекомендуется указывать url. В шаблоне ЦС "2.1.1_ЦС_Методиста__программа" приведен именно такой пример:


Если в LMS Провайдера формирование идентификатора в таком формате затруднительно, можно указывать внутренний id.

Вопрос: Что такое UUID попытки прохождения теста?

Ответ: Идентификатор UUID (универсальный уникальный идентификатор) — это 128-битная метка. UUID формируется на стороне Провайдера, с соблюдением спецификации UUID, что обеспечивает его уникальность. UUID в наших шаблонах предусмотрен не только для попыток прохождения тестов, но и ряда других объектов.