アプリ結合プラグイン マニュアル
はじめて使う方は、先に 共通ガイドをご覧ください。
⚠️ 最初に必ずお読みください
本プラグインは、実行ボタンを押すと、インストール先アプリの「全レコードを削除」してから結合結果を書き込みます。 すでに運用中のアプリへのインストールは行わないようにしてください。 なお、元のデータ(結合のもとになる2つのアプリ)には影響を与えません。
1. 本プラグインでできること
2つのkintoneアプリを、指定した共通のキーでつなぎ合わせ、その結果を1つのアプリにまとめます。
- 工数実績取り込みプラグインで取り込んだクラウドログの工数情報と、すでに存在している案件情報をkintone上で紐づけるような用途にご利用いただけます。
- ベースアプリの全レコードを残し、キーが一致する結合アプリの情報を結合します。一致する相手がいないレコードも、ベース側はそのまま残ります。(LEFT JOIN方式)
用語の説明
| 言葉 | 意味 |
|---|---|
| ベースアプリ | 結合の「土台」になるアプリ。このアプリの全レコードが結果に残ります。 |
| 結合アプリ | ベースアプリにくっつける情報を持つアプリ。 |
| 結合キー | 2つのアプリを結びつけるための共通の列(例:「案件コード」)。 |
2. 使う前に必要な準備
2-1. 結合結果専用のアプリを新しく作る
結合結果を入れるための新しいアプリを用意し、プラグインをインストールします。
2-2. ベースアプリ・結合アプリを用意する
- 結合したい2つのアプリ(ベースアプリと結合アプリ)を用意します。
- 2つのアプリは同じスペース内にある必要があります。
- 両アプリに、結合キーになる共通の列(例:案件コード)があることを確認してください。
ベースアプリの例
結合アプリの例
3. 設定手順
プラグイン設定画面を開き、次を設定します。
| 項目 | 設定内容 |
|---|---|
| ベースアプリ | 土台にするアプリを選択 |
| 結合アプリ | 結合するアプリを選択 |
| 結合キー | 2つのアプリをつなぐ共通の列を選択 |
| プレフィックス | フィールドコードが重複したときに付ける接頭辞(初期値は join_) |
3-1. フィールドコードが重複したときの動作
ベースアプリと結合アプリに同じフィールドコードがある場合、結合アプリ側のフィールドコードに「プレフィックス」が付きます。
例(プレフィックスが join_ の場合)
- ベースアプリ:
id,name,date - 結合アプリ:
id,code,name - 結合結果:
id(ベース),name(ベース),date(ベース),join_id(結合),code(結合),join_name(結合)
プレフィックスは「半角英数字とアンダースコア(_)」のみ、先頭は英字かアンダースコア、32文字以内で指定できます。
3-2. 結合結果アプリにフィールドを作成する
- 設定画面のフィールドプレビューに、結合結果に必要なフィールドコードの一覧が表示されます。
- この一覧を見ながら、結合結果アプリ側に同じフィールドコードのフィールドを作成してください。
- フィールドは 「文字列1行」で作成してください。結合結果はすべて文字列として書き込まれるため、数値型・日付型などで作ると取り込み時にエラーになることがあります。
4. 実行手順
- 結合結果アプリのレコード一覧画面を開きます。「結合プラグイン実行」ボタンが表示されます。
- ボタンを押すと確認ダイアログが出ます。
- 内容を確認して 「実行」を押します(結果アプリの既存レコードは全削除されます)。
- 完了すると、削除件数・挿入件数が表示されます。
5. 取り込めるフィールドの種類
結合できるフィールド
- 文字列1行 / 文字列複数行 / リッチエディター
- 数値 / 計算
- 日付 / 時刻 / 日時
- リンク
- ドロップダウン / ラジオボタン
- 複数選択 / チェックボックス ※カンマ区切りの文字列で取り込みます(例:選択肢A, 選択肢B)
結合できないフィールド
これらのフィールドは、設定画面の選択肢やプレビューに表示されません。
- ユーザー選択 / 組織選択 / グループ選択
- 添付ファイル
- テーブル(サブテーブル)
- 関連レコード一覧
- ラベル・罫線・スペースなどの装飾
- システムフィールド(レコード番号 / 作成者 / 作成日時 / 更新者 / 更新日時 / 作業者 / ステータス / カテゴリー)
- 作成日時, 更新日時, レコード番号などのkintoneシステムフィールド
6. 制限事項
- インストール先の既存データは保護されません。実行のたびに全レコードを削除して作り直します。
- 結合キーは1つだけです。「案件コード+年度」のように2つの列を組み合わせたキーでの結合はできません。
- 結合方式は LEFT JOIN のみです。「両方に存在するものだけ残す(INNER JOIN)」などは選べません。
- 全フィールドが取り込まれます。必要な列だけを選ぶことはできません。
- 差分のみの更新はできません。
- スペースをまたいだ結合はできません。ベースアプリと結合アプリは同じスペース内にある必要があります。
- 結合キーは文字列として突き合わせます。キーの値は文字列に変換して比較するため、前ゼロの有無(
001と1)や全角・半角の違いがあると、別物とみなされて結合されません。両アプリでキーの表記を揃えてください。 - キーが空のレコードは結合されません。結合アプリ側でキーが空のレコードは無視されます。ベースアプリ側でキーが空のレコードは残りますが、結合相手が見つからず結合列は空になります。
7. うまくいかないときは
| 項目 | 対処 |
|---|---|
| 「処理に失敗しました。時間をおいて再実行してください」と表示される | 一時的な通信エラーの可能性があります。少し待ってからもう一度実行してください。 |
| エラーメッセージ(権限不足・フィールド不一致など)が表示される | 表示された内容をご確認ください。 |