変換されたAlteryxアプリの使用

PlaidCloudは、Alteryxのアナリティックアプリの質問を、制御されたワークフロー変数に変換します。ユーザーは実行前にこれらの変数を設定でき、PlaidCloudはその値を、数式、フィルター、ファイルパス、条件、マクロパラメーター、後続のステップ設定に適用します。

App Runnerフロントエンド

Alteryxのアナリティックアプリ（.yxwz）を変換すると、そのインターフェースも、公開されたPanelの「App Runner」として実体化されます。これは、Alteryxの質問が収集していたのと同じ値を収集し、その値で変換後のワークフローを実行する、実際に動作する入力フォームです。このフロントエンドは変換の一環として自動的に作成されます。入力ウィジェットのないアプリはスキップされます。

アプリの質問は、App Runnerのコントロールになります。テキスト、数値、日付、チェックボックス、ラジオボタン、ドロップダウン、リストボックス、ツリー、ファイルの参照、フォルダーの参照です。各コントロールは、変換されたステップが読み取るワークフロー変数に書き込むため、App Runnerからの実行は、変数を手動で設定した場合と同じロジックを動かします。実際のワークフロー変数にバインドされていないコントロールには、どこにも渡らない値を黙って収集するのではなく、目に見える注記が表示されます。内容を確認し、意図した変数を指すようにしてください。

フォームは、アプリ作成者自身のグループ分けに沿って配置されます。つまり、作成者がアプリを構築したときのタブとラベル付きのボックスです。作成者の説明テキスト（AlteryxのLabelツール）は、それが説明する質問の横にフォームに表示されます。設計時に固定されたアプリの質問、たとえばインターフェースの質問に制御されていないDetourは、質問としてはまったく表示されません。

フォームは、ワークフローの変数に保存されている値で開きます。誰かが別の値を保存していない限り、それは作成者のデフォルトです。保存された値のない質問は空欄になります。保存された値が質問の選択肢のいずれにも一致しなくなった場合は、古い選択として表示されるのではなく、無視されます。数値の質問では、作成者が設定した最小値、最大値、ステップが適用されるため、狭い範囲に制約された質問に、その範囲外の値を答えることはできません。

変換されたワークフローが分岐する場合、App Runnerはその分岐をラベル付きの選択肢として表示します。これにより、Alteryxのアプリが選んでいたのと同じように、実行がたどるパスを実行時に選択できます。

ファイルとフォルダーの質問

ファイルまたはフォルダーの質問にはそれぞれ参照ボタンがあり、ドキュメントブラウザーが開くため、パスを記憶から入力するのではなく選択できます。

参照では、アクセスできるドキュメントアカウントが表示されます。デフォルトはアプリ自身のアカウントで、アカウント間で切り替えることもできます。
質問の現在の回答が示すフォルダーで開きます。質問にまだ回答がない場合は、アカウントの最上位で開きます。
上部のパンくずリストで上の階層に戻れます。一覧でフォルダーを選択するとそのフォルダーが開き、ファイルを選択するとそのファイルが選択されます。
選択は、押す前に入力されるパスを表示します。何も強調表示されていない場合、選択は現在表示しているフォルダーを選びます。これがアカウントの最上位を選ぶ方法です。
フォルダーを一覧表示できない場合は、一覧にその旨と理由が表示され、選択は、表示されていないパスを入力しません。20秒以内に応答がない一覧表示では、アカウントが応答しなかったことが表示されます。

アプリの実行

フォームに入力して、実行を押します。

回答は実行とともに渡され、その実行にのみ有効です。ワークフローには保存されないため、ある人の回答が別の人の実行に影響することはなく、アプリを実行するのにワークフローを変更する権限は必要ありません。これは、行を制限するプロジェクトで重要です。そのようなプロジェクトは、アーキテクトだけが変更できます。フォームが開く際の値を変更するには、以下のようにワークフローに保存してください。

回答は、実行が開始される前にチェックされます。回答されていない選択式の質問があると、実行は開始前に停止し、その質問が示されます。1時間近くかかるかもしれない実行の途中で発覚することはありません。

実行中、フォームには進捗バー、ワークフローの総ステップ数に対するN of M steps、経過時間、現在実行中のステップが表示されます。一時停止と停止は、実行中のみ実行の隣に表示されます。実行が一時停止されている間、一時停止は再開に変わります。

失敗したステップは、失敗した時点でフォームに名前が表示され、実行が終了すると、失敗した各ステップが報告した内容がフォームに引用されます。停止した理由を調べるために、ワークフローを開く必要はありません。前のステップが失敗したために実行できなかったステップは、失敗ではなく未実行として別に表示され、進捗バーにも数えられるため、バーは最後まで到達します。

