イベントのスロー

イベントタイプはイベントの発生についての通知を提供するためにスローされます。サービス操作では、操作の実行時にエラーが発生したことを示す例外イベントをスローできます。サービス例外や例外イベントタイプを明示的にスローすることはできません。

多くのサービスで、短時間および長時間プロセスでスローする非同期イベントを使用できます。プロセスでイベントをスローする場合、イベント通知に含まれるイベントデータとイベントメッセージデータを設定します。

イベントのスローはプロセスダイアグラムでアイコンとして表示されます。操作の場合と同様、イベントでルートの開始や終了を行うことができます。

実行時に、イベントタイプのスローに対するルートが設定され、実行されると、イベントに関する情報がそのイベントタイプのすべての受信者と取得者に送信されます。イベントがスローされた後、プロセスはそのイベントのスローから始まるルートに従って続行されます。

イベントのスローを設定するには、イベント受信者に送信するイベントデータを指定します。非同期イベントタイプについては、イベントメッセージデータも指定できます。タイマーイベントタイプについては、タイマーデータを指定できます。

非同期イベントのスローの追加と設定

* 9.5 の新機能 *

イベントは短時間プロセスに追加できます。

注意: 例外イベントタイプはスローできません。
  1. Event Picker  を Activity ツールバーからプロセスダイアグラムの未使用の部分にドラッグします。

  2. (オプション)「Name」ボックスに、デフォルトの名前の代わりに使用する新しい名前を入力します。

  3. (オプション)特定のイベントを検索するには、「Find」ボックスのデフォルトの文字列を任意の値に置き換えます。

  4. 非同期イベントタイプを選択して「OK」をクリックします。

  5. Event Behavior Configuration ダイアログボックスで「Event Throw」が選択されていることを確認します。

  6. 送信するイベントデータを追加します(送信するイベントデータの追加を参照)。

  7. (オプション)次の手順を実行して、XML 変数から追加の XML データを送信します。

    • Event Behavior Configuration ダイアログボックスで、「Event Message Data」ボックスの横の省略記号をクリックします。

    • Asynchronous Event Throw Configuration ダイアログボックスで、データが格納されている XML 変数を選択して「OK」をクリックします。

  8. 「OK」をクリックします。

タイマーイベントスローの追加と設定

タイマーイベントのスローを設定すると、タイマーデータをスローできます。特定の日付または期間を指定できます。

  1. Event Picker  を Activity ツールバーからプロセスダイアグラムの未使用の部分にドラッグします。

  2. (オプション)Define Event ダイアログボックスの「Name」ボックスで、デフォルトの名前のかわりに使用する新しい名前を入力します。

  3. (オプション)特定のイベントを検索するには、「Find」ボックスのデフォルトの文字列を任意の値に置き換えます。

  4. タイマーイベントカテゴリからイベントタイプを選択して、「OK」をクリックします。

    注意: タイマーカテゴリは、カスタムタイマーイベントが少なくとも 1 つ作成および配置されていないと表示されません。LiveCycle にはデフォルトのシステムタイマーイベントはありません。展開されていないカスタムタイマーイベントは現在のアプリケーションカテゴリに表示されません(「カスタムイベントタイプの作成」を参照)。
  5. Event Behavior Configuration ダイアログボックスで「Event Throw」が選択されていることを確認します。

  6. 送信するイベントデータを追加します(送信するイベントデータの追加を参照)。

  7. 次のいずれかの手順を実行して、日時のデータを設定します。

    • タイマーの期間を設定するには、「Set Timer Event Duration」を選択して、次の各フィールドで期間を入力します。

      • Date:XPath 式で DateTime 値に指定された日時を使用します。

      • Hours、Minutes、Second:Hours、Minutes、Seconds の各フィールドで定義された時刻を使用します。

    • タイマーが終了する特定の日時を設定するには、リストから次のいずれかの値を選択します。

      • LITERAL:「Date」ボックスの横にある省略記号  ボタンをクリックし、Calendar Date Selector ダイアログボックスで日付を選択します。また、Hour、Minute、Seconds の各値を入力して、「OK」をクリックします。

      • XPATH: 横にある省略記号  ボタンをクリックし、Timer Event Throw Configuration ダイアログボックスで DateTime 値を表す XPath 式を作成します。