Job Runner

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

概要

指定アプリの指定キーに合うレコードのデータを更新します。

使い方

「キーの値をもとにレコードを更新する」を行うアクションよりも先に「kintone 接続設定を行う」を行うようにアクションを配置します。

アクションの結果として、更新されたレコードの集合がセットされます。

フィールドに値をセットする」のようなフィールド値を変更するタイプの「やること」に、「キーの値をもとにレコードを更新する」の結果値を「レコード」パラメーターとして渡せば、更にフィールド値変更を行うことができます。ただし、kintone への保存処理が2回行われることになるので、効率はよくありません。なるべく「キーの値をもとにレコードを更新する」だけで更新を完結させることをお勧めします。

設定するパラメーター

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

更新先アプリ

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

API トークン

更新先アプリにアクセスするための API トークンを指定します。「kintone 接続設定を行う」を行うアクションの中から選択します。

その API トークンにはレコード閲覧権限とレコード編集権限が必要です。

キーとなるフィールド

レコードを更新する際のキーとなるフィールドを選択します。

テーブル内のフィールドは選択できません。

以下のフィールドタイプは選択できません

  • カテゴリー
  • テーブル
  • 関連レコード一覧
  • グループ
  • スペース

キーの値

更新するレコードのキーの値を入力します。

マッピング

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

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

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

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

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

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

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

レコード取得条件の発生有無

条件 発生有無
レコード1行が準備できた時 発生しません
レコード全行が準備できた時 発生しません

Webhook 通知

本「やること」を実行しても更新先アプリの Webhook 通知は発生しません。

関連記事