指定アプリに新しいレコードを追加します。
「レコードを追加する」を行うアクションよりも先に「kintone 接続設定を行う」を行うようにアクションを配置します。
アクションの結果値として追加したレコードが１行セットされ、「=$1」等の式で参照できます。ただし、マッピングでセットされたフィールドしか参照できません。この動きは kintone アプリカスタマイズ版の「レコードを追加する」とは異なるので注意してください。
１回の「レコードを追加する」だけでは思ったようにフィールド値を埋めきれない場合、「即時反映するかどうか」パラメーターを「即時反映しない（後でまとめて反映）」にしておけば、後続のアクションで追加レコードに対してフィールド値を加工することができます。例えば「フィールドに値をセットする」や「フィールドの選択を追加する」のようなフィールド値を変更するタイプの「やること」に対し、「レコードを追加する」の結果値を「レコード」パラメーターとして渡せば、追加したレコードに対して更にフィールド値変更を行うことができます。
「追加先アプリ」「API トークン」「マッピング」「即時反映するかどうか」を設定します。
レコードを追加するアプリを選択します。
追加先アプリにアクセスするための API トークンを指定します。「kintone 接続設定を行う」を行うアクションの中から選択します。
その API トークンにはレコード追加権限が必要です。
レコードに登録する情報を入力します。
このパラメーターの詳しい記述方法はフィールドマッピングの記述方法を参照してください。
「即時反映しない（後でまとめて反映）」を選択した場合、アクションを実行しても直ちに kintone アプリへは反映されません。ある程度溜めてからまとめて kintone アプリへ保存する動きになります。アクションを繰り返し実行して複数のレコードを追加する場合でも、kintone への APIリクエスト数が少なく済み、処理速度も向上します。
「即時反映する」の場合は、アクションの実行と同時に kintone アプリへレコード追加が反映されます。後続のアクションで kintone からレコードを取得しなおしたい場合は、「即時反映する」を選択してください。ただし、アクションを繰り返し実行して複数のレコードを追加する場合、kintone への APIリクエスト数が多くなりますので注意してください。
| 条件 | 発生有無 |
|---|---|
| 「レコード１行が準備できた時」 | 発生しません |
| 「レコード全行が準備できた時」 | 発生しません |
保存先アプリに「レコードの追加」条件で Webhook 通知を行うように設定されている場合、「即時反映する」設定で本「やること」を実行すると、追加先アプリの Webhook 通知が発生します。
「即時反映しない（後でまとめて反映）」場合は Webhook 通知は発生しません。