Page History

You can view a rule set's execution history in Rule Debugger to determine at which point, and why, a particular execution encountered problems.
Each time a rule set is executed, information about each event and action that occurred as part of that particular execution is stored in the Prinergy system's database. You can later view the details about any particular execution of a rule set in Rule Debugger. This is especially useful when you want to understand where and why an execution failed or was stopped.

When you open a rule set in Rule Debugger, the Rule Set Execution History pane lists each execution of the rule set that has occurred since the rule set was last modified. The most recent execution is selected.
Note: Execution history is retained only as far back as the last time the rule set was modified. If the Rule Set Execution History pane is empty, the rule set has either never been run or has not been run since it was last modified. If you want to keep a rule set's execution history after you modify the rule set, make a copy of the rule set, modify it, and use hot swapping to replace the old rule set with the new one. The old rule set is renamed and its execution history is retained.

Executions are grouped by date, and the following information appears for each execution:

• Icons representing the rule set's trigger event and the execution status. Examples of execution statuses are Done and Exception .
• The time the rule set was run.
• Whether the rule set was run at the system level or on a particular job and the name of the job.

Executions that completed successfully are automatically deleted from the database after two days. Executions that completed with an exception are automatically deleted after four days. An execution that has not yet completed (for example, because the rule set includes a Timer action that delays the completion of the execution for more than four days) is not deleted, even if the execution started more than four days ago.

If an execution of an enabled rule set completes while you are viewing the rule set's execution history in Rule Debugger, the list of executions in the Rule Set Execution History pane is automatically updated.
When you select an execution, the Execution Path pane lists each event that was triggered and each action that occurred during the selected execution.
Meanwhile, the workspace (the upper-right pane) provides a graphical representation of the rule set and the selected execution history. When you select an action in the rule set, the corresponding rule is selected in the Execution Path pane. As well, when you click an action in the rule set, the path through the rule set to that action for the selected execution is highlighted in blue, even when the execution path spans rule chains within the rule set. Any actions not triggered during the selected execution appear in gray.
If you select an execution that is still in progress, and then the execution completes while you are viewing it, the execution trace shown in the workspace is automatically updated. If the execution encounters multiple pause points (for example, the rule set includes a Timer action to archive separations after five days and another Timer action to purge archived separations after 10 days), the workspace will show the execution as having reached the first pause point (the first Timer action in the example) but will not update again until the execution is complete.

When you select a rule in the Execution Path pane or an action in the workspace, the Event and Action tabs at the bottom of Rule Debugger display information about the selected instance of the action and the event that triggered it. For more information, see Viewing a rule set's execution details.
Note: The Rule Set Execution History pane in also displays XML validation errors. For example, if you write XML that does not adhere to the schema, and you validate using the ReadXML action, Prinergy will fail upon reading the XML file and the information will be shown in the Rule Set Execution History pane with a red cross.

Sie können den Ausführungsverlauf einer Regelsammlung im Regel-Debugger anzeigen, um zu ermitteln, an welcher Stelle und aus welchen Gründen bei einer bestimmten Ausführung Probleme aufgetreten sind.
Bei jeder Ausführung einer Regelsammlung werden Informationen zu jedem Ereignis und jeder Aktion, die im Rahmen der betreffenden Ausführung aufgetreten sind, in der Datenbank des Prinergy-Systems gespeichert. Sie können später die Details zu jeder Ausführung einer Regelsammlung im Regel-Debugger anzeigen lassen. Dies ist besonders hilfreich, wenn Sie ermitteln möchten, an welcher Stelle und weshalb eine Ausführung fehlgeschlagen ist oder beendet wurde.

Wenn Sie eine Regelsammlung im Regel-Debugger öffnen, werden im Bereich Regelsammlungsverlauf sämtliche Ausführungen der Regelsammlung seit deren letzter Änderung aufgelistet. Die letzte Ausführung ist ausgewählt.
Anmerkung: Der Ausführungsverlauf wird nur bis zum letzten Änderungszeitpunkt der Regelsammlung gespeichert. Wenn der Bereich Regelsammlungsverlauf leer ist, wurde die Regelsammlung entweder noch nie oder seit Ihrer letzten Änderung nicht mehr ausgeführt. Wenn Sie den Ausführungsverlauf auch nach dem Ändern einer Regelsammlung aufbewahren möchten, erstellen Sie eine Kopie der Regelsammlung, ändern Sie sie, und ersetzen Sie mittels Hot Swapping die alte durch die neue Regelsammlung. Die alte Regelsammlung wird umbenannt, und ihr Ausführungsverlauf bleibt erhalten.

