Magic xpiトレーニングテキスト
18. エラー処理

18.1 エラー変数とエラーコード

【エラー変数（C.sys.Error ～）】

• Magic xpi はフロー内の各ステップが実行されるたびに、その実行結果をエラー変数(定義済みコンテキスト変数）に格納します。

【エラー変数（C.sys.LastError ～）】

• 最後に発生したエラー情報は「C.sys.LastError」から始まるエラー変数に格納されます。

【C.sys.ErrorとC.sys.LastErrorの違い】

• 「C.sys.Error」から始まるエラー変数は、次ステップの開始時に値がクリアされるので、次ステップの実行条件でのみ使用することができます。
• 「C.sys.LastError」から始まるエラー変数は、次のエラーが発生するまでは値が保持されるので、次ステップの中で前ステップのエラー内容を参照する場合に使用します。

【エラーコードの確認】

• ソリューションエクスプローラのエラーリポジトリで、エラーコードとエラー内容を確認できます。

18.2 エラー処理フローの呼び出し

• Magic xpi では、フローでエラーが発生した際の共通エラー処理フローを作成し、それを各フローから呼び出すことができます。
• エラーフローの呼び出し方には次の３つの方法があります。

　①　フローの特性で指定する。

　②　データマッパーのデータベース特性で指定する。

　③　「フロー呼出」コンポーネントで呼び出す。

【①　フローの特性で指定する】

• フローのプロパティ「エラー処理フロー」に、エラーを処理するためのフローを指定します。
• このプロパティを設定したフローの処理中にエラーが発生した場合、指定したフローが自動的に呼び出されます。

【②　データマッパーのデータベース特性で指定する】

• データマッパーの送り先に指定したDataBaseエントリのプロパティ「エラー処理フロー」に、エラーを処理するためのフローを指定します。

【③　「フロー呼出」コンポーネントで呼び出す】

• フロー内で変数「C.sys.ErrorCode」が0か否かを判断し、0以外（＝エラー）の場合に「フロー呼出」コンポーネントを使用してエラーを処理するためのフローを呼び出します。

【設定例】

• ①フロー特性のエラー処理フローと、②データベース特性のエラー処理フロー両方を指定した場合、②データベース特性のエラー処理フローが優先的に呼び出されます。

18.3 エラー処理フローの作成

• エラー処理フローでは、エラー通知メールを送信したり、ログファイルを出力します。
• エラー通知メールを送信するには、Emailコンポーネントの「Quick Send」メソッドを使用します。

18.4 エラーポリシーの設定

• エラー処理の方法として、エラー処理フローを呼び出すほか、エラーポリシーを設定できます。
• エラーポリシーではエラーが起こった際の動作（アボート/無視/フロー再起動/リトライ/ジャンプ）を設定します。
• エラーポリシーはフローごと、コンポーネントごと、エラーコードごとに設定します。

【設定例】

• ソリューションエクスプローラでエラーポリシーを設定するフロー下の「エラーポリシー」をダブルクリックし、エラーポリシーを設定します。

• ファイル管理コンポーネントでエラーが発生すると、「ステップ3：処理終了」へジャンプします。
• また、プロジェクトのプロパティで設定したエラーメール送信先にエラーメールが送信されます。

【エラー処理フローとエラーポリシーの優先順位】

• エラー処理フローとエラーポリシー両方を設定した場合、エラー処理フローのみが実行されます。
• エラー処理フローの実行後、エラーポリシーを実行したい場合は、エラー処理フローの最後のステップでエラーコードを更新する必要があります。