指定アプリの指定キーに合うレコードのデータを更新します。
「キーの値をもとにレコードを更新する」を行うアクションよりも先に「kintone 接続設定を行う」を行うようにアクションを配置します。
アクションの結果として、更新されたレコードの集合がセットされます。
「フィールドに値をセットする」のようなフィールド値を変更するタイプの「やること」に、「キーの値をもとにレコードを更新する」の結果値を「レコード」パラメーターとして渡せば、更にフィールド値変更を行うことができます。ただし、kintone への保存処理が２回行われることになるので、効率はよくありません。なるべく「キーの値をもとにレコードを更新する」だけで更新を完結させることをお勧めします。
「更新先アプリ」「API トークン」「キーとなるフィールド」「キーの値」「マッピング」「更新の競合をチェックする」を設定します。
更新するレコードのあるアプリを選択します。
更新先アプリにアクセスするための API トークンを指定します。「kintone 接続設定を行う」を行うアクションの中から選択します。
その API トークンにはレコード閲覧権限とレコード編集権限が必要です。
レコードを更新する際のキーとなるフィールドを選択します。
テーブル内のフィールドは選択できません。
以下のフィールドタイプは選択できません。
更新するレコードのキーの値を入力します。
レコードに登録する情報を入力します。
このパラメーターの詳しい記述方法はフィールドマッピングの記述方法を参照してください。
このマッピングでは @out を使用することができます。@out はキーに一致したレコードを参照します。
「チェックする」「チェックしない」から選択します。
「チェックする」の場合、更新レコードが他のユーザーからの更新と競合していないかがチェックされ、競合している場合は実行時にエラーとします。「チェックしない」の場合、このチェックを行いません。
よくわからない場合、「チェックする」をお勧めします。
| 条件 | 発生有無 |
|---|---|
| 「レコード１行が準備できた時」 | 発生しません |
| 「レコード全行が準備できた時」 | 発生しません |
本「やること」を実行しても更新先アプリの Webhook 通知は発生しません。