Handbook X Coordinator WebUI マニュアル

10. クエスチョン スタジオ

クエスチョン スタジオ(Question Studio)は、試験(Examination)やアンケート(Questionnaire)用の設問を作成し、それらを クエスチョンブック(試験ブック/アンケートブック)としてまとめて、リーダーアプリのユーザーに配信できる WebUI 機能です。

注意: クエスチョン スタジオは、以下のいずれかを利用しているオーナー/管理者アカウントでのみ利用できます。

Free / Personal プランのアカウントでは、ヘッダーの「クエスチョンスタジオ」メニュー自体が表示されません。バックエンド API 側でも同じ制限がかかるため、直接 URL を開いても plan_not_allowed エラーになります。

Note(iOS/Mac との違い): 従来 iOS/Mac 版のクエスチョン スタジオでは、設問データは端末ローカルに保管されていました。WebUI 版では サーバー保管 が基本となり、ブラウザを切り替えても同じ設問・クエスチョンブックが引き続き編集できます。iOS/Mac 側でローカル作成した設問と Web UI 側の設問を突き合わせるには 10.8 クライアントと同期 をご利用ください。

10.1 画面構成

ヘッダーメニューの 「クエスチョンスタジオ」 をクリックすると、クエスチョン スタジオ画面が表示されます。URL は /question-studio/questions などで、初回アクセスは自動的に「クエスチョン」タブに遷移します。

クエスチョン スタジオ 全体画面(クエスチョンタブ)

画面上部には次の3つのタブがあります。

タブ 説明 URL パス
クエスチョン 個別の設問(Question)を作成・管理します /question-studio/questions
クエスチョンブック 設問をまとめた試験ブック/アンケートブック(Question Book)を作成・管理します /question-studio/books
試験/アンケート結果 公開したブックへの回答結果を確認・ダウンロードします /question-studio/results

試験/アンケート作成の基本フロー

  1. 10.2 クエスチョン タブ で設問を作成します。設問は 試験用(Examination)アンケート用(Questionnaire) の2カテゴリに分かれます。
  2. 10.3 クエスチョンブック タブ で試験ブックまたはアンケートブックを作成し、10.5 クエスチョンブックの編集(Book Detail)で設問を追加します。
  3. 10.6 クエスチョンブックの公開 を実行すると、リーダーアプリ側でユーザーが受験/回答できるようになります。
  4. 10.7 試験/アンケート結果 タブ で回答結果を確認・ダウンロードできます。

10.2 クエスチョン タブ

個々の設問を作成・管理するタブです。作成した設問は ライブラリ として蓄えられ、複数のクエスチョンブックから使い回すことができます。

クエスチョン タブ(試験・アンケート混在の設問一覧)

「新規作成」ボタンをクリックすると、設問形式を選択するメニューが開きます。メニューは 試験アンケート の2セクションに分かれており、色付きアイコンで形式が識別できます。

新規作成メニュー(試験・アンケートの設問形式一覧)

10.2.1 ツールバー(閲覧モード)

閲覧モードでは、ページヘッダー右側に次のボタンが並びます。

ボタン 説明
インポート .qbz(設問アーカイブ)ファイルから設問を取り込みます
新規作成 プルダウンで「試験の設問形式」または「アンケートの設問形式」を選び、10.4 設問エディター を開きます
編集 一覧を編集モードに切り替えます

その下の副ヘッダーには 検索ボックス並び替えメニュー(更新日/作成日/タイトル)が表示されます。

10.2.2 設問一覧

設問一覧は、設問形式ごとの色付きアイコンとタイトル(設問文の先頭)で構成されます。各行の右端には 編集 アイコンが表示され、クリックすると 10.4 設問エディター が開きます。

10.2.3 編集モード(一括操作)

編集 ボタンをクリックすると編集モードに切り替わり、各行にチェックボックスが表示されます。1件以上を選択すると、ヘッダーのボタンが以下のように切り替わります。

ボタン 有効条件 説明
削除 1件以上選択 選択した設問を削除します(確認ダイアログ)
複製 1件以上選択 選択した設問を複製します(新しい ID で同じ内容の設問が作成されます)
エクスポート 1件以上選択 選択した設問を .qbz 形式でダウンロードします
完了 常に有効 編集モードを終了します