Ausführungen sind gruppiert nach dem Datum, und für jede Ausführung werden die folgenden Informationen angezeigt:

• Symbole, die das Auslöseereignis und den Ausführungsstatus der Regelsammlung darstellen. Beispiele für den Ausführungsstatus sind Fertig und Ausnahme .
• Der Zeitpunkt, zu dem die Regelsammlung ausgeführt wurde.
• Die Angabe, ob die Regelsammlung auf der Systemebene oder für einen bestimmten Job ausgeführt wurde, wobei der Name des Jobs angegeben wird.

Ausführungen, die erfolgreich abgeschlossen wurden, werden automatisch nach zwei Tagen aus der Datenbank gelöscht. Ausführungen, die mit einer Ausnahme abgeschlossen wurden, werden automatisch nach vier Tagen gelöscht. Eine Ausführung, die noch nicht abgeschlossen wurde (zum Beispiel, weil die Regelsammlung die Aktion Timer beinhaltet, die die Fertigstellung der Ausführung um mehr als vier Tage verzögert) wird nicht gelöscht, auch wenn die Ausführung vor über vier Tagen gestartet wurde.

Wenn die Ausführung einer aktivierten Regelsammlung während der Anzeige des Ausführungsverlaufs der betreffenden Regelsammlung im Regel-Debugger abgeschlossen wird, wird die Liste der Ausführungen im Bereich Regelsammlungsverlauf automatisch aktualisiert.
Wenn Sie eine Ausführung auswählen, werden im Bereich Ausführungspfad alle ausgelösten Ereignisse und alle aufgetretenen Aktionen für die betreffende Ausführung aufgelistet.
Gleichzeitig bietet der Arbeitsbereich (der obere rechte Bereich) eine grafische Darstellung der Regelsammlung und des ausgewählten Ausführungsverlaufs. Wenn Sie eine Aktion in der Regelsammlung auswählen, wird die entsprechende Regel im Bereich Ausführungspfad ausgewählt. Wenn Sie auf eine Aktion in der Regelsammlung klicken, wird zudem der Pfad durch die Regelsammlung für die betreffende Aktion in der ausgewählten Ausführung blau hervorgehoben, auch wenn sich der Ausführungspfad über mehrere Regelketten in der Regelsammlung erstreckt. Alle während der ausgewählten Ausführung nicht ausgelösten Aktionen werden in grau angezeigt.

Wenn Sie eine noch laufende Ausführung auswählen und die Ausführung während der Anzeige abgeschlossen wird, wird der im Arbeitsbereich dargestellte Ausführungsverlauf automatisch aktualisiert. Wenn während der Ausführung mehrere Haltepunkte gefunden werden (die Regelsammlung enthält beispielsweise eine Timer-Aktion zum Archivieren von Auszügen nach fünf Tagen und eine weitere Timer-Aktion zum Säubern archivierter Auszüge nach zehn Tagen), wird im Arbeitsbereich angezeigt, dass die Ausführung den ersten Haltepunkt (im Beispiel die erste Timer-Aktion) erreicht hat, er wird jedoch erst wieder aktualisiert, nachdem die Ausführung abgeschlossen wurde.

Wenn Sie eine Regel im Bereich Ausführungspfad oder eine Aktion im Arbeitsbereich auswählen, werden auf den Registerkarten Ereignis und Aktion am unteren Rand des Regel-Debuggers Informationen zur ausgewählten Instanz der Aktion sowie zum auslösenden Ereignis angezeigt. Weitere Informationen hierzu finden Sie unter Viewing a rule set's execution details.
Anmerkung: Beachten Sie, dass im Fensterbereich Regelsammlungsverlauf auch XML-Validierungsfehler angezeigt werden. Wenn Sie beispielsweise XML schreiben, das nicht dem Schema folgt und eine Validierung mit der Aktion XML lesen ausführen, gibt Prinergy beim Lesen der XML-Datei einen Fehler aus, und die Informationen werden im Fensterbereich Regelsammlungsverlauf mit einem roten Kreuz gekennzeichnet angezeigt.

