スプレッドシートが更新された時にRobotic Crowdを起動する

概要

Robotic Crowd Sheets Addon を使って、スプレッドシートの更新を検知し、Robotic Crowd のワークフローを起動する方法を説明します。

このチュートリアルのゴール

Robotic Crowd Sheets Addon を使用して、スプレッドシートから Robotic Crowd に作成したワークフローが起動し、セッション画面で確認を行います。 具体的には、

シート1のC列のセルへ変更があったことを検知して、会社名と電話番号の情報をRobotic Crowdへ送信し、「株式会社チュートリアルの電話番号は123-4567」というテキストを作成するワークフローを起動する

を試してみます。

手順

  1. スプレッドシートを準備

  2. Robotic Crowd にワークフローを作成

  3. 作成したワークフローを実行してみる

  4. Robotic Crowd Sheets Addon にトリガーを作成

  5. スプレッドシートを更新し、Robotic Crowd のセッションを確認

1. スプレッドシートを準備

例を参考に新規にスプレッドシートを作成します。 rcsa_spreadsheet_sample

スプレッドシートに Robotic Crowd Sheets Addon をインストールします。 Google Workspace Marketplace から、Robotic Crowd Sheets Addon を検索し、インストールしてください。 rcsa_searchaddon

インストールが完了すると、アドオンメニューに表示されるようになります。 「アドオンを有効化」をクリックしてサイドメニューを開きます。 rcsa_open_addon_menu

アクセスキーとシークレットキー、メールアドレスを入力することで、アドオンを使用できるようになります。

Robotic Crowdの設定ページからアクセスキーとシークレットキーを作成します。 rcsa_getaccesskey 「作成する」をクリックすると、スコープを設定するダイアログが開きます。 最低限必要なのは、

  • アクセストークンを作成する

  • ワークフローを実行する

の2つです。

rcsa_access_token_scopes

作成できたらメモをとっておき、自身のメールアドレスと共にアドオンへ入力、登録します。

これでスプレッドシートの準備は完了です。

2. Robotic Crowd にワークフローを作成

Robotic Crowdに、Text(テキストを作成)アクションを持つワークフローを作成します。 テキストの中身は、${name}の電話番号は${number} としておきます。 ワークフロー作成ページのURLでワークフローIDを確認できます。 rcsa_workflow_sample

3. 作成したワークフローを実行してみる

作成したワークフローを動かしてみましょう。 実行ボタンをクリックします。 rcsa_exec_workflow_at_rc

Text(テキストを作成)アクションには、${name}の電話番号は${number} を設定しました。 nameとnumberはそれぞれ変数です。 変数に代入する値を設定していないため、変数の設定を促すダイアログが開きます。 rcsa_set_variables

「株式会社チュートリアルの電話番号は123-4567」というテキストを作成したいので、 変数 name には「株式会社チュートリアル」を、変数 number には「123-4567」をそれぞれ設定します。 rcsa_set_variables_to_workflow

再度ワークフローを実行すると、期待通りの結果を得ることができます。 今回のチュートリアルでは、スプレッドシートの変更を起点にワークフローを実行します。 その際に変数 name と number の値が必要になりますが、これらをスプレッドシートに書き込まれた値から取得して設定します。 rcsa_rc_workflow_result

4. Robotic Crowd Sheets Addon にトリガーを作成

先ほど実行したワークフローをスプレッドシートから起動しましょう。 まずは、スプレッドシートにインストールした Robotic Crowd Sheets Addon にトリガーを作成します。

作成したスプレッドシートで アドオン > Robotic Crowd Sheets Addon > トリガー一覧 からサイドメニューを開き、追加ボタンからトリガーを作成します。

ワークフローIDには、先ほど Robotic Crowd 側で確認したワークフローIDを入力します。 rcsa_create_trigger_1

ワークフローを起動するきっかけは「値の変更」とします。 こちらを選択すると、追加で変更を検出するシートとセルを指定することができます。 「シート1のC列のセルに変更があった場合に発火する」トリガーを作成したいので、 シート名は「シート1」、セルは「C:C」を指定します。 rcsa_create_trigger_2

Robotic Crowd に送るパラーメーターの Variable Name にRobotic Crowdで扱いたい変数の名前を、Valueに送りたい値の入ったセルの場所を入力します。 rcsa_create_trigger_3

トリガーが保存されたら、Robotic Crowd を起動する準備が整いました。 rcsa_created_trigger

5. スプレッドシートを更新し、Robotic Crowd のセッションを確認

トリガー作成時に入力した変更を検出するシートとセルの範囲内で手動で値の変更を行った場合、Robotic Crowd を起動するリクエストが送られます。 シート1のC列にあるセルに変更があった場合に発火するので、C列のセルに値を入力してみます。 rcsa_edit_cell

Robotic Crowd のセッションを確認すると、起動したワークフローの履歴を確認することができます。 rcsa_add_to_queue

詳細をクリックし、Text の OUTPUT が指定したセルの値になっていれば成功です。 rcsa_execute_result

お疲れ様でした。

Robotic Crowd Sheets Addon でRobotic Crowdに作成したワークフローを実行する方法について説明しました。 次は設定メニューについてご紹介します。