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