24.3 Hinzufügen benutzerdefinierter Behandlungsroutinen

Benutzerdefinierte Behandlungsroutinen werden in DRA dazu verwendet, dass Eigenschaftenattribute zum Erfüllen einer Workflowaufgabe miteinander interagieren. Außerdem werden Sie für Anpassungen der Funktionen zum Laden und Senden in einem Workflow, einer Eigenschaft oder in einem Erstellungsformular.

Benutzerdefinierte Behandlungsroutinen für Eigenschaften

Einige Beispiele für benutzerdefinierte Behandlungsroutinen für Eigenschaften sind folgende:

Abrufen des Wert anderer Felder
Aktualisieren von Feldwerten
Umschalten des Nur-Lesen-Status eines Felds
Anzeigen oder Ausblenden von Feldern basierend auf konfigurierten Variablen

Behandlungsroutinen zum Laden von Formularen

Behandlungsroutinen zum Laden von Formularen führen typischerweise Initialisierungssteuerungen aus. Sie werden nur einmal beim ersten Laden des Formulars ausgeführt. Bei Eigenschaftenseiten werden sie ausgeführt, bevor der Server auf die Eigenschaften des ausgewählten Objekts abgerufen wird.

Behandlungsroutinen zum Senden von Formularen

Behandlungsroutinen zum Senden von Formularen ermöglichen eine Art der Überprüfung und gegebenenfalls das Abbrechen der Formularübermittlung, falls Fehler erkannt werden.

Ausführlichere Beispiele zum Verwenden von benutzerdefinierten Behandlungsroutinen und Anpassungen in der Webkonsole finden Sie in den Abschnitten Web Console Customization (Anpassung der Webkonsole) und Workflow Customization (Workflowanpassungen) in der Referenz Product Customization (Produktanpassung) auf der DRA-Dokumentationsseite.

Benutzerdefiniertes JavaScript aktivieren

Benutzerdefiniertes JavaScript ist aus Sicherheitsgründen standardmäßig deaktiviert. Nach dem Aktivieren von benutzerdefiniertem JavaScript können Administrators JavaScript-Codeausschnitte erstellen, die von der Webkonsole unverändert ausgeführt werden. Sie sollten diese Ausnahme nur aktivieren, wenn Sie die verbundenen Gefahren verstehen und akzeptieren.

So ermöglichen Sie Anpassungen mit benutzerdefiniertem JavaScript-Code:

Wechseln Sie zum Speicherort C:\ProgramData\NetIQ\DRARESTProxy.
Öffnen Sie die Datei restProxy.config.
Fügen Sie allowCustomJavaScript="true" zum Element <consoleConfiguration> hinzu.

24.3.1 Grundlegende Schritte zum Erstellen einer benutzerdefinierten Behandlungsroutine:

Die nachfolgenden Schritte beginnen mit einer vorab ausgewählten Seite für benutzerdefinierte Behandlungsroutinen. Um zu diesem Punkt zu gelangen, greifen Sie über das Eigenschaftensymbol eines Eigenschaftsfelds auf die benutzerdefinierten Behandlungsroutinen der Objekteigenschaft zu. Der Zugriff auf die Behandlungsroutinen zum Laden des Formulars und zum Senden des Formulars erfolgt über die Schaltfläche Formulareigenschaften eines ausgewählten Workflowformulars, einer Objekterstellungsseite oder einer Eigenschaftenbearbeitungsseite.

Wählen Sie je nach anzupassender Eigenschaft bzw. Seite die Registerkarte der geeigneten Behandlungsroutine aus:
- Benutzerdefinierte Behandlungsroutinen
- Behandlungsroutinen zum Laden von Formularen
- Behandlungsroutinen zum Senden von Formularen
Aktivieren Sie die Behandlungsroutinenseite und führen Sie einen der folgenden Schritte aus:
- Benutzerdefinierte Behandlungsroutine für Eigenschaftenfeld:
  1. Wählen Sie eine Ausführungszeit aus. Normalerweise ist die zweite oder dritte Option für die Ausführungszeit geeignet.
  2. Klicken Sie auf + Hinzufügen und wählen Sie eine benutzerdefinierte Behandlungsroutine im Menü Benutzerdefinierte Behandlungsroutine hinzufügen.
