8.2 Webclient

Im Webclient können Sie Objekteigenschaften, Workflowautomatisierungs-Formulare und das Branding der Benutzeroberfläche anpassen. Richtig implementiert vereinfachen Eigenschaften- und Workflowanpassungen die Automatisierung von Hilfsadministratoraufgaben bei der Objektverwaltung und automatisierten Workflowübertragung.

8.2.1 Benutzerdefinierte Eigenschaftenseiten

Sie können die Objekteigenschaftenformulare, die von den Hilfsadministratoren in den Active Directory-Verwaltungsrollen verwendet werden, nach Objekttyp anpassen. Dies umfasst auch das Erstellen und Anpassen neuer Objektseiten, die auf in DRA integrierten Objekttypen basieren. Sie können auch die Eigenschaften der integrierten Objekttypen ändern.

Objekte sind in der Liste der Eigenschaftsseiten in der Webkonsole klar definiert, sodass Sie einfach identifizieren können, welche Objektseiten integriert sind, welche integrierten Seiten angepasst wurden und welche Seiten nicht integriert sind und vom Administrator erstellt wurden.

Anpassen einer Objekteigenschaftsseite

Sie können Objekteigenschaftenformulare anpassen, indem Sie Seiten hinzufügen oder entfernen, vorhandene Seiten und Felder ändern oder neue benutzerdefinierte Behandlungsroutinen für Eigenschaftenattribute erstellen. Wenn Sie benutzerdefinierte Behandlungsroutinen erstellen, werden diese je nach Konfiguration automatisch ausgeführt, wenn ein Eigenschaftenfeld geändert wird oder ein Administrator auf eine Aufforderung zum Ausführen einer Abfrage antwortet.

Die Objektliste in den Eigenschaftsseiten bietet zwei Operationstypen für jeden Objekttyp: „Objekt erstellen“ und „Eigenschaften bearbeiten“. Dies sind die beiden wesentlichen Operationen, die Sie im Webclient ausführen. Die Anpassungen können die Verwaltung der Active Directory-Objekte in DRA in Bezug auf Effizienz und Benutzererlebnis verbessern.

So passen Sie eine Objekteigenschaftsseite in der Webkonsole an:

Melden Sie sich als „DRA Administrator“ an der Webkonsole an.
Navigieren Sie zu Anpassung > Eigenschaftsseiten.
Wählen Sie ein Objekt und einen Operationstyp (Erstellen oder Bearbeiten) in der Liste der Eigenschaftsseiten aus.
Klicken Sie auf die Schaltfläche Bearbeiten.
Passen Sie das Objekteigenschaftenformular an, indem Sie eine oder mehrere der folgenden Aktionen ausführen und dann die Änderungen anwenden:
- Neue Eigenschaftsseite hinzufügen: Seite hinzufügen
- Eigenschaftsseite auswählen und anpassen:
  - Konfigurationsfelder in der Seite neu sortieren:
  - Felder oder untergeordnete Felder bearbeiten:
  - Ein oder mehrere Felder hinzufügen: oder Feld hinzufügen
  - Ein oder mehrere Felder entfernen:
- Mit Skripten, Nachrichtenfeldern oder Abfragen (LDAP, DRA oder REST) benutzerdefinierte Behandlungsroutinen für Eigenschaften erstellen
  
  Weitere Informationen zur Verwendung von benutzerdefinierten Behandlungsroutinen finden Sie in Hinzufügen benutzerdefinierter Behandlungsroutinen.

Erstellen einer neuen Objekteigenschaftenseite

So erstellen Sie eine neue Objekteigenschaftenseite:

Melden Sie sich als „DRA Administrator“ an der Webkonsole an.
Navigieren Sie zu Anpassung > Eigenschaftsseiten.
Klicken Sie unter „Aufgaben“ auf Neue Aktion erstellen.
Erstellen Sie das anfängliche Objekteigenschaftenformular, indem Sie den Namen, das Symbol, den Objekttyp und die Vorgangskonfiguration definieren.
Passen Sie das neue Formular je nach Bedarf an. Siehe Anpassen einer Objekteigenschaftsseite.

8.2.2 Anpassen von Workflowformularen

