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 の Dynamic Registration 画面を開き、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 が利用可能な場合)

Dynamic Registration を備えた IMS LTI 1.3 Advantage 仕様を実装しているその他の LMS でも動作するはずです — 登録用 URL を生成する際はプラットフォームのドロップダウンから Other LTI 1.3 platform を選択してください（こちらで取得できます）。

Canvas LMS は別のセットアップ手順を使用します（Dynamic Registration の代わりに per-developer-key 構成の JSON を使用）。専用の Canvas LMS インストールガイドを参照してください。

LTI 1.3 設定に移動

FastComments にサインインし、LTI 1.3 設定ページに移動してください。

アカウントにまだ LTI アクセスがない場合は「LTI not enabled for this account」と表示されます。プランで有効にするにはサポートに連絡してください。

プラットフォームを選択（任意）

Generate a Dynamic Registration URL の下で、Platform ドロップダウンを使い、どの LMS に接続するかを FastComments に伝えます:

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

Auto-detect のままにしておくこともできます。登録中に LMS の openid-configuration からプラットフォームが読み取られます。ドロップダウンは生成される構成の表示ラベルを設定するためだけに使われます。

URL を生成する

Generate URL をクリックします。FastComments はワンタイム登録トークンを作成し、次のような URL を表示します:

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

コピーしてください。この URL は:

• は 単回使用 です — 一度 LMS が正常に呼び出すとトークンは消費されます。
• 使用されない場合、30 分後に期限切れになります。
• 非公開にしてください — URL を持っている人はその 30 分以内にあなたのテナントに対してツールを登録できます。

既存の構成

登録が正常に完了すると、新しい構成が同じページの 既存の構成 テーブルに表示され、プラットフォーム、Issuer、Client ID、およびステータスが確認できます。登録解除が必要になった場合は、このテーブルから構成を削除できます。

D2L Brightspace は LTI Advantage 管理インターフェースを通じて Dynamic Registration を公開しています。管理者アクセスが必要です。

登録画面を開く

1. 管理者として Brightspace インスタンスにサインインします。
2. Admin Tools > Manage Extensibility > LTI Advantage に移動します。
3. Register Tool をクリックします。（直接の URL は https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create です。）

URL を貼り付ける

登録フォームが表示されます。重要な項目は Tool initiation registration endpoint（一部の Brightspace バージョンでは "Tool Initiation Registration URL" と表記されます）です。

FastComments の登録 URL (ここで取得できます) をそのフィールドに貼り付けます。他のフィールドは空のままにしておいてください — 登録ハンドシェイク中に FastComments が自動的に入力します。

Register をクリックします。

ツールを承認する

Brightspace は FastComments と通信するポップアップを開き、キーを交換して確認画面を表示します。登録が完了するとポップアップは自動で閉じます。

新しいツールは LTI Advantage のツール一覧に表示されます。デフォルトでは Brightspace は新しいツールを disabled としてマークします — コースで使用できるようにトグルを enabled に切り替えてください。

デプロイメントを追加する

Brightspace では、LTI ツールがコースで使用される前に deployment が必要です:

1. 新しく登録した FastComments ツールを開きます。
2. View Deployments > New Deployment をクリックします。
3. デプロイメントに名前を付け（例: "FastComments - All Courses"）、利用可能にする組織単位を選択して保存します。

このデプロイメントを通じて最初に起動すると、FastComments は構成レコードに deployment_id を固定します — 同一クライアントの別のデプロイメントからのその後の起動は、再登録しない限り拒否されます。

Moodle を使っていますか？ FastComments は LTI 1.3 よりも緊密に統合された専用の Moodle プラグイン（成績同期フック、より詳細なアクティビティ報告、ネイティブな Moodle 設定 UI）も公開しています。Moodle プラグインインストールガイド を参照してください。以下の LTI 1.3 フローは、他の LMS もカバーする単一の登録を行いたい場合、または Moodle 管理者がサードパーティプラグインをインストールしない場合に適した選択です。

Moodle 4.0+ は External Tool プラグインを通じて LTI 1.3 の動的登録をサポートします。

ツール管理画面を開く

