シナリオの準備をしよう

著者名:Asami Maeda( サイボウズ株式会社 (External link) )

目次

はじめに

今回は、シナリオを作る前の準備をします。
最初に「何をきっかけに、何をするか」を整理してシナリオを設計し、その設計に沿ってプロジェクトとkintoneアプリを用意します。

準備を丁寧にしておくと、次回のシナリオ作成で迷う場面が減ります。
特に、kintoneアプリのフィールドコードは、シナリオの作りやすさを大きく左右します。忘れずに確認してください。

シナリオを設計する

シナリオを作るときは、最初に次の2点を決めます。

  • 何をきっかけにするか(イベント)
  • 何をするか(アクション)

このシリーズでは、次のシナリオを作ります。

項目 内容
きっかけ(イベント) 「問い合わせ管理」アプリにレコードが追加される
すること(アクション) 「To Do」アプリに、対応タスクのレコードを追加する

合わせて、イベントで受け取った値を、アクションのどこに使うかも決めておきます。
ここでは、問い合わせの内容をもとに、To DoのToDo名、詳細内容、締切日を作ります。

To Doアプリのフィールド 設定する値(問い合わせ管理アプリのフィールド)
ToDo名 「【問い合わせ対応】」+顧客名+「(」+ご担当者名+「様)」
詳細内容 詳細
締切日 期限

設計の段階で値の対応を表にまとめておくと、アプリで必要なフィールドが明確になります。
アクションの設定画面でも、値の入れ先を迷わずに済みます。

STEP 1. プロジェクトを作成する

シナリオは、プロジェクトの中に作成します。
ここでは、「問い合わせ対応チーム」という名前でプロジェクトを作成します。

information

プロジェクトを作成できるのは、連携コネクタで「オーナー」または「組織の管理者」の役割をもつユーザーです。

  1. 連携コネクタにログインし、画面上部のメニューで[プロジェクト]をクリックします。

  2. [プロジェクト一覧]で[新規プロジェクト作成]をクリックします。

  3. [プロジェクト作成]で、[プロジェクト名]に「問い合わせ対応チーム」と入力し、[作成]をクリックします。

  4. [プロジェクト一覧]に、「問い合わせ対応チーム」プロジェクトが表示されていることを確認します。

STEP 2. アプリストアからkintoneアプリを作成する

シナリオで使う2つのアプリを、kintoneのアプリストアから作成します。
アプリストアのアプリは、フィールドがあらかじめ用意されているため、すぐにシナリオ作りに取りかかれます。

アプリ アプリストアのアプリ
問い合わせ管理 問い合わせ管理 (External link)
To Do To Do (External link)

kintoneのアプリストアで、それぞれのアプリを選択して作成してください。
このとき、[サンプルデータを含める]のチェックは外しておきます。
To Doアプリにサンプルデータがないと、シナリオで追加されたレコードを見つけやすくなるためです。

アプリストアからアプリを作成する方法は、次のページを参照してください。
サンプルアプリを追加する (External link)

information

To Doアプリは、プロセス管理が有効になっています。
シナリオで追加されたレコードは、ステータスが「未着手」の状態で登録されます。

STEP 3. フィールドコードを確認し、わかりやすい名前に変更する

連携コネクタの設定画面では、kintoneの値がフィールド名ではなくフィールドコードで表示されます。
たとえば、問い合わせ管理アプリの顧客名とご担当者名は、次のように表示されます。

フィールド名 連携コネクタでの表示
顧客名 record > Customer > value
ご担当者名 record > 文字列__1行__0 > value

「文字列__1行__0」のままでは、どのフィールドの値なのかを画面だけでは判断できません。
そこで、ご担当者名のフィールドコードを「ContactName」に変更します。

フィールドコードの変更方法は、次のページを参照してください。
フィールドコードとは (External link)

warning
注意

シナリオを作成したあとでフィールドコードを変更すると、シナリオで設定した値が正しく連携されなくなります。
問い合わせ管理アプリとTo Doアプリのどちらでも、フィールドコードを変更したフィールドの値は連携されず、空欄のままレコードが登録されます。
実行結果はエラーにならず「成功」と表示されるため、気付きにくい点に注意してください。
フィールドコードは、シナリオを作成する前に決めておきましょう。

STEP 4. APIトークンを生成し、接続に必要な値を控える

連携コネクタからTo Doアプリにレコードを追加するため、To DoアプリのAPIトークンを生成します。
APIトークンは、連携コネクタの認証コネクタに登録する、アプリへのアクセス用の鍵です。
APIトークンのアクセス権には、[レコード追加]を付与してください。

APIトークンの生成方法は、次のページを参照してください。
APIトークンを生成する (External link)

information

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アプリを準備しました。
次回は 初めてのシナリオを作ろう で、いよいよイベントとアクションを作成し、シナリオを完成させましょう。

information

このTipsは、2026年10月版kintoneで動作を確認しています。

公式コミュニティ

kintone開発者同士で質問や知見を共有し、学び合うことができます。