Add Comments to Your LMS via LTI 1.3

1. Войдите в FastComments и перейдите на вашу страницу конфигурации LTI 1.3.
2. (Необязательно) Выберите платформу, с которой вы подключаетесь, в выпадающем списке Platform - это задаёт отображаемую метку, но Auto-detect работает нормально.
3. Нажмите Generate URL. Появится одноразовый Registration URL (действителен 30 минут, одноразовый).
4. В вашем LMS откройте экран динамической регистрации LTI 1.3 и вставьте URL в поле Tool initiation registration endpoint (или эквивалентное). Отправьте.
5. Ваш LMS выполняет обратный вызов в FastComments, обменивается ключами и создаёт интеграцию. Всплывающее окно закрывается само по завершении.
6. Вернувшись в FastComments, новая конфигурация появится в таблице Existing Configurations. Инструмент теперь доступен внутри курсов вашего LMS.

FastComments LTI 1.3 протестирован на следующих платформах:

• D2L Brightspace (любая версия с LTI Advantage)
• Moodle 4.0+ (плагин External Tool, LTI Advantage)
• Blackboard Learn (SaaS и Ultra)
• Sakai (версии с поддержкой LTI Advantage)
• Schoology (Enterprise, Dynamic Registration там, где доступно)

Любая другая LMS, которая реализует спецификацию IMS LTI 1.3 Advantage с Dynamic Registration, тоже должна работать — выберите Other LTI 1.3 platform в выпадающем списке платформ при создании вашего URL регистрации (получить его здесь).

Canvas LMS использует другой процесс настройки (per-developer-key configuration JSON вместо Dynamic Registration). См. отдельное руководство по установке Canvas LMS.

Перейдите к конфигурации LTI 1.3

Войдите в FastComments и перейдите на вашу страницу конфигурации LTI 1.3.

Если у вашего аккаунта ещё нет доступа к LTI, вы увидите "LTI not enabled for this account" — свяжитесь со службой поддержки, чтобы включить его в вашем плане.

Выберите платформу (необязательно)

В разделе Generate a Dynamic Registration URL используйте выпадающее меню Platform, чтобы указать FastComments, к какой LMS вы подключаетесь:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Other LTI 1.3 platform

Вы также можете оставить значение Auto-detect. Платформа считывается из openid-configuration вашей LMS во время регистрации; выпадающее меню только задаёт метку отображения для полученной конфигурации.

Создать URL

Нажмите Создать URL. FastComments создаст одноразовый регистрационный токен и покажет вам URL вида:

https://fastcomments.com/lti/v1p3/register/<long-token>

Скопируйте его. Этот URL:

• Является одноразовым — как только ваша LMS успешно обратится к нему, токен будет использован.
• Истекает через 30 минут, если не используется.
• Должен храниться в тайне — любой, у кого есть этот URL, сможет зарегистрировать инструмент для вашего tenant в течение этих 30 минут.

Существующие конфигурации

После успешного завершения регистрации новая конфигурация появится в таблице Existing Configurations на той же странице, с её Platform, Issuer, Client ID и Status. Вы можете удалить конфигурации из этой таблицы, если вам когда-либо потребуется снять регистрацию.

D2L Brightspace предоставляет Динамическую регистрацию через интерфейс администратора LTI Advantage. Потребуется доступ администратора.

Open the Registration Screen

