ドロップダウン値の変更時のアクション
レシピを実行アクションを使用すると、アプリ内のドロップダウン値が変更されたときに、サードパーティアプリケーションのデータを取得または変更し、Workflow appに動的に返すことができます。 これにより、外部システムとWorkflow appの間でデータをリアルタイムに同期できます。
ドロップダウン値の変更時にRun recipeアクションを設定
drop-down value changeでRun recipeアクションを設定するには、次の手順を実行します:
ドロップダウン値の変更でアクションを有効化
次の手順を実行して、drop-down value changeでレシピ実行アクションを有効にします：
新しいWorkflow appを作成するか、既存のWorkflow appを選択します。
a drop-down componentを選択し、アクションパネルに移動します。 アクションのトリガーイベントは、Value changedとして事前選択されています。
アクションドロップダウンメニューを使用してRun recipeを選択します。
レシピドロップダウンメニューを使用して、レシピを作成をクリックします。 これにより、新しいタブでSet up your recipeページが開きます。
drop-down value changeのアクション設定
外部アプリのデータを取得または変更するレシピを設定
このレシピに一意のNameを入力します。
Locationドロップダウンメニューを使用して、レシピがアプリページと同じフォルダにあることを確認します。
ビルドを開始をクリックします。
Workatoは、New component event（リアルタイム）トリガーとReturn data to componentアクションが事前設定されたレシピを生成します:
レシピの概要
New component eventトリガーを変更する
トリガーを変更するには、次の手順を完了します:
New component eventトリガーを選択します。
Setupタブに移動します。
Setupタブには、ページからデータを受け取り、ページにデータを返すために使用できるレシピ入力パラメータと出力パラメータが表示されます。
Input parametersに移動し、Add input parametersをクリックします。
レシピで使用するページデータを定義します。 各入力パラメータに対して、Name、Label、Data type、およびOptionalステータスを指定する必要があります。
入力パラメータの設定
Output schemaに移動し、Add fieldをクリックします。
ページに返す予定のレシピ出力を定義します。 各出力パラメータに対して、Name、Label、Data type、およびOptionalステータスを指定する必要があります。
出力スキーマの設定
アプリ内でアクションを設定する
外部システムからデータを取得または変更するために、アプリ内で1つ以上のアクションステップを設定するには、次の手順を完了します:
レシピ内のアプリとアクションを選択ステップをクリックします。
使用する予定のアプリを検索して選択します。 アプリで使用可能なアクションのリストが表示されます。
使用する予定のアクションを選択します。
コンポーネントイベントレシピに使用する予定のコネクションタイプを選択します。
コネクションタイプを選択
- エンドユーザーのコネクション: Workflow appsレシピは、アプリケーションに接続するユーザーのIDと権限に基づいてアクションを実行します。 エンドユーザーは、自分の認証情報で認証して外部アプリ内のデータを取得または変更します。
- このレシピのコネクション: このオプションは、レシピビルダーによって確立されたコネクションを使用し、通常のアプリコネクションと同じ原則に従います。
OAuth 2.0認可コードグラントを使用するアプリコネクションのみが、エンドユーザーのコネクションで利用できます。 詳細については、検証済みユーザーアクセスを参照してください。
既存のコネクションを選択するか、+ New connectionをクリックして新しいコネクションを作成します。
要件に基づいてアクションを設定します。
必要に応じて、入力パラメータをアクションにマッピングします。 たとえば、Account nameなどのユーザー入力を使用して、外部システム内のアカウントを検索し、関連データをページに返すことができます。
必要に応じて追加のステップを追加します。
Return data to componentアクションを変更する
レシピデータをアプリに返すには、次の手順を完了します:
Return data to componentアクションを選択します。
Consider this action as successful?ドロップダウンを使用して、アクションが正常に完了したかどうかを定義します。
出力セクションに移動し、レシピデータを指定された出力フィールドにマッピングします。 この出力は、New component eventトリガーで定義された出力フィールドと一致します。
Return data to component
Save、Exitの順にクリックします。
ページコンポーネントにレシピデータを表示
ページコンポーネントにレシピデータを表示するには、次の手順を実行します：
ページエディターに戻り、a drop-down componentを選択します。
変数を作成してページコンポーネントにマッピング
デザインパネルに移動し、+ 変数を追加を選択します。
必要に応じて、変数の名前、データ型、デフォルト値を入力します。 変数のデータ型は、トリガー出力パラメータで指定したデータ型と一致している必要があります。 詳細については、変数の作成を参照してください。
変数の追加
必要に応じて、追加の変数を作成します。
変数を表示するコンポーネント（テキストブロックなど）を選択し、コンテンツパネルに移動します。
ページデータモーダルを使用して変数をマッピングします。
変数のマッピング
レシピ入力パラメーターの定義
a drop-down componentを選択します。
アクションパネルに移動します。
レシピ入力パラメーターに移動します。
ページデータモーダルを使用して、ページコンポーネントデータをマッピングします。 たとえば、Account nameなどのユーザー入力をマッピングし、それを使用して外部システム内のアカウントデータを検索できます。
レシピ入力パラメーターの定義
レシピ出力を使用して変数値を設定
a drop-down componentを選択します。
アクションパネルに移動します。
レシピ出力で値を設定に移動し、+ 項目を追加をクリックします。
レシピ出力ドロップダウンメニューを使用して、レシピ出力を選択します。
値を設定する対象ドロップダウンメニューを使用して、値を設定するページコンポーネントまたは変数を選択します。 詳細については、レシピ出力を使用した変数への入力を参照してください。
レシピ出力を使用して変数値を入力
保存をクリックします。
Last updated: