Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space PRINSAG and version 9.0
Sv translation
languageen

Experienced programmers can write code to customize the Rule Parameters Editor.
If you know how to write in a programming language that the Microsoft .NET Framework supports, such as Microsoft Visual Basic, C#, or C++, you can use it to assign values to parameters.
The Visual Basic language is supported natively in the RBA software. You can also use other languages, as long as you create the code libraries externally and then import the managed .dll file.
Note: If you use unmanaged .dll files, the .NET Framework does not provide feedback to the RBA system about exceptions. You must troubleshoot any code problem yourself.

 

Writing code is useful when you want do things that are not possible in Rule Parameters Editor. The basic constructs for storing code in an RBA rule are:

  • Parameter assignments: Most RBA actions are parameter assignments. Custom coding allows you to specify how the action parameters obtain their values. The code is stored in a subroutine called ConfigureAction().
  • Branches: The Branch type of action uses simple Boolean expressions to get a true/false result. You can code your own condition logic. The code is stored in a subroutine called ConfigureAction().
  • Filters: The Filter type of action builds a list of objects that match a certain set of conditions. You can code your own selection criteria. The code is stored in a subroutine called ConfigureAction().
  • User Defined: The User Defined type of action is a simple container for any code. You control what code is executed and which resulting events are raised. The code is stored in a subroutine called Run().

The Rule Engine only executes code in the ConfigureAction() and Run() subroutines. This code is wrapped invisibly in the supporting code for the Rule Engine. You cannot add your own import statements, and you must refer explicitly to object types by namespace.
You can create and load your own code libraries in your RBA code. This is useful for re-using code in more than one place and allows you to work in programming languages other than Visual Basic.


 Writing code

Parameter Code Editor includes tools to help you write code. If you are more comfortable using another tool, such as Microsoft Visual Studio or a text editor, you can write code in it and then copy and paste the code into Parameter Code Editor.


 Removing code

If you later decide to stop using code for a particular event-action pair, right-click the line between the event and action, and select Reset to Default.

Sv translation
languagede

Erfahrene Programmierer können Code schreiben, mit dem sie den Regelparameter-Editor anpassen.
Wenn Sie eine Programmiersprache beherrschen, die von Microsoft .NET Framework unterstützt wird, z. B. Microsoft Visual Basic, C# oder C++, können Sie auf diese Weise Werte zu Parametern zuordnen.
Die Sprache Visual Basic wird von der RBA-Software standardmäßig unterstützt. Sie können auch andere Sprachen verwenden, sofern Sie die Codebibliotheken extern erstellen und anschließend die verwaltete .dll-Datei importieren.
Anmerkung: Wenn Sie nicht verwaltete .dll-Dateien verwenden, liefert .NET Framework keine Rückmeldung zu Ausnahmen an das RBA-System. Sie müssen sämtliche Codeprobleme selbst beheben.
Das Schreiben von Code ist sinnvoll, wenn Sie Arbeitsschritte ausführen möchten, die im Regelparameter-Editor nicht möglich sind. Die Grundelemente für das Speichern von Code in einer RBA-Regel sind folgende:

  • Anchor
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Anchor
    Bookmark167_concept2023__li_C516E535D9DC
    Bookmark167_concept2023__li_C516E535D9DC
    Parameterzuweisungen: Die meisten RBA-Aktionen sind Parameterzuweisungen. In eigenem Code können Sie festlegen, wie die Aktionsparameter ihre Werte erhalten. Der Code wird in der Unterroutine ConfigureAction() gespeichert.
  • Anchor
    Bookmark167_concept2023__li_55B8ED363D59
    Bookmark167_concept2023__li_55B8ED363D59
    Zweige: In Aktionen vom Typ „Zweig" werden einfache boolesche Ausdrücke verwendet, die das Ergebnis „wahr" oder „falsch" ausgeben. Im Code können Sie Ihre eigene Bedingungslogik verwenden. Der Code wird in der Unterroutine ConfigureAction() gespeichert.
  • Anchor
    Bookmark167_concept2023__li_FB4049D12CBA
    Bookmark167_concept2023__li_FB4049D12CBA
    Filter: Mit Aktionen vom Typ „Filter" wird eine Liste von Objekten erstellt, die bestimmte Bedingungen erfüllen. Im Code können Sie Ihre eigenen Auswahlkriterien verwenden. Der Code wird in der Unterroutine ConfigureAction() gespeichert.
  • Anchor
    Bookmark167_concept2023__li_04B9D87ECC89
    Bookmark167_concept2023__li_04B9D87ECC89
    Benutzerdefiniert: Aktionen vom Typ „Benutzerdefiniert" sind ein einfacher Container für beliebigen Code. Sie bestimmen, welcher Code ausgeführt wird und welche Folgeereignisse ausgelöst werden. Der Code wird in der Unterroutine Run() gespeichert.