您可以在规则调试器中查看规则集的执行历史记录，以确定某个特定执行在哪个点上遇到了问题以及原因。
每次执行规则集时，有关该特定执行发生的每个事件和操作的信息将存储在印能捷系统的数据库中。您以后可在规则调试器中查看有关规则集的任意特定执行的详细信息。当您想要了解某个执行失败或停止的位置和原因时，这将尤其有用。

在规则调试器中打开规则集时，规则集执行历史记录窗格会列出自上次修改该规则集后发生的该规则集的所有执行。最近的执行将处于选中状态。
注： 执行历史记录仅保留到对规则集的上次修改。如果规则集执行历史记录窗格为空，说明从未运行过该规则集或者自上次修改后从未运行过该规则集。如果要在修改规则集后保留规则集的执行历史记录，可创建该规则集的副本，对它进行修改，并使用热交换用新规则集替换旧规则集。旧规则集将重命名，其执行历史记录将会保留。

执行按日期分组，每个执行都会显示下面的信息：

• 代表规则集的触发事件和执行状态的图标。执行状态有完成 和异常 等。
• 规则集的运行时间。
• 规则集在系统还是特定作业上运行以及作业名。

两天后成功完成的执行将自动从数据库中删除。 四天后完成但有异常的执行将自动从数据库中删除。 尚未完成的执行（例如，因为规则集包括计时器操作，将执行完成延迟到四天以上）不会删除，即使执行是在四天前开始的。
如果某个已启用规则集的执行于您在规则调试器中查看其执行历史记录期间完成，规则集执行历史记录窗格中的执行列表将自动更新。
选定一个执行后，执行路径窗格将列出选定执行期间触发的所有事件和发生的所有操作。
同时，工作区（右上窗格）将提供该规则集和选定执行历史记录的图形演示。选定规则集中的某个操作后，会在执行路径窗格中选定相应的规则。同样，在单击规则集中的某个操作后，从规则集到选定执行的该操作的路径将以蓝色高亮显示，即使当执行路径跨过规则集内的规则链时也如此。在选定执行显示为灰色期间，不触发任何操作。
如果您选择了仍在进行中的执行，然后该执行在您查看它时完成，那么工作区中显示的执行跟踪将自动更新。如果执行遇到多个暂停点（例如，规则集包含一个在 5 天后存档分色的计数器操作和在 10 天后清除存档分色的另一个计时器操作），那么工作区会在到达第一个暂停点（示例中的第一个计时器操作）时显示该执行，但是在执行完成前不会再次更新。
当您在执行路径窗格中选择某个规则或在工作区中选择某个操作时，规则调试器底部的事件和操作选项卡将显示有关选定操作实例和触发该操作的事件的信息。有关详细信息，请参见Viewing a rule set's execution details。
注： 请注意，规则集执行历史记录窗格还会显示 XML 验证错误。例如，如果编写的 XML 不符合模式，而使用读 XML 操作进行验证，则印能捷在读取 XML 文件时将失败，规则集执行历史记录窗格中将显示带红叉的信息。

Puede revisar el historial de ejecución de un conjunto de reglas en el Depurador de reglas para determinar en qué punto, y por qué razón, una ejecución concreta ha tenido problemas.
Cada vez que se ejecuta un conjunto de reglas, la información sobre cada evento y acción que se produce como parte de esa ejecución concreta se almacena en la base de datos del sistema Prinergy. Posteriormente puede ver los detalles de cualquier ejecución particular de un conjunto de reglas en el Depurador de reglas. Esto resulta especialmente útil si desea comprender en qué lugar y por qué razón falló o se detuvo una ejecución.