Die Workflowformulare werden beim Erstellen bzw. Bearbeiten auf dem Webserver gespeichert. Der Zugriff erfolgt über die Seite Anpassung > Workflow. Mit diesen Formularen werden automatisierte Workflows gesendet, die auf dem Workflowautomatisierungsserver erstellt werden. Sie können die Formulare anpassen, um die Verwendung der Formulare durch die Hilfsadministratoren zum Ausführen von Objektverwaltungsaufgaben weiter zu automatisieren und zu verbessern.

Sie können vorhandene Formulareigenschaften und benutzerdefinierte Behandlungsroutinen hinzufügen und ändern. Das Verhalten der Benutzeroberfläche beim Hinzufügen und Anpassen der Eigenschaften in einem Workflowautomatisierungsformular entspricht dem Verhalten beim Anpassen von Objekteigenschaften. Die Themen unten enthalten weitere Informationen über das Hinzufügen und Ändern von Eigenschaften, dass Hinzufügen von benutzerdefinierten Behandlungsroutinen und über die Workflowautomatisierung im Allgemeinen.

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 Eigenschaften-Behandlungsroutinen können beispielsweise dazu verwendet werden, den Wert eines anderen Felds abzurufen, Werte zu aktualisieren, den Nur-Lesen-Zustand eines Felds umzuschalten oder Felder basierend auf konfigurierten Variablen anzuzeigen bzw. auszublenden.

Mit Behandlungsroutinen zum Laden von Formularen können Formulare angepasst werden, typischerweise durch die Initialisierung bestimmter Steuerelemente. Behandlungsroutinen zum Senden von Formularen ermöglichen das Bestätigen und gegebenenfalls Abbrechen des Sendens, falls Fehler erkannt werden.

DRA erleichtert die Erstellung von benutzerdefinierten Behandlungsroutinen mit verschiedenen JavaScript-Makros, die Sie beim Erstellen und Validieren der Behandlungsroutine auswählen können.

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 die Bearbeitungsschaltfläche eines Eigenschaftsfelds auf die benutzerdefinierten Behandlungsroutinen der Objekteigenschaft zu. Auf die Behandlungsroutinen zum Laden bzw. Senden von Formularen greifen Sie über die Formulareigenschaften in einem Workflowformular oder über eine Objekterstellungsseite zu.

Klicken Sie auf die Registerkarte „Benutzerdefinierte Behandlungsroutinen“ und aktivieren Sie die Seite .
- Benutzerdefinierte Behandlungsroutinen
- Behandlungsroutinen zum Laden von Formularen
- Behandlungsroutinen zum Senden von Formularen
Wählen Sie im Dropdown-Menü eine benutzerdefinierte Behandlungsroutine und wählen Sie eine Ausführungszeit aus. Normalerweise wird die zweite oder dritte Option für die Ausführungszeit verwendet.

HINWEIS:Typischerweise benötigen Sie meist nur eine benutzerdefinierte Behandlungsroutine. Sie können jedoch mehrere Behandlungsroutinen verwenden, indem Sie Flusssteuerungen im Skript konfigurieren, um die Behandlungsroutinen zu verknüpfen.
Sie müssen jede benutzerdefinierte Behandlungsroutine konfigurieren , die Sie zur Seite hinzufügen. Die Konfigurationsoptionen variieren je nach Typ der Behandlungsroutine. Alle Behandlungsroutinen werden jedoch über JavaScript ausgeführt.