Das Regelmodul führt nur Code aus, der in den Unterroutinen ConfigureAction() und Run() gespeichert ist. Dieser Code ist unsichtbar in den unterstützenden Code für das Regelmodul eingeschlossen. Sie können keine eigenen Importanweisungen hinzufügen, und Sie müssen auf Objekttypen explizit anhand des Namespace verweisen.
Im RBA-Code können Sie Ihre eigenen Codebibliotheken erstellen und laden. Dies empfiehlt sich, wenn Sie Code an mehreren Stellen wiederverwenden möchten und ermöglicht die Arbeit in anderen Programmiersprachen als Visual Basic.

Anchor
Bookmark167_concept2023__section_CC197A4
Bookmark167_concept2023__section_CC197A4
Schreiben von Code
Der Parameter-Code-Editor enthält Werkzeuge zum Schreiben von Code. Wenn Sie eine andere Anwendung (z. B. Microsoft Visual Studio oder einen Text-Editor) bevorzugen, können Sie den Code darin schreiben und anschließend in den Parameter-Code-Editor kopieren.
Anchor
Bookmark167_concept2023__section_A7B9053
Bookmark167_concept2023__section_A7B9053
Entfernen von Code
Wenn Sie später Code für ein bestimmtes Ereignis-Aktion-Paar nicht mehr verwenden möchten, klicken Sie mit der rechten Maustaste auf die Linie zwischen dem Ereignis und der Aktion und wählen dann Auf Standardeinstellung zurücksetzen.

Sv translation
languagezh

