指定アプリの既存レコードのデータを更新します。更新対象のレコードを検索する際のキーの値を、指定レコードのフィールドで指定します。
「レコードをもとに別のレコードを更新する」を行うアクションよりも先に「kintone 接続設定を行う」を行うようにアクションを配置します。
マッピングの元になるレコードを何らかの方法で取得します。例えば「クエリで条件を指定してレコードを取得する」などが使用できます。このレコードを「元になるレコード」として指定します。
「レコードをもとに別のレコードを更新する」を実行すると、「元になるレコード」の「キーの値となる元になるレコードのフィールド」と、「キーとなる更新先のフィールド」が一致する更新先アプリのレコードについて、「マッピング」に基づいてレコードの内容を更新します。
アクションの結果として、更新したレコードの集合がセットされます。
「フィールドに値をセットする」のようなフィールド値を変更するタイプの「やること」に、「レコードをもとに別のレコードを更新する」の結果値を「レコード」パラメーターとして渡せば、更にフィールド値変更を行うことができます。ただし、kintone への保存処理が２回行われることになるので、効率はよくありません。なるべく「レコードをもとに別のレコードを更新する」だけで更新を完結させることをお勧めします。
「更新先アプリ」「更新先アプリの API トークン」「キーとなる更新先のフィールド」「元になるレコード」「キーの値となる元になるレコードのフィールド」「マッピング」「更新の競合をチェックする」を設定します。
更新したいレコードがあるアプリを選択します。
更新先アプリにアクセスするための API トークンを指定します。「kintone 接続設定を行う」を行うアクションの中から選択します。
その API トークンにはレコード閲覧権限とレコード編集権限が必要です。
レコードを更新する際のキーとなるフィールドを、更新先アプリから選択します。
テーブル内のフィールドは選択できません。
選択可能なフィールドタイプは以下の通りです。
マッピングの元になるレコードを取得したアクションを選択します。
元になるレコードの取得元アプリについて、特に制限はありません。カスタマイズ中のアプリや追加先アプリと同じでも構いませんし、逆にどちらとも違うアプリでも指定可能です。
このレコードは複数行が含まれていても構いません。複数行含まれる場合、その各行に対して順次「キーに一致する更新先レコードを探して、更新する」という処理を繰り返します。レコード件数がゼロだった場合、更新処理は行われません。
「元になるレコード」のフィールドの中から、キーとして更新先レコードと比較するフィールドを指定します。
「キーとなる更新先のフィールド」の値と「キーの値となる元になるレコードのフィールド」の値が一致する更新先アプリのレコードが、更新処理の対象になります。
テーブル内にあるフィールドを選択した場合、テーブルの各行に対して処理が行われます。
選択可能なフィールドタイプは以下の通りです。
レコードに登録する情報を入力します。
このパラメーターの詳しい記述方法はフィールドマッピングの記述方法を参照してください。
このマッピングの式でフィールドコードを指定した場合、そのフィールドは「元になるレコード」のフィールドになります。
このマッピングでは @out を使用することができます。@out はキーに一致したレコードを参照します。
「チェックする」「チェックしない」から選択します。
「チェックする」の場合、更新レコードが他のユーザーからの更新と競合していないかがチェックされ、競合している場合は実行時にエラーとします。「チェックしない」の場合、このチェックを行いません。
よくわからない場合、「チェックする」をお勧めします。
| 条件 | 発生有無 |
|---|---|
| 「レコード１行が準備できた時」 | 発生しません |
| 「レコード全行が準備できた時」 | 発生しません |
本「やること」を実行しても更新先アプリの Webhook 通知は発生しません。