シナリオの準備をしよう
はじめに
今回は、シナリオを作る前の準備をします。
最初に「何をきっかけに、何をするか」を整理してシナリオを設計し、その設計に沿ってプロジェクトとkintoneアプリを用意します。
準備を丁寧にしておくと、次回のシナリオ作成で迷う場面が減ります。
特に、kintoneアプリのフィールドコードは、シナリオの作りやすさを大きく左右します。忘れずに確認してください。
シナリオを設計する
シナリオを作るときは、最初に次の2点を決めます。
- 何をきっかけにするか(イベント)
- 何をするか(アクション)
このシリーズでは、次のシナリオを作ります。
| 項目 | 内容 |
|---|---|
| きっかけ(イベント) | 「問い合わせ管理」アプリにレコードが追加される |
| すること(アクション) | 「To Do」アプリに、対応タスクのレコードを追加する |
合わせて、イベントで受け取った値を、アクションのどこに使うかも決めておきます。
ここでは、問い合わせの内容をもとに、To DoのToDo名、詳細内容、締切日を作ります。
| To Doアプリのフィールド | 設定する値(問い合わせ管理アプリのフィールド) |
|---|---|
| ToDo名 | 「【問い合わせ対応】」+顧客名+「(」+ご担当者名+「様)」 |
| 詳細内容 | 詳細 |
| 締切日 | 期限 |
設計の段階で値の対応を表にまとめておくと、アプリで必要なフィールドが明確になります。
アクションの設定画面でも、値の入れ先を迷わずに済みます。
STEP 1. プロジェクトを作成する
シナリオは、プロジェクトの中に作成します。
ここでは、「問い合わせ対応チーム」という名前でプロジェクトを作成します。
プロジェクトを作成できるのは、連携コネクタで「オーナー」または「組織の管理者」の役割をもつユーザーです。
-
連携コネクタにログインし、画面上部のメニューで[プロジェクト]をクリックします。
-
[プロジェクト一覧]で[新規プロジェクト作成]をクリックします。
-
[プロジェクト作成]で、[プロジェクト名]に「問い合わせ対応チーム」と入力し、[作成]をクリックします。
-
[プロジェクト一覧]に、「問い合わせ対応チーム」プロジェクトが表示されていることを確認します。
STEP 2. アプリストアからkintoneアプリを作成する
シナリオで使う2つのアプリを、kintoneのアプリストアから作成します。
アプリストアのアプリは、フィールドがあらかじめ用意されているため、すぐにシナリオ作りに取りかかれます。
| アプリ | アプリストアのアプリ |
|---|---|
| 問い合わせ管理 |
問い合わせ管理
|
| To Do |
To Do
|
kintoneのアプリストアで、それぞれのアプリを選択して作成してください。
このとき、[サンプルデータを含める]のチェックは外しておきます。
To Doアプリにサンプルデータがないと、シナリオで追加されたレコードを見つけやすくなるためです。
アプリストアからアプリを作成する方法は、次のページを参照してください。
サンプルアプリを追加する
To Doアプリは、プロセス管理が有効になっています。
シナリオで追加されたレコードは、ステータスが「未着手」の状態で登録されます。
STEP 3. フィールドコードを確認し、わかりやすい名前に変更する
連携コネクタの設定画面では、kintoneの値がフィールド名ではなくフィールドコードで表示されます。
たとえば、問い合わせ管理アプリの顧客名とご担当者名は、次のように表示されます。
| フィールド名 | 連携コネクタでの表示 |
|---|---|
| 顧客名 | record > Customer > value |
| ご担当者名 | record > 文字列__1行__0 > value |
「文字列__1行__0」のままでは、どのフィールドの値なのかを画面だけでは判断できません。
そこで、ご担当者名のフィールドコードを「ContactName」に変更します。
フィールドコードの変更方法は、次のページを参照してください。
フィールドコードとは
注意
シナリオを作成したあとでフィールドコードを変更すると、シナリオで設定した値が正しく連携されなくなります。
問い合わせ管理アプリとTo Doアプリのどちらでも、フィールドコードを変更したフィールドの値は連携されず、空欄のままレコードが登録されます。
実行結果はエラーにならず「成功」と表示されるため、気付きにくい点に注意してください。
フィールドコードは、シナリオを作成する前に決めておきましょう。
STEP 4. APIトークンを生成し、接続に必要な値を控える
連携コネクタからTo Doアプリにレコードを追加するため、To DoアプリのAPIトークンを生成します。
APIトークンは、連携コネクタの認証コネクタに登録する、アプリへのアクセス用の鍵です。
APIトークンのアクセス権には、[レコード追加]を付与してください。
APIトークンの生成方法は、次のページを参照してください。
APIトークンを生成する
APIトークンを生成した後は、[アプリを更新]をクリックして、変更をアプリに反映してください。
認証コネクタを作成するときは、APIトークンのほかに、サブドメインとアプリIDも入力します。
生成したAPIトークンと合わせて、To Doアプリの次の値を控えておきましょう。
| 控える値 | 確認する場所 |
|---|---|
| APIトークン | APIトークンの設定画面 |
| サブドメイン | kintoneのURLの先頭部分(https://sample.cybozu.comの場合は「sample」) |
| アプリID | アプリを開いたときのURLの/k/の後ろの数字(https://sample.cybozu.com/k/123/の場合は「123」) |
おわりに
今回は、シナリオを設計し、プロジェクトとkintoneアプリを準備しました。
次回は
初めてのシナリオを作ろう
で、いよいよイベントとアクションを作成し、シナリオを完成させましょう。
このTipsは、2026年10月版kintoneで動作を確認しています。
