Page History

One problem with handling exceptions is that the name of the rule set is not readily available the way the name of the rule is. As a result it may not be obvious which rule set an exception is originating in. With the introduction of rule set variables it is now possible to create a string rule set variable that contains the name of the rule set. The name of the rule set can then be included in the logging of the exception by referencing the rule set variable.

To create a string rule set variable that contains the name of a rule set:

1. Open the rule set in Rule Builder.
2. Open the Manage Variables Editor: in Rule Builder, from the Edit menu, select Manage Variables.
3. In the Manage Variables Editor, select the Rule Set Variables tab.
4. Click the Add Variables button.
5. In the Name column, type Rule_Set_Name.
6. In the Data Type column, select String.
7. In the Current Value column, type the actual name of the rule set.
8. Click OK.

Anywhere an exception is logged or reported, the #Rule_Set_Name variable can now be referenced to include the name of the rule set.

For example, to include the rule set name in an email subject line, the Subject parameter of the Send Email action could be:

Rule set: %#Rule_Set_Name% rule: %triggerEvent.RuleName% failed

A limitation of this approach is that you are responsible for keeping the value of the variable accurate because the name of the rule set stored in the variable does not get updated automatically when the rule set is renamed or copied.

Ein Problem beim Behandeln von Ausnahmen ist, dass der Name der Regelsammlung nicht so einfach verfügbar ist wie der Name der Regel. Aus diesem Grund ist eventuell nicht eindeutig erkennbar, in welcher Regelsammlung eine Ausnahme vorkommt. Mit der Einführung der Regelsammlungsvariablen ist es jetzt möglich, eine String-Regelsammlungsvariable zu erstellen, die den Namen der gewünschten Regelsammlung enthält. Der Namen der Regelsammlung kann dann in die Protokollierung der Ausnahme durch einen Verweis auf die Regelsammlungsvariable aufgenommen werden.

1. Öffnen Sie die Regelsammlung im Regelgenerator.
2. Öffnen Sie den Editor zum Verwalten von Variablen: Wählen Sie im Regelgenerator aus dem Menü Bearbeiten Variablen verwalten aus.
3. Im Editor zum Verwalten von Variablen wählen Sie die Registerkarte Regelsammlungsvariablen aus.
4. Klicken Sie auf die Schaltfläche Variable hinzufügen.
5. Geben Sie in der Spalte Name Rule_Set_Name ein.
6. In der Spalte Datentyp wählen Sie String aus.
7. In der Spalte aktueller Wert geben Sie den Namen der Regelsammlung ein.
8. Klicken Sie auf OK.

Wenn eine Ausnahme protokolliert oder gemeldet wird, kann nun auf die Variable #Rule_Set_Name verwiesen werden, um den Namen der Regelsammlung einzuschließen.
Um zum Beispiel den Regelsammlungsnamen in einer E-Mail-Betreffzeile einzuschließen, könnte der Parameter Betreff der Aktion E-Mail senden folgendermaßen aussehen:
Rule set: %#Rule_Set_Name% rule: %triggerEvent.RuleName% failed
Eine Einschränkung dieses Ansatzes ist, dass Sie dafür verantwortlich sind, den Wert der Variable immer zu aktualisieren, da der Namen der Regelsammlung, der in der Variable gespeichert ist, nicht automatisch aktualisiert wird, wenn die Regelsammlung umbenannt oder kopiert wird.

处理异常的一个问题是，规则集的名称并不像规则名称那样随时可用。 因此异常源自哪个规则集可能不明显。 通过引入规则集变量，现在可以创建一个字符串规则集变量，用于包含规则集的名称。 然后可通过引用规则集变量将规则集名称包括到异常日志中。

1. 在规则生成器中打开规则集。
2. 打开"管理变量编辑器"：在规则生成器的编辑菜单中，选择管理变量。
3. 在"管理变量编辑器"中，选择规则集变量选项卡。
4. 单击添加变量按钮。
5. 在名称列中，键入 Rule_Set_Name。
6. 在数据类型列中，选择字符串。
7. 在当前值列中，键入规则集的实际名称。
8. 单击确定。

只要记录或报告了异常，现在就可以引用 #Rule_Set_Name 变量以包括规则集的名称。
例如，要在电子邮件的主题行中包括规则集名称，发送电子邮件操作的主题参数可以是：
Rule set: %#Rule_Set_Name% rule: %triggerEvent.RuleName% failed
这种方法的局限在于，您需要负责使变量的值保持准确，因为在重命名或复制规则集时，存储在变量中的规则集名称不会自动更新。

