レコード一覧からテーブル作成詳細マニュアル

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

基本情報

プラグインID	records-to-table
対象バージョン	v1.2.0(配布中の最新版)
カテゴリ	テーブル
説明	レコード一覧の複数レコードを、別アプリの1レコード内のテーブルにまとめて出力します。

動作条件

対応環境	kintone スタンダードコース(デスクトップ版UI)。最新版の Chrome / Edge / Safari / Firefox に対応。
動作画面	レコード一覧画面。ヘッダーにパターン選択と実行ボタンを設置します。
必要な権限	実行するユーザーに、このアプリのレコード閲覧権限と、出力先アプリのレコード追加権限が必要です。出力先にルックアップを指定している場合は、そのルックアップの参照先アプリの閲覧権限も必要です。

設定項目リファレンス

プラグイン設定の全項目です。「項目」は設定データ(エクスポートファイルの config)のキーを表し、[] は配列の要素を意味します。設定画面での入力項目と1対1に対応します。この構造の正式な定義はJSON Schema(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`	オブジェクト	任意	出力先フィールドの型情報(保存時に自動算出) 実行時の値変換に使う内部情報。手で編集しない(保存時に出力先アプリの定義から再計算される)。
`settings.destLookups`	オブジェクト	任意	出力先のうちルックアップであるフィールドの参照先情報(保存時に自動算出) 実行前の事前チェック(参照先アプリの閲覧権限・コピー元フィールドの重複禁止・値の存在)に使う内部情報。キーは出力先フィールドコード。手で編集しない。

設定のポイント

patterns の配列順が一覧でのプルダウン表示順になります。パターン名は重複できません。
条件の valType では固定値(value)のほか、TODAY(今日)・FROM_TODAY(今日からn日)・THIS_MONTH(今月)・LAST_MONTH(先月)・THIS_YEAR(今年)・LOGINUSER(ログインユーザー)の動的な値が使えます。
rowLimit(出力できる最大行数)は既定1,000行・最大5,000行です。
autoSet を使うと、実行したパターン名・対象件数・使用クエリを出力先レコードのフィールドへ自動記録できます。destTypes は保存時に自動算出される内部項目のため手で編集しないでください。
出力先にはルックアップも指定できます(文字列1行・ルックアップなど型が合う出力元と関連付け)。ルックアップの参照先アプリの「コピー元のフィールド」には「値の重複を禁止する」の設定が必要で、未設定の場合は設定画面に警告が出て保存できません。ルックアップの「ほかのフィールドのコピー」先フィールドは出力時に自動で入るため、出力先として指定できません。

動作仕様

実行のたびに、出力先アプリへ新しいレコードを追加します(パターンごとに1レコード)。実行前に出力先アプリと対象件数が表示され、確認してから実行できます。
テーブルの各行に、出力元レコードのレコード番号(recordNoField)とURL(recordUrlField)を自動で入れられます。
複数パターンの一括実行にも対応しています。
出力先にルックアップを指定している場合、実行前に参照先アプリを照会し、参照先に存在しない値・参照先アプリの閲覧権限不足・「値の重複を禁止する」の未設定があれば、どの値(レコード番号)が該当するかを表示して出力を中止します(E106)。
このプラグインは実行時のエラーを画面にエラーコード付きで表示します(E101〜E106)。各コードの意味と対処はエラーコード一覧を参照してください。

制限事項・既知の仕様

モバイルアプリの画面では動作しません(デスクトップ版UIのみ)。
1回の出力は最大5,000行までです(既定1,000行)。上限を超える場合は実行されません(E103)。
出力元と出力先のフィールドは型に互換性が必要です。
出力先のルックアップには、参照先アプリの「コピー元のフィールド」に存在する値と完全に一致する値のみ出力できます(前後の空白や全角・半角の違いも不一致になります)。1行でも不一致があると、そのパターンの出力は行われません。

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

プラグイン設定画面の上部にある「設定のインポート / エクスポート」から、現在の設定を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: 出力先へのレコード作成に失敗しました: 出力先アプリのレコード追加権限があるか、出力先のフィールド(テーブル列・テーブル外の転記先)が変更・削除されていないかを確認してください。
E106: ルックアップの事前チェックで問題が見つかりました: メッセージに表示される内容に応じて対処してください。「参照先アプリに存在しません」: 表示された値(とレコード番号)を参照先アプリに登録するか、出力元の値を参照先と完全一致するよう修正します。「値の重複を禁止する」が未設定: 参照先アプリのフォーム設定で「コピー元のフィールド」の重複禁止を有効にします。「情報を取得できませんでした」: 実行するユーザーに参照先アプリの閲覧権限を付与します。

エラーコードと診断情報

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

レコード一覧からテーブル作成 詳細マニュアル