1. サイト管理者として Moodle にサインインします。
2. Site administration > Plugins > Activity modules > External tool > Manage tools に移動します。

URL を貼り付ける

Tool URL というラベルのカードが表示されます。テキストフィールドに FastComments の登録 URL (こちらから取得) を貼り付け、Add LTI Advantage をクリックします。

Moodle はツールの識別情報と要求している権限を表示する登録画面を開きます。内容を確認して Activate（Moodle のバージョンによっては Register）をクリックします。

登録が完了するとポップアップは閉じ、新しい FastComments ツールが Tools リストに Active ステータスで表示されます。

利用可能にする

デフォルトでは Moodle は新しいツールを「Course tools」リストに追加しますが、アクティビティピッカーには表示しません。コース全体で FastComments を表示するには:

1. FastComments タイルの歯車アイコンをクリックします。
2. Tool configuration usage の下で Show in activity chooser and as a preconfigured tool を選択します。
3. 保存します。

講師はこれで Add an activity or resource > FastComments から任意のコースに FastComments を追加できるようになります。

Blackboard Learn SaaS と Ultra は LTI 1.3 の動的登録（Dynamic Registration）をサポートしています。

ツールプロバイダ画面を開く

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 を貼り付ける

FastComments の登録用 URL (ここで取得できます) を 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 Advantage を含むリリースで LTI 1.3 の Dynamic Registration をサポートしています。Administration Workspace から:

1. Sakai の管理者としてサインインし、Administration Workspace を開きます。
2. External Tools > Install LTI 1.3 Tool を選択します。
3. FastComments の登録用 URL（ここで取得）を貼り付けて送信します。
4. ハンドシェイクが完了したらツールを承認します。

ツールはその後 External Tools に表示され、サイトの管理者によってサイトに追加できます。

Schoology

Schoology の Enterprise インスタンスは LTI 1.3 をサポートしますが、Dynamic Registration の利用可否はデプロイによって異なります。Schoology のアカウントマネージャーに確認してください。

お使いの Schoology インスタンスで Dynamic Registration が利用できない場合、次のエンドポイントを使って統合を手動で設定する必要があります:

• 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

IMS LTI 1.3 Advantage 仕様に準拠する任意の LMS は、同じ登録 URL（ここで取得）で動作するはずです。設定項目として "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint", またはそれに類する項目を探してください。

プラットフォームが手動での LTI 1.3 設定のみをサポートする場合は、上の Schoology セクションに記載された 4 つのエンドポイントを使用し、設定完了のためにサポートに連絡してください。

このページでは、管理者がツールを登録しデプロイメントを作成した後に、Brightspace コースに FastComments を追加する方法を説明します。ツールがまだ登録されていない場合は、まず D2L 登録ガイドを参照してください。

Brightspace のユニットトピックに埋め込まれた FastComments

Brightspace には 2 つのコンテンツ作成エクスペリエンスが搭載されています: Classic Content と New Content Experience（Lessons とも呼ばれます）。どちらも FastComments を利用できますが、メニューの経路が異なります。以下の各セクションでは、分岐する箇所で両方をカバーします。

FastComments ツールを見つける

FastComments ツールはコースのコンテンツエディタ内の 2 箇所に表示されます:

1. モジュール／ユニットの Add Existing ボタン（古い Brightspace では Add Existing Activities と表示）からアクセスするアクティビティピッカー。現在の Brightspace ビルドでは FastComments はピッカーに直接表示されますが、古いバージョンでは External Learning Tools サブメニューの下にネストされています。どちらの経路でも FastComments を単独のトピックとして追加します。
2. HTML エディタ内の Insert Stuff ダイアログの LTI Advantage。これは LTI のディープリンクフローを介して HTML トピック内に FastComments をインラインで埋め込みます。

どちらのピッカーにも FastComments が表示されない場合、デプロイメントがそのコースを含む組織ユニットで有効になっていません。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. ディスカッションを置くユニットとレッスンを開きます。
3. Add > Existing Activity をクリックし、FastComments を選択します（古い Brightspace: External Learning Tools の下にネストされています）。
4. アクティビティがレッスンに追加されます。
5. アクティビティタイトルをクリックして名前を変更します。

