Rational ClearQuest Web
unterstützt eine Untergruppe der vollständigen Hook-Funktionalität, die von einem Schemaentwickler konfiguriert werden kann.
Im Rational-ClearQuest-Schema erstellte Hooks werden auf Computern ausgeführt, auf denen
die Serverkomponente von
Rational ClearQuest aktiv ist.
Beachten Sie folgende Punkte, wenn Sie Hooks mit Rational ClearQuest Web verwenden:
- Sie können keine Visual Basic- oder Perl-Nachrichtenfelder wie auf dem Desktop-Client
verwenden. Sie können jedoch Felder mit Informations- oder Fehlernachrichten oder
Warnungen anzeigen, indem eine angepasste Nachricht definiert oder ein vorab ausgefülltes
Datensatzformular geöffnet wird. Siehe Angepasste Nachricht generieren und Vorab ausgefülltes Formular öffnen.
- Kontextmenü-Hooks werden in der Anwendung Rational ClearQuest Web nicht unterstützt.
- Sie können Hooks verwenden, um eine Websitzung zu erkennen.
Die folgenden Hook-Typen werden unterstützt:
- Feld-Hooks
- Auswahlliste
- Legt die einem Feld zugeordneten Auswahlmöglichkeiten fest. Wenn eine Auswahlliste
für ein Feld von einem anderen Feld bestimmt wird, muss dieses andere Feld das Zielfeld
als sein Web-abhängiges Feld angeben. Für Felder mit Auswahllisten-Hooks sind die
folgenden Steuerelementtypen zulässig: Kombinationsfeld, Dropdown-Kombinationsfeld und
Dropdown-Liste.
- Standardwert
- Wird ausgeführt, wenn ein Übergabeformular angezeigt wird. Wird nicht ausgeführt, wenn ein
Datensatz durch Klicken auf Save übergeben wird.
- Berechtigung
- Wird nur ausgeführt, wenn das Formular zum ersten Mal im Bearbeitungsmodus angezeigt
wird.
- Validierung
- Wird nur ausgeführt, wenn das Formular gespeichert
wird. Wird nicht ausgeführt, wenn der Benutzer einen Feldwert ändert. Validierungs-Hooks
können zu unterschiedlichen Zeiten ausgeführt werden, je
nach Typ des Formularsteuerelements und Angabe der Feldeigenschaft als Web-abhängig. Weitere Informationen hierzu finden Sie im Abschnitt Besondere Hinweise für Feld-Hooks.
- Geänderter Wert
- Wird ausgeführt, wenn sich der Wert des entsprechenden Felds
in den folgenden Formularsteuerelementtypen ändert: Dropdown-Liste,
Dropdown-Kombinationsfeld und Kombinationsfeld. Hooks für geänderte Werte können zu
unterschiedlichen Zeiten ausgeführt werden, je nach Typ des Formularsteuerelements und
Angabe der Feldeigenschaft als Web-abhängig. Weitere Informationen hierzu finden Sie im Abschnitt Besondere Hinweise für Feld-Hooks.
- Aktions-Hooks
- Zugriffssteuerung
- Initialisierung
- Validierung
- Festschreibung
- Benachrichtigung
- Datensatz-Scripts
- Aliasaktionen für Datensatzscripts erscheinen in einer Dropdown-Liste der
Schaltfläche "Utilities" in einem Datensatz mit einem bestimmten Status.
- Die Hook-Aktion wird auf der Registerkarte Button
Hooks der Schaltfläche "Properties" im Bereich Enable for
web festgelegt.
- Hooks für das Kontextmenü werden in keinem Formularsteuerelement unterstützt.
- Globale Scripts
Besondere Hinweise für Feld-Hooks
Das
Verhalten von Hooks für geänderte Werte und Feld-Hooks für die Validierung ist vom Typ
des Formularsteuerelements und von den Eigenschafteneinstellungen für die Zielfelder
abhängig. In den folgenden besonderen Hinweisen wird erläutert, wann die Hooks ausgeführt
werden und wie Änderungen für verschiedene Formularsteuerelementtypen den Benutzern angezeigt
werden.
- Geänderter Wert
Ein Feld-Hook für geänderte Werte wird unmittelbar ausgeführt, nachdem ein
Benutzer den Wert in den folgenden Formularfeldern ändert:
Feldtyp |
Formularsteuerelement |
REFERENCE |
- Kombinationsfeld
- Dropdown-Kombinationsfeld
- Dropdown-Liste
|
REFERENCE_LIST |
Liste |
SHORT_STRING |
- Dropdown-Kombinationsfeld
- Dropdown-Liste
Anmerkung: Diese Formularsteuerelemente erfordern eine
Web-abhängige Feldzuordnung, damit der Hook für geänderte Werte sofort ausgeführt werden
kann.
|
Ein Hook für geänderte
Werte wird bei der nächsten Kommunikation des Browsers mit dem ClearQuest-Server
ausgeführt, wenn für den Hook der Feldtyp SHORT_STRING mit einem Formularsteuerelement
der folgenden Typen festgelegt wurde:
- Kombinationsfeld
- Dropdown-Kombinationsfeld
- Dropdown-Liste
Das Wechseln zwischen den Registerkarten in einem
Formular bewirkt nicht, dass der Browser mit dem Rational ClearQuest-Server kommuniziert.
- Feld-Hooks für Validierung
Ein Validierungs-Hook wird in der Clientkomponente von
ClearQuest Web unmittelbar
ausgeführt, aber das Formular muss aktualisiert werden, um die Ergebnisse anzuzeigen.
Gehen Sie wie folgt vor, um
eine Schaltfläche "Aktualisieren" zu erstellen:
- Erstellen Sie einen Hook für Datensatzscripts, der keinen Code enthält. Geben Sie
dem Hook den Namen Refresh.
- Erstellen Sie eine Schaltfläche auf dem Formular. Nennen Sie die Schaltfläche
Refresh.
- Klicken Sie mit der rechten Maustaste auf die Schaltfläche und dann auf
Properties.
- Wählen Sie auf der Registerkarte Button Hooks im Bereich
Hooks das Datensatzscript "Refresh" aus der Liste
Click Hook aus.
- Wählen Sie im Bereich Enable for web die Option
Click Hook aus.
Benutzer der Clientkomponente von
ClearQuest Web müssen auf die
Schaltfläche Refresh klicken, um die Ergebnisse des Validierungs-Hooks anzuzeigen.