ページを閉じたり接続が切れたりしても、実行は続行されます。その実行がまだ進行中にアプリを再度開くと、アイドル状態のフォームではなく、一時停止と停止ボタンの付いた、進行中の実行が表示されます。

実行の隣にあるワークフローを開くリンクは、基になるワークフローをPlaidCloudの新しいタブで開きます。DAGワークフローの場合は、そのキャンバスで開きます。フォーム自体の実行状況の表示が更新されなくなっていても動作します。

以下のように変数を設定して、ワークフローを直接実行することもできます。App Runnerは、アプリ形式での追加の入り口です。

アプリを最新の状態に保つ

App Runnerアプリは、PlaidCloudがapp.py、widget_map.py、requirements.txtを生成するPanelサーバーアプリです。PlaidCloudがApp Runnerを更新すると、既存のアプリは自動的に新しいバージョンを取得します。各アプリは最新のファイルに更新され、PlaidCloudが次に更新されたときに再ビルドされます。また、マイPanelアプリ画面でアプリを再ビルドまたは編集するたびにも再ビルドされます。アプリの設定とそのワークフローには手を加えません。

ロックされたアプリはそのまま残ります。 ロックを解除して再ビルドをクリックすると、最新の状態になります。
生成されたファイルへの手動の編集は置き換えられます。 更新では、最新のapp.py、widget_map.py、requirements.txtがあなたの変更の上に書き込まれます。アプリのGit履歴には、以前のバージョンが残ります。

変換される入力タイプ

PlaidCloudは、一般的なAlteryxのアプリコントロールを、型付きのワークフロー入力に変換します。

テキストボックスはテキスト変数になります。
数値コントロールは数値変数になります。
日付コントロールはISO日付変数になります。
チェックボックス、ラジオボタン、ドロップダウン、リストボックス、ツリーは、制御された選択式の変数になります。
ファイル参照コントロールはドキュメントのファイル変数になります。
フォルダー参照コントロールはドキュメントのフォルダー変数になります。

変換後のワークフローは、Alteryxのアプリが元の質問の値を使用していたあらゆる場所で、これらの変数を使用します。

実行前の値の設定

変換されたアプリのワークフローを実行する前に：

変換されたワークフローを開きます。
ワークフロー変数を確認します。
必須のテキスト、数値、日付、選択式、ファイル、フォルダーの値を設定します。
ドキュメントのファイルパスとフォルダーパスが、インポートされた依存関係の場所、または承認された別のドキュメントパスを指していることを確認します。
ワークフローを実行します。

スケジュールされた実行では、スケジュールが実行されるたびに使用する変数の値を保存します。

条件、警告、エラー

Alteryxのアプリの条件とエラーチェックは、PlaidCloudのステップ条件に変換されます。条件には、次のことができます。

ワークフローの続行を許可する。
警告メッセージを出力する。
アプリのルールで求められている場合に、明確なエラーでワークフローを停止する。
実行を別の分岐に振り分ける。

この動作を使うと、PlaidCloudでワークフローを実行しながら、アプリレベルの検証を維持できます。

ファイルとフォルダーの入力

ファイルとフォルダーの質問は、ドキュメントパスを使用します。

ファイル入力は、ドキュメントからファイルを選択します。
フォルダー入力は、ドキュメントのフォルダーを選択します。
インポートされたデスクトップの依存関係は、インポート時に選択したドキュメントパスに保存されます。
動的入力ステップは、変数を使って、実行時に最終的なドキュメントパスを解決できます。

これにより、変換されたアプリは、ユーザー間やスケジュールされた実行間で移植可能になります。

マクロパラメーター

変換されたアプリがマクロを呼び出す場合、アプリの変数をマクロパラメーターに渡すことができます。PlaidCloudは、マクロ入力と制御パラメーターの処理を通じて、これらの値を生成されたマクロワークフローに渡します。

同時実行されるマクロの実行は分離されているため、複数のワークフローの実行が、中間状態を共有することなく、同じ変換済みマクロを使用できます。

検証チェックリスト

変換された各アプリについて、次を確認します。

想定されるすべての質問がワークフロー変数として表示されている。
デフォルトが設定されていた場合は、元のアプリのデフォルトと一致している。
制御されたリストに、想定される選択肢が含まれている。
ファイル変数とフォルダー変数が、ドキュメントパスを指している。
条件が、想定されるメッセージ、警告、または停止の動作を生成する。
選択した変数の値で、出力のパリティが合格する。