カスタマイズ

レコードを更新または追加する(キーの値を直接指定)

概要

指定アプリに対し、キーに一致するレコードがあれば更新し、なければ新しいレコードを追加します。

使い方

設定するパラメーター

「追加先アプリ」「キーとなるフィールド」「キーの値」「マッピング」を設定します。

追加先アプリ

レコードを追加または更新するアプリを選択します。

キーとなるフィールド

レコードを取得する際のキーとなるフィールドを選択します。

テーブル内のフィールドは選択できません。

以下のフィールドタイプは選択できません

  • カテゴリー
  • テーブル
  • 関連レコード一覧
  • グループ
  • スペース

キーの値

取得するレコードのキーの値を入力します。

マッピング

レコードに登録する情報を入力します。

このパラメーターの詳しい記述方法はフィールドマッピングの記述方法を参照してください。

このマッピングでは @out を使用することができます。キーに一致するレコードがあった場合、@out はそのレコードを参照します。キーに一致するレコードがなかった場合、@out は空になります。

競合の検出について

キーに一致するレコードが存在する場合、そのレコードを上書き保存しようとしますが、その際、更新の競合はチェックされます。

この「やること」と似ている「レコードを更新する(キーの値を直接指定)」では、更新の競合をチェックするかどうかは設定で選択可能ですが、この「レコードを更新または追加する(キーの値を直接指定)」では競合をチェックしないようにはできません。

一方、キーに一致するレコードが存在しない場合、つまり新規レコードが作成される場合は、競合はチェックされません

そのため、アクションを2人が同時に実行した場合、同じ内容の新規レコードが2つできてしまう可能性があります。 これを避けたい場合、kintone アプリの設定で、キーとなるフィールドの「値の重複を禁止する」をオンにしておくことを強くお勧めします。

Webhook 通知

追加先アプリに「レコードの追加」条件で Webhook 通知を行うように設定されている場合、本「やること」を実行した結果レコードが追加されると、この通知が発生します。

「やること」の実行結果がレコード追加ではなく既存レコードの更新になった場合は、Webhook 通知は発生しません。

関連記事