Identity Manager 8.0 - Web Designer Referenzhandbuch

Verwalten einer datenbankbasierten Collection

Das Verwalten einer datenbankbasierten Collection umfasst unter anderem sowohl das Hinzufügen von Eigenschaften oder Objekten, als auch das Entfernen und Löschen von Objekten aus einer Collection oder Datenbank.

Im Folgenden werden alle wesentlichen Vorgänge beschrieben, die die Verwaltung einer datenbankbasierten Collection betreffen:

Um einer datenbankbasierten Collection eine Proxy-Eigenschaft hinzuzufügen

Proxy-Eigenschaften ermöglichen die transparente Verwendung einer Datenbankspalte (Basiseigenschaft) mit veränderten Metadaten. Zu den Metadaten zählen unter anderem:

• Beschriftung
• Beschreibung
• Eigenschaft als Pflicht oder optional angeben
• Bildungsart der Anzeige eines Eigenschaftswerts
• Komponentenwahl zur Anzeige und Bearbeitung von Eigenschaftswerten

Sie können mit Proxy-Eigenschaften eine Eigenschaft innerhalb einer Komponente genau an die Bedürfnisse der Komponente anpassen. Dabei ist zu beachten, dass der Datenwert einer Proxy-Eigenschaft immer der Wert der Basiseigenschaft ist. Aktualisierungen des Wertes über die Proxy-Eigenschaft wirken sich immer zusätzlich auf die Basiseigenschaft aus.

1. Wählen Sie eine Collection mit Rechtsklick.
2. Wählen Sie die Option Proxy-Eigenschaft.

   Die Proxy-Eigenschaft wird unterhalb des gewählten Collections-Knotens angelegt.

3. Wählen Sie im Fenster Knotenbearbeitung im Auswahlfeld Basis-Eigenschaft eine Eigenschaft.
4. Erfassen Sie im Textfeld Bezeichner den Namen für die Proxy-Eigenschaft.

Um einer datenbankbasierten Collection weitere Eigenschaften hinzuzufügen

1. Wählen Sie eine Collection mit Rechtsklick.
2. Wählen Sie die Option Eigenschaft.
3. Erfassen Sie für diese Eigenschaft mindestens einen Namen und einen Datentypen.

Um ein neues Objekt in eine Collection hinzuzufügen

1. Wählen Sie einen Aktionsknoten mit Rechtsklick.
   

   Dies kann zum Beispiel der Knoten Initialisierung der Komponente sein.

2. Wählen Sie die Aktion Einfügen und klicken Sie auf den neu erstellten Knoten.
3. Wählen Sie im Fenster Knotenbearbeitung unter Collection die gewünschte Collection.
4. Erfassen Sie mit der Eigenschaft Filterbedingung einen Ausdruck für eine Filterbedingung, wenn Sie das wünschen.

Um an einer datenbankbasierten Collection eine Eigenschaft zu ändern

In der folgenden Schrittanleitung wird als Beispiel der Anzeigewert der Spalte Eintrittsdatum in der Ansicht Telefonbuch von <dd.MM.yy> in <yyyy-MM-dd> geändert.

1. Melden Sie sich am Web Portal mit Ihren Benutzerdaten an und wählen Sie die Ansicht Telefonbuch.
2. Wählen Sie die zusätzliche Spalte Eintrittsdatum, wenn diese nicht angezeigt wird und sehen Sie sich den aktuellen Anzeigewert an.

   In unserem Beispiel gehen wir davon aus, dass der Anzeigewert <dd.MM.yy> eingestellt ist.

3. Klicken Sie in den Titel der Ansicht Telefonbuch und wechseln Sie in den Web Designer.
4. Öffnen Sie das Fenster Eigenschaften und wechseln Sie mit zum Definitionsobjekt im Definitionsbaumfenster.
5. Öffnen Sie den Knoten Collections mit und markieren Sie das Datenbankobjekt Person.
6. Wählen Sie aus dem Kontextmenü den Eintrag Element in Erweiterung | Eigenschaft verändern.

   Die Ansicht im Definitionsbaumfenster wechselt in Konfiguration (kundenspezifisch).

7. Wählen Sie im Knotenbearbeitungsfenster im Auswahlfeld Basis-Eigenschaft* den Eintrag EntryDate und erfassen Sie im Textfeld Ausdruck für Anzeigewert den neuen Ausdruck für den Anzeigewert.

   In unserem Beispiel könnte das folgender Ausdruck sein.

   FormatDate(EntryDate, "yyyy-MM-dd")