Cuando se abre un conjunto de reglas en el Depurador de reglas, en el panel Historial de ejecución del conjunto de reglas se muestra cada ejecución del conjunto que se ha producido desde que éste se modificó por última vez. La ejecución más reciente está seleccionada.
Nota: El historial de ejecución sólo se conserva desde la última vez que se modificó el conjunto de reglas. Si el panel Historial de ejecución del conjunto de reglas está vacío, indica que el conjunto de reglas no se ha ejecutado nunca o que no se ha ejecutado desde la última vez que se modificó. Si desea conservar el historial después de modificar el conjunto de reglas, haga una copia del conjunto de reglas, modifíquelo y use la función How Swap para sustituir el antiguo por el nuevo. El conjunto de reglas antiguo cambiará de nombre y su historial de ejecución se conservará.

Las ejecuciones se agrupan por fecha y se muestra la siguiente información para cada ejecución:

• Iconos que representan el evento desencadenante del conjunto de reglas y el estado de ejecución. Algunos ejemplos de estados de ejecución son Listo y Excepción .
• La hora a la que se ejecutó el conjunto de reglas.
• Si el conjunto de reglas se ejecutó en el nivel del sistema o en un trabajo particular, así como el nombre del trabajo.

Las ejecuciones que se completan correctamente se eliminan de forma automática de la base de datos una vez transcurridos dos días. Las ejecuciones que se completan con una excepción se eliminan automáticamente una vez transcurridos cuatro días. Las ejecuciones que aún no se han completado (por ejemplo, porque el conjunto de reglas contiene una acción Temporizador que retrasa la finalización de la ejecución más de cuatro días) no se eliminan, aun cuando la ejecución se haya iniciado hace más de cuatro días.
Si la ejecución de un conjunto de reglas activado se completa mientras está consultando el historial en el Depurador de reglas, la lista de ejecuciones del panel Historial de ejecución del conjunto de reglas se actualiza automáticamente.

Cuando selecciona una ejecución, el panel Ruta de ejecución muestra todos los eventos que se han desencadenado y cada acción que se ha producido durante la ejecución seleccionada.
Por su parte, en el espacio de trabajo (el panel superior derecho) muestra una representación gráfica del conjunto de reglas y del historial de ejecución seleccionado. Cuando selecciona una acción en el conjunto de reglas, el conjunto correspondiente se selecciona en el panel Ruta de ejecución. Asimismo, si hace clic en una acción del conjunto de reglas, la ruta por el conjunto de reglas hasta esa acción para la ejecución seleccionada se destaca en azul, incluso cuando la ruta de ejecución se reparte por cadenas de reglas del conjunto. Las acciones que no se han desencadenado durante la ejecución seleccionada se muestran en gris.

Si selecciona una ejecución que sigue en curso y dicha ejecución se completa mientras la está viendo, el rastro de la ejecución mostrado en el espacio de trabajo se actualiza automáticamente. Si la ejecución encuentra varios puntos de pausa (por ejemplo, si el conjunto de reglas incluye una acción Temporizador para archivar separaciones pasados cinco días y otra acción Temporizador para vaciar las separaciones archivadas después de 10 días), el espacio de trabajo mostrará la ejecución hasta que encuentre el primer punto de pausa (el primer Temporizador del ejemplo), pero no se actualizará hasta que se complete la ejecución.

Cuando selecciona una regla en el panel Ruta de ejecución o una acción en el espacio de trabajo, las fichas Evento y Acción de la parte inferior del Depurador de reglas muestran información sobre la instancia seleccionada de la acción y el evento que la desencadenó. Para más información, consulte Viewing a rule set's execution details.
Nota: Tenga en cuenta que el panel Historial de ejecución del conjunto de reglas también muestra los errores de validación de XML. Por ejemplo, si escribe código XML que no se adhiera al esquema y lo valida mediante la acción Leer XML, Prinergy fallará al leer el archivo XML y la información se mostrará en el panel Historial de ejecución del conjunto de reglas con una cruz roja.

Vous pouvez afficher l'historique d'exécution d'un jeu de règles dans le Débogueur de règles pour déterminer à quel point, et pourquoi, une exécution particulière a rencontré des problèmes.
Chaque fois qu'un jeu de règles est exécuté, les informations relatives à chaque événement et chaque action qui se sont produits lors de cette exécution particulière sont stockés dans la base de données du système Prinergy. Vous pouvez ensuite afficher les détails relatifs à n'importe quelle exécution particulière d'un jeu de règles dans le Débogueur de règles. Cela est particulièrement utile lorsque vous souhaitez connaître l'endroit où et la raison pour laquelle une exécution a échoué ou a été arrêtée.