1. Sign in to your Brightspace instance as an admin.
2. Navigate to Admin Tools > Manage Extensibility > LTI Advantage.
3. Click Register Tool. (The direct URL is https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Paste the URL

You'll see a registration form. The key field is Tool initiation registration endpoint (some Brightspace versions label it "Tool Initiation Registration URL").

Paste the FastComments registration URL (получите его здесь) into that field. Leave the other fields blank - they're auto-populated by FastComments during the registration handshake.

Click Register.

Approve the Tool

Brightspace opens a popup that talks to FastComments, exchanges keys, and shows a confirmation screen. The popup closes itself when registration completes.

The new tool appears in your LTI Advantage tool list. By default Brightspace marks new tools as disabled - flip the toggle to enabled so your courses can use it.

Add a Deployment

In Brightspace, LTI tools need a deployment before they can be used in courses:

1. Open the newly-registered FastComments tool.
2. Click View Deployments > New Deployment.
3. Give the deployment a name (e.g. "FastComments - All Courses"), pick the org units it should be available in, and save.

After the first launch through this deployment, FastComments pins the deployment_id to its configuration record - subsequent launches from a different deployment under the same client will be rejected unless you re-register.

Используете Moodle? Мы также выпускаем специальный плагин для Moodle для FastComments с более тесной интеграцией, чем LTI 1.3 (синхронизация оценок, более подробная отчетность по активностям, нативный интерфейс настроек Moodle). См. руководство по установке плагина Moodle. Поток LTI 1.3 ниже — правильный выбор, если вы хотите одну регистрацию, которая также покрывает другие LMS, или если администратор вашего Moodle не будет устанавливать сторонние плагины.

Moodle 4.0+ поддерживает динамическую регистрацию LTI 1.3 через плагин External Tool.

Откройте экран управления инструментами

1. Войдите в Moodle как администратор сайта.
2. Перейдите в Администрирование сайта > Плагины > Модули активности > Внешний инструмент > Управление инструментами.

Вставьте URL

Вы увидите карточку с надписью URL инструмента. Вставьте URL регистрации FastComments (получить его здесь) в текстовое поле и нажмите Добавить LTI Advantage.

Moodle откроет экран регистрации, показывающий идентификацию инструмента и запрашиваемые разрешения. Проверьте и нажмите Активировать (или Зарегистрировать, в зависимости от версии Moodle).

Всплывающее окно закроется после завершения регистрации; новый инструмент FastComments появится в списке Инструменты со статусом Активный.

Сделать доступным

По умолчанию Moodle добавляет новые инструменты в список "Инструменты курса", но не показывает их в выборе активности. Чтобы сделать FastComments доступным во всём курсе:

1. Нажмите на значок шестерёнки на плитке FastComments.
2. В разделе Использование конфигурации инструмента выберите Показывать в выборе активности и как предварительно настроенный инструмент.
3. Сохранить.

Преподаватели теперь могут добавить FastComments в любой курс через Добавить активность или ресурс > FastComments.

Blackboard Learn SaaS и Ultra поддерживают динамическую регистрацию LTI 1.3.

Откройте экран поставщика инструментов

1. Войдите в Blackboard как системный администратор.
2. Перейдите в Administrator Panel > Integrations > LTI Tool Providers.
3. Нажмите Register LTI 1.3 / LTI Advantage Tool.

Если вы видите только "Register LTI 1.1 Provider", ваша версия Blackboard ещё не поддерживает LTI 1.3 — обновите её или обратитесь в службу поддержки Blackboard.

Вставьте URL

Вставьте URL регистрации FastComments (получить его здесь) в поле Client ID / Registration URL (наименование полей в Blackboard зависит от версии). Отправьте.

Blackboard выполняет процесс обмена регистрационными данными с FastComments и показывает экран подтверждения.

Одобрите и включите

Blackboard по умолчанию помечает вновь зарегистрированные инструменты как Approved but excluded:

1. Найдите запись FastComments в списке поставщиков инструментов.
2. Откройте меню и выберите Edit.
3. Установите Tool Status в значение Approved.
4. В разделе Institution Policies проверьте, какие данные пользователя отправляются (name, email, role). Сохраните.

Инструмент теперь доступен преподавателям при добавлении контента в курсы.

Sakai

Sakai поддерживает LTI 1.3 Dynamic Registration в релизах с LTI Advantage. В рабочей области администратора:

1. Войдите как администратор Sakai и откройте Рабочую область администратора.
2. Выберите Внешние инструменты > Установить инструмент LTI 1.3.
3. Вставьте URL регистрации FastComments (получить его здесь) и отправьте.
4. Одобрите инструмент после завершения рукопожатия.

Инструмент затем появится в разделе Внешние инструменты и может быть добавлен на сайты их администраторами.

Schoology

Инстансы Schoology Enterprise поддерживают LTI 1.3, но доступность Dynamic Registration варьируется в зависимости от развертывания. Свяжитесь с вашим менеджером по работе с аккаунтом Schoology.

Если Dynamic Registration недоступна в вашем экземпляре Schoology, вам потребуется настроить интеграцию вручную, используя эти эндпоинты:

• OIDC Login URL: https://fastcomments.com/lti/v1p3/login
• Target Link URL: https://fastcomments.com/lti/v1p3/launch
• Public Keyset URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• Redirect URLs: https://fastcomments.com/lti/v1p3/launch

После того как Schoology предоставит вам Client ID и Deployment ID, свяжитесь со службой поддержки FastComments, чтобы зарегистрировать конфигурацию в вашем тенанте.

Other LTI 1.3 Platforms

Любая LMS, соответствующая спецификации IMS LTI 1.3 Advantage, должна работать с тем же URL регистрации (получить его здесь). Ищите настройку с названием "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" или похожую.

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

Эта страница описывает добавление FastComments в курс Brightspace после того, как администратор зарегистрировал инструмент и создал развертывание. Если инструмент ещё не зарегистрирован, сначала смотрите руководство по регистрации D2L.

FastComments, встроенный как тема раздела в Brightspace

Brightspace поставляется с двумя средами для создания контента: Classic Content и New Content Experience (также называемой Lessons). Обе поддерживают FastComments, но пути в меню различаются. В каждом разделе ниже описаны оба варианта там, где они отличаются.

Найдите инструмент FastComments

Инструмент FastComments появляется в двух местах внутри редактора контента курса:

1. В селекторе активности, доступном через кнопку Add Existing модуля/раздела (в старых версиях Brightspace помечается как Add Existing Activities). В текущих сборках Brightspace FastComments отображается напрямую в селекторе; в старых версиях он вложен в подменю External Learning Tools. Любой путь добавляет FastComments как отдельную тему.
2. В диалоге Insert Stuff внутри HTML-редактора, в разделе LTI Advantage. Это встраивает FastComments в HTML-тему через поток глубокой привязки LTI.

Если FastComments не отображается ни в одном из селекторов, развертывание не включено для организационной единицы (org unit), в которой находится курс. Попросите администратора Brightspace открыть Admin Tools > Manage Extensibility > LTI Advantage > инструмент FastComments > View Deployments, открыть развертывание и добавить организационную единицу курса (или родительскую организационную единицу) в раздел Org Units.

Добавление FastComments как темы в модуле

Classic Content:

1. Откройте курс и нажмите Content в навигационной панели.
2. Выберите модуль, который должен содержать обсуждение (или создайте его через Add a module).
3. Нажмите Add Existing (в старом Brightspace: Add Existing Activities > External Learning Tools).
4. В селекторе нажмите FastComments. Brightspace создаст тему в модуле и вернёт вас в представление контента.
5. Нажмите новую тему. Переименуйте её в что-то описательное, например FastComments Discussion, используя встроенный редактор заголовка.

New Content Experience (Lessons):

1. Откройте курс и нажмите Content.
2. Откройте юнит и lesson, которые должны содержать обсуждение.
3. Нажмите Add > Existing Activity и выберите FastComments (в старом Brightspace: вложено в External Learning Tools).
4. Активность добавляется в lesson.
5. Нажмите заголовок активности, чтобы переименовать её.

При первом открытии темы любым пользователем (инструктором или студентом) FastComments инициализирует поток для этой ресурсной ссылки. Поток привязан к идентификатору resource link, поэтому переименование или перемещение темы не меняет загружаемый поток.

Встроить FastComments внутри HTML-темы

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

1. Откройте или создайте HTML-тему в модуле/lesson.
2. Нажмите Edit HTML, чтобы открыть HTML-редактор Brightspace.
3. Поместите курсор туда, где должен появиться поток комментариев.
4. Нажмите кнопку Insert Stuff (иконка пазла в панели инструментов редактора).
5. В диалоге Insert Stuff прокрутите до LTI Advantage и нажмите FastComments.
6. FastComments откроет селектор глубокой привязки. Подтвердите размещение (параметры по умолчанию подходят для обсуждений контента); нажмите Insert или Continue.
7. Brightspace вернётся в HTML-редактор с блоком-заполнителем, представляющим LTI-запуск. Нажмите Save and Close в теме.

Когда тема загрузится, Brightspace заменит заполнитель на iframe, который автоматически запустит FastComments через LTI. Студенты увидят поток обсуждения прямо на странице.

Одна HTML-тема может содержать несколько глубоких привязок FastComments. Каждое встраивание получает свой поток, потому что каждая глубокая ссылка создаёт отдельный идентификатор resource link.

Тема модуля против встроенного быстрого линка

Выберите подход «тема модуля», когда:

• Обсуждение является основной активностью на этом шаге модуля.
• Вы хотите, чтобы тема отображалась в оглавлении Brightspace, в отслеживании выполнения и в Class Progress.

Выберите подход «встроенное встраивание», когда:

• Комментарии должны находиться под другим содержимым на той же странице.
• Вы не хотите отдельный элемент в оглавлении, отслеживаемый на выполнение.

Видимость, черновик и условия выпуска

Новая тема FastComments по умолчанию видна студентам. Чтобы скрыть её, пока вы настраиваете:

1. В редакторе контента нажмите заголовок темы (Classic) или меню с тремя точками на активности (New Content Experience).
2. Установите статус Draft (Classic) или переключите видимость Visibility в положение выкл. (New Content Experience).

Темы в статусе черновика (Draft) невидимы студентам. Инструкторы и ассистенты всё ещё видят их с бейджем «Draft».

Чтобы ограничить тему для конкретной группы или секции:

1. Откройте тему.
2. Нажмите меню заголовка темы > Edit Properties In-place (Classic) или Edit > Restrictions (New Content Experience).
3. В разделе Release Conditions нажмите Create.
4. Выберите Group enrollment или Section enrollment, выберите группу/секцию и сохраните.

Условия выпуска суммируются с собственной системой сопоставления ролей FastComments. Студенты, которые не видят тему, не получат LTI‑запуск.

Что видят студенты при первом запуске

Когда студент нажимает тему (или загружает HTML-тему с встраиванием):

1. Brightspace выполняет LTI 1.3 запуск в фоне.
2. FastComments получает имя студента, email, URL аватара и роль в LMS, и автоматически их аутентифицирует. Запроса на вход в FastComments не отображается.
3. Поток комментариев для этой ресурсной ссылки рендерится внутри iframe Brightspace.

Сопоставление ролей при запуске:

• Brightspace Administrator становится в FastComments администратором (admin) для потока (полный модерационный доступ: модерация, удаление, бан и доступ к настройкам).
• Brightspace Instructor становится в FastComments модератором (moderator) (закрепление, скрытие, удаление, бан).
• Все остальные роли (Learner, TeachingAssistant и т. д.) становятся обычными комментаторами.

Комментарии привязываются к учётной записи студента в Brightspace. Если студент изменит своё имя или аватар в Brightspace, при следующем LTI‑запуске изменения синхронизируются.

Высота iframe и изменение размера

FastComments посылает postMessage org.imsglobal.lti.frameResize при каждом рендере потока и при изменениях контента (новый комментарий, разворачивание ответов). Brightspace слушает это сообщение и корректирует высоту iframe, чтобы поток не обрезался и не отображалась внутренняя полоса прокрутки.

Если iframe остаётся зафиксированным на небольшой высоте:

• Убедитесь, что курс загружается по HTTPS. Слушатель postMessage Brightspace отклоняет фреймы смешанного контента.
• Убедитесь, что никакое расширение браузера не блокирует канал postMessage.
• Для встроенных в HTML-тему вставок окружающий HTML не должен оборачивать iframe в контейнер с фиксированной высотой. Удалите любой inline-атрибут style="height: ..." у родительского элемента.

Специфические подводные камни Brightspace

Инструмент не отображается в селекторе Add Existing. Развертывание не включено для организационной единицы этого курса. Администратору нужно добавить орг. единицу (или родительскую) в список Org Units развертывания. Регистрация инструмента сама по себе недостаточна; развертывание определяет, в каких курсах инструмент виден.

Несоответствие deployment_id при запуске. FastComments привязывает (TOFU) первый увиденный deployment_id для регистрации. Если администратор удалит исходное развертывание и создаст новое, запуски из нового развертывания будут отклоняться с ошибкой несоответствия развертывания. Решение — повторно зарегистрировать FastComments (сгенерировать новый URL регистрации (получить его здесь) и запустить динамическую регистрацию снова); старая запись конфигурации будет заменена.

Инструмент запускается, но отображает «Invalid LTI launch». Курс находится в другой структуре тенанта/организации, чем охватывает развертывание, или развертывание было отключено после регистрации. Повторно проверьте Admin Tools > Manage Extensibility > LTI Advantage > FastComments > переключатель Enabled и список организационных единиц развертывания.

Имена и роли отсутствуют внутри FastComments. Brightspace отправляет LTI‑запуски с утверждениями NRPS (Names and Role Provisioning Services). Если курс был обновлён из старой LTI 1.1 ссылки, в запуске отсутствуют утверждения name и email. Повторно добавьте тему FastComments через Add Existing (не мигрируйте старую ссылку), чтобы запуск использовал LTI 1.3.

Встраивание показывает экран входа вместо автологина SSO. HTML-тема была вставлена как обычный <iframe>, указывающий на FastComments, а не через Insert Stuff > LTI Advantage. Обычные iframe пропускают LTI‑запуск и приводят пользователей на публичную страницу FastComments. Удалите iframe и вставьте снова через поток Insert Stuff.

После того как администратор зарегистрировал FastComments как инструмент LTI 1.3 Advantage и утвердил политики учреждения, преподаватели добавляют его в курсы через стандартные точки размещения Blackboard. Точные шаги отличаются для Ultra Course View и Original Course View, поэтому ниже рассмотрены оба варианта.

Ultra Course View

Ultra Course View является значением по умолчанию в Blackboard Learn SaaS с 2026 года.

1. Откройте курс и перейдите на страницу Course Content.
2. Наведите курсор или нажмите в том месте оглавления, где вы хотите разместить поток комментариев, и нажмите фиолетовую кнопку + (Add content).
3. Выберите Content Market. Панель Content Market перечисляет все утверждённые LTI-инструменты и размещения Building Block для вашего учреждения.
4. Найдите плитку FastComments и нажмите её. Blackboard создаст элемент содержания на позиции, где вы открыли меню +.
5. По умолчанию элемент появляется в оглавлении как запись «Visible to students» для преподавателей, у которых в личных настройках по умолчанию отключен параметр Hide from students. Если ваш параметр по умолчанию — Hidden, элемент создаётся скрытым, и вы можете переключить селектор видимости на строке элемента, когда будете готовы.
6. Чтобы переименовать элемент, щёлкните по заголовку в оглавлении и введите новый ярлык. Заголовок, который видят студенты в оглавлении, независим от идентификатора потока FastComments, поэтому переименование безопасно в любое время.

Если вы не видите Content Market в списке, в вашем учреждении это размещение скрыто. Тот же выбор можно открыть через More tools в том же меню + в группе LTI Tools.

Original Course View

Original Course View по‑прежнему поддерживается в Learn SaaS и остаётся основным интерфейсом для саморазвёрнутых сайтов Learn 9.1 на ветке релизов Q4 2024 CU.

1. Откройте курс и войдите в Content Area (например, в стандартную область Information или Content в меню курса).
2. Включите Edit Mode с помощью переключателя в правом верхнем углу страницы.
3. Нажмите Build Content на панели действий.
4. В подменю Learning Tools нажмите FastComments. Подменю Learning Tools заполняется из размещений инструментов LTI 1.3 после регистрации инструмента администратором. Если вы не видите его, см. раздел о типичных проблемах ниже.
5. В форме Create FastComments установите:
   • Name: метка, которую видят студенты в области содержания.
   • Description: необязательный текст, отображаемый над встроенным потоком.
   • Permit Users to View this Content: переключатель доступности Да/Нет.
   • Track Number of Views: включите, если хотите статистику просмотров по элементам в Blackboard. FastComments ведёт собственную аналитику независимо.
   • Date and Time Restrictions: необязательные окна Display After / Display Until.
6. Отправьте форму. Инструмент появится как кликабельный элемент в области содержания.

Встраивание внутрь элемента или документа

В обеих версиях курса преподаватели встраивают FastComments непосредственно в тело элемента, документа или любое поле с расширенным текстом через кнопку LTI Advantage в Content Editor.

Ultra Course View:

1. Создайте или отредактируйте Document.
2. Нажмите Add content внутри тела документа там, где вы хотите разместить поток.
3. В панели инструментов редактора откройте меню Insert content и нажмите Content Market (точка входа LTI Advantage / Deep Linking).
4. Выберите FastComments. FastComments возвращает payload глубокой ссылки, и Blackboard вставляет встроенный блок в тело документа в позиции курсора.
5. Сохраните документ. Студенты увидят поток, отображённый inline, по мере прокрутки страницы.

Original Course View:

1. Отредактируйте любой элемент с телом в формате расширенного текста.
2. В панели инструментов Content Editor нажмите значок плюса Add Content и выберите Content Market (в старых Q4 2024 CU это помечено как Add Content from External Tool).
3. Выберите FastComments. Редактор вставит блок‑заполнитель, ссылающийся на ресурс глубокой ссылки.
4. Отправьте элемент.

Каждое встраивание через глубокую ссылку создаёт собственный поток FastComments, поэтому элемент с двумя встроенными блоками FastComments будет иметь два независимых потока комментариев.

Видимость, условия выпуска и ограничения по группам

Элементы содержания FastComments ведут себя как любые другие элементы содержания Blackboard в отношении правил контроля доступа, применяемых к ним.

• Ultra: щёлкните селектор видимости в строке (Visible to students, Hidden from students, Conditional availability). Conditional availability поддерживает окна даты/времени, правила по результатам в gradebook и правила членства по группам курса.
• Original: откройте контекстное меню элемента и выберите Adaptive Release или Adaptive Release: Advanced, чтобы ограничить доступ к инструменту по дате, членству, оценке или статусу рецензирования. Используйте Set Group Availability на элементе, чтобы ограничить доступ конкретными группами курса.

FastComments соблюдает решения Blackboard о допуске. Если Blackboard скрывает элемент от студента, LTI‑запуск для этого студента не происходит, и он не появится в представлении модератора.

Поведение с Gradebook

FastComments не передаёт оценки обратно через LTI Advantage Assignment and Grade Services. Для элементов содержания FastComments столбец оценок автоматически не создаётся.

Если ваш арендатора Blackboard настроен на автоматическое создание столбца в gradebook для каждого нового элемента содержания вне зависимости от метаданных об оценивании, пустой столбец появится в любом случае. Чтобы скрыть его:

• Ultra: откройте Gradebook, нажмите заголовок столбца, выберите Edit и выключите Show to students и Include in calculations. Либо используйте Delete, если в вашем учреждении разрешено удалять столбцы для неоценённых элементов.
• Original: откройте Grade Center, нажмите шеврон у столбца, выберите Hide from Users (on/off) и при необходимости Hide from Instructor View в разделе Column Organization.

Что видят студенты

Когда студент открывает элемент FastComments или прокручивает страницу до встроенного блока:

1. Blackboard отправляет сообщение LTI 1.3 в FastComments. Студент автоматически входит через SSO, используя свою учётную запись Blackboard (имя, email, аватар, роль) без отображения формы входа.
2. Поток комментариев рендерится в iframe. Наличие вложенности, ответов, упоминаний и реакций зависит от настроек виджета комментариев в FastComments.
3. Их комментарии атрибутируются их учётной записи Blackboard. Если студент позже изменит имя или фото в Blackboard, при следующем запуске профиль FastComments обновится.

Отображение ролей из Blackboard в FastComments:

• System Administrator и Course Builder отображаются как FastComments admin.
• Instructor и Teaching Assistant отображаются как FastComments moderator.
• Student, Guest и Observer отображаются как FastComments commenter.

Модераторы видят элементы управления модерацией (pin, hide, ban, delete) в интерфейсе для каждого комментария в потоке.

Область действия потока

FastComments ограничивает область действия каждого потока по тройке (Blackboard host, course ID, resource link ID). Два элемента FastComments в одном курсе создают два разных потока. Тот же самый элемент, скопированный в другие оболочки курса (например, при копировании курса), создаёт два потока, потому что Blackboard выдаёт новый resource link ID при копировании. Чтобы сохранить общий поток при копировании курса, используйте Deep Linking с явным URN потока, настроенным в FastComments до запуска копирования.

Частые особенности и проблемы, специфичные для Blackboard

Плитка FastComments отсутствует в меню Build Content (Original) или Content Market (Ultra). Администратор утвердил инструмент, но оставил политику учреждения, блокирующую соответствующее размещение. Перейдите в Administrator Panel > Integrations > LTI Tool Providers, отредактируйте запись FastComments и убедитесь, что размещения Course Content Tool (Original) и Course Content Tool - allow students / Deep Linking content tool (Ultra) включены. Сохраните и обновите страницу курса.

Ошибка «Tool not configured for this context» или «Tool is not deployed» при запуске. Область развертывания, зарегистрированная во время динамической регистрации, не соответствует контексту учреждения, к которому принадлежит курс. В записи поставщика инструментов Blackboard проверьте, что Deployment ID совпадает с тем, что FastComments показывает на странице конфигурации LTI 1.3 для этого арендатора. Если они отличаются, удалите размещение и повторно выполните динамическую регистрацию с нового URL регистрации (получить её здесь).

Высота iframe выглядит фиксированной или содержимое обрезается. Некоторые арендаторы Blackboard используют строгую политику Content Security Policy, которая блокирует стандартный postMessage для изменения размера LTI‑iframe. FastComments отправляет как Canvas‑совместимое сообщение lti.frameResize, так и сообщение в форме IMS спецификации org.imsglobal.lti.frameResize, чтобы максимизировать совместимость, но глобальное переопределение CSP на уровне арендатора может блокировать слушатель в родительском окне. Попросите вашего администратора подтвердить, что *.fastcomments.com находится в белом списке LTI‑инструментов и что никакой пользовательский заголовок CSP не удаляет события postMessage. После этого изменение размера будет работать без дополнительной настройки.

Копирование курса дублирует потоки. При копировании курса Blackboard выдаёт новые resource link ID для LTI‑размещений, поэтому в скопированных курсах потоки начинают пустыми. Это ожидаемо. Если вам нужно, чтобы скопированный курс унаследовал оригинальный поток, настройте Deep Linking с явным URN потока до копирования или обратитесь в поддержку FastComments для массового переназначения идентификаторов потоков.

Студент видит общую ошибку Blackboard при запуске. Причина — отсутствующая или устаревшая email claim. Убедитесь, что политика учреждения для FastComments имеет включенные поля Role, Name и Email Address в разделе User Fields to Send. Сохраните настройки, затем выполните запуск снова в новой сессии браузера.

"Токен регистрации не найден, истёк или уже использован"

Токен в вашем URL для регистрации (получить его здесь) действителен в течение 30 минут и может быть использован только один раз. Если ваш LMS занял больше времени, или если попытка регистрации была повторно выполнена после успешной регистрации, токен будет отклонён. Сгенерируйте новый URL на странице конфигурации FastComments LTI 1.3 и начните заново.

"Platform rejected registration"

Ваш LMS отклонил попытку регистрации. Наиболее частые причины:

• Tool already registered with the same client name. Некоторые платформы (в частности D2L) отклоняют повторную регистрацию "FastComments", пока предыдущая запись не будет удалена. Удалите старый инструмент в вашем LMS, затем повторите попытку.
• Wrong field in the LMS. Убедитесь, что вы вставили URL в поле registration / tool initiation registration endpoint, а не в поле launch URL или login URL.
• The LMS doesn't actually support Dynamic Registration. Старые версии Moodle и Blackboard заявляют поддержку LTI 1.3, но позволяют только ручную настройку. Проверьте документацию вашей платформы.

"Failed to fetch platform configuration"

FastComments не смог прочитать документ openid-configuration вашего LMS. Такое случается редко и обычно означает, что LMS предоставил некорректный или недоступный discovery URL. Обратитесь в поддержку вашего LMS.

Launch shows "Configuration not found"

Либо конфигурация в FastComments была удалена, либо запуск пришёл от пары iss/client_id, которую мы не распознаём. Если вы удалили и повторно зарегистрировали, попросите ваш LMS удалить и заново добавить инструмент FastComments, чтобы он получил новый client_id.

Launch shows "Deployment not registered"

Вы запустили FastComments из развертывания Brightspace/Moodle/Blackboard, отличного от того, в котором он был запущен впервые. FastComments закрепляет deployment_id при первом запуске в качестве проверки безопасности. Чтобы добавить новое развертывание для того же клиента, обратитесь в поддержку — мы добавим deployment ID в конфигурацию.

Launch shows "Unsupported message_type"

LMS отправил LTI-сообщение, которое FastComments не обрабатывает (например, LtiSubmissionReviewRequest). FastComments поддерживает только стандартные потоки resource-link launch и deep-linking. Свяжитесь с нами, если вам нужен конкретный тип сообщения.

Iframe doesn't resize

Большинство LMS автоматически подстраивают размер LTI iframe. Если ваш этого не делает, проверьте, что настройки запуска LMS позволяют инструменту отправлять события postMessage в родительский фрейм. FastComments отправляет как сообщения в стиле Canvas (lti.frameResize), так и по спецификации IMS (org.imsglobal.lti.frameResize) для изменения размера.