kintone導入「寄り添いサービス」会員の方は、このプラグインを無償でご利用いただけます。
こちらは有料プラグインです。ご利用には別途ご契約が必要です。
概要
kintone標準の関連レコード一覧では、参照先レコードの項目は表示できても、サブテーブル(明細)の中身までは見ることができません。本プラグインは、レコード詳細画面に置いたスペース要素へ、関連するレコードとその明細を1つの表にまとめて表示します。親レコードの項目は明細の行数ぶんセルを結合して表示されるため、どのレコードのどの明細かがひと目で分かります。明細に添付されたファイルは画面を離れずにプレビュー・ダウンロードでき、画像・PDF・Excel・CSV・テキストなどに対応しています。表はそのままExcelへ貼り付けたり印刷したりでき、数値列の合計も表示できます。ご利用にはライセンス契約が必要です(お問い合わせください)。
使い方・設定方法
kintone標準の関連レコード一覧では見ることができない「参照先レコードのサブテーブル(明細)」を、親レコードの情報と一緒に1つの表で表示します。取引先レコードを見ながら受注の明細を確認する、案件レコードから作業報告の内訳を追う、といった使い方ができます。
できること
- 他のアプリのレコードを、キー項目で紐づけて一覧表示します
- 参照先レコードのサブテーブル明細を、同じ表に展開して表示します
- 親レコードの項目は明細の行数ぶんセルを結合して表示します
- 明細の並べ替え、数値列の合計、Excelへのコピー、印刷ができます
- 明細に添付されたファイルをその場でプレビュー・ダウンロードできます
- 1つのレコード詳細画面に複数の表を配置できます
事前準備
次の2点をご用意ください。
| 準備するもの | 内容 |
|---|---|
| キー項目 | 表示する側のアプリと参照先アプリの両方に、レコードを紐づける同じ値が入る項目(取引先コード、案件番号など)。両方で同じフィールド型にしてください |
| スペース要素 | 表を表示したい位置に、フォームの「スペース」要素を配置し、要素IDを付けておきます |
参照先アプリには、表示したいサブテーブルが1つ以上必要です。
設定手順
- 表を表示したいアプリのフォーム設定で「スペース」要素を配置し、要素ID(例:
relatedOrders)を設定します - アプリの設定画面から本プラグインの設定を開きます
- ライセンスキーを入力します
- 「+ ブロックを追加」を押し、次の項目を設定します
- 保存して、アプリを更新します
設定できる項目は次のとおりです。
| 設定項目 | 内容 |
|---|---|
| スペース要素ID | 手順1で設定した要素ID |
| ブロックタイトル | 表の見出しに表示される名前 |
| 参照先アプリ | 明細を表示したいアプリ。アプリ名やアプリIDを検索欄に入力して絞り込めます |
| 自アプリのキー/参照先のキー | レコードを紐づける項目。参照先のキーは、選んだキーと同じ型のものだけが候補に出ます |
| 追加の絞り込み条件 | 特定の状態のレコードだけを表示したい場合に指定します(任意) |
| 表示するサブテーブル | 参照先アプリのどの明細を表示するか |
| 表示する親フィールド | 表の左側に出す、参照先レコードの項目。チェックで選び、↑↓で並び順を変えられます |
| 表示するサブテーブル列 | 表の右側に出す明細の列。同じくチェックと↑↓で指定します |
| レコードへのリンクにする列 | クリックで参照先レコードを開く列 |
| 取得上限 | 表示する関連レコードの最大件数(1〜500件) |
| 初期ソート/並び順 | 最初に表示するときの並び順 |
| 合計を出す列 | 表の最下部に合計を表示する列(数値・計算の列から選べます) |
| 表示オプション | 明細のない関連レコードを隠すか、画像をサムネイルで表示するか |
| 既定の表示モード | 最初に「結合」と「繰り返し」のどちらで表示するか |
1つのレコード詳細画面に複数の表を出したい場合は、スペース要素をその数だけ配置し、ブロックを追加してください。
使い方
2つの表示モード
表の右上のボタンで、2つの表示を切り替えられます。
| モード | 表示 | 向いている場面 |
|---|---|---|
| 結合 | 親レコードの項目を、明細の行数ぶんセルを結合して表示 | 画面上で読むとき。どのレコードのまとまりか分かりやすくなります |
| 繰り返し | 親レコードの項目を、明細の各行に繰り返して表示 | Excelに貼り付けるとき。明細の並べ替えもできます |
列の見出しをクリックすると並べ替わります。もう一度押すと昇順と降順が切り替わります。明細の列で並べ替えたときは、自動的に「繰り返し」表示に変わります(セルを結合したままでは明細の順番を入れ替えられないためです)。
添付ファイルの確認
明細に添付ファイルの列がある場合、画像はサムネイル、それ以外はファイル名で表示されます。クリックすると画面を離れずにプレビューが開きます。
| 種類 | プレビュー |
|---|---|
| 画像(JPEG・PNG・GIF ほか) | 表示できます |
| ページ送り・拡大縮小ができます | |
| Excel・CSV・TSV | 表として表示できます。見出しと行番号はスクロールしても固定表示され、複数シートはタブで切り替えられます |
| テキスト・Markdown・JSON・HTML | 文字コードを切り替えて表示できます |
| 動画・音声 | 再生できます |
| ZIP・Word・PowerPoint ほか | プレビューはできません。ダウンロードしてご確認ください |
プレビュー画面の「‹」「›」では、その表に含まれる添付ファイルを関連レコードをまたいで順番に見ていけます。1件ずつレコードを開き直す必要がありません。どのレコードのどの明細のファイルかは画面下部に表示されます。「ダウンロード」からファイルを保存できます。
Excelへのコピー・印刷
- 「コピー」を押すと、表示中の内容がクリップボードにコピーされます。Excelに貼り付けるとそのまま表になります(親の項目は各行に繰り返した形でコピーされるため、貼り付け後の並べ替えや集計にも使えます)
- 「印刷」を押すと、操作ボタンを除いた表だけが印刷されます。見出しと合計行は各ページに繰り返し印刷されます
注意事項・うまくいかないとき
| 症状 | 確認すること |
|---|---|
| 表が表示されない | フォームに配置したスペース要素の要素IDと、設定画面のスペース要素IDが一致しているか確認してください |
| 「キーが未入力のため関連レコードを表示できません」と出る | 表示中のレコードのキー項目が空欄です。値を入力すると表示されます |
| 「該当する関連レコードはありません」と出る | キーの値が一致するレコードが参照先アプリに無いか、絞り込み条件で除外されています |
| 「参照先アプリを表示する権限がありません」と出る | 参照先アプリの閲覧権限をご確認ください。閲覧できないレコードは表示されません |
| 表の下に上限のお知らせが出る | 取得上限に達しています。上限を増やすか、絞り込み条件で対象を絞ってください(上限は最大500件です) |
| PDFやExcelのプレビューが開かない | プレビュー機能はインターネット接続が必要です。社内ネットワークの制限をご確認ください。開けない場合もダウンロードはご利用いただけます |
そのほかの注意点は次のとおりです。
- 表示は閲覧専用です。明細の値をこの表から編集することはできません
- パソコンの画面に対応しています(モバイル版アプリでは表示されません)
- 明細が1行も無い関連レコードは「(明細なし)」として1行表示されます。表示したくない場合は設定で隠せます
- 合計は、画面に表示されている行だけを対象に計算されます
バージョン履歴
- v1.0.32026-08-03
アイコンを刷新しました。
- v1.0.22026-08-03
ExcelやCSVをプレビューしたときの表示を見直しました。文字コードの切り替えを上部にまとめ、表に見出しと行番号の固定表示を加えて読みやすくしました。
- v1.0.12026-08-03
参照先アプリの一覧に表示されないアプリがある問題を修正しました。あわせて、アプリ名やアプリIDで絞り込める検索欄を設定画面に追加しました。
- v1.0.02026-08-03
初回リリース。関連レコードとそのサブテーブル明細をまとめて表示し、明細の添付ファイルをプレビュー・ダウンロードできます。