- Behandlungsroutine für Formular: Klicken Sie auf + Hinzufügen und wählen Sie eine benutzerdefinierte Behandlungsroutine im Menü Benutzerdefinierte Behandlungsroutine hinzufügen.
HINWEIS:Üblicherweise benötigen Sie nur eine benutzerdefinierte Behandlungsroutine, Sie können jedoch auch mehrere Behandlungsroutinen verwenden. Mehrere Behandlungsroutinen werden der Reihe nach in der aufgeführten Reihenfolge ausgeführt. Wenn Sie die Reihenfolge der Behandlungsroutinen ändern oder eine nicht benötigte Behandlungsroutine überspringen möchten, können Sie Flusskontrollmakros zum Skript hinzufügen.
Sie müssen jede benutzerdefinierte Behandlungsroutine konfigurieren, die Sie zur Seite hinzufügen. Die Konfigurationsoptionen hängen vom Typ der Behandlungsroutinen ab.

Sie können Ihre eigenen Behandlungsroutinentypen erstellen.
- Behandlungsroutinen für LDAP- oder REST-Abfragen:
  1. Wenn die Abfrage auf statischen Werten basieren soll, definieren Sie Verbindungsinformationen und Abfrageparameter.
    
    Wenn die Abfrage dynamisch sein soll, geben Sie Platzhalterwerte in die Pflichtfelder ein. Dies ist erforderlich, damit die Behandlungsroutine ausgeführt wird. Das Skript überschreibt die Platzhalterwerte.
    
    HINWEIS:Sie können auch Header und Cookies für die REST-Abfrage konfigurieren.
  2. Verwenden Sie in der Aktion vor der Abfrage den Skripteditor, um benutzerdefinierten JavaScript-Code zu erstellen, der vor dem Senden der Abfrage ausgeführt wird. Dieses Skript hat Zugriff auf alle Verbindungsinformationen und Abfrageparameter und kann beliebige dieser Elemente ändern, um die Abfrage benutzerdefiniert anzupassen. Zum Beispiel können Abfrageparameter basierend auf Werten, die der Benutzer im Formular eingegeben hat, festgelegt werden.
  3. In der Aktion nach der Abfrage können Sie ein Skript zum Verarbeiten der Abfrageergebnisse einschließen. Übliche Aufgaben sind zum Beispiel das Überprüfen auf Fehler, das Aktualisieren von Werten auf Grundlage der zurückgegebenen Ergebnisse und das Bestätigen der Objekteindeutigkeit basierend auf der Anzahl der von der Abfrage zurückgegebenen Objekte.
- Skript: Fügen Sie benutzerdefinierten JavaScript-Code ein, um das Skript zu erstellen.
- DRA-Abfrage: Geben Sie die JSON-Nutzlast auf der Registerkarte „Abfrageparameter“ an. Das Nutzlastformat muss mit dem VarSet-Schlüssel oder den Wertepaaren übereinstimmen, die an den DRA-Server gesendet werden. Ähnlich wie bei REST- und LDAP-Abfragen können Sie eine Aktion vor der Abfrage angeben, mit der die Nutzlast vor dem Senden an den Server geändert werden kann, und eine Aktion nach der Abfrage zum Verarbeiten der Ergebnisse.
- Behandlungsroutinen für Mitteilungsfeld: Nachdem Sie die Eigenschaften des Mitteilungsfelds definiert haben, können Sie außerdem die JavaScript-Segmente für die Aktion vor dem Anzeigen und die Aktion nach dem Schließen erstellen.
  
  Diese Aktionen sind optional. Mit der Aktion vor dem Anzeigen können die Eigenschaften des Mitteilungsfelds angepasst werden, bevor das Mitteilungsfeld für den Benutzer angezeigt wird. Mit der Aktion nach dem Schließen wird die Schaltflächenauswahl des Benutzers verarbeitet und eine damit verbundene, zusätzliche Logik ausgeführt.
Klicken Sie auf OK, um die Behandlungsroutine zu speichern.