Tip: 編集モードの左側には「選択中: N 件」チップが表示され、× ボタンで一括解除できます。

10.2.4 検索・並び替え

10.2.5 インポート/エクスポート

操作 対応形式 補足
設問のインポート .qbz 「インポート」ボタン → ファイル選択 → 自動的に取り込み。取り込み結果は「N 件をインポート、K 件をスキップ」のトーストで通知されます
設問のエクスポート .qbz 編集モードで選択 → 「エクスポート」ボタン → 確認ダイアログ後にダウンロードが開始されます

Note(ファイルサイズ上限): インポート/エクスポートは 1ファイルあたり 100MB までに制限されています。超過時は questionStudio_ie_error_tooLarge エラーが表示されます。

Note(未対応の添付): 動画などの安全性チェックに合格しなかった添付は自動的にスキップされ、「形式が未対応のため N 件の添付をスキップしました」といったトーストが表示されます。


10.3 クエスチョンブック タブ

設問をひとつのブック(試験ブック/アンケートブック)にまとめて、リーダーアプリのユーザーに配信するためのタブです。

クエスチョンブック タブ(試験ブックとアンケートブックが並んだ状態)

まだブックを1件も作成していない状態では、中央に「問題集を作成してください。」というプレースホルダーと 「問題集を作成」 ボタンが表示されます。

クエスチョンブック タブ(空の状態)

「新規作成」ボタンをクリックすると、下記のような作成メニューが開きます。

クエスチョンブックの新規作成メニュー

10.3.1 ツールバー(閲覧モード)

ボタン 説明
新規作成 プルダウンで以下から選択します。
試験ブックを作成(正解あり・採点あり)
アンケートブックを作成(正解なし・集計目的)
アンケート問題集をインポート(.hqz)(既存ブックの取り込み)
編集 一覧を編集モードに切り替えます

副ヘッダーには 検索ボックス並び替えメニュー が表示されます(クエスチョン タブと同様)。

10.3.2 ブック一覧(カード表示)

作成済みのクエスチョンブックがカード形式で表示されます。各カードには:

項目 説明
表紙画像 ブックの表紙
種別バッジ EXAMINATION または QUESTIONNAIRE
タイトル ブックのタイトル
バージョン 公開のたびに更新されるリビジョン番号
時間 制限時間(分)。 は制限なし
問題数 ブックに含まれる設問の数

10.3.3 ブックの新規作成ダイアログ

「新規作成」から 試験ブックを作成 または アンケートブックを作成 を選ぶと、それぞれ以下のようなダイアログが開きます。

試験ブックの作成ダイアログ

アンケートブックの作成ダイアログ

試験ブックには 「結果を表示」「結果に正解を表示」 のトグルがありますが、アンケートブックには「1回のみ回答」以外の結果表示トグルはありません(採点結果の概念がないため)。

項目 説明
表紙 ダイアログ上部で表紙をプレビューします。右側の「デフォルトの表紙」から選択するか、「写真を選択」で画像をアップロードできます
タイトル 必須項目です。空だと作成ボタンが無効になります
時間(0 = 制限なし) 分単位で入力します。0 の場合は制限時間なし
1回のみ回答 オンにすると、同じユーザーは1回のみ受験/回答できます。文言は種別により「テストごとに1回のみ回答」「アンケートごとに1回のみ回答」と切り替わります
結果を表示(試験のみ) オンにすると、受験後に結果ページが表示されます
結果に正解を表示(試験のみ) オンにすると、結果ページで各設問の 回答正解 を並べて表示します。「結果を表示」がオフのときはこのトグルも無効化されます

Note: 「結果に正解を表示」(showCorrectAnswers)は 2026 年 6 月の Web UI 追加時点で新設された設定です。過去に作成したブックのデフォルト値はオフです。

10.3.4 編集モード(一括操作)

編集モードに入ると、各カードにチェックボックスが表示されます。1件以上を選択して以下のボタンで操作できます。

ボタン 有効条件 説明
削除 1件以上選択 選択したブックを削除します
複製 1件以上選択 選択したブックを複製します(設問はそのまま含まれます)
エクスポート 1件以上選択 選択したブックを .hqz 形式でダウンロードします
公開 1件以上選択 選択したブックを 公開(Publish)します。→ 10.6 クエスチョンブックの公開
完了 常に有効 編集モードを終了します