有经验的程序员可以编写代码来自定义规则参数编辑器。
如果您知道如何使用 Microsoft .NET Framework 支持的编程语言(例如,Microsoft Visual Basic、C# 或 C++)进行编写,则可以使用它来指定参数的值。
RBA 软件本身支持 Visual Basic 语言。您也可以使用其他语言,只要在外部创建代码库,然后导入托管的 .dll 文件即可。
注: 如果使用非托管 .dll 文件,则 .NET Framework 不会为 RBA 系统提供关于异常的反馈。对于任意代码问题,您都必须自己解决。
当您想要做在规则参数编辑器中无法完成的事时,编写代码是很有用的。在 RBA 规则中存储代码的基本结构有:

  • Anchor
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Anchor
    Bookmark167_concept2023__li_C516E535D9DC
    Bookmark167_concept2023__li_C516E535D9DC
    参数赋值:大多数 RBA 操作都是参数赋值。自定义编码使您可以指定操作参数如何获取它们的值。代码存储在名为 ConfigureAction() 的子例程中。
  • Anchor
    Bookmark167_concept2023__li_55B8ED363D59
    Bookmark167_concept2023__li_55B8ED363D59
    分支:分支类型的操作使用简单的布尔型表达式来获取 true/false 结果。您可以编写自己的条件逻辑。代码存储在名为 ConfigureAction() 的子例程中。
  • Anchor
    Bookmark167_concept2023__li_FB4049D12CBA
    Bookmark167_concept2023__li_FB4049D12CBA
    过滤器:过滤器类型的操作构造与一组特定条件匹配的对象列表。您可以编写自己的选择条件代码。代码存储在名为 ConfigureAction() 的子例程中。
  • Anchor
    Bookmark167_concept2023__li_04B9D87ECC89
    Bookmark167_concept2023__li_04B9D87ECC89
    用户定义:用户定义类型的操作是任意代码的简单容器。您可以控制执行的代码以及产生的相应结果事件。代码存储在名为 Run() 的子例程中。

规则引擎只会执行 ConfigureAction() 和 Run() 子例程中的代码。该代码以不可见的方式打包在规则引擎的支持代码中。您不能添加自己的导入语句,并且必须通过名称空间显式引用对象类型。
您可以在 RBA 代码中创建和加载自己的代码库。这对于在多个位置复用代码非常有用,使您可以使用 Visual Basic 之外的其他编程语言。

Anchor
Bookmark167_concept2023__section_CC197A4
Bookmark167_concept2023__section_CC197A4
编写代码
参数代码编辑器包含可帮助您编写代码的工具。如果您感觉使用其他工具(比如 Microsoft Visual Studio 或文本编辑器)更加方便,也可以使用其他工具编写代码,然后将代码复制并粘贴到参数代码编辑器。
Anchor
Bookmark167_concept2023__section_A7B9053
Bookmark167_concept2023__section_A7B9053
移除代码
如果您稍后决定对特定的事件操作对停止使用代码,请右键单击事件和操作之间的连线,并选择恢复为默认值

Sv translation
languagees

Los programadores que cuenten con la experiencia necesaria pueden escribir código para personalizar el Editor de parámetros de regla.
Si sabe cómo escribir en un lenguaje de programación compatible con Microsoft .NET Framework como, por ejemplo, Microsoft Visual Basic, C# o C++, podrá servirse de él para asignar valores a los parámetros.
El lenguaje Visual Basic es compatible de forma nativa con el software RBA. También podrá usar otros lenguajes siempre que cree externamente las bibliotecas de código y, a continuación, importe el archivo .dll gestionado.
Nota: Si utiliza archivos .dll sin gestionar, .NET Framework no proporcionará comentarios al sistema RBA acerca de las excepciones. Deberá solucionar usted mismo cualquier problema relacionado con el código.
Escribir código resulta útil para hacer cosas que no son posibles en el Editor de parámetros de regla. Los constructores básicos para almacenar código en una regla de RBA son:

  • Anchor
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Anchor
    Bookmark167_concept2023__li_C516E535D9DC
    Bookmark167_concept2023__li_C516E535D9DC
    Asignaciones de parámetros: la mayoría de las acciones de RBA son asignaciones de parámetros. El uso de código personalizado permite especificar cómo obtienen sus valores los parámetros de acción. El código se almacena en una subrutina llamada ConfigureAction().
  • Anchor
    Bookmark167_concept2023__li_55B8ED363D59
    Bookmark167_concept2023__li_55B8ED363D59
    Circuitos derivados: el tipo de acción Circuito derivado utiliza expresiones booleanas sencillas para obtener un resultado de verdadero o falso. Puede codificar su propia lógica de condiciones. El código se almacena en una subrutina llamada ConfigureAction().
  • Anchor
    Bookmark167_concept2023__li_FB4049D12CBA
    Bookmark167_concept2023__li_FB4049D12CBA
    Filtros: el tipo de acción Filtro genera una lista de objetos que coinciden con un cierto conjunto de condiciones. Puede codificar sus propios criterios de selección. El código se almacena en una subrutina llamada ConfigureAction().
  • Anchor
    Bookmark167_concept2023__li_04B9D87ECC89
    Bookmark167_concept2023__li_04B9D87ECC89
    Definida por el usuario: el tipo de acción Definida por el usuario es un contenedor sencillo de cualquier código. Es el usuario el que controla qué código se ejecuta y qué eventos resultantes de generan. El código se almacena en una subrutina llamada Run().

El Motor de reglas sólo ejecuta código en las subrutinas ConfigureAction() y Run(). Este código está envuelto de forma invisible en el código que da soporte para el Motor de reglas. No es posible agregar sus propias declaraciones de importación y es necesario referirse explícitamente a tipos de objetos mediante un espacio de nombre.
Puede crear y cargar sus propias bibliotecas de código en el código RBA. Esto resulta útil para volver a utilizar el código en más de un sitio y permite trabajar en lenguajes de programación distintos de Visual Basic.

Anchor
Bookmark167_concept2023__section_CC197A4
Bookmark167_concept2023__section_CC197A4
Escribir código
El Editor de código de parámetros incluye herramientas que le ayudarán a escribir código. Si prefiere utilizar otra herramienta, como Microsoft Visual Studio o un editor de texto, puede escribir el código en ella y, a continuación, copiar y pegar el código en el Editor de código de parámetros.
Anchor
Bookmark167_concept2023__section_A7B9053
Bookmark167_concept2023__section_A7B9053
Eliminar código
Si más adelante decide dejar de utilizar código para un par de acción-evento determinado, haga clic con el botón secundario del ratón en la línea situada entre el evento y la acción, y seleccione Recuperar valores predeterminados.

Sv translation
languagefr

Les programmateurs expérimentés peuvent écrire un code pour personnaliser l'Éditeur de paramètres de règles.
Si vous savez écrire dans un langage de programmation, tel que Microsoft Visual Basic, C# ou C++, pris en charge par le logiciel Microsoft .NET framework, vous pouvez l'utiliser pour attribuer des valeurs aux paramètres.
Le langage Visual Basic est à l'origine pris en charge par le logiciel RBA. Vous pouvez également utiliser d'autres langages, du moment que vous créez des bibliothèques de codes à l'extérieur et que vous importez ensuite le fichier géré .dll.
Remarque : Si vous utilisez des fichiers .dll non gérés, .NET Framework ne transmet pas au système RBA les rétroactions concernant les exceptions. Vous devez résoudre tout problème de code par vous-même.
L'écriture du code est utile lorsque vous souhaitez exécuter des actions qui ne sont pas possibles dans l'Éditeur de paramètres de règles. Les constructions de base pour stocker un code dans une règle RBA sont :

  • Anchor
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Anchor
    Bookmark167_concept2023__li_C516E535D9DC
    Bookmark167_concept2023__li_C516E535D9DC
    Affectations de paramètres : la plupart des actions RBA sont des affectations de paramètres. Le codage personnalisé vous permet d'indiquer comment les paramètres d'action obtiennent leurs valeurs. Le code est stocké dans un sous-programme nommé ConfigureAction().
  • Anchor
    Bookmark167_concept2023__li_55B8ED363D59
    Bookmark167_concept2023__li_55B8ED363D59
    Dérivations : le type d'action Dérivation utilise des expressions booléennes simples pour obtenir un résultat vrai/faux. Vous pouvez coder votre propre logique de condition. Le code est stocké dans un sous-programme nommé ConfigureAction().
  • Anchor
    Bookmark167_concept2023__li_FB4049D12CBA
    Bookmark167_concept2023__li_FB4049D12CBA
    Filtres : le type d'action Filtre génère une liste d'objets correspondant à un certain jeu de conditions. Vous pouvez coder vos propres critères de sélection. Le code est stocké dans un sous-programme nommé ConfigureAction().
  • Anchor
    Bookmark167_concept2023__li_04B9D87ECC89
    Bookmark167_concept2023__li_04B9D87ECC89
    Défini par l'utilisateur : le type d'action Défini par l'utilisateur permet de stocker facilement n'importe quel code. Vous contrôlez le code qui est exécuté et les événements résultant qui sont déclenchés. Le code est stocké dans un sous-programme nommé Run().

Le Moteur de règles exécute uniquement un code dans les sous-programmes ConfigureAction() et Run(). Ce code est dissimulé dans le code de support du Moteur de règles. Vous ne pouvez pas ajouter vos déclarations d'importation personnelles et vous devez faire explicitement référence aux types d'objets par espace de noms.
Vous pouvez créer et charger vos propres bibliothèques de codes dans votre code RBA. Cette fonction est utile pour réutiliser un code à plusieurs endroits et vous permet de travailler dans des langages de programmation autre que Visual Basic.

Anchor
Bookmark167_concept2023__section_CC197A4
Bookmark167_concept2023__section_CC197A4
Écrire un code
L'Éditeur de code de paramètre comprend des outils pour vous aider à écrire un code. Si vous êtes plus à l'aise en utilisant un autre outil, tel que Microsoft Visual Studio ou un éditeur de texte, vous pouvez y écrire un code, puis le copier-coller dans l'Éditeur de code de paramètre.
Anchor
Bookmark167_concept2023__section_A7B9053
Bookmark167_concept2023__section_A7B9053
Supprimer un code
Si vous décidez ensuite de ne plus utiliser une paire particulière événement-action, cliquez avec le bouton droit sur la ligne entre l'événement et l'action, puis sélectionnez Réinitialiser à la valeur par défaut.

Sv translation
languageja

経験のあるプログラマーであれば、ルール パラメータ エディタをカスタマイズするコードを記述できます。
Microsoft Visual Basic、C#、C++ など、Microsoft .NET Framework がサポートするプログラミング言語でコードを記述できる場合、これらの言語を使用してパラメータに値を割り当てることができます。
Visual Basic 言語は、RBA ソフトウェアでネイティブにサポートされています。他の言語を使用する場合は、外部でコード ライブラリを作成してから managed .dll ファイルをインポートします。
注: unmanaged .dll ファイルを使用した場合、.NET Framework は例外に関するフィードバックを RBA システムに返しません。コードに関する問題のトラブルシューティングは、すべてお客様自身で行ってください。
ルール パラメータ エディタでは実行できない操作を行う場合、コードを記述すると便利です。RBA ルール内でコードを格納するための基本構造は以下のとおりです。

  • Anchor
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Bookmark167_concept2023__ul_7C4DF7A70D61
    Anchor
    Bookmark167_concept2023__li_C516E535D9DC
    Bookmark167_concept2023__li_C516E535D9DC
    パラメータ割り当て:ほとんどの RBA アクションはパラメータ割り当てです。カスタム コードを記述して、アクション パラメータの値の取得方法を指定することができます。コードは、ConfigureAction() という名前のサブルーチンに格納されます。
  • Anchor
    Bookmark167_concept2023__li_55B8ED363D59
    Bookmark167_concept2023__li_55B8ED363D59
    条件分岐:条件分岐型のアクションでは、単純なブール型の式を使用して True/False の結果を取得します。これを使用して独自のロジックをコーディングできます。コードは、ConfigureAction() という名前のサブルーチンに格納されます。
  • Anchor
    Bookmark167_concept2023__li_FB4049D12CBA
    Bookmark167_concept2023__li_FB4049D12CBA
    フィルタ:フィルタ型のアクションでは、特定の条件セットに一致するオブジェクトのリストを作成します。これを使用して独自の選択条件をコーディングできます。コードは、ConfigureAction() という名前のサブルーチンに格納されます。
  • Anchor
    Bookmark167_concept2023__li_04B9D87ECC89
    Bookmark167_concept2023__li_04B9D87ECC89
    ユーザー定義:ユーザー定義型のアクションは、すべてのコードを単純に受け入れます。これを使用して、実行するコードの内容や、結果として生じるイベントを制御できます。コードは、Run() という名前のサブルーチンに格納されます。

ルール エンジンでは、ConfigureAction() および Run() サブルーチンに格納されているコードのみが実行されます。このコードは、ルール エンジンでサポートされるコードでラッピングされ、隠されます。独自のインポート ステートメントは追加できません。また、オブジェクト タイプを名前空間で明示的に参照する必要があります。
RBA コード内では、作成した独自のコード ライブラリを読み込むことができます。これは、複数の箇所で同じコードを再使用する場合に便利です。これによって Visual Basic 以外のプログラミング言語を使用できます。

Anchor
Bookmark167_concept2023__section_CC197A4
Bookmark167_concept2023__section_CC197A4
コードの記述
パラメータ コード エディタには、コードを記述できるツールが用意されています。Microsoft Visual Studio やテキスト エディタなど他のツールのほうが使い慣れている場合は、そのツールでコードを記述してから、コピーしてパラメータ コード エディタに貼り付けることができます。
Anchor
Bookmark167_concept2023__section_A7B9053
Bookmark167_concept2023__section_A7B9053
コードの削除
特定のイベントとアクションの組み合わせに含めたコードの使用をやめる場合は、イベントとアクションの間のラインを右クリックして、デフォルトにリセットを選択します。