外部サイトから取得したデータをレコード単位で追加する[拡張機能 kintone レコード追加]

kintone グループ・繰り返し

仮想ブラウザの拡張機能「kintone/レコード追加」の使い方についてご紹介します。

拡張機能「kintone/レコード追加」を使用すると、自動操作中にkintoneAPIを使用してkintoneにレコード追加を行う事ができます。

例えば、Webサイトから取得したデータをkintoneにレコード追加したい際に、kintoneの画面をRPAで操作せずにレコード追加が可能です。
レコード追加イメージ

今回はクラウドBOTのニュース一覧をグループデータとして取得し、kintoneアプリにレコード追加する流れを例にしてBOTの作成手順をご紹介します。
※記事の一番下にサンプルBOTのJWSファイルもご用意しました。

kintoneアプリの準備

アプリテンプレート

今回の手順で使用するkintoneアプリのテンプレートをご用意しましたので、ご自身のkintoneにインポートしてお試しください。
ニュース履歴.zip (2.0 KB)

アプリのAPIトークンを発行する

インポートが完了したら、アプリの設定からAPIトークンを発行してください。
発行したトークンには「レコード追加」のアクセス権を付与してください。
(アプリの更新を忘れずに!)
1-2.クラウドBOTで使用するAPIトークンを発行


BOTの作成手順

BOTエディタを開き、操作を記録していきます。
まずはクラウドBOTのニュース一覧を取得する操作を記録します。
※一覧取得に関する詳しい解説は割愛します。必要に応じて、以下のチュートリアルをご参照ください。
[チュートリアル:2-3. Webページから一覧データを取得し、グループデータを作成する]

2-1.ニュース一覧を取得する操作を記録

クラウドBOTのニュース一覧画面(https://www.c-bot.pro/ja/news/)からタイトルとサムネイル画像のみをグループデータとして取得しています。
2-2.取得したグループデータ

データ欄から「グループを使う」でタスク内にグループを挿入し、グループ内にタスクカーソルを移動します。
その後、画面右上のメニューから「拡張機能」を呼び出します。
2-3.グループの中で拡張機能を呼び出す

今回はkintoneパッケージの「レコード追加」を使用します。
(拡張機能[kintone/レコード追加]のバージョン3を使用しています。拡張機能は使用時のバージョンによってUIが異なる場合があります。)
2-4.kintoneパッケージのレコード追加を呼び出す

仮想ブラウザ内に拡張機能アプリが表示されますので、記録しながら入力・操作を進めていきます。
まずは画面に沿って、
・レコード追加を行うkintoneのドメイン名
・レコード追加を行うkintoneのアプリID
を入力します。
ドメイン名、アプリIDの説明

(ご自身の環境に合わせて入力してください。)
2-5.ドメイン名・アプリIDを入力

続いて、
認証方式を”APIトークン”に変更し、事前にkintone側で発行しておいたAPIトークンを入力します。
その後、「次へ」ボタンをクリックします。
2-6.認証方式・APIトークンを入力

続いて、kintoneに存在する「タイトル」、「サムネイル画像」というフィールドに対し、グループデータ内の「タイトル」、「サムネイル画像」を入力する操作を記録していきます。

入力フィールドの「追加」ボタンをクリックします。
2-7.入力フィールドを追加するボタンをクリックする操作を記録

フィールドは”タイトル”を選択します。
2-8.「タイトル」を選択する操作を記録

同じように、入力フィールドの「追加」ボタンをクリックし、”サムネイル画像”を選択します。
その後、「次へ」ボタンをクリックします。
2-9.「サムネイル画像」のフィールドも追加

タイトルにグループデータ内のタイトルを貼り付けます。
2-10.グループデータ内のタイトルを貼り付ける操作を記録

同様に、サムネイル画像にグループデータ内のサムネイル画像を貼り付けます。
「追加」ボタンをクリックします。
2-11.グループデータ内のサムネイル画像を貼り付ける操作を記録

”追加完了しました”と表示されますので、追加件数をコピーしておきます(確認用)。
2-12.追加件数をコピーする操作を記録

この時点で実際にkintoneAPIが実行されています。
kintoneアプリを確認すると、ニュースが1レコード追加されています。
2-13.レコードが追加された事を確認

「グループ処理を完了する」ボタンをクリックし、残りのグループ処理を完了させます。
2-14.「グループ処理を完了」ボタンをクリック

kintoneアプリを確認すると、取得した全てのニュースがレコード追加されてます。
2-16.kintoneに全てのデータがレコード追加される

サンプルBOT

今回紹介した手順をサンプルのBOTとしてご用意しましたので、是非、お手元のクラウドBOT環境で実行してみてください。
クラウドBOTのニュース一覧取得.jws (9.5 KB)
※JWSファイルのインポート手順についてはこちらをご参照ください。
[チュートリアル:その他用途別 3. BOTのインポート・エクスポート]

サンプルBOTの使い方

ドメイン名、アプリID、APIトークンを入力し、実行します。
ご自身のkintone環境に合わせて値を入力し、実行してみてください。
サンプルBOTの使い方


仮想ブラウザの拡張機能「kintone/レコード追加」を使用すると、kintoneの画面をRPAで操作せずにレコード追加が可能です。
RPAでデータ追加を行った場合に比べ、データ連携にかかる時間が短縮されるとともに、画面変更によるメンテナンスが不要になります。

Webサイトから取得したデータをkintoneにレコード追加したい場面で、ご活用ください。