レコードをもとに別のレコードを更新する

概要

指定されたキーに一致するレコードを更新します。更新対象のレコードを検索する際のキーの値を、指定レコードのフィールドで指定します。

使い方

まず、キーの値を持ちマッピングの元になるレコードを何らかの方法で取得します。例えば「条件を指定してレコードを取得する」などが使用できます。このレコードを「元になるレコード」として指定します。

「元になるレコード」の「キーの値となる元になるレコードのフィールド」と、「キーとなる更新先のフィールド」が一致する更新先アプリのレコードについて、「マッピング」に基づいてレコードの内容を更新します。

キーの値を持つレコードとして、現在編集画面で編集しているレコードを用いたい場合は、この「レコードをもとに別のレコードを更新する」ではなく、代わりに「レコードを更新する(キーの値をフィールドで指定)」や「レコードを更新する(キーの値を直接指定)」を使用してください。

設定するパラメーター

「更新先アプリ」「キーとなる更新先のフィールド」「元になるレコード」「キーの値となる元になるレコードのフィールド」「マッピング」「更新の競合をチェックする」を設定します。

更新先アプリ

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

キーとなる更新先のフィールド

レコードを更新する際のキーとなるフィールドを、更新先アプリから選択します。テーブル内のフィールドは選択できません。

元になるレコード

キーの値を持ち、マッピングの元になるレコードを取得したアクションを選択します。

元になるレコードの取得元アプリについて、特に制限はありません。カスタマイズ中のアプリや更新先アプリと同じでも構いませんし、逆にどちらとも違うアプリでも指定可能です。

このレコードは複数行が含まれていても構いません。複数行含まれる場合、その各行に対して順次「キーに一致する更新先レコードを探して、更新する」という処理を繰り返します。逆にレコード件数がゼロだった場合、エラーにはなりませんが、更新対象がひとつもないので処理は行われません。

キーの値となる元になるレコードのフィールド

「元になるレコード」のフィールドの中から、キーとして更新先レコードと比較するフィールドを指定します。

「キーとなる更新先のフィールド」の値と「キーの値となる元になるレコードのフィールド」の値が一致する更新先アプリのレコードが、更新処理の対象になります。

テーブル内にあるフィールドを選択した場合、テーブルの各行に対して処理が行われます。

マッピング

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

登録したいフィールド毎に、「登録先フィールドコード = 設定する値」という形で記載します。

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

このマッピングの式でフィールドコードを指定した場合、そのフィールドは「元になるレコード」のフィールドになります。現在画面で編集中のレコードのフィールドではありません。現在画面で編集中のレコードを参照したい場合は @this を使用します。

このマッピングでは @out を使用することができます。キーに一致したレコードを参照します。

更新の競合をチェックする

「チェックする」「チェックしない」から選択します。

「チェックする」の場合、更新レコードが他のユーザーからの更新と競合していないかがチェックされ、競合している場合は実行時にエラーとします。「チェックしない」の場合、このチェックを行いません。

よくわからない場合、「チェックする」をお勧めします。

使用例