最初に誰か（講師または学生）がトピックを開くと、FastComments はそのリソースリンク用のスレッドを初期化します。スレッドはリソースリンク ID に紐づくため、トピック名の変更や移動は読み込まれるスレッドを変更しません。

HTML トピック内に FastComments をインラインで埋め込む

読み物、ビデオ、または同じトピックページ内の他のコンテンツの下にコメントを表示したい場合は、このフローを使用してください。別トピックではなく同一ページ内に表示されます。

1. モジュール／レッスンで HTML トピックを開くか作成します。
2. Brightspace の HTML エディタで Edit HTML をクリックして開きます。
3. コメントスレッドを表示したい位置にカーソルを置きます。
4. Insert Stuff ボタン（エディタツールバーのパズルピースアイコン）をクリックします。
5. Insert Stuff ダイアログで LTI Advantage にスクロールし、FastComments をクリックします。
6. FastComments はディープリンクピッカーを開きます。配置を確認します（コンテントディスカッションにはデフォルトオプションで問題ありません）。Insert または Continue をクリックします。
7. Brightspace はプレースホルダブロックを伴って HTML エディタに戻します。トピックで Save and Close をクリックします。

トピックがロードされると、Brightspace はプレースホルダを iframe に置き換え、LTI を介して自動的に FastComments を起動します。学生はディスカッションスレッドをインラインで閲覧できます。

1 つの HTML トピックに複数のディープリンクされた FastComments 埋め込みを含めることができます。各埋め込みはそれぞれ異なるリソースリンク ID を生成するため、個別のスレッドを持ちます。

モジュールトピックとインラインクイックリンクの使い分け

次の場合は モジュールトピック のアプローチを選んでください:

• そのステップでの主要なアクティビティがディスカッションである場合。
• トピックを Brightspace の目次、完了トラッキング、および Class Progress に表示させたい場合。

次の場合は インライン埋め込み のアプローチを選んでください:

• コメントを同じページ上の他のコンテンツの下に表示したい場合。
• 目次に別個の完了トラッキング対象項目として表示させたくない場合。

表示、ドラフト、およびリリース条件

新しい FastComments トピックはデフォルトで学生に表示されます。設定中に非表示にしたい場合:

1. コンテンツエディタでトピックタイトルをクリック（Classic）するか、アクティビティの三点メニュー（New Content Experience）をクリックします。
2. Classic ではステータスを Draft に設定、New Content Experience では Visibility をオフに切り替えます。

ドラフトのトピックは学生には表示されません。講師と TA は「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 は学生の名前、メール、アバター URL、および LMS ロールを受け取り、自動的にサインインさせます。FastComments のログインプロンプトは表示されません。
3. そのリソースリンク用のコメントスレッドが Brightspace の iframe 内にレンダリングされます。

ランチ時のロールマッピング:

• Brightspace の Administrator はスレッドに対する FastComments の管理者（admin）になります（完全なモデレーション、削除、バン、および設定アクセス）。
• Brightspace の Instructor は FastComments のモデレーター（moderator）になります（ピン、非表示、削除、バン）。
• その他のすべてのロール（Learner、TeachingAssistant など）は標準のコメント投稿者になります。

コメントは学生の Brightspace アカウントに紐づけられます。学生が Brightspace 側で名前やアバターを編集した場合、次回の LTI ランチで変更が同期されます。

iframe の高さとリサイズ

FastComments はスレッドのレンダリングごとおよびコンテンツ変更時（新しいコメント、返信の展開など）に org.imsglobal.lti.frameResize の postMessage を送信します。Brightspace はこのメッセージをリッスンし、iframe の高さを調整してスレッドが切り取られたり内部のスクロールバーが表示されたりしないようにします。

iframe が短い固定高さのままの場合:

• コースが HTTPS 経由で読み込まれていることを確認してください。Brightspace の postMessage リスナーは混在コンテンツのフレームを拒否します。
• ブラウザ拡張機能が postMessage チャネルをブロックしていないことを確認してください。
• HTML トピック内のインライン埋め込みの場合、周囲の HTML が iframe を固定高さのコンテナでラップしていないことを確認してください。親要素の inline style="height: ..." を削除してください。

