# レコード一覧からテーブル作成 詳細マニュアル | 設定リファレンス・トラブルシューティング - KINTAUROS

> kintoneプラグイン「レコード一覧からテーブル作成」の詳細マニュアル。全設定項目のリファレンス(意味・制約値)、動作条件・制限事項、エラーコード別のトラブルシューティングを掲載。対象バージョン: v1.1.0。

元ページ: https://kintauros.com/plugins/records-to-table/manual/

レコード一覧からテーブル作成は、レコード一覧の絞り込み結果や登録済みパターンの対象レコードを、別アプリの1レコード内のサブテーブルへワンクリックで集約するプラグインです。このマニュアルでは、設定項目のリファレンスと、動作仕様・制限事項・トラブルシューティングを説明します。

機能紹介・画面イメージ・導入手順は[プラグイン紹介ページ](https://kintauros.com/plugins/records-to-table/)を、ダウンロードは[ダウンロードページ](https://kintauros.com/download/)をご覧ください。このマニュアルは[Markdown版](index.md)でも提供しており、全プラグインのメタ情報と設定スキーマは機械可読な[catalog.json](https://kintauros.com/catalog.json)から取得できます。

## 基本情報

- **プラグインID**: records-to-table

- **対象バージョン**: v1.1.0(配布中の最新版)

- **カテゴリ**: テーブル編集・連携

- **説明**: レコード一覧の複数レコードを、別アプリの1レコード内のテーブルにまとめて出力します。

## 動作条件

- **対応環境**: kintone スタンダードコース(デスクトップ版UI)。最新版の Chrome / Edge / Safari / Firefox に対応。

- **動作画面**: レコード一覧画面。ヘッダーにパターン選択と実行ボタンを設置します。

- **必要な権限**: 実行するユーザーに、このアプリのレコード閲覧権限と、出力先アプリのレコード追加権限が必要です。

## 設定項目リファレンス

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

- **項目**: 型 / 必須 / 説明・制約

- **settings**: オブジェクト / 必須 / -

- **settings.destAppId**: 文字列 / 必須 / 出力先アプリID / 形式: ^[0-9]+$

- **settings.destAppName**: 文字列 / 任意 / 出力先アプリ名(表示用の控え)

- **settings.destTable**: 文字列 / 必須 / 出力先テーブル(出力先アプリのサブテーブルのフィールドコード) / 1文字以上

- **settings.rowLimit**: 整数 / 任意 / 出力できる最大行数(既定 1000) / 1以上 / 5000以下

- **settings.tableMappings**: 配列 / 必須 / フィールドの指定(テーブル列) / 1件以上

- **settings.tableMappings[].src**: 文字列 / 必須 / このアプリのフィールドコード / 1文字以上

- **settings.tableMappings[].dest**: 文字列 / 必須 / 出力先テーブル内のフィールドコード(型に互換性が必要) / 1文字以上

- **settings.recordNoField**: 文字列 / 任意 / 元レコード番号を入れるテーブル列。空なら使用しない

- **settings.recordUrlField**: 文字列 / 任意 / 元レコードURLを入れるテーブル列。空なら使用しない

- **settings.headerMappings**: 配列 / 任意 / フィールドの指定(テーブル外)

- **settings.headerMappings[].src**: 文字列 / 必須 / 1文字以上

- **settings.headerMappings[].dest**: 文字列 / 必須 / 1文字以上

- **settings.autoSet**: オブジェクト / 任意 / 自動セット項目(出力先のテーブル外フィールド)

- **settings.autoSet.patternName**: 文字列 / 任意 / パターン名のセット先。空なら使用しない

- **settings.autoSet.count**: 文字列 / 任意 / 件数のセット先。空なら使用しない

- **settings.autoSet.query**: 文字列 / 任意 / 使用クエリのセット先。空なら使用しない

- **settings.patterns**: 配列 / 必須 / 絞り込みパターン(配列順=一覧の表示順) / 1件以上

- **settings.patterns[].name**: 文字列 / 必須 / パターン名(重複不可) / 1文字以上

- **settings.patterns[].logic**: 文字列 / 任意 / 条件の結合。省略時は and / 値: and | or

- **settings.patterns[].conditions**: 配列 / 必須 / 1件以上

- **settings.patterns[].conditions[].field**: 文字列 / 必須 / このアプリのフィールドコード / 1文字以上

- **settings.patterns[].conditions[].op**: 文字列 / 必須 / 値: = | != | > | < | >= | <= | like | not like | in | not in

- **settings.patterns[].conditions[].valType**: 文字列 / 必須 / 値: value | TODAY | FROM_TODAY | THIS_MONTH | LAST_MONTH | THIS_YEAR | LOGINUSER

- **settings.patterns[].conditions[].value**: 文字列 / 任意 / valType=value のときの比較値 / FROM_TODAY のときの日数

- **settings.patterns[].conditions[].type**: 文字列 / 任意 / フィールド型(保存時に自動算出。手で編集しない)

- **settings.patterns[].sortField**: 文字列 / 任意 / 並べ替えフィールド。空なら指定なし

- **settings.patterns[].sortOrder**: 文字列 / 任意 / 並べ替え順 / 値: asc | desc

- **settings.destTypes**: オブジェクト / 任意 / 出力先フィールドの型情報(保存時に自動算出) / 実行時の値変換に使う内部情報。手で編集しない(保存時に出力先アプリの定義から再計算される)。

## 設定のポイント

- patterns の配列順が一覧でのプルダウン表示順になります。パターン名は重複できません。

- 条件の valType では固定値(value)のほか、TODAY(今日)・FROM_TODAY(今日からn日)・THIS_MONTH(今月)・LAST_MONTH(先月)・THIS_YEAR(今年)・LOGINUSER(ログインユーザー)の動的な値が使えます。

- rowLimit(出力できる最大行数)は既定1,000行・最大5,000行です。

- autoSet を使うと、実行したパターン名・対象件数・使用クエリを出力先レコードのフィールドへ自動記録できます。destTypes は保存時に自動算出される内部項目のため手で編集しないでください。

## 動作仕様

- 実行のたびに、出力先アプリへ新しいレコードを追加します(パターンごとに1レコード)。実行前に出力先アプリと対象件数が表示され、確認してから実行できます。

- テーブルの各行に、出力元レコードのレコード番号(recordNoField)とURL(recordUrlField)を自動で入れられます。

- 複数パターンの一括実行にも対応しています。

- このプラグインは実行時のエラーを画面にエラーコード付きで表示します(E101〜E105)。各コードの意味と対処はエラーコード一覧を参照してください。

## 制限事項・既知の仕様

- モバイルアプリの画面では動作しません(デスクトップ版UIのみ)。

- 1回の出力は最大5,000行までです(既定1,000行)。上限を超える場合は実行されません(E103)。

- 出力元と出力先のフィールドは型に互換性が必要です。

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

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

## トラブルシューティング

**E101: プラグインの設定が完了していません / 実行対象のパターンが見つかりません**

アプリ設定 > プラグイン から、出力先アプリ・出力先テーブル・フィールドの関連付け・絞り込みパターンを設定して保存し、アプリを更新してください。

**E102: 対象レコードが0件のため出力しませんでした**

パターンの絞り込み条件に一致するレコードがありません。条件を見直すか、対象レコードがあるか確認してください。

**E103: 対象件数が上限を超えています**

絞り込み条件で対象を減らすか、プラグイン設定の「出力できる最大行数」(最大5,000)を見直してください。

**E104: 対象レコードの取得に失敗しました**

パターンの条件に使っているフィールドが変更・削除されていないか確認してください。フォーム変更後は設定画面で条件フィールドを選び直して保存してください。

**E105: 出力先へのレコード作成に失敗しました**

出力先アプリのレコード追加権限があるか、出力先のフィールド(テーブル列・テーブル外の転記先)が変更・削除されていないかを確認してください。

## エラーコードと診断情報

レコード一覧からテーブル作成を含む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"}}
```

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

## ライセンスについて

- 初回利用時は、プラグイン設定画面の「利用開始」ボタンから60日間の無料トライアルを開始できます(カード登録不要)。

- トライアル・契約の期限が切れるとプラグインの動作は停止し、画面に案内が表示されます。[料金プラン](https://kintauros.com/#pricing)から契約すると同じ設定のまま再開できます。

- ライセンス確認のための外部通信で送信されるのは、kintoneドメイン名・プラグインID・バージョンのみです。レコードの内容や個人情報が外部に送信されることはありません。

- ライセンスサーバーに一時的に接続できない場合も、プラグインは一定期間動作を継続する設計です。

## サポート

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

最終更新: 2026-08-14 / 対象バージョン: v1.1.0