ビュースタジオ 詳細マニュアル

基本情報

プラグインID	view-studio
対象バージョン	v3.7.1(配布中の最新版)
カテゴリ	一覧画面カスタマイズ
説明	データを、テーブル・カンバン・カレンダーなど自在なビューで表示します。

動作条件

対応環境	kintone スタンダードコース(デスクトップ版UI)。最新版の Chrome / Edge / Safari / Firefox に対応。
動作画面	レコード一覧のカスタマイズビュー。指定したビューを開くとタブ切替のビュースタジオ画面が表示されます。
表示言語	日本語・英語・中国語(簡体字・繁体字)。設定画面・各ビューの文言は kintone の表示言語に合わせて切り替わります(それ以外の表示言語では英語。3.7.1 以降)。ビュー名・フィールド名・選択肢はアプリの設定のまま表示されます。
必要なフィールド	タイトルフィールド(全ビュー共通の見出し)のほか、使うビューに応じて: カンバン=ドロップダウンまたはラジオボタン+並び順用の数値、カレンダー・タイムライン=日付または日時(開始・任意で期限)、ギャラリー=任意で添付ファイル(カバー画像)。親子表示を使う場合はレコードID・親レコードID用の数値または文字列(1行)×2。
必要な権限	閲覧はレコード閲覧権限。ドラッグ&ドロップによる移動・日程変更・親子の付け替えには対象レコードの編集権限、カレンダーの空白クリックからの新規作成にはレコード追加権限が必要です。

設定項目リファレンス

プラグイン設定の全項目です。「項目」は設定データ(エクスポートファイルの config)のキーを表し、[] は配列の要素を意味します。設定画面での入力項目と1対1に対応します。この構造の正式な定義はJSON Schema(catalog.json の configSchema)として公開しています。

設定のポイント

• targetView にはビュースタジオを表示するカスタマイズビューのビューIDを指定します。ビューのHTMLは空でかまいません。
• views(ビュー)は最大10個まで定義でき、配列の順序がタブの並び順、先頭のビューが初期表示になります。同じタイプのビューを絞り込み条件や軸を変えて複数並べることもできます(例: 「開発カンバン」「営業カンバン」)。
• カンバンの並び順フィールドはプラグインがカード順序の保存に使います。ユーザーが直接編集しない、このビュー専用の数値フィールドをおすすめします。
• レコードIDフィールド(keyField)は必須かつ重複禁止の設定を推奨します。空の場合はレコード番号を使いますが、アプリ間でデータを移行すると親子関係が崩れるため、専用のIDフィールドの利用をおすすめします。
• 色分けは2種類あります。「色分け」は選択肢フィールド(ドロップダウン/ラジオ)の選択肢ごとに色を割り当てます。「条件付き色分け」は任意の条件(日付の TODAY±n・ログインユーザー指定も可)を上から評価し、最初に一致した色を適用します(「色分け」より優先)。
• 絞り込み条件はビューごとに設定でき、すべての条件に一致するレコードだけを表示します(AND)。kintone標準のビューの絞り込み条件も別途反映されます。

動作仕様

