レコードをフィールドの値を書き換えながら書き出します。テーブルを書き出すことができます。
「条件を組み立ててレコードを取得する」など、レコードを取得するアクションで取得したレコードを書き出します。
同じアプリにフィールドの値を書き換えながら書き出すこともできますし、別のアプリに新しいレコードとして書き出すことも可能です。
「レコードを書き出す」とほぼ同じですが、「テーブル付きでレコードを書き出す」では書き出す内容にテーブルを含めることができます。
同様の「やること」に「テーブル付きでレコードを１つずつ書き出す」がありますが、以下の２点が異なります。
| 「やること」 | 別アプリへ書き出し | テーブルの書き出し | Webhook |
|---|---|---|---|
| 「レコードを書き出す」 | ○ | × | × |
| 「レコードを１つずつ書き出す」 | × | × | ○ |
| 「テーブル付きでレコードを書き出す」 | △ | ○ | × |
| 「テーブル付きでレコードを１つずつ書き出す」 | × | ○ | ○ |
「レコード」「書き出し先アプリ」「マッピング」「書き出し先テーブル」「書き出し対象テーブル行の条件になるフィールド」「条件」「比較値」「テーブルに対するマッピング」「更新または追加」を設定します。
書き出し元となるレコードを取得したアクションを指定します。
書き出し先のアプリを選択します。
元となるレコードと同じアプリでも、異なるアプリでも構いません。
書き出すレコードのフィールド値を設定します。
このパラメーターの詳しい記述方法はフィールドマッピングの記述方法を参照してください。
フィールドに対してマッピングの式を空にした場合、空の値を書き出すのではなく、そのフィールドは書き出しません。更新の場合は元のレコードの値を維持し、追加の場合はアプリ設定上の初期値がセットされることになります。
このマッピングで「セットする値」に記載したフィールドは、書き出し元のレコードのアプリのフィールドになります。
書き出し先アプリ内のどのテーブルに書き出すかを選択します。
書き出し元にも同じフィールドコード、同じ構造のテーブルが必要です。
特定の条件に合うテーブル行だけに対して「テーブルに対するマッピング」を適用したい場合に、その条件になるフィールドを「書き出し先テーブル」から選択します。
この条件に合わなかったテーブル行は「テーブルに対するマッピング」が適用されず、そのテーブル行の全フィールドがコピーされます。そのテーブル行を出力しないという意味ではありません。
全てのテーブル行に「テーブルに対するマッピング」を適用したい場合は、条件を空（フィールド未選択）にしてください。
実行時には「書き出し先」ではなく「書き出し元」のテーブル行に対して条件をチェックすることになります。
書き出し対象テーブル行の条件になるフィールドと比較値との比較方法を選択します。
条件になるフィールドの値と比較する値を設定します。空にすると空の値と比較します。
直接値を指定するか、または式を使用することができます。
式を用いる場合は注意が必要です。比較中の行のテーブル内フィールド値を参照することはできません。
２つ目、３つ目の条件を指定したい場合に選択します。条件が１つでよい場合は省略できます。
書き出し対象テーブル行の条件になるフィールド(1)と同じテーブルから選択する必要があります。
２つ目、３つ目の条件を指定したい場合に選択します。条件が１つでよい場合は省略できます。
２つ目、３つ目の条件を指定したい場合に選択します。条件が１つでよい場合または空の値と比較したい場合は省略できます。
書き出し先テーブルへのマッピングを記述します。
マッピング元のテーブルは、書き出し元のテーブルのフィールドコードのテーブルであるとみなされます。
例えば、「レコード」にアプリが A、「書き出し先アプリ」が B の場合、「書き出し先テーブル」は B から選択しますが、そのフィールドコードが Table_1 だった場合、マッピング元のテーブルは A の Table_1 になります。つまり、A の Table_1 から B の Table_1 へマッピングされます。
フィールドに対してマッピング式を空にした場合、空の値を書き出すのではなく、マッピング元テーブルの同じフィールドコードのフィールド値がコピーされます。
このマッピングで「セットする値」に記載したフィールドは、マッピング元テーブルのフィールドになります。
「既存レコードを更新」を選んだ場合、書き出し元と同じレコードの値を上書き更新します。
「新規にレコードを追加」の場合は上書きではなく別の新しいレコードを追加します。
「既存レコードを更新」は、書き出し元のレコードの取得元アプリと、「書き出し先アプリ」は同じアプリである必要があります。
「既存レコードを更新」の場合、更新の競合はチェックされます。
「新規にレコードを追加」はチェックされません。
本「やること」を実行しても更新先アプリの Webhook 通知は発生しません。
複数のテーブルを一度に書き出すことはできません。
書き出し先のテーブルのフィールドコードと書き出し元のテーブルのフィールドコードが同じである必要があります。異なるフィールドコードのテーブルへ書き出すことはできません。
書き出し対象テーブル行を条件パラメーターで絞り込む場合、テーブル内の２つのフィールドを比較して絞り込むことはできません。このような条件分岐を行いたい場合は、テーブルに対するマッピングでif関数を使用してください。
書き出し対象テーブル行の条件を４つ以上指定することはできません。