スプレッドテーブル 詳細マニュアル

基本情報

プラグインID	spreadtable
対象バージョン	v1.5.0(配布中の最新版)
カテゴリ	テーブル
説明	サブテーブルを、Excelのような操作感で編集します。

動作条件

対応環境	kintone スタンダードコース(デスクトップ版UI)。最新版の Chrome / Edge / Safari / Firefox に対応。
動作画面	レコードの追加画面・編集画面。対象のサブテーブルは非表示になり、代わりに表計算UIが表示されます。
表示言語	日本語・英語・中国語(簡体字・繁体字)。設定画面・編集画面の文言は kintone の表示言語に合わせて切り替わります(それ以外の表示言語では英語。1.5.0 以降)。
必要な事前準備	フォーム設定で、対象のサブテーブルと、UIを表示する「スペース」フィールド(要素ID設定済み)を配置しておく必要があります。
対応フィールド	サブテーブル内の文字列・数値・日付・日時・ドロップダウン・ラジオボタン・チェックボックス・複数選択など。

設定項目リファレンス

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

設定のポイント

• targetSpaceId に指定するのはスペースの「要素ID」です(フィールドコードではありません)。フォーム設定でスペースを配置する際に設定した値を使います。
• スペースはサブテーブルの近く(直下など)に配置すると、入力の流れが自然になります。

動作仕様

• レコード追加・編集画面で、対象サブテーブルの代わりに表計算UIが表示されます。編集内容はレコード保存時にkintone標準のサブテーブルの値として書き込まれるため、データの持ち方は変わりません。
• Excel・Googleスプレッドシートから範囲コピーした表をそのまま貼り付けられます。Enter・Tab・矢印キーでのセル移動、右クリックメニューからの行の挿入・削除に対応。
• セルはフィールドタイプに応じた編集方式になります(数値は右寄せ、ドロップダウン・ラジオボタンは選択式、日付はカレンダー入力など)。列の並びはフォームのテーブル設定に追従します。
• 保存前の変更は見た目で区別できます(1.5.0 以降)。変更したセルは左端に黄色のマーカー、値を入れた追加行は行番号に色が付き、「追加」ボタンの横に「未保存の変更: N セル / 追加 N 行 / 削除 N 行 / 行の並び替え」が表示されます。元の値に戻すとマーカーは消えます。レコードを保存またはキャンセルすると表示はクリアされます。

制限事項・既知の仕様

• モバイルアプリの画面では動作しません(デスクトップ版UIのみ)。
• 動作にはサブテーブルと要素ID設定済みスペースの両方が必要です。どちらかが無いアプリでは設定画面にその旨のエラーが表示されます。
• 詳細画面の表示はkintone標準のサブテーブル表示のままです(表計算UIになるのは追加・編集画面のみ)。

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

プラグイン設定画面の上部にある「設定のインポート / エクスポート」から、現在の設定を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())。

トラブルシューティング

設定画面に「サブテーブルまたはスペースがありません」と表示される

フォーム設定で(1)サブテーブルを配置しているか、(2)スペースフィールドを配置して「要素ID」を設定しているかを確認し、フォームを保存してから設定画面を開き直してください。

追加・編集画面に表計算UIが表示されない

(1)設定で対象サブテーブルと表示先スペースを選択して保存したか、(2)保存後に「アプリを更新」したか、(3)フォームからスペースを削除したり要素IDを変更したりしていないかを確認してください。

貼り付けた値がセルに入らない

ドロップダウン・ラジオボタンなど選択式のセルには、選択肢に存在する値のみ入力できます。貼り付け元の値が選択肢と完全一致しているか(前後の空白を含め)確認してください。

エラーコードと診断情報

スプレッドテーブルを含む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 / 対象バージョン: v1.5.0