Note: 編集モードのタイトルは 「問題集を編集」 に変わります。ブックを1件以上選択すると、ツールバー中央に「N 件選択中」チップが表示され、削除・複製・エクスポート・公開の各ボタンが有効化されます。

クエスチョンブックの編集モード(ブック未選択)

クエスチョンブックの編集モード(1件選択中)


10.4 設問エディター

「クエスチョン」タブから 新規作成 ボタンで設問形式を選ぶか、既存の設問の 編集 ボタンをクリックすると、設問エディター(/question-studio/questions/:id/edit)が開きます。

設問エディター(例: 多肢選択の設問を編集中)

アンケートの 選択式(Selective) では、単一選択・ドロップダウン・複数選択のタイプを切り替えられ、選択肢を並べます。

設問エディター(例: 選択式のアンケート設問を編集中)

10.4.1 共通レイアウト

エリア 説明
ヘッダー 「戻る」「保存」ボタンと設問形式名
メディア 設問に画像または動画を添付できます(「画像または動画を選択」ボタン)。画像は最大 100MB。対応形式は各設問形式ごとに異なり、動画対応の設問(穴埋め・並べ替え・線で結ぶ・多肢選択・画像選択)と、画像のみ対応の設問(ポイント指定)があります
問題文(stem) 設問本文を入力するテキストエリア
回答エリア 設問形式ごとに UI が変わります(10.4.3 試験の設問形式 参照)

10.4.2 設問カテゴリ

クエスチョン スタジオでは、以下の2カテゴリの設問を扱えます。

「新規作成」ボタンのプルダウンでは、試験アンケート のセクション見出しでカテゴリごとにグループ化された色付きアイコン付きメニューから設問形式を選びます。

10.4.3 試験の設問形式(6種類)

設問形式 内部識別子 概要
穴埋め(FillBlank) blanks 問題文中に ((1)), ((2)) のような回答欄プレースホルダーを挿入し、各欄に正解候補を複数登録できます
並べ替え(Order) order 表示順のとおりに並んだ状態が正解となる項目を登録します。回答者はドラッグして正しい順序に並べ替えます
ポイント指定(Point) point 回答用画像を1枚アップロードし、その上に ピン を配置します。正解ピンをもう一度タップすると緑色に変わります
線で結ぶ(Connect) connect 左右のペアを登録します。回答者は線をドラッグして正しいペア同士を結びます
多肢選択(Select) select 選択肢を並べ、チェックボックスで正解の選択肢をマークします。複数選択可
画像選択(SelPic) selPic テキストではなく画像を選択肢とします。各画像に正解フラグを付けます

穴埋め(FillBlank)の詳しい入力

並べ替え(Order)の詳しい入力

ポイント指定(Point)の詳しい入力

線で結ぶ(Connect)の詳しい入力

多肢選択(Select)の詳しい入力

画像選択(SelPic)の詳しい入力

10.4.4 アンケートの設問形式(3種類)

設問形式 内部識別子 概要
10段階評価(Scale) scale 0〜10 の11段階スケールで回答してもらう設問です。選択肢の登録は不要(1〜10 のスケールで自動描画されます)。NPS などに向いています
選択式(Selective) selective ラジオ(単一選択)/ドロップダウン/チェックボックス(複数選択)の3タイプから表示形式を選び、選択肢を並べます
自由記述(FreeText) freeText 自由記述で回答してもらう設問です。選択肢の登録は不要

各設問には 「回答必須」 トグルがあり、オンにすると受験者は空欄で送信できなくなります。

選択式(Selective)のタイプ

タイプ 動作
単一選択(ラジオ) Radio ボタンで1つのみ選択可能
ドロップダウン ドロップダウンリストから1つのみ選択可能
複数選択(チェックボックス) 複数選択可能

Radio / DropDown ではチェックマークは「デフォルト選択」として扱われるため、チェックマークは1つだけ にする必要があります(selectiveErrSingleCorrect で検証されます)。

10.4.5 保存

「保存」ボタンで設問をサーバーに保存します。バリデーションに失敗すると 「保存前に問題を修正してください。」 と表示され、該当箇所に赤いエラーメッセージが出ます。


10.5 クエスチョンブックの編集(Book Detail)

クエスチョンブックタブでブックをクリックするか、編集モードで1件選択して「編集」を押すと、Book Detail 画面/question-studio/books/:uuid/edit)に遷移します。