Un problema que se plantea con el manejo de excepciones es que el nombre del conjunto de reglas no suele estar tan fácilmente disponible como el nombre de la regla. En consecuencia, es posible que no resulte obvio en qué conjunto de reglas se está originando una excepción. Con la introducción de las variables del conjunto de reglas se puede crear una variable de conjunto de reglas de cadena que contenga el nombre del conjunto de reglas. El nombre del conjunto de reglas se puede incluir, de esta forma, en el registro de la excepción al hacer referencia a la variable del conjunto de reglas.

1. Abra el conjunto de reglas en el Generador de reglas.
2. Abra el Editor de administración de reglas: en el Generador de reglas, en el menú Editar, seleccione Gestionar variables.
3. En el Editor de administración de variables, seleccione la ficha Variables del conjunto de reglas.
4. Haga clic en el botón Agregar variables.
5. En la columna Nombre, escriba Rule_Set_Name.
6. En la columna Tipo de datos, seleccione Cadena.
7. En la columna Current Value (Valor actual), escriba el nombre real del conjunto de reglas.
8. Haga clic en Aceptar.

En cualquier lugar que se registra una excepción o se informa de ella ahora se puede hacer referencia a la variable #Rule_Set_Name para que incluya el nombre del conjunto de reglas.
Por ejemplo, para incluir el nombre del conjunto de reglas en la línea de asunto del correo electrónico, el parámetro Asunto de la acción Enviar correo electrónico podría ser:
Rule set: %#Rule_Set_Name% rule: %triggerEvent.RuleName% failed
Una limitación de este método es que el usuario debe mantener la precisión del valor de la variable, porque el nombre del conjunto de reglas almacenado en la variable no se actualiza automáticamente cuando el nombre del conjunto de reglas se cambia o se copia.

En cas d'exceptions, le nom du jeu de règles n'est pas aussi facilement identifiable que le nom de la règle. Ainsi, il peut être difficile de savoir de quel jeu de règles provient une exception donnée. Grâce aux variables de jeu de données, il est désormais possible de créer une variable de jeu de règles de type chaîne contenant le nom du jeu de règles. Le nom du jeu de règles peut ensuite être inclus dans la consignation de l'exception en référençant la variable de jeu de règles.

1. Ouvrez le jeu de règles dans le Créateur de règles.
2. Ouvrez le Gestionnaire de variables : dans le Créateur de règles, ouvrez le menu Édition, puis sélectionnez Gérer les variables.
3. Dans le Gestionnaire de variables, sélectionnez l'onglet Variables de jeu de règles.
4. Cliquez sur le bouton Ajouter une variable.
5. Dans la colonne Nom, saisissez Rule_Set_Name.
6. Dans la colonne Type de données, sélectionnez Chaîne.
7. Dans la colonne Valeur actuelle, saisissez le nom du jeu de règles.
8. Cliquez sur OK.

La variable #Rule_Set_Name peut désormais être référencée partout où une exception est consignée ou signalée afin d'inclure le nom du jeu de règles.
Par exemple, pour inclure le nom du jeu de règles dans la ligne d'objet d'un courrier électronique, le paramètre Objet de l'action Envoyer un message électronique peut être :
Rule set: %#Rule_Set_Name% rule: %triggerEvent.RuleName% failed
La limite de cette méthode est que vous devez vous assurer que la valeur de la variable est correcte, car le nom du jeu de règles stocké dans la variable n'est pas automatiquement mis à jour lorsque le jeu de règles est renommé ou copié.

例外を処理するときの問題の 1 つは、ルール セットの名前がルールの名前と同じようにすぐに使用できないことです。 結果として、例外の発生元のルール セットが明白ではない場合があります。 ルール セット変数が導入されてから、ルール セットの名前が含まれる文字列ルール セット変数を作成できるようになりました。 ルール セット変数を参照することによって、ルール セットの名前を例外のログに含めることができます。

1. ルール ビルダでルール セットを開きます。
2. ルール ビルダで、編集メニューの変数の管理を選択し、変数エディタを開きます。
3. 変数エディタで、ルール セット変数タブを選択します。
4. 変数の追加ボタンをクリックします。
5. 名前列にRule_Set_Nameを入力します。
6. データ タイプ列で、文字列を選択します。
7. 現在の値列に、ルール セットの実際の名前を入力します。
8. OKをクリックします。

これで、例外がログに記録されるか報告されるときにはいつでも、#Rule_Set_Name変数を参照してルール セットの名前を含めることができるようになります。
たとえば、電子メールの件名行にルール セット名を含めるには、電子メールの送信アクションの件名パラメータを次のように指定します。
Rule set: %#Rule_Set_Name% rule: %triggerEvent.RuleName% failed
ルール セットの名前が変更されたりコピーされたりしたときに、変数に格納されているルール セットの名前は自動的に更新されないので、この方法には、正確な変数の値をユーザーが維持しなければならないという制限があります。