• レコードはビューを開いたときに一括取得し(500件ずつ・最大1万件)、全ビューで共有します。タブ切替時の再取得はありません(「再読み込み」ボタンで最新化できます)。
• テーブル: 列見出しクリックでソート、親子表示(インデント+折りたたみ)、親の行に子孫のロールアップ集計(合計/平均/件数)を表示できます。数値・計算フィールドは桁区切り+右揃えで表示します。行クリックでレコード詳細を開きます。
• カンバン: カードのドラッグ&ドロップで、カラム分けフィールドの値と並び順フィールドが更新されます。ラベルフィールド(複数選択/チェックボックス)を設定すると、カード上部に色付きチップで表示されます。条件付き色分けが一致したカードは背景色が変わります。
• カレンダー: 月/週表示を切り替えられます。予定のドラッグ&ドロップで日付を変更でき、空白日のクリックからその日付が入った新規レコード作成画面を開けます。
• タイムライン: 日/週/月のズームを切り替えられます。バーのドラッグで日程の移動、バー端のドラッグで開始日/期限の変更ができます。自分の日付が無い親レコードは、子孫の期間から導出した点線バーで表示されます(操作不可)。
• ギャラリー: カード形式の一覧です。カバー画像フィールドの最初の画像ファイルをカードのカバーとして表示します(画面に入ったカードから遅延読み込み。画像はブラウザ内で取得され、外部には送信されません)。
• 親子: テーブルの行・タイムラインのタイトルのドラッグ&ドロップで親子を付け替えられます(自分の子孫への移動などの循環は拒否)。レコード詳細画面には親レコードへのリンク、追加・編集画面には「親レコードを選択」(タイトル検索モーダル)が表示されます。
• クリック時の動作: カード・行・予定・バーをクリックすると、レコード詳細画面が別タブで開きます。ビューの設定で「クリック時に簡易表示する」(quickView.enabled)をONにすると(3.7.0 以降)、詳細画面を開く代わりに、そのビューで指定したフィールド(quickView.fields。1〜20個)を2列のウィンドウで簡易表示します。ウィンドウの「レコードを開く」から詳細画面を開けます。Esc キー・✕・背景のクリックで閉じます。
• 最後に表示していたタブはブラウザごとに記憶され、次回そのタブから開きます。

制限事項・既知の仕様

• モバイルアプリの画面では動作しません(デスクトップ版UIのみ)。
• 表示できるレコードは最大1万件です。超過分は表示されず、件数表示に「(上限)」と表示されます。
• ビューは10個まで、テーブルの列は20個まで、カードに表示するフィールドは4個まで、簡易表示するフィールドは20個まで、絞り込み条件・条件付き色分けは各10件までです。
• カンバンのカラムはドロップダウン/ラジオボタンの選択肢から作られます。カラム分けフィールドが未入力のレコードはカンバンに表示されません(他のビューには表示されます)。
• プロセス管理のステータスをカンバンのカラム分けフィールドにすることはできません(ドロップダウン/ラジオボタンのみ)。
• 並び順フィールド・親レコードIDフィールドの値はプラグインが管理する前提です。レコードを直接編集して値を変更すると、並び順や親子表示が意図しない状態になることがあります。

設定のインポート / エクスポート

プラグイン設定画面の上部にある「設定のインポート / エクスポート」から、現在の設定をJSONファイルとして書き出し(エクスポート)、別のアプリで読み込み(インポート)できます。検証用アプリから本番アプリへの設定コピーや、バックアップ・復元にご利用ください。

• インポートは取り込む内容の差分を確認してから「設定画面に反映」し、最後に「保存」を押して確定します(反映しただけでは保存されません)。
• 読み込んだファイルはブラウザ内で処理され、KINTAUROSのサーバーには送信されません。
• 別のアプリの設定を取り込んだ場合、このアプリに存在しないフィールドは警告として一覧表示されるので、反映後に該当箇所を選び直してください。

エクスポートファイルは次の形式(封筒形式)です。config の中身が設定本体で、その構造は上の設定項目リファレンスのとおりです。

{
  "kintauros": "config/v1",
  "plugin": "<プラグインID>",
  "pluginName": "<プラグイン名>",
  "pluginVersion": "<バージョン>",
  "exportedAt": "<書き出し日時(ISO 8601)>",
  "sourceApp": "<書き出し元アプリID>",
  "config": { ... 設定本体 ... }
}

AIエージェント向け: ブラウザコンソールAPI

各プラグインは共通ランタイム window.KINTAUROS を搭載しており、ブラウザの開発者コンソールから設定の読み取り・検証・保存ができます。設定の保存(save: true)はkintoneの制約上、プラグイン設定画面でのみ成功します。