Sie können eigene Vanilla-JavaScript-Einträge erstellen oder die integrierten Makros verwenden.
- 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 Platzhaltertext in die Pflichtfelder ein. Dies ist erforderlich, damit das Skript ausgeführt wird. Das Skript überschreibt die Platzhalterwerte.
    
    HINWEIS:Sie können auch Header und Cookies für die REST-Abfrage konfigurieren.
  2. Wählen Sie in der Aktion vor der Abfrage den Makrotyp Global, Abfrage oder Formularfeld aus.
  3. Wählen Sie in der Dropdown-Liste ein Makro und fügen Sie es ein (</> Makro einfügen).
  4. Fügen Sie je nach Bedarf weitere Makros ein und geben Sie dann die gewünschten Werte an, um das Skript fertigzustellen.
    
    Als Beispiel verwenden wir in der Aktion vor der Abfrage ein Skript, das bestätigt, dass ein vom Benutzer eingegebener Gruppenname beim Senden des Formulars nicht bereits in Active Directory vorhanden ist.
    
    Wir erstellen eine LDAP-Abfrage mit dem vom Benutzer eingegebenen Namen. Mit dem Makro Field() greifen wir auf den Wert des Felds „Name“ zu und erstellen die Abfragezeichenfolge, die dann mit dem Makro Filter() als Abfragefilter festgelegt wird.
    Filter() = '(&(objectCategory=group)(objectClass=group)(name=' + Field(name) + '))';
  5. Anschließend überprüfen wir in der Aktion nach der Abfrage die Ergebnisse der Abfrage. Die Ergebnisse werden als Array an Objekten wiedergegeben, die die Abfragekriterien erfüllen. Wir müssen also nur überprüfen, ob die Länge des Arrays größer 0 ist.
    
    Wenn eine Gruppe gefunden wird, die die Abfragekriterien erfüllt, brechen wir das Senden des Formulars mit dem Makro Cancel() ab. Dem Makro kann optional eine Nachricht übergeben werden, die dem Benutzer angezeigt werden soll.
    
    if (QueryResults().length > 0) { Cancel('Eine Gruppe mit diesem Namen ist bereits vorhanden, bitte geben Sie einen eindeutigen Namen ein.');}
- Skript: Fügen Sie benutzerdefinierten JavaScript-Code ein oder verwenden Sie die Makros zum Erstellen des Skripts.
- DRA-Abfrage: Definieren Sie für die Abfrageparameter eine Nutzlast im JSON-Format. Verwenden Sie dann Makros ähnlich wie oben für LDAP- und REST-Abfragen beschrieben.
- Behandlungsroutinen für Mitteilungsfeld: Nachdem Sie die Eigenschaften für das Mitteilungsfeld selbst definiert haben, verwenden Sie Makros ähnlich wie oben für LDAP- und REST-Abfragen beschrieben. Anstelle der Aktionen vor und nach der Abfrage erstellen Sie jedoch stattdessen Makroskripte für die Aktionen vor dem Anzeigen und nach dem Schließen.
Klicken Sie auf Behandlungsroutinen testen, um das Skript vor dem Speichern des Formulars zu bestätigen.

Dies generiert eine Zusammenfassung der Testergebnisse, in der Sie die Ausführungsergebnisse anzeigen können.

HINWEIS:Wenn die Behandlungsroutine vom aktuellen Zustand des Formulars abhängt (zum Beispiel davon, ob das Feld einen Wert enthält), kann sie nicht erfolgreich ausgeführt werden, weil beim Bearbeiten eines Formulars keine Daten geladen werden. Für solche Szenarien muss die Behandlungsroutine außerhalb des Formulareditors getestet werden. Speichern Sie dazu die Anpassung, navigieren Sie zum entsprechenden Formular und geben Sie die erforderlichen Daten ein.

8.2.3 Anpassen des Branding der Benutzeroberfläche

Sie können die Titelleiste der DRA-Webkonsole mit einem eigenen Titel und Logobild anpassen. Diese Elemente werden direkt rechts neben dem DRA-Produktnamen angezeigt. Da diese Position auch für die Navigation der obersten Ebene verwendet wird, werden die Elemente nach der Anmeldung durch die DRA-Navigationslinks der obersten Ebene verdeckt. Auf der Browserregisterkarte wird die angepasste Kachel jedoch weiterhin angezeigt.

So passen Sie das Branding der Titelleiste in DRA an:

Melden Sie sich als „DRA Administrator“ an der Webkonsole an.
Navigieren Sie zu Anpassung > Branding.
Wenn Sie ein Firmenlogo hinzufügen möchten, speichern Sie das Logobild in components\lib\img auf dem Webserver.
Fügen Sie die erforderlichen Informationen je nach Bedarf für die drei Felder auf der Branding-Anpassungsseite hinzu und speichern Sie die Änderungen.