processingコンポーネントについて

processingコンポーネントは、現在バックエンド・プロセスが進行中であることをユーザーに知らせるために使用されます。外観的には、このコンポーネントは、パーセント完了を表示するステータス・バー形式の処理アイコン、またはパーセント完了が不明のときは回転する時計を表示します。処理アイコンの下に表示されるプロセスのステータスを説明するには、索引付けされた子を使用します。このコンポーネントは、エージェントのタイプがpda、phoneおよびvoiceの場合にはサポートされません。

Processing status bar showing 25% complete

Processing spinning clock

注意: プロセスのステータスを説明する索引付けされた子については、ステータスの可変部分(たとえば、25%)にはstyleClassのOraProcessingStatusVariable、ステータスの固定部分(たとえば、「ケーキの焼け具合」のテキスト)にはstyleClassのOraProcessingStatusFixedが使用できます。

パーセント完了が不明のときは、処理アイコンの下に表示されるステータスの説明にチェックリストやグローリング・リストを含めることができます。

これはチェックリストで、プロセスのすべてのステップが処理アイコンの下に縦に表示されます。各ステップが完了すると、ステップの隣にチェックマークが表示されます。

Processing status bar with checklist below

これはグローリング・リストで、ステップが完了すると、リストの下にステップの説明が追加されます。

Processing status bar with growing list below

processingコンポーネントに設定できる属性は次のとおりです。

processingコンポーネントは、timeInterval属性によって指定された時間間隔の後にrefreshイベントをトリガーします。このイベントを処理して、プロセスが完了したかどうかを確認し、可能な場合はパーセント完了を測定する必要があります。percentComplete属性はデータ・バインドできます。プロセスが完了すると、必要に応じて新しいページをリダイレクトすることができます。

processingコンポーネントが、フォーム送信または標準引数を持つURLとしてrefreshイベントをトリガーします。送信されるパラメータは、次のとおりです。

processing要素がフォーム内にある場合、フォーム名が自動的に検出され、特殊な非表示フィールド値、eventおよびsourceとともに、リフレッシュごとにフォームが送信されます。processing要素がフォーム内にない場合、refreshイベント・パラメータがURLに追加されます。

イベントが起動されると、要素は部分ページ・レンダリング(PPR)モードまたはページの完全リフレッシュのいずれかでリフレッシュされ、イベントは指定されたtimeInterval後に再起動されます。PPRが有効な場合、processing要素は、索引付けされた子とともに、自動的にPPRモードでリフレッシュされます。PPRが無効な場合は、完全リフレッシュが実行されます。PPRモードが使用可能な場合には、processingコンポーネントがPPRモードでリフレッシュできるように、必ずid属性を指定してください。


processingコンポーネントの使用
単純なコンポーネントおよびその他のコンポーネントの使用

 

Copyright © 1997, 2004, Oracle. All rights reserved.