Tips

文字結合プラグイン

目次

概要

複数のフィールドに入力された値を結合するプラグインです。
このプラグインでは、計算フィールドで結合できない、ルックアップやラジオボタンも結合できます。

  • 最大で 5 つのフィールドを結合できます。
  • 設定できる結合項目は 3 つまでです。
  • 結合するフィールド間の記号も、自由に設定できます。

注意事項

  • サンプルプラグインに関するお問い合わせは、API サポート窓口へのお問い合わせの対象外です。
  • kintone プラグインは、スタンダードコースでのみ利用できます。

制限事項

  • 次のフィールドを結合元フィールドにした場合、選択した一番上の値を結合します。
    • チェックボックス
    • 複数選択
    • ユーザー選択
    • 組織選択
    • グループ選択
  • 次のフィールドは文字結合の対象外です。
    • レコード番号
    • 作成者
    • 更新者
    • 作成日時
    • 更新日時
    • リッチエディター
    • テーブルに含まれるフィールド
    • カテゴリー
    • ステータス
    • 作業者
    • 添付ファイル

プラグインの機能

複数のフィールドの値を結合した文字列を、別のフィールドに入力できます。

プラグインのパッケージング

プラグイン化の手順の詳細は kintone プラグイン開発手順 を参照してください。

STEP1：ソースコードのダウンロード

GitHub (External link) にアクセスしてフォルダーごとダウンロードしてください。
「examples/textConnect」がこのプラグインのソースコード一式です。

ファイルの構成

「examples/textConnect」配下のファイル構成は次のとおりです。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

examples/textConnect
├── README.md
├── config_css
│   └── 51-modern-default.css
├── config_js
│   └── config.js
├── contents
│   ├── icon.png
│   └── setting.html
├── desktops
│   └── desktop.js
├── manifest.json
├── mobiles
│   └── mobile.js
└── package.sh

STEP2：パッケージング

plugin-packer の手順を参考にパッケージングします。

パッケージングしたサンプル

このプラグインはプラグイン開発のためのサンプルで、サポート対象外です。
ご理解の上、ダウンロードしてください。

SAMPLE_text_connect_plugin_v1.3.5.zip

プラグインの設定

STEP1：プラグインの読み込み

kintone システム管理画面で、パッケージングしたファイル（zip ファイル）を読み込みます。
ファイルからプラグインを読み込む (External link)

STEP2：アプリの設定

  1. アプリを追加します。

  2. 次のフィールドを配置します。

    フィールド フィールドの種類 備考
    結合の対象となるフィールド 次のいずれか
    • 文字列（1行）
    • 文字列（複数行）
    • 数値
    • ラジオボタン
    • チェックボックス
    • 複数選択
    • ドロップダウン
    • 日付
    • 時刻
    • 日時
    • リンク
    • ユーザー選択
    • 組織選択
    • グループ選択
    • ルックアップ
    		 結合の対象となるフィールド
    結合された文字列を入力するフィールド 次のいずれか
    • 文字列（1行）
    • リッチエディタ
    • 文字列（複数行）
    		 結合された文字列が入力されるフィールド

STEP3：プラグインの追加と設定

  1. アプリの設定画面を開き、プラグインを追加します。
    アプリにプラグインを追加する (External link)

  2. プラグインの設定画面を開き、項目を設定します。

    項目名 必須 説明
    結合する項目 必須 結合の対象となるフィールド
    最大 5 つまで選択できます。
    項目間の記号 省略可 「結合する項目」の間の記号
    未入力の場合は、項目が直接結合されます。
    結合された文字列を表示する項目 必須 結合された文字列を入力するフィールド
    保存時の入力値チェック 省略可 「結合する項目」に指定したフィールドが未入力の場合、アラートを表示できます。

  3. 【保存】をクリックします。

  4. 「アプリの設定」画面で、【設定完了】をクリックします。

STEP4：動作確認

  1. レコードを追加します。
  2. 「結合する項目」に指定したフィールドへ値を入力すると、「結合された文字列を表示する項目」に指定したフィールドへ結合された文字列が入力されることを確認します。
  3. 【保存】をクリックします。
    「保存時の入力値チェック」を選択した場合、「結合する項目」に指定したフィールドが未入力のとき、アラートが表示されます。

  4. 結合された文字列が保存されることを確認します。

更新履歴

  • 2016 年 6 月 30 日 v1.0 を公開
  • 2017 年 2 月 10 日 v1.1 を公開
    • プラグイン設定画面で何も設定しない場合に、レコード登録できない不具合を修正しました。
  • 2017 年 11 月 1 日 v1.1.1 を公開
    • プログラムで使用しているフォーム設計情報取得 API を、フィールドの一覧を取得する API に置き換えました。
  • 2017 年 11 月 20 日 v1.2.0 を公開
    • 設定できる結合項目を 3 つまで追加しました。
  • 2018 年 11 月 5 日 v1.2.1 を公開
    • 結合対象の文字列に値が存在しない場合の結合結果を変更しました。
      たとえば、「文字列 A」「文字列 B」「文字列 C」を結合記号「,」で結合する場合、文字列 B に値が存在しないときの結果は次のとおりです。
      • v1.2.0 まで：文字列 A,,文字列 C
      • v1.2.1 から：文字列 A,文字列 C
    • 設定項目のローカライズ対応（英語）を行いました。
  • 2019 年 1 月 9 日 v1.3.0 を公開
    • モバイルに対応しました。
    • 「結合する項目」がチェックボックスフィールドや複数選択フィールドの場合に、結合対象の文字列に値が存在しないときの結合結果を修正しました。
      結合結果は、更新履歴 v1.2.1 での結果と同じです。
  • 2019 年 2 月 1 日 v1.3.1 を公開
    • 「項目間の記号」に半角スペース、または全角スペースを設定した際のエスケープ処理に関する不具合を修正しました。
  • 2019 年 4 月 5 日 v1.3.2 を公開
    • 設定画面に「保存時の入力値チェック」の項目を追加しました。
    • 「保存時の入力値チェック」が有効なときのみ、レコード保存時に未入力チェックを行うよう変更しました。
    • v1.3.1 の修正内容をモバイルにも反映しました。
  • 2020 年 5 月 29 日 v1.3.3 を公開
    • 設定項目のローカライズ対応（中国語）を行いました。
  • 2021 年 2 月 25 日 v1.3.4 を公開
    • 利用していない jQuery を削除しました。
  • 2022 年 10 月 5 日 v1.3.5 を公開

利用している OSS のライセンス情報

このプラグインで利用している OSS のライセンスは次のとおりです。