作成直後の試験ブックは設問が未登録の状態で表示されます。

Book Detail 画面(作成直後・設問なし)

設問を追加すると、番号/タイプアイコン/問題文/配点の一覧に切り替わります。

Book Detail 画面(試験ブックに設問を2件追加した状態)

アンケートブックの場合は 「アンケートを開始」 ボタンでプレビューを起動でき、配点フィールドはグレーアウト表示になります。

Book Detail 画面(アンケートブックに設問を3件追加した状態)

10.5.1 画面構成

エリア 説明
パンくず 「問題集」からクリックで一覧に戻れます
タイトル [テスト] タイトル名 または [アンケート] タイトル名。編集モードでは「〜を編集」に変わります
ツールバー 「追加」「試験を開始/アンケートを開始」「編集」ボタンなど
サブヘッダー 「合計点:N」(試験の場合。各設問の配点の合計)
設問リスト このブックに含まれる設問。閲覧モードでは番号/タイプアイコン/問題文/配点が表示されます

10.5.2 設問の追加(Add)

「追加」ボタンをクリックすると、10.2 クエスチョン タブ で作成したライブラリの設問一覧が 設問追加ダイアログ として開きます。試験ブックには試験用の設問、アンケートブックにはアンケート用の設問だけが選択できます。

Book Detail 画面から設問追加ダイアログを開いた状態(試験ブック)

複数選択して「保存」を押すと、選んだ設問がブックの末尾に追加されます。

10.5.3 「試験を開始」/「アンケートを開始」(プレビュー)

「試験を開始」または「アンケートを開始」ボタンをクリックすると、リーダーアプリと同じ受験画面(Question Player) が新しいページ(/question-studio/books/:uuid/play)で開き、実際にどのように表示されるかを事前にプレビュー・シミュレーションできます。

プレビュー再生(試験の開始画面)

プレビュー再生(Question Player: 穴埋め問題)

10.5.4 編集モード

「編集」 ボタン(ペンアイコン)で編集モードに入ります。編集モード中は:

Book Detail 画面の編集モード(配点編集・部分配点トグル)

編集を終えたら 「完了」 ボタンで保存されます。

Note(バージョン競合): 他のブラウザや管理者が同じブックを更新した場合は、「他のユーザーがこの問題集を更新しました。最新版を再読み込みします。」というダイアログが表示され、最新版が自動的に読み込まれます。

10.5.5 部分配点の設定

穴埋め・並べ替え・線で結ぶ・ポイント指定・多肢選択・画像選択 で条件を満たす設問(回答欄が2つ以上、または正解が2つ以上など)には、行のメニューから 「部分配点を設定」 を有効化できます。

部分配点をオンにすると、各回答(空欄・並び順・ペア・ピン・選択肢・画像)に対して個別に配点を割り振れます。設問全体の配点は自動的に各回答の合計になります(合計と各配点が一致しない場合は保存時に partialPointsSumMismatch エラーになります)。

採点ルールは iOS/Mac 版と同じです:


10.6 クエスチョンブックの公開

クエスチョンブックタブの編集モードで対象ブックを選択し、「公開」 ボタンを押すと、ブックがリーダーアプリ向けに 公開 されます。

公開の確認ダイアログ

Note: 公開したクエスチョンブックへのアクセスは、通常のブックと同様に 共有 で制御します(アクセスコード共有・グループ共有・ユーザー共有)。共有の詳細は 4. 共有 を参照してください。


10.7 試験/アンケート結果 タブ

公開済みのクエスチョンブックへの回答結果を確認・ダウンロードするタブです。

試験/アンケート結果タブ(公開済み試験ブック未取得の状態)

10.7.1 サブタブ

副ヘッダーに以下の2つのサブタブがあります。

サブタブ 内容
試験ブック 公開済みの試験ブック一覧
アンケートブック 公開済みのアンケートブック一覧

10.7.2 一覧テーブル

各サブタブでは以下の列を持つテーブルが表示されます。

試験ブックの列

説明
タイトル ブックのタイトル(表紙アイコン付き)
リビジョン 現在のバージョン番号
受験者数 受験を送信したユーザーの合計
平均点 全受験者の平均点
(ダウンロード) 行末の インポート アイコンから結果をダウンロード