Lorsque vous ouvrez un jeu de règles dans le Débogueur de règles, le volet Historique d'exécution du jeu de règles répertorie chaque exécution du jeu de règles qui s'est produite depuis sa dernière modification. L'exécution la plus récente est sélectionnée.
Remarque : L'historique d'exécution est conservé uniquement depuis la dernière modification du jeu de règles. Si le volet Historique d'exécution du jeu de règles est vide, soit le jeu de règles n'a jamais été exécuté, soit celui-ci n'a pas été exécuté depuis sa dernière modification. Si vous souhaitez conserver l'historique d'exécution d'un jeu de règles après avoir modifié ce dernier, effectuez une copie du jeu de règles, modifiez-le, puis utilisez la fonction de remplacement à chaud pour remplacer l'ancien par le nouveau. L'ancien jeu de règles est renommé et son historique d'exécution est conservé.

Les exécutions sont regroupées par date et les informations suivantes apparaissent pour chaque exécution :

• Des icônes représentant l'événement de démarrage du jeu de règles et son état d'exécution. Terminé et Exception sont des exemples d'états d'exécution.
• La date et l'heure à laquelle le jeu de règles a été exécuté.
• Si le jeu de règles a été exécuté au niveau du système ou dans un travail particulier et le nom de ce travail.

Les exécutions réalisées avec succès sont automatiquement supprimées de la base de données au bout de deux jours. Les exécutions ayant généré une exception sont automatiquement supprimées au bout de quatre jours. Une exécution qui n'est pas encore terminée (par exemple, parce que le jeu de règles inclut une action Temporisateur qui retarde la fin de l'exécution pendant plus de quatre jours) n'est pas supprimée, même si celle-ci a commencé il y a plus de quatre jours.

Si une exécution d'un jeu de règles activé se termine alors que vous affichez l'historique d'exécution de ce dernier dans le Débogueur de règles, la liste des exécutions dans le volet Historique d'exécution du jeu de règles est automatiquement mise à jour.
Lorsque vous sélectionnez une exécution, le volet Chemin d'exécution répertorie chaque événement qui a été démarré et chaque action qui s'est produite lors de l'exécution sélectionnée.
Pendant ce temps, l'espace de travail (le volet supérieur droit) fournit une représentation graphique du jeu de règles et de l'historique d'exécution sélectionné. Lorsque vous sélectionnez une action dans le jeu de règles, la règle correspondante est sélectionnée dans le volet Chemin d'exécution. De la même manière, lorsque vous cliquez sur une action dans le jeu de règles, le chemin du jeu de règles vers cette action pour l'exécution sélectionnée est mis en surbrillance en bleu, même lorsque celui-ci couvre les chaînes de règles du jeu de règles. Toute action non démarrée lors de l'exécution sélectionnée apparaît en gris.

Si vous sélectionnez une exécution encore en cours et que celle-ci se termine alors que vous la visualisez, la trace d'exécution affichée dans l'espace de travail est automatiquement mise à jour. Si l'exécution rencontre plusieurs points d'interruption (par exemple, le jeu de règles inclut une action Temporisateur pour archiver les sélections après cinq jours et une autre action Temporisateur pour purger les sélections archivées après 10 jours), l'espace de travail affiche l'exécution lorsque celle-ci atteint le premier point d'interruption (la première action Temporisateur dans l'exemple) mais n'est pas remis à jour jusqu'à ce que l'exécution soit terminée.

Lorsque vous sélectionnez une règle dans le volet Chemin d'exécution ou une action dans l'espace de travail, les volets Événement et Action au bas du Débogueur de règles affichent des informations relatives à l'instance sélectionnée de l'action et de l'événement qui l'a déclenchée. Pour plus d'informations, consultez la section Viewing a rule set's execution details.
Remarque : Remarque : le panneau Historique d'exécution du jeu de règles affiche également les erreurs de validation XML. Par exemple, si vous écrivez XML qui n'adhère pas au schéma, et que vous validez en utilisant l'action LireXML, Prinergy échouera à la lecture du fichier XML et les informations seront affichées sur le panneau Historique d'exécution du jeu de règles avec une croix rouge.