Brightspace 固有の注意点

Add Existing ピッカーにツールが表示されない。 デプロイメントがこのコースの組織ユニットで有効になっていません。管理者はデプロイメントの Org Units リストに組織ユニット（または親のユニット）を追加する必要があります。ツールの登録だけでは不十分で、デプロイメントがどのコースでツールを見せるかを制御します。

ランチ時の deployment_id の不一致。 FastComments は登録時に最初に見た deployment_id を TOFU（Trust On First Use）で固定します。管理者が元のデプロイメントを削除して新しいものを作成した場合、新しいデプロイメントからのランチはデプロイメント不一致エラーで拒否されます。修正方法は FastComments を再登録することです（新しい登録 URL を生成して（ここから取得）ダイナミック登録を再実行してください）；これにより古い構成レコードは置き換えられます。

ツールは起動するが「Invalid LTI launch」と表示される。 コースがデプロイメントのカバー範囲と異なるテナント／組織構造にあるか、登録後にデプロイメントが無効化された可能性があります。Admin Tools > Manage Extensibility > LTI Advantage > FastComments > Enabled トグルとデプロイメントの組織ユニットリストを再確認してください。

FastComments 内で名前やロールが欠落している。 Brightspace は Names and Role Provisioning Services (NRPS) クレームを含む LTI ランチを送信します。コースが古い LTI 1.1 リンクからアップグレードされている場合、ランチに name や email クレームが欠けることがあります。FastComments トピックを Add Existing で再追加してください（古いリンクをマイグレートしないでください）。そうすることでランチは LTI 1.3 を使用します。

埋め込みが自動 SSO ではなくログイン画面を表示する。 HTML トピックが Insert Stuff > LTI Advantage を経由せずに、FastComments を指す単なる <iframe> として挿入されている可能性があります。プレーンな iframe は LTI ランチをスキップし、ユーザーを公開向けの FastComments ページに導きます。iframe を削除し、Insert Stuff フローで再挿入してください。

Once an administrator has registered FastComments as an LTI 1.3 Advantage tool and approved the institution policies, instructors add it to courses through the standard Blackboard placement points. The exact steps differ between Ultra Course View and Original Course View, so both are covered below.

Ultra Course View

Ultra Course View is the default in Blackboard Learn SaaS as of 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 がオプションに表示されない場合、機関がその配置を非表示にしています。同じ + メニューの LTI Tools グループ内にある More 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 ツール配置から生成されます。表示されない場合は下の「gotchas」セクションを参照してください。
5. Create FastComments フォームで次を設定します:
   • Name: コンテンツエリアで学生が目にするラベル。
   • Description: 埋め込みスレッドの上に表示される任意のテキスト。
   • Permit Users to View this Content: Yes/No の可用性トグル。
   • Track Number of Views: Blackboard のアイテム別閲覧統計が必要な場合に有効にします。FastComments は独自にアナリティクスを実行します。
   • Date and Time Restrictions: 任意の Display After / Display Until ウィンドウ。
6. 送信します。ツールはコンテンツエリア内のクリック可能な項目として表示されます。

Embedding Inside an Item or Document

両方のコースビューで、講師は Content Editor の LTI Advantage ボタンを使って Item、Document、または任意のリッチテキストフィールド内に FastComments をインライン埋め込みできます。

Ultra Course View:

1. Document を作成または編集します。
2. スレッドを表示したいドキュメント本文内で Add content をクリックします。
3. エディタのツールバーで Insert content メニューを開き、Content Market（LTI Advantage / Deep Linking のエントリポイント）をクリックします。
4. FastComments を選びます。FastComments はディープリンクのペイロードを返し、Blackboard はカーソル位置に埋め込みブロックをドキュメント本文に挿入します。
5. ドキュメントを保存します。学生はスクロールしてその位置を通過すると、インラインでレンダリングされたスレッドを確認できます。

Original Course View:

1. リッチテキスト本文を持つ任意の項目を編集します。
2. Content Editor のツールバーで Add Content のプラスアイコンをクリックし、Content Market（古い Q4 2024 CU では Add Content from External Tool と表示）を選択します。
3. FastComments を選びます。エディタはディープリンクされたリソースを参照するプレースホルダブロックを挿入します。
4. 項目を送信します。

各ディープリンク埋め込みはそれぞれ独立した FastComments スレッドを生成するため、1つの項目に FastComments ブロックが2つ埋め込まれている場合は、2つの独立したコメントストリームになります。

Visibility, Release Conditions, and Group Restrictions

FastComments のコンテンツ項目は、上に重ねられたアクセス制御ルールについて他の Blackboard コンテンツ項目と同様に動作します。

• Ultra: 行の可視性セレクタ（Visible to students, Hidden from students, Conditional availability）をクリックします。Conditional availability は日付/時刻ウィンドウ、成績表アイテムに対するパフォーマンスルール、コースグループに対するメンバールールをサポートします。
• Original: 項目のコンテキストメニューを開き、Adaptive Release または Adaptive Release: Advanced を選択して、日付、メンバーシップ、成績、またはレビュー状況でツールを制限します。項目に対して Set Group Availability を使用して特定のコースグループに制限します。

FastComments は Blackboard のゲートが決定する内容を尊重します。Blackboard が学生に対して項目を非表示にする場合、その学生に対しては LTI 起動が実行されず、モデレータビューに表示されません。

Gradebook Behavior

FastComments は LTI Advantage Assignment and Grade Services を通じて成績を返送しません。FastComments のコンテンツ項目用に成績列が自動作成されることはありません。

Blackboard テナントがすべての新しいコンテンツ項目に対して成績メタデータにかかわらず自動的に成績列を作成するよう設定されている場合は、空の列が表示されることがあります。非表示にするには:

• Ultra: Gradebook を開き、列ヘッダをクリックして Edit を選び、Show to students と Include in calculations をオフにします。あるいは、機関が未採点項目の列削除を許可している場合は Delete を使用します。
• Original: Grade Center を開き、列のチェブロンをクリックして Hide from Users (on/off) を選び、必要に応じて Column Organization の下で Hide from Instructor View を選択します。

What Students See

学生が FastComments 項目を開くか埋め込みブロックまでスクロールすると:

1. Blackboard は FastComments に LTI 1.3 メッセージを起動します。学生は Blackboard の資格情報（名前、メール、アバター、役割）を使用した SSO によりログインし、ログインフォームを見ることはありません。
2. コメントスレッドが iframe 内にレンダリングされます。スレッド化、返信、メンション、リアクションは FastComments のコメントウィジェット設定に基づいて利用可能です。
3. 学生のコメントはその Blackboard アカウントに紐づけられます。学生が後で Blackboard で名前や写真を編集した場合、次回の起動で FastComments のプロフィールが更新されます。

Blackboard から FastComments へのロールマッピング:

• System Administrator and Course Builder map to FastComments admin.
• Instructor and Teaching Assistant map to FastComments moderator.
• Student, Guest, and Observer map to FastComments commenter.

モデレータはスレッド内の各コメントに対してピン、非表示、バン、削除などのモデレーションコントロールをインラインで見られます。

Thread Scoping

FastComments は各スレッドを (Blackboard host, course ID, resource link ID) によってスコープします。同じコース内の 2 つの FastComments 項目は 2 つのスレッドを生成します。同じ項目を 2 つのコースシェルにコピーした場合（たとえばコースコピー経由）、コピー時に Blackboard が新しい resource link ID を発行するため 2 つのスレッドが生成されます。コースコピー間で共有スレッドを維持するには、コピーを開始する前に FastComments 側で明示的なスレッド URN を設定した Deep Linking を使用してください。

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or 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" or "Tool is not deployed" error on launch. ダイナミック登録時に登録されたデプロイメントスコープが、コースが属する機関のコンテキストと一致していません。Blackboard のツールプロバイダエントリで、Deployment ID がこのテナントの FastComments の LTI 1.3 Configuration ページに表示されているものと一致しているか確認してください。異なる場合は、配置を削除して新しい登録 URL からダイナミック登録を再実行します（ここで取得できます）。

