株式会社XenoX

マニュアル›アプリ間自動更新プラグイン

アプリ間自動更新プラグイン マニュアル

このプラグインでできること

「アプリ間自動更新プラグイン」は、レコードを保存したときに、ほかのアプリのレコードを条件で探して自動で更新するプラグインです。
出庫を登録したら在庫数を減らす、受注を保存したら顧客マスタの最終取引日を書き換える、といった二重入力をなくせます。条件に合うレコードがないときは、追加もできます。

アプリ間自動更新プラグインの紹介ページを見る

主な機能は次のとおりです。

  • レコードの保存のあとに、ほかのアプリ(このアプリ自身も可)のレコードを更新する
  • 更新するレコードを、更新先のフィールドとこのアプリの値を比べる条件(10件まで)で探す
  • 数値は「上書きする」「足す(加算)」「引く(減算)」から選べる。足し引きは更新先の今の値から計算する
  • テーブルの明細1行ずつに、更新先を探して更新できる
  • 条件に合うレコードがないときは、レコードを追加できる
  • PC版・モバイル版の追加・編集画面と、一覧のインライン編集で動作する

出庫を登録する画面。明細に「AC-100 を2個」「FL-200 を6個」と入れて保存する

出庫を登録する画面。明細に「AC-100 を2個」「FL-200 を6個」と入れて保存する

保存する前の在庫管理アプリ。東京倉庫の AC-100 は20、FL-200 は50

保存する前の在庫管理アプリ。東京倉庫の AC-100 は20、FL-200 は50

保存した後の在庫管理アプリ。東京倉庫の AC-100 は18、FL-200 は44 に減り、最終出庫日と最終会社名が入る。大阪倉庫の AC-100 は変わらない

保存した後の在庫管理アプリ。東京倉庫の AC-100 は18、FL-200 は44 に減り、最終出庫日と最終会社名が入る。大阪倉庫の AC-100 は変わらない

こんな場面で役立ちます。

  • 入出庫のアプリと在庫のアプリを分けていて、在庫数を手で直している
  • 商談や受注の登録のたびに、顧客マスタの最終取引日や担当者を書き換えている
  • 貸出・返却の登録で、台帳の状態を「貸出中」「返却済み」に変えている

動作環境・前提条件

2-1. 事前に必要な設定

更新先のアプリと、更新するレコードを探すための項目(品番・顧客コードなど)を、両方のアプリに用意しておきます。
専用のフィールドを追加する必要はありません。

2-2. 必要な権限

対象必要な権限
プラグインを設定する人このアプリの管理権限と、更新先アプリの閲覧権限
レコードを保存する人更新先アプリの「レコード編集」の権限(追加もするときは「レコード追加」の権限)

💡 更新は、レコードを保存した人の権限で行います。APIトークンの設定は要りません。

2-3. 対応する画面と操作

画面・操作対応
レコード追加・編集画面で保存(PC版・モバイル版)対応
レコード一覧のインライン編集で保存(PC版)対応(「編集して保存したとき」)
プロセス管理のアクション(ステータスの変更)対象外
CSVの読み込み、API・ほかのプラグインによる更新対象外

設定手順

3-1. プラグインを追加する

  1. アプリの設定画面を開き、「設定」タブの「プラグイン」をクリックします。
  2. 「追加する」をクリックし、「アプリ間自動更新プラグイン」にチェックを入れて「追加」をクリックします。
  3. プラグインの一覧で、アプリ間自動更新プラグインの歯車のアイコンをクリックすると、設定画面が開きます。

3-2. ルールを作る

  1. タブの「+」をクリックして、ルールを追加します。
  2. 「ルール名」を入力します(例:出庫したら在庫数を減らす)。右のスイッチで、ルールの有効・無効を切り替えられます。
  3. 「実行するタイミング」を選びます。
    • 追加して保存したとき
    • 編集して保存したとき(一覧のインライン編集も含みます)
  1. 「実行する単位」を選びます。
    • レコードごとに1回
    • テーブル「○○」の行ごと:テーブルの1行ごとに、更新先のレコードを探して更新します。条件・式・コピー元では、その行の値を使えます
  1. 必要なら「このアプリのレコードの条件」を設定します。保存したレコードがこの条件に合うときだけ実行します。条件が無いときは、いつも実行します。

ルールの設定画面。実行するタイミングに「追加して保存したとき」、実行する単位に「テーブル「明細」の行ごと」を選んだところ

ルールの設定画面。実行するタイミングに「追加して保存したとき」、実行する単位に「テーブル「明細」の行ごと」を選んだところ

ルールは左のタブから順に実行します。タブはドラッグで並べ替えられます。

3-3. 更新先と、更新するレコードの条件

  1. 「更新先のアプリ」で、更新するアプリを検索して選びます。
  2. 「更新するレコードの条件」で「+ 条件を追加」をクリックし、次を設定します(10件まで。すべての条件に合うレコードを更新します)。
    • 更新先のフィールド
    • 比べ方
    • 比べる値:「このアプリのフィールド」「固定の値」「ログインユーザー」(ユーザー選択などのとき)
  1. 「条件に合うレコードがないとき」を選びます。
    • 何もしない
    • レコードを追加する:「=」「いずれかを含む」で比べた値と、下の「更新する内容」を入れたレコードを追加します。加算・減算は 0 に対して行います

更新先に在庫管理アプリを選び、「品番が明細の品名と等しい」「倉庫が東京」の2つの条件で更新するレコードを探す設定

更新先に在庫管理アプリを選び、「品番が明細の品名と等しい」「倉庫が東京」の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. 「条件に合うレコードがないとき」で「レコードを追加する」を選びます。「=」「いずれかを含む」で比べた値と、更新する内容を入れたレコードを追加します。

« マニュアルの一覧に戻る