このプラグインでできること
「アプリ間自動更新プラグイン」は、レコードを保存したときに、ほかのアプリのレコードを条件で探して自動で更新するプラグインです。
出庫を登録したら在庫数を減らす、受注を保存したら顧客マスタの最終取引日を書き換える、といった二重入力をなくせます。条件に合うレコードがないときは、追加もできます。
主な機能は次のとおりです。
- レコードの保存のあとに、ほかのアプリ(このアプリ自身も可)のレコードを更新する
- 更新するレコードを、更新先のフィールドとこのアプリの値を比べる条件(10件まで)で探す
- 数値は「上書きする」「足す(加算)」「引く(減算)」から選べる。足し引きは更新先の今の値から計算する
- テーブルの明細1行ずつに、更新先を探して更新できる
- 条件に合うレコードがないときは、レコードを追加できる
- PC版・モバイル版の追加・編集画面と、一覧のインライン編集で動作する
出庫を登録する画面。明細に「AC-100 を2個」「FL-200 を6個」と入れて保存する
保存する前の在庫管理アプリ。東京倉庫の AC-100 は20、FL-200 は50
保存した後の在庫管理アプリ。東京倉庫の AC-100 は18、FL-200 は44 に減り、最終出庫日と最終会社名が入る。大阪倉庫の AC-100 は変わらない
こんな場面で役立ちます。
- 入出庫のアプリと在庫のアプリを分けていて、在庫数を手で直している
- 商談や受注の登録のたびに、顧客マスタの最終取引日や担当者を書き換えている
- 貸出・返却の登録で、台帳の状態を「貸出中」「返却済み」に変えている
動作環境・前提条件
2-1. 事前に必要な設定
更新先のアプリと、更新するレコードを探すための項目(品番・顧客コードなど)を、両方のアプリに用意しておきます。
専用のフィールドを追加する必要はありません。
2-2. 必要な権限
| 対象 | 必要な権限 |
|---|---|
| プラグインを設定する人 | このアプリの管理権限と、更新先アプリの閲覧権限 |
| レコードを保存する人 | 更新先アプリの「レコード編集」の権限(追加もするときは「レコード追加」の権限) |
💡 更新は、レコードを保存した人の権限で行います。APIトークンの設定は要りません。
2-3. 対応する画面と操作
| 画面・操作 | 対応 |
|---|---|
| レコード追加・編集画面で保存(PC版・モバイル版) | 対応 |
| レコード一覧のインライン編集で保存(PC版) | 対応(「編集して保存したとき」) |
| プロセス管理のアクション(ステータスの変更) | 対象外 |
| CSVの読み込み、API・ほかのプラグインによる更新 | 対象外 |
設定手順
3-1. プラグインを追加する
- アプリの設定画面を開き、「設定」タブの「プラグイン」をクリックします。
- 「追加する」をクリックし、「アプリ間自動更新プラグイン」にチェックを入れて「追加」をクリックします。
- プラグインの一覧で、アプリ間自動更新プラグインの歯車のアイコンをクリックすると、設定画面が開きます。
3-2. ルールを作る
- タブの「+」をクリックして、ルールを追加します。
- 「ルール名」を入力します(例:出庫したら在庫数を減らす)。右のスイッチで、ルールの有効・無効を切り替えられます。
- 「実行するタイミング」を選びます。
- 追加して保存したとき
- 編集して保存したとき(一覧のインライン編集も含みます)
- 「実行する単位」を選びます。
- レコードごとに1回
- テーブル「○○」の行ごと:テーブルの1行ごとに、更新先のレコードを探して更新します。条件・式・コピー元では、その行の値を使えます
- 必要なら「このアプリのレコードの条件」を設定します。保存したレコードがこの条件に合うときだけ実行します。条件が無いときは、いつも実行します。
ルールの設定画面。実行するタイミングに「追加して保存したとき」、実行する単位に「テーブル「明細」の行ごと」を選んだところ
ルールは左のタブから順に実行します。タブはドラッグで並べ替えられます。
3-3. 更新先と、更新するレコードの条件
- 「更新先のアプリ」で、更新するアプリを検索して選びます。
- 「更新するレコードの条件」で「+ 条件を追加」をクリックし、次を設定します(10件まで。すべての条件に合うレコードを更新します)。
- 更新先のフィールド
- 比べ方
- 比べる値:「このアプリのフィールド」「固定の値」「ログインユーザー」(ユーザー選択などのとき)
- 「条件に合うレコードがないとき」を選びます。
- 何もしない
- レコードを追加する:「=」「いずれかを含む」で比べた値と、下の「更新する内容」を入れたレコードを追加します。加算・減算は 0 に対して行います
更新先に在庫管理アプリを選び、「品番が明細の品名と等しい」「倉庫が東京」の2つの条件で更新するレコードを探す設定
| 更新先のフィールド | 使える比べ方 |
|---|---|
| 文字列(1行)・リンク | =(等しい)、≠(等しくない)、次を含む、次を含まない |
| 数値・計算・日付・日時・時刻・レコード番号など | =、≠、>、<、≧、≦ |
| ドロップダウン・ラジオボタン・チェックボックス・複数選択・ユーザー選択など | いずれかを含む、いずれも含まない |
⚠️ 条件に使う値が空のときは、そのルール(行ごとのときはその行)を実行しません。条件に合うレコードは、一度に100件まで更新します。
3-4. 更新する内容
「+ 更新するフィールドを追加」をクリックし、次を設定します(30件まで)。
| 項目 | 内容 |
|---|---|
| 更新先のフィールド | 書き換えるフィールド |
| 入れる値 | 式の結果/フィールドの値/固定の値/ログインユーザー(ユーザー選択のみ)/空にする |
| 入れ方 | 数値のフィールドだけ。「上書きする」「足す(加算)」「引く(減算)」 |
在庫数を明細の数量だけ引き、最終出庫日に今日、最終会社名に会社名を入れる設定
- 「足す」「引く」は、更新先の今の値を読んでから計算します。同じレコードが続けて更新されても、数はずれません。
- 式で使えるのは、このアプリのフィールドです。更新先のフィールドの値は式で使えません。
- 式の書き方は kintone の計算式と同じです(フィールドコードをそのまま書く、文字は
""で囲む、文字をつなぐときは&)。
⚠️ 「編集して保存したとき」でも加算・減算すると、同じレコードを編集して保存し直すたびに、もう一度足し引きされます。設定画面にも注意が出ます。
3-5. 保存する
「設定保存」をクリックします(Ctrl+S でも保存できます)。設定の確認のあと、アプリの更新まで自動で行います。
「設定を保存して、アプリを更新しました」と表示されたら完了です。
設定画面には、保存は止めない注意も表示されます。
- 更新先がこのアプリ自身のとき
- 追加するレコードに、条件の値が入らないとき
- 更新先の必須フィールドに値を入れていないとき(追加するときにエラーになります)
「設定出力」で設定を JSON ファイルに保存し、「設定読込」でほかのアプリに読み込めます。
使い方
4-1. レコードを保存する
設定したアプリでレコードを保存すると、保存が完了したあとに、ほかのアプリのレコードが更新されます。
うまく更新できたときは、画面には何も表示されません。更新先のアプリを開くと、値が変わっています。
4-2. 更新できなかったとき
更新できなかったときは、「ほかのアプリを更新できませんでした」と、どのルールの何行目で、なぜ更新できなかったかが表示されます。
このときも、保存したレコードは保存済みのままです。内容を確かめて、更新先のアプリを手で直してください。
4-3. スマートフォンで使う
kintone のモバイル版の追加・編集画面で保存したときも、PC版と同じように動きます。
制限事項・注意点
- 保存が完了したあとに動きます。 更新先の更新に失敗しても、元のレコードの保存は取り消しません。ほかのルールは続けて実行します。
- プロセス管理のアクション、CSVの読み込み、API・ほかのプラグインによる更新では動きません。
- 1つのルールの条件で更新するのは100件までです。 それより多く条件に合うときは、レコード番号の小さい順に100件を更新します。
- 1回の保存で実行するのは、ルールとテーブルの行を合わせて100件までです。 超えると「一度に実行できるのは 100 件までです。それ以降の行は更新していません。」と表示します。
- 更新先のテーブル、添付ファイル、計算、ルックアップのコピー先、自動計算を設定した文字列(1行)は更新できません。
- 更新先アプリに入っているプラグインやカスタマイズは、この更新では動きません。
- 加算・減算は数値のフィールドだけです。 保存するたびに足し引きします。
- 上限は、ルール50件、このアプリの条件10件、更新するレコードの条件10件、更新するフィールド30件です。
困ったときは
6-1. 表示されるメッセージ
| メッセージ | 内容 |
|---|---|
| ほかのアプリを更新できませんでした | 更新先の更新に失敗しました。一覧に、ルール名・行・理由が出ます。保存したレコードは保存済みです |
| 「○○」を更新できませんでした。… | 更新先アプリの権限が無いか、更新先の入力チェック(必須・重複禁止など)にかかっています。kintone のメッセージを添えて表示します |
| 選択肢にない値です | コピーした値が、更新先の選択肢にありません |
| 数値ではない値は加算・減算できません | 足し引きする値が数値ではありません |
| 一度に実行できるのは 100 件までです。… | 1回の保存で実行できる件数を超えました |
| 更新先アプリのフィールドを取得できませんでした。…(設定画面) | 更新先アプリが削除されているか、閲覧する権限がありません |
6-2. 確認ポイント
| 症状 | 確認すること |
|---|---|
| 何も更新されない | ルールが「有効」か。タイミング(追加・編集)が合っているか。このアプリのレコードの条件に合っているか |
| 一部の行だけ更新されない | その行の、条件に使う値が空ではないか |
| 該当するはずのレコードが更新されない | 更新するレコードの条件の値が、更新先と一致しているか(全角・半角、空白なども) |
| 在庫などが二重に減る・増える | 「編集して保存したとき」でも加算・減算していないか |
| レコードが追加されない・エラーになる | 「レコードを追加する」を選んでいるか。更新先の必須フィールドに値を入れているか。「レコード追加」の権限があるか |
| ステータスを進めたときに動かない | プロセス管理のアクションでは動きません |
| 更新先アプリが一覧に出ない | 設定する人に、更新先アプリの閲覧権限があるか |
6-3. よくある質問
Q. 同じアプリのほかのレコードを更新できますか?
A. できます。更新先にこのアプリ自身を選んでください。保存したレコードとは別のレコードが更新されるよう、条件を確かめてください。
Q. 入庫で在庫を増やし、出庫で減らしたい
A. 入庫のアプリでは「足す(加算)」、出庫のアプリでは「引く(減算)」のルールを作ります。
Q. 更新先に該当がないときは、新しく作りたい
A. 「条件に合うレコードがないとき」で「レコードを追加する」を選びます。「=」「いずれかを含む」で比べた値と、更新する内容を入れたレコードを追加します。