レコードを１つずつ書き出す

概要

レコードをフィールドの値を書き換えながら書き出します。その際、１レコード毎に kintone へ保存を行います。

「条件を組み立ててレコードを取得する」など、レコードを取得するアクションで取得したレコードを、同じアプリへ書き出します。

同様の「やること」に「レコードを書き出す」がありますが、以下の２点が異なります。

「レコードを書き出す」はレコードをまとめて保存するのに対し、「レコードを１つずつ書き出す」は１レコードずつ保存します。
- その結果、「レコードを１つずつ書き出す」では書き出し先アプリに「レコードの編集」に対する Webhook が設定されていればその Webhook に通知が発生します。「レコードを書き出す」では Webhook 通知は発生しません。
- レコード数が多い場合、「レコードを書き出す」の方が kintone API 呼び出し回数が少なく済み、高速です。
「レコードを書き出す」では別のアプリへ新規レコード追加として書き出すことができますが、「レコードを１つずつ書き出す」では同じアプリのレコードへの上書き保存しかできません。

「やること」	別アプリへ書き出し	テーブルの書き出し	Webhook
「レコードを書き出す」	○	×	×
「レコードを１つずつ書き出す」	×	×	○
「テーブル付きでレコードを書き出す」	△	○	×
「テーブル付きでレコードを１つずつ書き出す」	×	○	○

「レコード」「書き出し先アプリ」「マッピング」を設定します。

書き出し元となるレコードを取得したアクションを指定します。

書き出し先のアプリを選択します。

元となるレコードと同じアプリを指定する必要があります。

書き出すレコードのフィールド値を設定します。

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

フィールドの値を空にした場合、空の値を書き出すのではなく、そのフィールドは書き出しません。その場合、元のレコードのフィールド値が維持されます。

このマッピングで「セットする値」に記載したフィールドは、書き出し元のレコードのアプリのフィールドになります。

更新の競合はチェックされます。

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