8. Wechseln Sie in die Vorschau und kompilieren Sie die Webanwendung neu.
9. Wählen Sie die Ansicht Telefonbuch und die zusätzliche Spalte Eintrittsdatum.

   In der Spalte Eintrittsdatum wird als Anzeigewert das Format yyyy-MM-dd angezeigt.

Um Objekte aus der Collection zu entfernen oder aus der Datenbank zu löschen

1. Wählen Sie einen Aktionsknoten mit Rechtsklick.

   Dies kann zum Beispiel der Knoten Initialisierung der Komponente sein.

2. Klicken Sie die Aktion Löschen und wählen Sie den neu erstellten Knoten.
3. Wählen Sie im Fenster Knotenbearbeitung unter Collection die gewünschte Collection.
4. Nehmen Sie eine der folgenden Aktionen vor.
   1. Wählen Sie unter Art des Löschens den Wert Zeilen nur aus Collection entfernen, wenn Sie Objekte aus der Collection entfernen möchten.
   2. Wählen Sie unter Art des Löschens den Wert Datenbankobjekt löschen und speichern.
5. Erfassen Sie mit der Eigenschaft Filterbedingung einen Ausdruck für eine Filterbedingung, wenn Sie das wünschen.

Um Objekte in die Datenbank zu speichern

1. Wählen Sie einen Aktionsknoten mit Rechtsklick.

   Dies kann zum Beispiel der Knoten Initialisierung der Komponente sein.

2. Wählen Sie die Aktion Speichern und klicken Sie den neu erstellten Knoten.
3. Wählen Sie im Fenster Knotenbearbeitung unter Collection die gewünschte Collection.
4. Erfassen Sie mit der Eigenschaft Filterbedingung einen Ausdruck für eine Filterbedingung, wenn Sie das wünschen.

Laden von Datenbankobjekten über Relationen

Daten sind in einer Datenbank über Relationen miteinander logisch verknüpft. Sie können diese Relationen nutzen, um Daten auf einfache Weise aus der Datenbank zu laden.

Voraussetzung für die Nutzung einer solchen Collection ist eine Collection, die die Quelldaten enthält.

Zur Definition von Collectionen gibt es verschiedene Arten von Relationen:

• Definition mit Fremdschlüsselbeziehung:

  Mithilfe einer Fremdschlüsselbeziehung werden automatisch diejenigen Objekte in eine Datenbanksicht geladen, die über eine Fremdschlüsselbeziehung aus den Objekten einer anderen Collection referenziert wurden.

• Definition mit Child-Beziehung:

  Mithilfe einer Child-Beziehung werden automatisch diejenigen Objekte in eine Datenbanksicht geladen, die über eine Child-Beziehung auf Objekte einer anderen Collection verweisen.

Um eine Collection mit einer Fremdschlüsselbeziehung zu definieren

1. Öffnen Sie das Modul oder die Komponente, in dem die Collection angelegt werden soll.
2. Wählen Sie mit Rechtsklick den Knoten Collections.
3. Wählen Sie die Option Datenbanksicht über Fremdschlüssel-Beziehung.
4. Wählen Sie unter Collection mit Quelldaten die Collection mit den Quelldaten.
5. Wählen Sie unter Fremdschlüsselspalte die gewünschte Fremdschlüsselspalte, über die die Beziehung zur Zieltabelle hergestellt wird.
6. Erfassen Sie unter Bezeichner den gewünschten Namen der neuen Collection an.

Für eine solche Collection ist kein Auslösen eines Ladevorgangs erforderlich. Sobald Daten in der Collection mit den Quelldaten vorliegen, werden die über Fremdschlüssel referenzierten Objekte automatisch nachgeladen.

Um eine Collection mit einer Child-Beziehung zu definieren

1. Öffnen Sie das Modul oder die Komponente, in dem die Collection angelegt werden soll.
2. Wählen Sie mit Rechtsklick den Knoten Collections.
3. Wählen Sie die Option Datenbanksicht über Child-Beziehung.
4. Wählen Sie unter Objekttyp die Datenbanktabelle, aus der die Objekte geladen werden sollen.
5. Wählen Sie unter Collection mit Quelldaten die Collection, welche die Objekte enthält, auf die verwiesen wird.
6. Wählen Sie unter Spalte der Child-Beziehung die gewünschte Fremdschlüsselspalte, über die die Beziehung hergestellt wird.
7. Erfassen Sie unter Bezeichner den gewünschten Namen der neuen Collection an.

Für eine solche Collection ist kein Auslösen eines Ladevorgangs erforderlich. Sobald Daten in der Collection mit den Quelldaten vorliegen, werden referenzierte Objekte automatisch nachgeladen.

Laden von Datenbankobjekten aus mehreren Tabellen