Iframe height looks fixed or content gets cut off. 一部の Blackboard テナントはデフォルトの LTI iframe-resize postMessage をブロックする厳格な Content Security Policy を導入しています。互換性を最大化するために FastComments は Canvas スタイルの lti.frameResize メッセージと IMS 仕様形式の org.imsglobal.lti.frameResize メッセージの両方を送出しますが、テナントレベルの CSP オーバーライドが親リスナーをブロックすることがあります。管理者に *.fastcomments.com が LTI ツールの許可リストに含まれていること、およびカスタム CSP ヘッダが postMessage イベントを削除していないことを確認するよう依頼してください。そうすればリサイズは追加設定なしに機能します。

Course copy duplicates threads. Blackboard のコースコピーは LTI 配置に対して新しい resource link ID を発行するため、コピーされたコースは空のスレッドから開始します。これは想定された動作です。コピー先のコースが元のスレッドを継承する必要がある場合は、コピー前に明示的なスレッド URN を設定した Deep Linking を設定するか、FastComments サポートに連絡してスレッド ID を一括でリマップしてください。

Student sees a generic Blackboard error on launch. 原因は欠落しているか古くなった email クレームです。FastComments の機関ポリシーで User Fields to Send の下に Role, Name, Email Address が有効になっていることを確認してください。保存し、新しいブラウザセッションで再度起動してください。

"登録トークンが見つからない、期限切れ、または既に使用されています"

あなたの登録用URL（ここで取得できます）内のトークンは30分間有効で、1回しか使用できません。LMS の処理にそれ以上時間がかかった場合、または登録が成功した後に再試行された場合、トークンは拒否されます。FastComments の LTI 1.3 設定ページで新しい URL を生成して最初からやり直してください。

"プラットフォームが登録を拒否しました"

あなたの LMS が登録ハンドシェイクを拒否しました。最も一般的な原因:

• 同じクライアント名ですでにツールが登録されています。 一部のプラットフォーム（特に D2L）は、前のものが削除されるまで「FastComments」の2回目の登録を拒否します。LMS で古いツールを削除してから再試行してください。
• LMS の誤ったフィールドに入力しています。 URL を registration / tool initiation registration endpoint フィールドに貼り付けたことを確認してください。launch URL や login URL のフィールドではありません。
• LMS が実際には Dynamic Registration をサポートしていません。 古い Moodle や Blackboard のバージョンは LTI 1.3 を謳っていますが、手動設定のみを許可します。プラットフォームのドキュメントを確認してください。

"プラットフォーム構成の取得に失敗しました"

FastComments があなたの LMS の openid-configuration ドキュメントを読み取れませんでした。これは稀で、通常は LMS が不正なまたは到達不能な discovery URL を提供したことを意味します。LMS サポートに連絡してください。

起動時に "設定が見つかりません" と表示される

FastComments の設定が削除されたか、起動が当社で認識していない iss/client_id の組み合わせから行われました。設定を削除して再登録した場合は、LMS に FastComments ツールを削除して再追加するよう指示し、新しい client_id を取得するようにしてください。

起動時に "デプロイメントが登録されていません" と表示される

最初に起動したものとは異なる Brightspace/Moodle/Blackboard のデプロイメントから FastComments を起動しました。FastComments はセキュリティチェックとして初回起動時に deployment_id を固定します。同じクライアントの下で新しいデプロイメントを追加するにはサポートに連絡してください — 我々が設定に deployment ID を追加します。

起動時に "message_type がサポートされていません" と表示される

LMS が FastComments が処理しない LTI メッセージを送信しました（例: LtiSubmissionReviewRequest）。FastComments は標準の resource-link launch と deep-linking flows のみをサポートします。特定の message type を追加してほしい場合はお問い合わせください。

iframe がリサイズされない

ほとんどの LMS は LTI iframe を自動でサイズ調整します。あなたの LMS がそうでない場合は、LMS の起動設定がツールから親フレームへの postMessage イベント送信を許可しているか確認してください。FastComments は Canvas スタイル（lti.frameResize）と IMS 仕様（org.imsglobal.lti.frameResize）の両方のリサイズメッセージを送出します。