KINTAUROS.config.plugins()                   // このページのKINTAUROSプラグインID一覧
KINTAUROS.config.describeAll()               // 同居プラグインすべての設定サマリ
KINTAUROS.config.of('<プラグインID>').schema()    // 設定のJSON Schema
KINTAUROS.config.of('<プラグインID>').export()    // 現在の設定(封筒つき)
KINTAUROS.config.of('<プラグインID>').validate(x) // 保存せず検証
KINTAUROS.config.of('<プラグインID>').diff(x)     // 現在の設定との差分
await KINTAUROS.config.of('<プラグインID>').import(x, { save: true }) // 検証して保存(設定画面のみ)

登録が1件だけのページでは of(...) を省略できます(例: KINTAUROS.config.export())。

トラブルシューティング

ビューを開いてもタブが表示されない

アプリ設定 > プラグイン からビュースタジオの設定画面を開き、対象のカスタマイズビュー・タイトルフィールド・ビューを設定して保存し、「アプリを更新」してください。表示されるのは設定で指定したビューだけです。また、必須のマッピング(カンバンのカラム分け・並び順、カレンダー/タイムラインの開始日など)が欠けたビューはタブに表示されません。

E001: 設定されたフィールドが見つかりません

設定後にフィールドが削除・変更された状態です。プラグイン設定画面を開き、各ビューのフィールドを現在のフォームに合わせて選び直して保存してください。

カンバンに一部のレコードが表示されない

カラム分けフィールドが未入力のレコードと、「表示する列」で外した選択肢のレコードはカンバンに表示されません。また、ビューの絞り込み条件・kintone標準の絞り込みに一致しないレコードも表示されません。

ドラッグ&ドロップの保存に失敗する

対象レコードの編集権限が必要です。プロセス管理の作業者制限や、フィールドの編集権限もあわせて確認してください。失敗した場合は画面を再読み込みすると最新の状態に戻ります。

レコードの一部しか表示されない

表示は最大1万件です。件数表示が「全10000件(上限)」になっている場合は上限に達しています。ビューの絞り込み条件やkintone標準の絞り込みで対象を絞ってください。

エラーコードと診断情報

ビュースタジオを含むKINTAUROSプラグインは、エラー発生時にブラウザのコンソールへ統一形式のログを出力します。人間向けの1行に続けて、機械可読なJSON(code / plugin / version / appId / message / doc)を出力し、doc には該当エラーの解説ページのURLが入ります。

[KINTAUROS <プラグインID>@<バージョン>] E001: 設定されたフィールドが見つかりません: ...
{"kintauros":{"code":"E001","plugin":"...","version":"...","appId":"...","message":"...","doc":"https://kintauros.com/docs/errors/E001"}}

各エラーコードの意味と対処はエラーコード一覧を参照してください。また、プラグイン設定画面の「サポート用情報をコピー」から、環境・バージョン・ライセンス状態・直近のエラーを含む診断情報をコピーできます(レコードの内容や個人情報は含まれません)。お問い合わせの際はこの情報を添えてください。

ライセンスについて

• 初回利用時は、プラグイン設定画面の「利用開始」ボタンから60日間の無料トライアルを開始できます(カード登録不要)。
• トライアル・契約の期限が切れるとプラグインの動作は停止し、画面に案内が表示されます。料金プランから契約すると同じ設定のまま再開できます。
• ライセンス確認のための外部通信で送信されるのは、kintoneドメイン名・プラグインID・バージョンのみです。レコードの内容や個人情報が外部に送信されることはありません。
• ライセンスサーバーに一時的に接続できない場合も、プラグインは一定期間動作を継続する設計です。

サポート

解決しない場合はお問い合わせからご連絡ください。その際、プラグイン設定画面の「サポート用情報をコピー」でコピーした診断情報を添えていただくと、調査がスムーズです。

最終更新: 2026-09-18 / 対象バージョン: v3.7.1