Für verschiedene Anwendungsfälle ist es erforderlich, Datenbankobjekte aus mehreren Tabellen zusammen zu betrachten. Dafür bietet das Objektmodell den speziellen Collection-Typ Datenbankobjekt aus mehreren Tabellen an.

Um eine Collection mit der Option "Datenbankobjekt aus mehreren Tabellen" zu definieren

1. Öffnen Sie das Modul oder die Komponente, in dem die Collection angelegt werden soll.
2. Wählen Sie mit Rechtsklick den Knoten Collections.
3. Wählen Sie die Option Datenbankobjekt aus mehreren Tabellen hinzufügen.
4. Erfassen Sie unter Bezeichner den gewünschten Namen der neuen Collection.

   Eine solche Collection ist datenbankbasiert, kann aber Objekte verschiedener Datenbanktabellen aufnehmen.

Weitere Informationen finden Sie unter "Datenbankobjekte" als Collection. Dabei müssen Sie explizit angeben, aus welcher Datenbanktabelle die Objekte geladen werden sollen.

Datenbankabfrage-Assistent nutzen

Aus Sicherheitsgründen ist es im Web Designer nicht möglich SQL-Ausdrücke direkt auszuführen. Stattdessen unterstützt Sie dieser Assistent dabei SQL-Ausdrücke zu erstellen, die in der Tabelle QBMLimitedSQL hinterlegt und in der Tabelle QBMGroupHasLimitedSQL mit mindestens einer Rechtegruppe verknüpft werden. Für die Abfrage wird ein eigener Collection-Knoten angelegt.

Um eine Datenbankabfrage zu erstellen

1. Nehmen Sie eine der folgenden Aktionen vor.
   1. Wählen Sie in der Navigationsansicht ein Modul oder eine Komponente.
   2. Erstellen Sie ein neues Modul beziehungsweise eine neue Komponente.
2. Markieren Sie in der Ansicht Objektdefinition im Definitionsbaumfenster den Knoten Collections und wählen Sie aus dem Kontextmenü den Eintrag Assistenten | Datenbankabfrage-Assistent oder Element in Erweiterung | Assistenten | Datenbankabfrage-Assistent.

   Hinweis: Die Menüführung hängt davon ab, ob Sie ein kundenspezifisches Modul/Komponente oder ein Standard-Modul/Komponente gewählt haben. Standard Datenbankobjekte benötigen zunächst eine Erweiterung am Objekt. Weitere Informationen finden Sie unter Erweiterungen.

   Die Seite Assistent zum Erstellen oder Wählen einer Datenbankabfrage wird angezeigt, um einen SQL-Ausdruck anzugeben oder einen bereits erstellten auszuwählen.

3. Wählen Sie die Option Neu.

   Folgende Eingabe- und Textfelder werden angezeigt.

   Tabelle 51: Einstellungen zu einem SQL-Ausdruck

   Einstellung	Beschreibung
   Name der Collection	Überschreiben Sie bei Bedarf den voreingestellten Namen für die Collection, die Sie mit dieser Abfrage anlegen.
   Bezeichner	Erfassen Sie in diesem Eingabefeld einen eindeutigen Identifier, der später verwendet wird, um den Eintrag zu identifizieren.
   SQL-Ausdruck	Erfassen Sie im Textfeld den kompletten Ausdruck. Es können auch Parameter deklariert werden.
   Beschreibung	Erfassen Sie im Textfeld eine Erklärung zu diesem Eintrag. Damit fällt es anderen Benutzern leichter, diesen Ausdruck zu verstehen und einzuordnen.

4. Nehmen Sie die Einstellungen vor und klicken Sie Weiter.

   Auf der Seite Assistent zum Erstellen oder Wählen einer Datenbankabfrage geben Sie die Dialoggruppen an, die das SQL-Fragment ausführen dürfen. Alle Dialoggruppen sind ausgewählt.

5. Geben Sie die gewünschten Dialoggruppen an.
   • Deaktivieren Sie die gewünschte Dialoggruppe, indem Sie doppelklicken.
   • Deaktivieren Sie Alle auswählen / abwählen, um alle gelisteten Dialoggruppen abzuwählen und die gewünschten Dialoggruppen wieder einzeln zu aktivieren.
   • Aktivieren Sie die gewünschte Dialoggruppe, indem Sie doppelklicken.
