エラー処理ルートへのフィルタリングとネストの追加
フィルターとネストを含めることで、エラー処理ルートに高度なエラー処理技術を追加できます。
アクセス要件
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront パッケージ |
任意の Adobe Workfront Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ Workfront Ultimate Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。 |
| Adobe Workfront ライセンス |
標準 Work またはそれ以上 |
| 製品 | 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。 |
この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。
フィルタリング
エラーハンドラールートで実行できるフィルタリングには 2 種類あります。
エラーハンドラーのルートにフィルターを追加する
フィルターを使用して、エラーハンドラールートで処理されるエラーを制御できます。 これにより、特定のタイプのエラーのみを処理できます。 エラーがフィルターを通過しない場合は、指定されたモジュールに対してエラーハンドラールートが定義されていないものとして扱われます。
これらのフィルターは、Fusionの他のフィルターと同様に設定されます。 手順については、 シナリオへのフィルターの追加を参照してください。
ルーターを追加し、その後にフィルターをエラーハンドラーに追加します
ルータをエラー処理ルートに追加すると、異なるタイプのエラーに対して異なるルートを設定できます。
例えば、エラーがDataErrorの場合に実行するルートを1つ設定するには、マッピングされたエラータイプがDataErrorと等しい場合にデータを通過させるフィルターを設定できます。
Fusionが様々なデータタイプを評価および処理する方法について詳しくは、 エラータイプ を参照してください。
例：フィルターを使用したエラー処理
このシナリオの例では、これらのフィルターがエラー処理でどのように機能するかを示します。
Dropbox/Create a folder moduleを使用し、同じ名前のフォルダーが既に存在する場合、そのフォルダーはDataErrorをスローします。
完全なシナリオは次のように機能します。
-
ツール/変数を設定モジュールには、フォルダー名が含まれます
-
HTTP/ファイルを取得モジュールは、フォルダーにアップロードする必要があるファイルを取得します
-
Dropbox/Create a folder モジュールは、モジュールにマッピングされているフォルダーと同じ名前のフォルダーが既に存在する場合にエラーをスローします
-
エラーハンドラーのルート（透明なバブル）には、エラーをフィルタリングするルーターが含まれています
最初のルートは、DataErrorという指定されたタイプのエラーです。DataErrorが発生し、エラーの詳細がフィルターを通過した場合、Dropbox/フォルダーモジュール内のすべてのファイル/サブフォルダーを一覧表示すると、Dropbox内のすべてのフォルダーが一覧表示されます。- 後続のフィルターは、フォルダー名と一致します。
- Resume ディレクティブは、既存のフォルダーのフォルダーIDとフォルダーパスを指定し、シナリオの実行はDropbox/フォルダーモジュールの作成から再開します。 ただし、新しいフォルダーを作成する代わりに、FusionはResume ディレクティブの値を使用して次のモジュールに移動し、既存のフォルダーにファイルをアップロードします。
-
2つ目のルートは、他のすべてのエラーに対するもので、Rollback ディレクティブで終了します。これにより、シナリオがすぐに停止されます
以下に、DataError ルートの詳細な説明を示します。
ファイルのアップロードなど、後続のモジュールで既存のフォルダーを使用するには、モジュールにエラーハンドラーのルートを追加し、次に示すResume ディレクティブモジュールにマッピングするフォルダーパスを取得する必要があります。
最初のルートのフィルターは、同じ名前のフォルダーが既に存在する場合に表示される特定のエラー（DataError）のみを処理するように設定されています。
Dropbox/フォルダーモジュール内のすべてのファイルを一覧表示は、ターゲットフォルダー内のすべてのフォルダーを返すように設定されています。 次のフィルターは、最初に作成しようとしていたもののみを渡します。 （フォルダー名は33に保存されます。 フォルダー名項目。）
次に、「再開」ディレクティブは、失敗したモジュールの出力としてフォルダーパスを提供します。 フォルダーIDは、ファイルモジュールをアップロードする際に必要ではないため、空白のままになっています。
ネスト
エラーハンドラールートは、ルーターを除くすべてのモジュールで作成および設定できます。 したがって、既に既存のエラーハンドラールートの一部となっているモジュールに対して、エラーハンドラールートを作成できます。
例：
フィルターを含むネストされたエラーハンドラーのルート：
このシナリオでは、2番目のエラーハンドラールートは、最初のエラーハンドラールートの下にネストされます。
Dropbox/Create a folder モジュールでエラーが発生した場合、実行は最初のルートに移動します。 DataError Takes Place フィルターを渡すと、次のモジュールが実行され、Dropbox/フォルダーモジュール内のすべてのファイル/サブフォルダーを一覧表示でエラーが発生しない場合は、再開ディレクティブモジュールが続きます。
ただし、Dropbox/フォルダーモジュールのすべてのファイル/サブフォルダーを一覧表示でエラーが発生した場合、実行はError Handler Route 2に移動し、Ignore ディレクティブで終了します。 この場合、再開ディレクティブモジュールは実行されません。