マスタ累計更新プラグイン

マスタ累計更新プラグイン 操作マニュアル

日々の明細を登録する「明細アプリ」と、累計値を持つ「マスタアプリ」をつなぐプラグインです。明細アプリでレコードを保存・編集・削除するだけで、マスタの累計値と履歴テーブルが自動で更新されます。旧名称「在庫管理連携プラグイン」の後継で、これまでの設定はそのまま使えます。

1. こんな使い方ができます

2. できること

• 明細アプリでレコードを追加すると、マスタの累計値を自動で加減算します
• 同時に、マスタの履歴テーブルへ明細1件分の行を自動で追加します
• 「加算として扱う区分の値」に一致する区分は加算、それ以外の区分は減算として扱います（値は設定で自由に決められます）
• レコードを編集したときは差分だけを、削除したときは取り消し方向に、累計値を調整します
• 取引IDにあたる項目を設定すると、編集・削除の内容が履歴テーブルの行にも同期されます
• マスタに存在しないキー項目で保存しようとすると、保存時にエラーでお知らせします
• PCブラウザとスマートフォン（kintoneモバイル）のどちらからの登録でも動作します
• 対象のフィールドは設定画面のプルダウンから選ぶだけで、フィールド名やアプリ構成は自由に決められます

3. 事前準備（必要なフィールド）

明細アプリ（このプラグインを追加するアプリ）

マスタアプリ

マスタのキー項目の値は重複しないよう管理してください。 同じ値のレコードが複数あると、先頭の1件だけが更新されます。

4. 設定手順

1. 明細アプリの「アプリの設定」→「プラグイン」から、本プラグインの設定画面を開きます。
2. 画面上部の「ライセンス設定」欄に、ご契約後にお渡しする情報を入力します。正しく入力できていれば、その場で有効期限が表示されます。
3. 「明細アプリ（このアプリ）のフィールド設定」で、日付・キー項目・増減区分・数量のフィールドを選びます。
4. 「加算として扱う区分の値」に、加算とみなす区分の値を入力します（複数はカンマ区切り。空欄の場合は「入庫」）。
5. 「マスタアプリの設定」でマスタアプリのIDを入力し、「アプリ情報を取得」を押します。マスタのフィールドが選べるようになります。
6. キー項目・累計値・履歴テーブルを選びます。履歴テーブルを選ぶと、その中のフィールドが選べるようになります。
7. テーブル内の日付・増減区分・数量、必要に応じて取引IDを選びます。
8. 保存を押し、アプリの「変更を反映」（アプリを更新）を実行します。

設定例

取引IDを設定するかどうか

取引IDには、明細アプリのレコード番号を入れる数値フィールド（またはレコード番号を参照するルックアップ）をマスタの履歴テーブル内に用意して指定するのがおすすめです。

5. 使い方

• 明細アプリでいつもどおりレコードを登録・編集・削除するだけです。特別なボタン操作はありません。
• 保存すると、マスタの累計値と履歴テーブルがその場で更新されます。
• マスタに該当するキー項目が無い場合は、エラーメッセージが表示され保存できません。累計のズレを未然に防ぐための動作です。
• キー項目を別の値に変更した場合は、変更前のマスタから取り消し、変更後のマスタへ計上し直します。

6. 注意事項・うまくいかないとき

• 累計値が更新されない：設定画面の必須項目がすべて選択されているか、保存後に「変更を反映」を実行したかをご確認ください。
• キー項目は完全一致で突き合わせます。 前後のスペースや全角・半角の違いがあると、該当するレコードが見つかりません。
• マスタに同じキー項目のレコードが複数あると、1件だけが更新対象になります。 キー項目は重複しないよう管理してください。
• 一覧画面での直接編集（インライン編集）は連携の対象外です。 数量や区分を変更するときは、詳細画面または編集画面から行ってください。
• 編集・削除しても履歴テーブルの行が変わらない：取引IDの項目が未設定の可能性があります。設定画面でご確認ください。
• マスタアプリのレコードを編集する権限が無いユーザーは、累計値の更新に失敗します。 プラグインを使うメンバーにマスタアプリのレコード編集権限を付与してください。
• 更新に失敗した場合はメッセージが表示されます。その際はマスタの累計値をご確認ください。
• 明細の数量を「前回の累計値との差」で自動計算している場合（車両のメーターなど）、同じマスタに対して複数人が同時に入力すると差の起点がずれることがあります。その場合は該当の明細を編集すれば差分で修正されます。