6. Geben Sie auf der folgenden Seite Assistent zum Erstellen oder Wählen einer Datenbankabfrage die Parameter an, die Sie auswählen möchten und deren Werte festlegen.
   • Deaktivieren Sie bei Bedarf die Parameter-Spalte, die Sie nicht in die Abfrage einbinden möchten beziehungsweise der Parser Parameter erkannt hat, die keine sind.
   • Deaktivieren Sie Alle auswählen / abwählen, um alle Parameter-Spalten einzeln auszuwählen.
   • Erfassen Sie einen Wert für den Parameter, indem Sie neben der gewünschten Parameter-Spalte klicken.

   Hinweis: Sie haben die Möglichkeit Ihre Datenbankabfrage mit der Schaltfläche Ausdruck testen zu prüfen. Sobald die im Hintergrund laufenden Datenbankprozesse abgeschlossen sind, können Sie die neuen Ausdrücke testen.

   Die Seite Verarbeitung wird angezeigt und die neue Collection und der SQL-Ausdruck erstellt.

7. Schließen Sie den Assistenten mit Fertig.

Um eine Datenbankabfrage zu wählen

1. Nehmen Sie eine der folgenden Aktionen vor.
   1. Wählen Sie in der Navigationsansicht ein Modul oder eine Komponente.
   2. Erstellen Sie ein neues Modul beziehungsweise eine neue Komponente.
2. Markieren Sie in der Ansicht Objektdefinition im Definitionsbaumfenster den Knoten Collections und wählen Sie aus dem Kontextmenü den Eintrag Assistenten | Datenbankabfrage-Assistent oder Element in Erweiterung | Assistenten | Datenbankabfrage-Assistent.

   Hinweis: Die Menüführung hängt davon ab, ob Sie ein kundenspezifisches Modul/Komponente oder ein Standard-Modul/Komponente gewählt haben. Standard Datenbankobjekte benötigen zunächst eine Erweiterung am Objekt. Weitere Informationen finden Sie unter Erweiterungen.

   Die Seite Assistent zum Erstellen oder Wählen einer Datenbankabfrage wird angezeigt, um einen SQL-Ausdruck anzugeben oder einen bereits erstellten auszuwählen.

3. Wählen Sie die Option Bereits vorhanden.

   Folgende Eingabe- und Auswahlfelder werden angezeigt.

   Tabelle 52: Einstellungen zu einem bereits erstellten SQL-Ausdruck

   Einstellung	Beschreibung
   Name der Collection	Überschreiben Sie bei Bedarf den voreingestellten Namen für die Collection, die Sie mit dieser Abfrage anlegen.
   SQL-Fragment	Wählen Sie im Auswahlfeld ein vorhandenes Fragment, dass Sie im Textfeld SQL-Ausdruck verwenden und ergänzen können.
   SQL-Ausdruck	Ergänzen Sie gegebenenfalls im Textfeld das ausgewählte Fragment und die voreingestellten Parameter.

4. Nehmen Sie die Einstellungen vor und klicken Sie Weiter.

   Auf der folgenden Seite Assistent zum Erstellen oder Wählen einer Datenbankabfrage können Sie die Dialoggruppen angeben, die das SQL-Fragement ausführen dürfen.

5. Geben Sie die gewünschten Dialoggruppen an.
   • Aktivieren Sie die gewünschte Dialoggruppe, indem Sie doppelklicken.
   • Deaktivieren Sie die gewünschte Dialoggruppe, indem Sie doppelklicken.

     Hinweis: Dialoggruppen, die bereits in einer Collection eines Standard-Moduls angegeben waren, können nicht abgewählt werden.

   • Deaktivieren Sie Alle auswählen / abwählen, um alle gelisteten Dialoggruppen aus- oder abzuwählen und die gewünschten Dialoggruppen wieder einzeln zu aktivieren oder zu deaktivieren.
6. Geben Sie auf der folgenden Seite Assistent zum Erstellen oder Wählen einer Datenbankabfrage die Parameter an, die Sie auswählen möchten und deren Werte festlegen.
   • Deaktivieren Sie bei Bedarf die Parameter-Spalte, die Sie nicht in die Abfrage einbinden möchten beziehungsweise der Parser Parameter erkannt hat, die keine sind.
   • Deaktivieren Sie Alle auswählen / abwählen, um alle Parameter-Spalten einzeln auszuwählen.
   • Erfassen Sie einen Wert für den Parameter, indem Sie neben der gewünschten Parameter-Spalte klicken.

   Hinweis: Sie haben die Möglichkeit Ihre Datenbankabfrage mit der Schaltfläche Ausdruck testen zu prüfen. Sobald die im Hintergrund laufenden Datenbankprozesse abgeschlossen sind, können Sie die neuen Ausdrücke testen.

   Die Seite Verarbeitung wird angezeigt und die neue Collection und der SQL-Ausdruck erstellt.

7. Schließen Sie den Assistenten mit Fertig.