ルール デバッガでルール セットの実行履歴を表示し、特定の実行で生じた問題の発生場所と原因を明らかにすることができます。
ルール セットが実行されるたびに、Prinergy システムのデータベースにはその特定の実行の一部として発生した各イベントとアクションに関する情報が保存されます。後でルール デバッガを使用して、ルール セットの特定の実行に関する詳細を表示することができます。これは、実行の失敗や停止の場所と原因を把握する場合に特に有用です。

ルール デバッガでルール セットを開くと、ルール セットの実行履歴ウィンドウにはそのルール セットの最後の変更より後に行われたルール セットの実行がすべて表示されます。最も最近の実行が選択されています。
注: 保持される実行履歴は、ルール セットの最後の変更より後のものに限られます。ルール セットの実行履歴ウィンドウに何も表示されていない場合、そのルール セットは実行されたことがないか、または最後の変更以降に実行されていません。ルール セットの実行履歴をルール セットの変更後も保管する場合、ルール セットのコピーを作成してから変更し、ホット スワップを使用して古いルール セットを新しいルール セットに置き換えます。古いルール セットは名前が変更されますが、その実行履歴は失われません。

実行は日付でグループ化され、次の情報が実行ごとに表示されます。

• ルール セットのトリガ イベントを表すアイコンと実行ステータス。実行ステータスの例には、完了 や例外 があります。
• ルール セットが実行された時刻。
• ルール セットがシステム レベルで実行されたか、特定のジョブ（ジョブ名）で実行されたかが表示されます。

正常に終了した実行は、2 日後に自動的にデータベースから削除されます。 例外が発生した実行は、4 日後に自動的に削除されます。 まだ完了していない実行（ルール セットにタイマー アクションが含まれ、その実行が 4 日より後に完了するように設定されている場合など）は、その実行の開始から 4 日以上経過していても削除されません。
有効なルール セットの実行がそのルール セットの実行履歴をルール デバッガで表示しているときに完了した場合、ルール セットの実行履歴ウィンドウの実行リストは自動的に更新されます。
ある実行を選択すると、実行のパスウィンドウにはその実行中にトリガされた各イベントと発生した各アクションが表示されます。
同時に、作業領域（右上のウィンドウ）にはルール セットと選択した実行の履歴がグラフィックで表示されます。ルール セット内のアクションを選択すると、対応するルールが実行のパスウィンドウ内で選択されます。また、ルール セット内のアクションをクリックすると、ルール セット内を進み、選択した実行のアクションに至るパスが、その実行パスがルール セット内の複数のルールにわたる場合にも青色で強調表示されます。選択した実行の最中にトリガされていないアクションについては、グレーで表示されます。
現在進行中の実行を選択し、表示しているときにその実行が完了した場合は、作業領域に表示される実行記録は自動的に更新されます。実行が複数の一時停止ポイントで中断される場合（ルール セット内のあるタイマーアクションでは色版を 5 日後にアーカイブし、別のタイマーアクションではアーカイブした色版を 10 日後にパージする場合など）、作業領域には、実行が最初の一時停止ポイント（この例の最初のタイマーアクション）に到達していることが表示されますが、実行が完了するまでは再び更新されません。
実行のパスウィンドウでルールを選択するか、作業領域でアクションを選択すると、ルール デバッガ下部のイベントタブおよびアクションタブに、選択したインスタンスに関する情報がアクションおよびこれをトリガしたイベントとして表示されます。詳細については、Viewing a rule set's execution detailsを参照してください。
注: ルール セットの実行履歴ウィンドウには XML 評価エラーも表示されます。たとえば、スキーマに準拠しない XML を記述して、XML の読み取りアクションを使用して評価を行うと、Prinergy で XML ファイルの読み取りエラーが発生し、ルール セットの実行履歴ウィンドウに赤い×印が付いた情報が表示されます。