初めてのレシピの作成

初めてレシピを作成する際には、こちらのビデオをご覧ください。

レシピとは、アプリ間を接続する自動化されたワークフローのことです。それぞれのレシピは、トリガーと1つまたは複数のアクションで構成されます。レシピは有効にされると、トリガーとなるイベントが発生するまで待ってからアクションを実行します。

以下のステップでは、同じ名前の Jira の課題がクローズすると Salesforce のケースもクローズするレシピを作成する手順について説明します。

準備

• Jira アカウントへの接続には、ホスト名、メールアドレス、API トークンが必要です。
  API トークンの生成方法については「Atlassian で API トークンを作成する」を参照してください。
• Salesforce アカウントへの接続には、ユーザー名とパスワードが必要です。

ステップ1 : 新しいレシピを開く

1. [Assets] に移動し、 [Create Recipe] をクリックします。
2. [Name] フィールドに「My first recipe」と入力します。
3. [Start building] をクリックします。

ステップ2 : Jira に接続する

1. Jira アプリを検索します。
2. [Updated issue] を選択します。
   [Connection] ページが開きます。
3. コネクションの名前を [Connection name] フィールドに入力します。
   コネクションはレシピ間で共有できるので、アカウントを特定できる分かりやすい名前を入力します。(例 : Test Jira account)。
4. Jira アカウントの URL を入力します。
5. Yes を選択して、API トークンを使用して認証を受けることを指定します。
6. Jira へのログインに使用するメールアドレスを入力します。
7. Atlassian から取得した API トークンを入力します。
8. [Connect] をクリックします。
   これで、トリガーのフィールドを設定できるようになりました。

ステップ3 : トリガーを設定する

このレシピは、課題がクローズされると実行されます。レシピは起動されると、過去7日間に条件に一致するイベントがなかったかどうかを確認します。

1. [When first started...] フィールドに「7.days.ago」という関数を入力します。
2. クリックしてトリガー条件を設定します。
3. [Recipe data] ウィンドウで [Status] > [Name] を検索します。
4. [Name] データピルを [Trigger data] フィールドにドラッグします。
5. 条件を contains に設定します。
6. 値を Closed に設定します。

ステップ4 : Salesforce に接続する

1. [Actions] の下にある [+] をクリックしてから、 [Action in app] をクリックします。
2. Salesforce アプリを検索します。
3. [Search records] を選択します。
   [Connection] ページが開きます。
4. 分かりやすいコネクション名を [Connection name] フィールドに入力します。
5. [Connect] をクリックします。
   Salesforce のログインページが新しいウィンドウで開きます。
6. ユーザー名とパスワードを入力して、 [Log In] をクリックします。
   これで、アクションのフィールドを設定できるようになりました。

ステップ5 : アクションを設定する

このレシピでは、Jira の課題と同じケース名の Salesforce のケースを検索します。

1. [Search for] フィールドで、 [Case] を選択します。
2. レコード数の上限として「150」と入力します。
3. [Summary] データピルを [Subject] フィールドにドラッグします。

ステップ6 : 条件付きステートメントを設定する

このステップでは、レシピに対して Salesforce のケースがクローズされているかどうかを確認するよう指示します。クローズされていない場合は、ステータスをクローズ済みに更新します。

1. [Actions] の下にある [+] をクリックしてから、 [IF condition] をクリックします。
2. [Status] データピルを [Data] フィールドにドラッグします。
3. [equals] 条件を選択します。
4. [Value] フィールドに「Closed」と入力します。
5. [Select an app...] をクリックします。
6. Salesforce アプリを選択し、 [Update record] を選択します。
   このアクションではステップ4で確立したコネクションが自動的に選択されます。
7. [Case] を選択します。
8. [Case ID] データピルを [Case ID] フィールドにドラッグします。
9. [Closed] ステータスを選択します。

ステップ7 : レシピを保存して開始する

1. [Save] をクリックしてから、 [Exit] をクリックします。
2. [Start recipe] をクリックします。 完成したレシピは、こちら (opens new window)のようになります。

次のステップ

次のステップとして、以下のことをお勧めします。

• Community ライブラリ (opens new window)で、すぐに使用できる他のユーザーが作成したレシピを見てみる。
• 「レシピコンポーネント」で他の種類のトリガーとアクションについて学ぶ。