指定した日時にkintoneアプリにレコードを追加する処理は、Job Runnerの定期実行タスクを利用すれば実現可能です。
このTipsでは、下記について取り扱います。
定期実行タスクでkintoneアプリにレコードを追加する
追加するレコードには、他のアプリから取得したレコードをテーブル行として登録する
ルックアップを含むレコードを追加する
アプリの設定
「レコードを追加するアプリ」を作成していきます。
フィールドの構成は下記です。
コード(文字列(1行))
担当者(ルックアップ)
⇒「従業員名簿」アプリから従業員名をルックアップ商品テーブル
⇒「商品在庫」テーブルから、コードフィールドの値と商品コードフィールドの値が一致するレコードを取得し、
テーブル行としてセット
APIトークンの取得
Job Runnerはkintoneアプリへの接続にAPIトークンを使用します。
カスタマイズの中で使用するkintoneアプリ全てにAPIトークンの取得が必要ですので、カスタマイズを作る前に”カスタマイズでどのkintoneアプリを使用する必要があるか”を確認してください。
今回は「レコードを追加するアプリ」「従業員名簿」「商品在庫」の3つのアプリをカスタマイズで使用します。
「従業員名簿」は、カスタマイズの中で特にレコードを取得する処理はないのですが、「レコードを追加するアプリ」にレコードを追加するタイミングでルックアップの取得が自動的に行われるため、
その処理にAPIトークンが必要となります。
Job Runnerでレコードの追加・編集を行うアプリにルックアップフィールドが存在する場合は、この点に注意してください。
3つのアプリでそれぞれAPIトークンを取得します。
APIトークンの取得は、各kintoneアプリの、アプリの設定→APIトークンから設定できます。
レコードを追加するアプリ
⇒レコードを追加したいので、レコード追加のみ許可します。従業員名簿
→ルックアップを取得したいので、レコード閲覧のみ許可します。商品在庫
→こちらもレコードの取得したいので、レコード閲覧のみ許可します。
カスタマイズの作成
Job Runnerの定期実行タスクを作成します。
kintoneアプリへ接続
まず、kintone接続設定で3つのアプリに接続します。
接続対象となるアプリ1つにつき、「kintone 接続設定を行う」のアクションを1つ作成してください。
スタート地点となるアクションの条件は「実行予定時刻になった時」、二つ目以降は「他のアクションの実行が完了した時」で繋げてください。
商品在庫アプリからテーブルに追加するためのレコードを取得
kintoneアプリへの接続が完了したら、新しく追加するレコードのテーブル行として登録するため、商品在庫アプリからレコードを取得します。
やること
「クエリで条件を指定してレコードを取得する」などの、レコードを取得するやることを使用します。
「キーを指定してレコードを取得する」でもかまいません。
取得先アプリは「商品在庫」、APIトークンには商品在庫アプリに接続した、アクション番号「19」を指定します。
検索条件には任意のクエリを指定してください。今回は、商品コードが”A001”と一致するレコードを取得するクエリを指定しました。
条件
「他のアクションの実行が完了した時」で、kintone接続設定の最後のアクション「20」を指定しました。
テーブル行をセットした状態のレコードを追加
「レコードを追加するアプリ」に、テーブル行をセットした状態のレコードを追加します。
やること
「テーブルデータをセットしたレコードを追加する」を指定します。
「追加先アプリ」にはレコードを追加するアプリを指定してください。
ここでポイントになるのが「追加先アプリのAPIトークン」です。
ここに「kintone 接続設定を行う」のアクションを指定する際に、下記の二つを指定します。
レコードを追加するアプリ(今回は「レコードを追加するアプリ」)
レコードを追加するアプリ内のルックアップフィールドのルックアップ元アプリ(今回は「従業員名簿」)
追加先のアプリにルックアップフィールドが存在し、マッピングで指定する場合は、「追加先アプリのAPIトークン」に、追加先のアプリだけでなくルックアップ元のアプリも指定するのを忘れないでください。
指定し忘れると、定期実行タスクのジョブ実行時にエラーになります。
「テーブルの元になるレコード」には、テーブル行として追加したいレコードを取得したアクション番号「21」を指定しました。
条件
「レコード全行が準備できた時」を指定します。
これは、テーブル行として追加したいレコードが全て準備完了となってから、レコード追加を行いたいためです。
レコード取得アクションには「21」を指定しました。
以上で定期実行タスクの設定は完了です。
なお、当Tipsでは一気にアクションを作成していますが、実際に作成される際は1アクションごとに実行し、エラーが起きていないか確認しながら進めてみてください。
特に、APIトークンを指定する箇所は間違いやすい箇所です。
”その処理で使っているAPIトークンをもれなく指定できているか?”を常に確認しながら進めてください。
問題なさそうでしたら、「ジョブ生成・設定」ボタンを押し、ジョブ設定画面で「直ちに実行」ボタンを押してみてください。
その後、「実行履歴」タブで実行結果を確認してください。
エラーがないようでしたら問題なく動いているようです。
なお、「終了」や「実行時間(ミリ秒)」に値が入っていなければまだジョブの実行が完了していません。
こちらの更新ボタンを押して、最新の状態に更新してみてください。
また、kintoneアプリにレコードが追加されているかどうかも確認してください。
問題なくレコードが追加されていたら、次にスケジュール設定です。
スケジュール設定については、こちらのページの下部でご案内しておりますのでご確認ください。
ご不明点等ございましたら、チャットにてご質問ください!
Customineドキュメントやサポートページもぜひご活用ください。