アンケートブックの列

説明
タイトル ブックのタイトル
リビジョン 現在のバージョン番号
回答数 回答を送信したユーザーの合計
(ダウンロード) 行末の インポート アイコンから結果をダウンロード

ヘッダー右側の 「更新」 ボタンで最新の集計を再読み込みできます。回答者が結果を送信すると、リーダー側から結果は 即時 で反映されます(大きな遅延はありません)。

10.7.3 結果のダウンロード

ダウンロードアイコンをクリックすると、結果ダウンロードダイアログ が開きます。

項目 説明
開始日/終了日 ダウンロード対象の期間を指定します。開始日が終了日より後になっているとエラーになります
XLSX をダウンロード Excel 形式(.xlsx)でダウンロード
CSV をダウンロード CSV 形式(.csv)でダウンロード

Note(期間制限): ダウンロードは 直近1年間 に制限されています。開始日をそれより前に設定すると「直近1年以内のデータのみエクスポートされます」と警告表示されます。

Note(データがない場合): 選択期間に回答記録がない場合は「選択した期間に回答記録がありません」というトーストが表示され、ファイルはダウンロードされません。


10.8 クライアントと同期

iOS / Mac のクエスチョン スタジオでは、設問はローカル端末に保管される(またはユーザー個別バックアップとして端末側からサーバーへ差分アップロードされる)仕組みです。この iOS/Mac 側でバックアップした設問を Web UI で作成した設問と突き合わせて双方向に同期 するのが、「クライアントと同期」(Backup Sync) 機能です。

「クライアントと同期」プレビューダイアログ

10.8.1 起動方法

「クエスチョン」タブのヘッダー右側にある 「クライアントと同期」 ボタンをクリックすると、プレビューダイアログが開きます。

10.8.2 プレビュー画面の構成

サーバーが Web 側と iOS 側のバックアップを突き合わせて、以下の セクション ごとに差分をまとめて表示します。

セクション 説明 適用アクション
iOS → Web に取り込み iOS 側にのみ存在する設問。Web に取り込みます Pull
Web → iOS に反映 Web 側にのみ存在する設問。iOS に反映します Push
競合 両方で更新されている設問。iOS 側を採用 / Web 側を採用 / 保留 を選択します 解決アクション
削除を反映(要確認) 片側で削除されている項目 Pull Delete / Push Delete
復活(要確認) 過去に削除されたが片側で復元されている項目 Pull Restore

各セクションでは:

Note(進行中のアップロード): iOS 側でまだアップロードが完了していない設問は自動的に除外され、「N 件の iOS アップロードが進行中のため一時的に除外しています。」というメモが表示されます。少し時間をおいて 「再プレビュー」 すると、それらも同期対象に含めることができます。

10.8.3 適用

選択が終わったら 「適用」 ボタンをクリックします。

10.8.4 エラーの原因と対処

メッセージ 主な原因 対処
プレビュー後にデータが変更されました。再プレビューします。 プレビュー取得後にどちらかの側で更新があった 「再プレビュー」でやり直します
別の端末が先に更新しました。プレビューをやり直してください。 サーバー側のバージョンタグと不一致 「再プレビュー」でやり直します
ほかの同期処理が実行中です。完了後にもう一度お試しください。 別ユーザー/別ブラウザで Backup Sync 適用中 しばらく待ってから再実行します
iOS バックアップを解析できませんでした。 iOS 側のバックアップ zip が破損または非対応 対象を保留にして、次回の iOS バックアップ後にやり直します
添付の保存中に一部失敗しました。 S3 への添付アップロードに一部失敗 「再プレビュー」で残りをやり直します
対応していない添付形式が含まれていました。 サーバーで許可されていない MIME 該当添付を含む項目はスキップされます(iOS 側で拡張子を見直してください)
この機能を利用する権限がありません。 プランがクエスチョン スタジオ非対応 プランをアップグレードしてください

Note(iOS の HEIC / HEIF / M4V 対応): 2026 年 7 月の Web UI 追加時点で、iOS 特有の画像・動画形式(HEIC / HEIF / M4V)もサーバー側でホワイトリストに追加されており、Backup Sync でも取り込めます。


10.9 制限事項・トラブルシューティング


← 前へ: 9. プロフィール/設定 | 次へ: 付録A. 権限について →