Skripts in Eingabeformularen
Mit Hilfe von Skripts können Sie Datensatzfelder in Eingabeformularen aktualisieren und in einigen Fällen eine Aktion, wie z.B. das Senden von E-Mails, ausführen. Skripts können in den folgende Situationen ausgeführt werden:
1.Skript bei Datensatzspeicherung: Mit Hilfe des Skripts werden andere Feldwerte des Datensatzes geändert und/oder E-Mails gesendet. Der Einstiegspunkt für die Definition des Skripts ist ein Kontrollkästchen im oberen Bereich des Eingabeformulars (in der Abbildung unten rot umrandet).
2.Skript bei Bearbeitung eines beliebigen Felds eines Datensatzes Bei jeder Bearbeitung eines beliebigen Felds eines Datensatzes modifiziert des Skript ein oder mehrere Felder des geänderten Datensatzes. Der Einstiegspunkt für die Definition des Skripts ist ein Kontrollkästchen im oberen Bereich des Eingabeformulars (in der Abbildung unten rot umrandet).
3.Skript bei Bearbeitung eines bestimmten Felds eines Datensatzes Wenn ein bestimmtes Feld eines Datensatzes bearbeitet wird, modifiziert des Skript ein oder mehrere Felder des Datensatzes.
4.Skript hinter Schaltflächen: Bei Klick auf eine Schaltfläche, kann dessen Skript Feldwerte des Datensatzes ändern.
5.Skript bei Änderung eines Child-Datensatzes: Wenn sich ein Datensatz ändert, kann ein Skript in der Parent-Komponente Daten im Parent-Datensatz ändern.
6.Skript beim Datensatzladen oder bei Formularänderung durch Benutzer: Dieses Skript wird jedes Mal, wenn ein Datensatz vom Benutzer geladen oder geändert wird, ausgelöst.
Im Folgenden wird beschrieben, wie Sie Skripts für die einzelnen Szenarien erstellen.
Erstellen, Entfernen und Bearbeiten von Skripts
Der Einstiegspunkt für jede der oben aufgelisteten Skriptarten ist ein Kontrollkästchen. Aktivieren Sie das Kontrollkästchen im Design, um das Skript zu erstellen. Deaktivieren Sie das Kontrollkästchen, um das Skript zu entfernen. Klicken Sie, nachdem ein Skript erstellt wurde, auf die Bearbeiten-Schaltfläche, um das Skript zu ändern (siehe Abbildung oben).
Rückgängig-Aktionen machen alle Skriptaktionen rückgängig
Wenn ein Benutzer sich dazu entscheidet, eine Aktion rückgängig zu machen, nachdem ein Skript ausgeführt wurde, werden alle Aktionen dieses Skripts rückgängig gemacht, unabhängig davon, ob die Aktionen einen Datensatz erstellt, geändert oder gelöscht haben.
Die Aktionen eines Skripts
In einem Skript können eine oder mehrere Aktionen definiert werden.
•Welche Art von Aktionen (z.B. Aktualisierung von Feldern oder Senden von E-Mails) ausgeführt wird, hängt von der Art des Skripts ab. Die verfügbaren Aktionen werden für jeden unten aufgelisteten Skripttyp aufgelistet.
•Jede Aktion in einem Skript wird unterhalb der zuvor hinzugefügten Aktion aufgelistet.
•Die Aktionen des Skripts werden in der Reihenfolge, in der sie aufgelistet werden, ausgeführt.
•Die Aktion "Speichern" wird automatisch immer als letzte Aktion des Skripts hinzugefügt.
•Wenn Sie die Ausführungsreihenfolge ändern möchten, können Sie die Aktionen mit Hilfe des Nach oben/Nach unten verschieben-Symbols neben der gewünschten Aktion (erstes Symbol von rechts in der Abbildung oben) neu anordnen. Beachten Sie, dass das Nach oben/Nach unten verschieben-Symbol für Aktionen erst angezeigt wird, nachdem eine zweite Aktion zur Liste hinzugefügt wurde. Das Nach oben/Nach unten verschieben-Symbol wird bei Speichern-Aktionen nicht angezeigt, da diese Art von Aktion immer die letzte Aktion eines Skripts sein muss.
•Wenn Sie auf das Nach oben/Nach unten verschieben-Symbol klicken, (i) werden alle Aktionssymbole durch ein einziges X-Symbol und (ii) alle Symbole jeder der anderen Aktionen durch einen Pfeil, der entweder nach oben oder nach unten weist, (siehe Abbildung unten) ersetzt. Wenn Sie nun auf einen dieser Pfeile klicken, wird die (durch ein X markierte) ursprünglich ausgewählte Aktion je nach Pfeilrichtung entweder oberhalb der Aktion, auf deren Pfeil Sie geklickt habe oder unterhalb der Aktion eingefügt. So kann etwa die "Send Email"-Aktion in der Abbildung unten entweder an die erste oder an die dritte Position in der Sequenz verschoben werden.
1. Skript bei Datensatzspeicherung
Definiert über: | Kontrollkästchen im oberen Bereich des Eingabeformulars: Skript bei Datensatzspeicherung |
Auslösung des Skripts: | bei Datensatzspeicherung |
Skriptaktionen: | (i) Ändert Felder des zu speichernden Datensatzes; (iii) erstellt über- und untergeordnete Datensätze; (iv) ändert/löscht untergeordnete Datensätze |
Mechanismen: | (i) Hinzufügung von Feldaktualisierungen; (ii) Hinzufügung von Bedingungen (oder Verzweigungen); (iii) Bearbeitung von anderen Datensätzen (für eine beliebige Datentabelle) oder Änderung/Löschung von Child-Datensätzen; (iv) Abrufen von Datensätzen; (v) Hinzufügung von E-Mails |
Sie können in jedem Skript dieser Art (i) die zu aktualisierenden Felder und deren Werte definieren (Feldaktualisierung hinzufügen); (ii) Bedingungen für die Aktualisierung festlegen (Verzweigung hinzufügen); (iii) Child-Datensätze oder Datensätze für jede beliebige Datentabelle erstellen oder Child-Datensätze ändern und löschen (Andere Datensätze bearbeiten) und (iv) eine E-Mail an ausgewählte Empfänger senden (E-Mail hinzufügen). Jede Option kann mehrmals ausgewählt werden. In der Abbildung unten sehen Sie das Skriptformular, nachdem Sie Aktionen zum Senden von E-Mails und Aktualisieren eines Felds dazu hinzugefügt haben.
Sie können die folgenden Aktionen zum Skript hinzufügen.
Bei Klick auf Feldaktualisierung hinzufügen, wird das Formular Feld aktualisieren angezeigt (Abbildung unten):
Hier können Sie einen neuen Wert für ein Datensatzfeld definieren:
•Wählen Sie in der Auswahlliste des Formulars aus, welches Feld des aktuellen Datensatzes bei Auslösung der Aktion aktualisiert werden soll. •Definieren Sie im Textfeld des Formulars den neuen Wert des Zielfelds. Wenn ein vordefinierter Wert verwendet werden soll, aktivieren Sie Fixwert und geben Sie den Wert ein. Wenn ein Wert dynamisch berechnet werden soll, aktivieren Sie Berechnung und geben Sie einen XPath-Ausdruck ein. •Da die Aktualisierung vom System und nicht von einem Benutzer durchgeführt wurde, wird sie unter Überwachen nicht automatisch markiert. Wenn die Aktualisierung in der Überwachung markiert erscheinen soll, aktivieren Sie das Kontrollkästchen Markieren.
|
Bei Klick auf Verzweigung hinzufügen, wird das Formular Verzweigung, wenn angezeigt (Abbildung unten). Mit Hilfe dieses Formulars können Sie einen Filter zur Auswahl des zu aktualisierenden Felds erstellen.
Über die Schaltflächen des Formulars können Sie Bedingungsverzweigungen hinzufügen. Eine Verzweigung hat die folgende Struktur: Überprüfung einer Gruppe von Bedingungen. Für jeden Fall (true oder false) wird die entsprechende Aktion für diese Art von Skript ausgeführt.
Für die einzelnen Skriptarten stehen die folgenden Aktionen zur Verfügung:
•Skript bei Datensatzspeicherung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails •Skript bei jeder Bearbeitung in diesem Formular: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters (siehe Abbildung unten). •Skript bei Feldbearbeitung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen •Skript hinter Schaltflächen: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Speichern eines Datensatzes; (iv) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails; (iii) Hinzufügung einer Meldung •Skript bei Änderung eines Child-Datensatzes: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters
Anmerkung: Sie können in den Parametern von Filtern XPath-Ausdrücke verwenden, um Parameterwerte zu generieren.
Nähere Informationen zur Verwendung der Schaltflächen des Formulars finden Sie unter Definieren von Bedingungsverzweigungen.
|
Mit Hilfe dieser Option können Sie: (i) Child-Datensätze oder Datensätze für jede beliebige Datentabelle erstellen und (ii) Child-Datensätze ändern und löschen.
Bei Klick auf Andere Datensätze bearbeiten, wird das Formular Datentabelle auswählen angezeigt (Abbildung unten). Wählen Sie entweder (i) die Child-Datentabelle, in der ein Datensatz erstellt, geändert oder gelöscht werden soll, aus oder (ii) wählen Sie eine beliebige andere, nicht untergeordnete Datentabelle, in der ein Datensatz erstellt werden soll. Beachten Sie, dass Sie (i) Datensätze in jeder Datentabelle, die sich nicht unterhalb der Child-Ebene befindet, erstellen können, dass Sie aber (ii) nur Datensätze von Child-Datentabellen ändern oder löschen können.
Bei Klick auf Weiter, wird das Formular Skript angezeigt (Abbildung unten). Hier können Sie ein Skript erstellen, (i) um einen neuen Datensatz für eine Child-Datentabelle zu erstellen; (ii) einen neuen Datensatz für jede beliebige andere Datenbanktabelle, die sich nicht unterhalb der Child-Ebene befindet, zu erstellen; (iii) Datensätze einer Child-Datentabelle zu ändern und (iv) Datensätze einer Child-Datentabelle zu löschen. Da Sie die Datentabelle des/der zu erstellenden, ändernden, löschenden Datensatzes/Datensätze bereits im vorherigen Schritt ausgewählt haben, klicken Sie nun auf das entsprechende Register (Erstellen, Ändern oder Löschen) und erstellen Sie das Skript für diese Aktion.
Beachten Sie die folgenden Punkte:
•Wenn Sie einen neuen Datensatz in einer Nicht-Child-Datentabelle erstellen, kann es sein, dass Datensätze der Datentabelle denselben neuen Datensatz mehrmals erstellen. In einem solchen Fall, steht eine Ersetzen-Option zur Verfügung. Aktivieren Sie sie, damit der Datensatz nur einmal erstellt wird. •Wenn Sie einen neuen Datensatz erstellen oder einen bestehenden ändern, können Sie ein Feld mit Hilfe der Aktion Feldaktualisierung hinzufügen ausfüllen oder aktualisieren. •Mit Hilfe der Aktion Verzweigung hinzufügen können Sie eine Auswahl durch Bedingungen, Filter und Suchen einschränken, bevor Sie Aktualisierungsaktionen hinzufügen. •Sie können alle oder bestimmte Datensätze einer Child-Datentabelle ändern. Bestimmte Datensätze können mit Hilfe von Bedingungen, Filtern und Suchen ausgewählt werden. •Sie können festlegen, dass bei Änderung von Child-Datensätzen ein neuer Datensatz erstellt wird, falls der Datensatz nicht vorhanden ist. •Sie können alle oder bestimmte Datensätze einer Child-Datentabelle löschen. Wie auch bei Änderungen (siehe vorheriger Punkt) können bestimmte Datensätze mit Hilfe von Bedingungen, Filtern und Suchen ausgewählt werden.
|
Bei Klick auf Datensätze abrufen erscheint das Formular mit dem Titel Gespeicherte Datensätze für Berechnungen abrufen (Abbildung unten). Mit Hilfe des Datensätze abrufen-Skripts können Sie Datensätze aus der Datenbank abrufen und in einer Variablen speichern. Mit Hilfe der Daten der Variablen können anschließend während der Bearbeitung des aktuellen Datensatzes Berechnungen durchgeführt werden. So können Sie z.B. einem Benutzer, während er die Daten einer Abteilung bearbeitet, eine Liste der Verträge dieser Abteilung anzeigen lassen. Dazu können Sie die Datensätze der Contract-Datentabelle abrufen und diese filtern, sodass nur die Verträge der aktuell ausgewählten Datentabelle angezeigt werden. In der Abbildung unten wird der Name der aktuellen Abteilung an den Parameter Department des Filters Expiring in 90 Days (läuft ab in 90 Tagen) übergeben. Folglich gibt der Filter nur diejenigen Datensätze zurück, in denen der Name der aktuellen Abteilung in dem Feld Contracting_Party eines Datensatzes enthalten ist.
Im Formular Datensätze abrufen geben Sie folgendermaßen an, welche Datensätze in einer Variablen enthalten sein sollen:
•Wählen Sie in der Auswahlliste Variable als Namen der Variablen einen der vordefinierten Werte aus. Dieser Variablenname muss innerhalb des Eingabeformulars eindeutig sein. •Wählen Sie in der Auswahlliste der Daten der Datentabelle die Datentabelle aus, aus der Datensätze in die Variable geladen werden sollen. •In der Auswahlliste Filter können Sie einen der Filter der Datentabelle auswählen, um ihn auf die Datenauswahl anzuwenden. Mit Hilfe eines Filters wird die Anzahl der zu ladenden Datensätze eingeschränkt, um so den Speicherbedarf zu verringern. Wenn für einen Filter Parameter definiert wurden, so wird jeder Parameter zusammen mit einem Eingabefeld für seinen Wert aufgelistet. Hier können Sie einen XPath-Ausdruck eingeben, um den Wert zu generieren. Klicken Sie alternativ auf die Schaltfläche Bearbeiten und wählen Sie einen aus der Liste der automatisch generierten kontextbasierten Ausdrücke aus. Der XPath-Ausdruck in der Abbildung unten lautet: $FetchedRecords_A/Name, womit das in der Variablen $FetchedRecords_A enthaltene Feld Name ausgewählt wird (diese Variable ist eine weitere im aktuellen Eingabeformular definierte Variable, die die Felder des aktuellen Datensatzes enthält). •Wählen Sie in der Einstellung Felder die Felder der in der Variablen zu speichernden ausgewählten Datensätze aus. Wählen Sie nur die benötigten Felder aus, um den Speicherbedarf zu verringern. •Mit der Einstellung Wie oft legen Sie fest, wann die Variable aktualisiert werden soll: entweder einmal, wenn das Skript zum ersten Mal ausgeführt wird und bis der Datensatz fertig bearbeitet ist oder bei jeder Ausführung des Skripts. Wenn Sie die zweite Option auswählen, werden im Skript immer die aktuellsten Daten aus der Datenbank verwendet.
|
Sie können bei der Erstellung von Skripts für Aktionen, die (i) beim Speichern eines Datensatzes und (ii) bei Schaltflächenklick ausgeführt werden sollen, auf E-Mail hinzufügen klicken, um das Skript für zum Senden von E-Mails an ausgewählte Empfänger über eines der für die aktuelle Datentabelle definierten E-Mail Formulare einzurichten.
Bei Klick auf E-Mail hinzufügen, wird das Formular E-Mail senden angezeigt (Abbildung unten):
Im Formular wird Folgendes definiert:
•Welches E-Mail-Formular verwendet werden soll. Wählen Sie im Dropdown-Feld eines der für die Datentabelle definierten E-Mail-Formulare aus. Wenn keines vorhanden ist, erstellen Sie eines, wie im Kapitel E-Mail-Formulare beschrieben. •Wählen Sie durch Aktivieren des entsprechenden Kästchens Empfänger für die Zeilen An, Cc und/oder Bcc der E-Mail aus.
Auswählen von E-Mail-EmpfängernE-Mail-Empfänger können nach folgenden Kriterien ausgewählte werden:
•Bestimmte Benutzer nach Namen •Benutzer aus Benutzergruppen. Dabei stehen Option zur Verfügung, welche Gruppen und welche Benutzer in den Gruppen ausgewählt werden sollen (siehe Abbildung unten) •Alle Gruppenleiter
Beachten Sie, dass Sie mehr als ein Auswahlkriterium verwenden können.
|
2. Skript bei Bearbeitung eins beliebigen Felds eines Datensatzes
Definiert über: | Kontrollkästchen im oberen Bereich des Eingabeformulars: Skript bei jeder Bearbeitung in diesem Formular |
Auslösung des Skripts: | Wenn ein beliebiges Feld eines Datensatzes bearbeitet wird |
Skriptaktionen: | Ändert Felder des bearbeiteten Datensatzes |
Mechanismen: | (i) Hinzufügung von Feldaktualisierungen; (ii) Hinzufügung von Bedingungen (oder Verzweigungen); (iii) Abrufen von Datensätzen |
Mit Hilfe dieser Skripts können Sie (i) die zu aktualisierenden Felder und deren Werte definieren (Feldaktualisierung hinzufügen) und (ii) Bedingungen für die Aktualisierung festlegen (Verzweigung hinzufügen). Beide Optionen können mehrmals ausgewählt werden. Wenn das vom Benutzer bearbeitete Feld ein eigenes Skript hat (siehe Skripttyp 3 weiter unten), so wird dieses Skript vor diesem Skript ausgeführt, d.h. wenn beide Skripts dasselbe Feld aktualisieren, überschreibt dieses Skript alle zuvor aktualisierten Werte des Zielfelds.
Sie können die folgenden Mechanismen zum Skript hinzufügen.
Bei Klick auf Feldaktualisierung hinzufügen, wird das Formular Feld aktualisieren angezeigt (Abbildung unten):
Hier können Sie einen neuen Wert für ein Datensatzfeld definieren:
•Wählen Sie in der Auswahlliste des Formulars aus, welches Feld des aktuellen Datensatzes bei Auslösung der Aktion aktualisiert werden soll. •Definieren Sie im Textfeld des Formulars den neuen Wert des Zielfelds. Wenn ein vordefinierter Wert verwendet werden soll, aktivieren Sie Fixwert und geben Sie den Wert ein. Wenn ein Wert dynamisch berechnet werden soll, aktivieren Sie Berechnung und geben Sie einen XPath-Ausdruck ein. •Da die Aktualisierung vom System und nicht von einem Benutzer durchgeführt wurde, wird sie unter Überwachen nicht automatisch markiert. Wenn die Aktualisierung in der Überwachung markiert erscheinen soll, aktivieren Sie das Kontrollkästchen Markieren.
|
Bei Klick auf Verzweigung hinzufügen, wird das Formular Verzweigung, wenn angezeigt (Abbildung unten). Mit Hilfe dieses Formulars können Sie einen Filter zur Auswahl des zu aktualisierenden Felds erstellen.
Über die Schaltflächen des Formulars können Sie Bedingungsverzweigungen hinzufügen. Eine Verzweigung hat die folgende Struktur: Überprüfung einer Gruppe von Bedingungen. Für jeden Fall (true oder false) wird die entsprechende Aktion für diese Art von Skript ausgeführt.
Für die einzelnen Skriptarten stehen die folgenden Aktionen zur Verfügung:
•Skript bei Datensatzspeicherung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails •Skript bei jeder Bearbeitung in diesem Formular: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters (siehe Abbildung unten). •Skript bei Feldbearbeitung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen •Skript hinter Schaltflächen: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Speichern eines Datensatzes; (iv) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails; (iii) Hinzufügung einer Meldung •Skript bei Änderung eines Child-Datensatzes: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters
Anmerkung: Sie können in den Parametern von Filtern XPath-Ausdrücke verwenden, um Parameterwerte zu generieren.
Nähere Informationen zur Verwendung der Schaltflächen des Formulars finden Sie unter Definieren von Bedingungsverzweigungen.
|
Bei Klick auf Datensätze abrufen erscheint das Formular mit dem Titel Gespeicherte Datensätze für Berechnungen abrufen (Abbildung unten). Mit Hilfe des Datensätze abrufen-Skripts können Sie Datensätze aus der Datenbank abrufen und in einer Variablen speichern. Mit Hilfe der Daten der Variablen können anschließend während der Bearbeitung des aktuellen Datensatzes Berechnungen durchgeführt werden. So können Sie z.B. einem Benutzer, während er die Daten einer Abteilung bearbeitet, eine Liste der Verträge dieser Abteilung anzeigen lassen. Dazu können Sie die Datensätze der Contract-Datentabelle abrufen und diese filtern, sodass nur die Verträge der aktuell ausgewählten Datentabelle angezeigt werden. In der Abbildung unten wird der Name der aktuellen Abteilung an den Parameter Department des Filters Expiring in 90 Days (läuft ab in 90 Tagen) übergeben. Folglich gibt der Filter nur diejenigen Datensätze zurück, in denen der Name der aktuellen Abteilung in dem Feld Contracting_Party eines Datensatzes enthalten ist.
Im Formular Datensätze abrufen geben Sie folgendermaßen an, welche Datensätze in einer Variablen enthalten sein sollen:
•Wählen Sie in der Auswahlliste Variable als Namen der Variablen einen der vordefinierten Werte aus. Dieser Variablenname muss innerhalb des Eingabeformulars eindeutig sein. •Wählen Sie in der Auswahlliste der Daten der Datentabelle die Datentabelle aus, aus der Datensätze in die Variable geladen werden sollen. •In der Auswahlliste Filter können Sie einen der Filter der Datentabelle auswählen, um ihn auf die Datenauswahl anzuwenden. Mit Hilfe eines Filters wird die Anzahl der zu ladenden Datensätze eingeschränkt, um so den Speicherbedarf zu verringern. Wenn für einen Filter Parameter definiert wurden, so wird jeder Parameter zusammen mit einem Eingabefeld für seinen Wert aufgelistet. Hier können Sie einen XPath-Ausdruck eingeben, um den Wert zu generieren. Klicken Sie alternativ auf die Schaltfläche Bearbeiten und wählen Sie einen aus der Liste der automatisch generierten kontextbasierten Ausdrücke aus. Der XPath-Ausdruck in der Abbildung unten lautet: $FetchedRecords_A/Name, womit das in der Variablen $FetchedRecords_A enthaltene Feld Name ausgewählt wird (diese Variable ist eine weitere im aktuellen Eingabeformular definierte Variable, die die Felder des aktuellen Datensatzes enthält). •Wählen Sie in der Einstellung Felder die Felder der in der Variablen zu speichernden ausgewählten Datensätze aus. Wählen Sie nur die benötigten Felder aus, um den Speicherbedarf zu verringern. •Mit der Einstellung Wie oft legen Sie fest, wann die Variable aktualisiert werden soll: entweder einmal, wenn das Skript zum ersten Mal ausgeführt wird und bis der Datensatz fertig bearbeitet ist oder bei jeder Ausführung des Skripts. Wenn Sie die zweite Option auswählen, werden im Skript immer die aktuellsten Daten aus der Datenbank verwendet.
|
3. Skript bei Bearbeitung eins bestimmten Felds eines Datensatzes
Wird wo definiert: | Als Feldeigenschaft |
Auslösung des Skripts: | Wenn dieses bestimmte Feld bearbeitet wird |
Skriptaktionen: | (i) Ändert andere Felder des Datensatzes, der das bearbeitete Feld enthält; (ii) erstellt über- und untergeordnete Datensätze; (iii) ändert/löscht untergeordnete Datensätze |
Mechanismen: | (i) Hinzufügung von Feldaktualisierungen; (ii) Hinzufügung von Bedingungen (oder Verzweigungen); (iii) Hinzufügung von anderen Datensätzen (für eine beliebige Datentabelle) oder Änderung/Löschung von Child-Datensätzen; (iv) Abrufen von Datensätzen |
Diese Art von Skript wird für ein Feld zum Zeitpunkt der Erstellung des Felds im Eingabeformular als eine der Eigenschaften eines Felds definiert. Sie können mit dem Skript (i) die zu aktualisierenden Felder und deren Werte festlegen (Feldaktualisierung hinzufügen); (ii) Bedingungen für die Aktualisierung definieren (Verzweigung hinzufügen) und (iii) Child-Datensätze oder Datensätze für jede beliebige Datentabelle erstellen oder Child-Datensätze ändern und löschen (Andere Datensätze bearbeiten). Jede dieser Optionen kann mehrmals ausgewählt werden. Beachten Sie Folgendes: Wenn ein weiteres Skript, das bei jeder Bearbeitung im Formular ausgeführt wird, definiert ist, so würde dieses Skript die Aktualisierung dieses Skripts überschreiben, wenn beide dasselbe Feld aktualisieren (siehe Skripttyp 2 weiter oben).
Sie können die folgenden Mechanismen zum Skript hinzufügen.
Bei Klick auf Feldaktualisierung hinzufügen, wird das Formular Feld aktualisieren angezeigt (Abbildung unten):
Hier können Sie einen neuen Wert für ein Datensatzfeld definieren:
•Wählen Sie in der Auswahlliste des Formulars aus, welches Feld des aktuellen Datensatzes bei Auslösung der Aktion aktualisiert werden soll. •Definieren Sie im Textfeld des Formulars den neuen Wert des Zielfelds. Wenn ein vordefinierter Wert verwendet werden soll, aktivieren Sie Fixwert und geben Sie den Wert ein. Wenn ein Wert dynamisch berechnet werden soll, aktivieren Sie Berechnung und geben Sie einen XPath-Ausdruck ein. •Da die Aktualisierung vom System und nicht von einem Benutzer durchgeführt wurde, wird sie unter Überwachen nicht automatisch markiert. Wenn die Aktualisierung in der Überwachung markiert erscheinen soll, aktivieren Sie das Kontrollkästchen Markieren.
|
Bei Klick auf Verzweigung hinzufügen, wird das Formular Verzweigung, wenn angezeigt (Abbildung unten). Mit Hilfe dieses Formulars können Sie einen Filter zur Auswahl des zu aktualisierenden Felds erstellen.
Über die Schaltflächen des Formulars können Sie Bedingungsverzweigungen hinzufügen. Eine Verzweigung hat die folgende Struktur: Überprüfung einer Gruppe von Bedingungen. Für jeden Fall (true oder false) wird die entsprechende Aktion für diese Art von Skript ausgeführt.
Für die einzelnen Skriptarten stehen die folgenden Aktionen zur Verfügung:
•Skript bei Datensatzspeicherung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails •Skript bei jeder Bearbeitung in diesem Formular: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters (siehe Abbildung unten). •Skript bei Feldbearbeitung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen •Skript hinter Schaltflächen: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Speichern eines Datensatzes; (iv) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails; (iii) Hinzufügung einer Meldung •Skript bei Änderung eines Child-Datensatzes: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters
Anmerkung: Sie können in den Parametern von Filtern XPath-Ausdrücke verwenden, um Parameterwerte zu generieren.
Nähere Informationen zur Verwendung der Schaltflächen des Formulars finden Sie unter Definieren von Bedingungsverzweigungen.
|
Mit Hilfe dieser Option können Sie: (i) Child-Datensätze oder Datensätze für jede beliebige Datentabelle erstellen und (ii) Child-Datensätze ändern und löschen.
Bei Klick auf Andere Datensätze bearbeiten, wird das Formular Datentabelle auswählen angezeigt (Abbildung unten). Wählen Sie entweder (i) die Child-Datentabelle, in der ein Datensatz erstellt, geändert oder gelöscht werden soll, aus oder (ii) wählen Sie eine beliebige andere, nicht untergeordnete Datentabelle, in der ein Datensatz erstellt werden soll. Beachten Sie, dass Sie (i) Datensätze in jeder Datentabelle, die sich nicht unterhalb der Child-Ebene befindet, erstellen können, dass Sie aber (ii) nur Datensätze von Child-Datentabellen ändern oder löschen können.
Bei Klick auf Weiter, wird das Formular Skript angezeigt (Abbildung unten). Hier können Sie ein Skript erstellen, (i) um einen neuen Datensatz für eine Child-Datentabelle zu erstellen; (ii) einen neuen Datensatz für jede beliebige andere Datenbanktabelle, die sich nicht unterhalb der Child-Ebene befindet, zu erstellen; (iii) Datensätze einer Child-Datentabelle zu ändern und (iv) Datensätze einer Child-Datentabelle zu löschen. Da Sie die Datentabelle des/der zu erstellenden, ändernden, löschenden Datensatzes/Datensätze bereits im vorherigen Schritt ausgewählt haben, klicken Sie nun auf das entsprechende Register (Erstellen, Ändern oder Löschen) und erstellen Sie das Skript für diese Aktion.
Beachten Sie die folgenden Punkte:
•Wenn Sie einen neuen Datensatz in einer Nicht-Child-Datentabelle erstellen, kann es sein, dass Datensätze der Datentabelle denselben neuen Datensatz mehrmals erstellen. In einem solchen Fall, steht eine Ersetzen-Option zur Verfügung. Aktivieren Sie sie, damit der Datensatz nur einmal erstellt wird. •Wenn Sie einen neuen Datensatz erstellen oder einen bestehenden ändern, können Sie ein Feld mit Hilfe der Aktion Feldaktualisierung hinzufügen ausfüllen oder aktualisieren. •Mit Hilfe der Aktion Verzweigung hinzufügen können Sie eine Auswahl durch Bedingungen, Filter und Suchen einschränken, bevor Sie Aktualisierungsaktionen hinzufügen. •Sie können alle oder bestimmte Datensätze einer Child-Datentabelle ändern. Bestimmte Datensätze können mit Hilfe von Bedingungen, Filtern und Suchen ausgewählt werden. •Sie können festlegen, dass bei Änderung von Child-Datensätzen ein neuer Datensatz erstellt wird, falls der Datensatz nicht vorhanden ist. •Sie können alle oder bestimmte Datensätze einer Child-Datentabelle löschen. Wie auch bei Änderungen (siehe vorheriger Punkt) können bestimmte Datensätze mit Hilfe von Bedingungen, Filtern und Suchen ausgewählt werden.
|
Bei Klick auf Datensätze abrufen erscheint das Formular mit dem Titel Gespeicherte Datensätze für Berechnungen abrufen (Abbildung unten). Mit Hilfe des Datensätze abrufen-Skripts können Sie Datensätze aus der Datenbank abrufen und in einer Variablen speichern. Mit Hilfe der Daten der Variablen können anschließend während der Bearbeitung des aktuellen Datensatzes Berechnungen durchgeführt werden. So können Sie z.B. einem Benutzer, während er die Daten einer Abteilung bearbeitet, eine Liste der Verträge dieser Abteilung anzeigen lassen. Dazu können Sie die Datensätze der Contract-Datentabelle abrufen und diese filtern, sodass nur die Verträge der aktuell ausgewählten Datentabelle angezeigt werden. In der Abbildung unten wird der Name der aktuellen Abteilung an den Parameter Department des Filters Expiring in 90 Days (läuft ab in 90 Tagen) übergeben. Folglich gibt der Filter nur diejenigen Datensätze zurück, in denen der Name der aktuellen Abteilung in dem Feld Contracting_Party eines Datensatzes enthalten ist.
Im Formular Datensätze abrufen geben Sie folgendermaßen an, welche Datensätze in einer Variablen enthalten sein sollen:
•Wählen Sie in der Auswahlliste Variable als Namen der Variablen einen der vordefinierten Werte aus. Dieser Variablenname muss innerhalb des Eingabeformulars eindeutig sein. •Wählen Sie in der Auswahlliste der Daten der Datentabelle die Datentabelle aus, aus der Datensätze in die Variable geladen werden sollen. •In der Auswahlliste Filter können Sie einen der Filter der Datentabelle auswählen, um ihn auf die Datenauswahl anzuwenden. Mit Hilfe eines Filters wird die Anzahl der zu ladenden Datensätze eingeschränkt, um so den Speicherbedarf zu verringern. Wenn für einen Filter Parameter definiert wurden, so wird jeder Parameter zusammen mit einem Eingabefeld für seinen Wert aufgelistet. Hier können Sie einen XPath-Ausdruck eingeben, um den Wert zu generieren. Klicken Sie alternativ auf die Schaltfläche Bearbeiten und wählen Sie einen aus der Liste der automatisch generierten kontextbasierten Ausdrücke aus. Der XPath-Ausdruck in der Abbildung unten lautet: $FetchedRecords_A/Name, womit das in der Variablen $FetchedRecords_A enthaltene Feld Name ausgewählt wird (diese Variable ist eine weitere im aktuellen Eingabeformular definierte Variable, die die Felder des aktuellen Datensatzes enthält). •Wählen Sie in der Einstellung Felder die Felder der in der Variablen zu speichernden ausgewählten Datensätze aus. Wählen Sie nur die benötigten Felder aus, um den Speicherbedarf zu verringern. •Mit der Einstellung Wie oft legen Sie fest, wann die Variable aktualisiert werden soll: entweder einmal, wenn das Skript zum ersten Mal ausgeführt wird und bis der Datensatz fertig bearbeitet ist oder bei jeder Ausführung des Skripts. Wenn Sie die zweite Option auswählen, werden im Skript immer die aktuellsten Daten aus der Datenbank verwendet.
|
4. Skript bei Schaltflächenklick
Wird wo definiert: | |
Auslösung des Skripts: | Bei Klick auf die Schaltfläche |
Skriptaktionen: | (i) Ändert Felder des zu speichernden Datensatzes; (ii) erstellt über- und untergeordnete Datensätze; (iii) ändert/löscht Child-Datensätze; (iv) sendet E-Mails; (iii) zeigt Meldungen an |
Mechanismen: | (i) Hinzufügung von Feldaktualisierungen; (ii) Hinzufügung von Bedingungen (oder Verzweigungen); (iii) Speichern des Datensatzes; |
Skripts dieser Art werden beim Klick auf eine Schaltfläche eines Eingabeformulars ausgeführt. Sie können mit dem Skript (i) die zu aktualisierenden Felder und deren Werte definieren (Feldaktualisierung hinzufügen); (ii) Bedingungen für die Aktualisierung festlegen (Verzweigung hinzufügen); (iii) den Datensatz speichern (Datensatz speichern); (iv) über- und untergeordnete Datensätze erstellen oder Child-Datensätze ändern und löschen (Andere Datensätze bearbeiten); (v) eine E-Mail an ausgewählte Empfänger senden (E-Mail hinzufügen) und (vi) eine Meldung anzeigen (Meldung hinzufügen). Jede Option mit Ausnahme von Datensatz speichern kann mehrmals verwendet werden.
Sie können die folgenden Mechanismen zum Skript hinzufügen:
Bei Klick auf Feldaktualisierung hinzufügen, wird das Formular Feld aktualisieren angezeigt (Abbildung unten):
Hier können Sie einen neuen Wert für ein Datensatzfeld definieren:
•Wählen Sie in der Auswahlliste des Formulars aus, welches Feld des aktuellen Datensatzes bei Auslösung der Aktion aktualisiert werden soll. •Definieren Sie im Textfeld des Formulars den neuen Wert des Zielfelds. Wenn ein vordefinierter Wert verwendet werden soll, aktivieren Sie Fixwert und geben Sie den Wert ein. Wenn ein Wert dynamisch berechnet werden soll, aktivieren Sie Berechnung und geben Sie einen XPath-Ausdruck ein. •Da die Aktualisierung vom System und nicht von einem Benutzer durchgeführt wurde, wird sie unter Überwachen nicht automatisch markiert. Wenn die Aktualisierung in der Überwachung markiert erscheinen soll, aktivieren Sie das Kontrollkästchen Markieren.
|
Bei Klick auf Verzweigung hinzufügen, wird das Formular Verzweigung, wenn angezeigt (Abbildung unten). Mit Hilfe dieses Formulars können Sie einen Filter zur Auswahl des zu aktualisierenden Felds erstellen.
Über die Schaltflächen des Formulars können Sie Bedingungsverzweigungen hinzufügen. Eine Verzweigung hat die folgende Struktur: Überprüfung einer Gruppe von Bedingungen. Für jeden Fall (true oder false) wird die entsprechende Aktion für diese Art von Skript ausgeführt.
Für die einzelnen Skriptarten stehen die folgenden Aktionen zur Verfügung:
•Skript bei Datensatzspeicherung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails •Skript bei jeder Bearbeitung in diesem Formular: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters (siehe Abbildung unten). •Skript bei Feldbearbeitung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen •Skript hinter Schaltflächen: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Speichern eines Datensatzes; (iv) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails; (iii) Hinzufügung einer Meldung •Skript bei Änderung eines Child-Datensatzes: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters
Anmerkung: Sie können in den Parametern von Filtern XPath-Ausdrücke verwenden, um Parameterwerte zu generieren.
Nähere Informationen zur Verwendung der Schaltflächen des Formulars finden Sie unter Definieren von Bedingungsverzweigungen.
|
Bei Klick auf Speichern hinzufügen, wird das Formular Datensatz speichern angezeigt (Abbildung unten). Mit der Aktion "Datensatz speichern" wird der aktuelle Datensatz nach Ausführung aller Aktionen des Skripts gespeichert. Diese Aktion wird immer als letzte Aktion des Skripts hinzugefügt und kann nur einmal pro Skript hinzugefügt werden.
Sie können auswählen, was nach Speicherung des Datensatzes geschehen soll:
•Wählen Sie Und nächsten Datensatz anzeigen oder Und vorherigen Datensatz anzeigen, um zum nächsten bzw. zum vorherigen Datensatz zu gelangen, nachdem der aktuelle Datensatz gespeichert wurde. Es kann nur eine dieser Optionen ausgewählt werden. •Aktivieren oder deaktivieren Sie die Option Nach dem Speichern zurück zur Datensatzliste gehen , um entweder zurück zur Datensatzliste zu gelangen oder beim aktuellen Datensatz zu bleiben (siehe Abbildung). Wenn eine der anderen Kontrollkästchenoptionen aktiviert ist, so wird die Option, zur Datensatzliste zurückzugehen, nur dann aktiv, wenn es keinen nächsten oder vorhergehenden Datensatz gibt.
|
Mit Hilfe dieser Option können Sie: (i) Child-Datensätze oder Datensätze für jede beliebige Datentabelle erstellen und (ii) Child-Datensätze ändern und löschen.
Bei Klick auf Andere Datensätze bearbeiten, wird das Formular Datentabelle auswählen angezeigt (Abbildung unten). Wählen Sie entweder (i) die Child-Datentabelle, in der ein Datensatz erstellt, geändert oder gelöscht werden soll, aus oder (ii) wählen Sie eine beliebige andere, nicht untergeordnete Datentabelle, in der ein Datensatz erstellt werden soll. Beachten Sie, dass Sie (i) Datensätze in jeder Datentabelle, die sich nicht unterhalb der Child-Ebene befindet, erstellen können, dass Sie aber (ii) nur Datensätze von Child-Datentabellen ändern oder löschen können.
Bei Klick auf Weiter, wird das Formular Skript angezeigt (Abbildung unten). Hier können Sie ein Skript erstellen, (i) um einen neuen Datensatz für eine Child-Datentabelle zu erstellen; (ii) einen neuen Datensatz für jede beliebige andere Datenbanktabelle, die sich nicht unterhalb der Child-Ebene befindet, zu erstellen; (iii) Datensätze einer Child-Datentabelle zu ändern und (iv) Datensätze einer Child-Datentabelle zu löschen. Da Sie die Datentabelle des/der zu erstellenden, ändernden, löschenden Datensatzes/Datensätze bereits im vorherigen Schritt ausgewählt haben, klicken Sie nun auf das entsprechende Register (Erstellen, Ändern oder Löschen) und erstellen Sie das Skript für diese Aktion.
Beachten Sie die folgenden Punkte:
•Wenn Sie einen neuen Datensatz in einer Nicht-Child-Datentabelle erstellen, kann es sein, dass Datensätze der Datentabelle denselben neuen Datensatz mehrmals erstellen. In einem solchen Fall, steht eine Ersetzen-Option zur Verfügung. Aktivieren Sie sie, damit der Datensatz nur einmal erstellt wird. •Wenn Sie einen neuen Datensatz erstellen oder einen bestehenden ändern, können Sie ein Feld mit Hilfe der Aktion Feldaktualisierung hinzufügen ausfüllen oder aktualisieren. •Mit Hilfe der Aktion Verzweigung hinzufügen können Sie eine Auswahl durch Bedingungen, Filter und Suchen einschränken, bevor Sie Aktualisierungsaktionen hinzufügen. •Sie können alle oder bestimmte Datensätze einer Child-Datentabelle ändern. Bestimmte Datensätze können mit Hilfe von Bedingungen, Filtern und Suchen ausgewählt werden. •Sie können festlegen, dass bei Änderung von Child-Datensätzen ein neuer Datensatz erstellt wird, falls der Datensatz nicht vorhanden ist. •Sie können alle oder bestimmte Datensätze einer Child-Datentabelle löschen. Wie auch bei Änderungen (siehe vorheriger Punkt) können bestimmte Datensätze mit Hilfe von Bedingungen, Filtern und Suchen ausgewählt werden.
|
Bei Klick auf Datensätze abrufen erscheint das Formular mit dem Titel Gespeicherte Datensätze für Berechnungen abrufen (Abbildung unten). Mit Hilfe des Datensätze abrufen-Skripts können Sie Datensätze aus der Datenbank abrufen und in einer Variablen speichern. Mit Hilfe der Daten der Variablen können anschließend während der Bearbeitung des aktuellen Datensatzes Berechnungen durchgeführt werden. So können Sie z.B. einem Benutzer, während er die Daten einer Abteilung bearbeitet, eine Liste der Verträge dieser Abteilung anzeigen lassen. Dazu können Sie die Datensätze der Contract-Datentabelle abrufen und diese filtern, sodass nur die Verträge der aktuell ausgewählten Datentabelle angezeigt werden. In der Abbildung unten wird der Name der aktuellen Abteilung an den Parameter Department des Filters Expiring in 90 Days (läuft ab in 90 Tagen) übergeben. Folglich gibt der Filter nur diejenigen Datensätze zurück, in denen der Name der aktuellen Abteilung in dem Feld Contracting_Party eines Datensatzes enthalten ist.
Im Formular Datensätze abrufen geben Sie folgendermaßen an, welche Datensätze in einer Variablen enthalten sein sollen:
•Wählen Sie in der Auswahlliste Variable als Namen der Variablen einen der vordefinierten Werte aus. Dieser Variablenname muss innerhalb des Eingabeformulars eindeutig sein. •Wählen Sie in der Auswahlliste der Daten der Datentabelle die Datentabelle aus, aus der Datensätze in die Variable geladen werden sollen. •In der Auswahlliste Filter können Sie einen der Filter der Datentabelle auswählen, um ihn auf die Datenauswahl anzuwenden. Mit Hilfe eines Filters wird die Anzahl der zu ladenden Datensätze eingeschränkt, um so den Speicherbedarf zu verringern. Wenn für einen Filter Parameter definiert wurden, so wird jeder Parameter zusammen mit einem Eingabefeld für seinen Wert aufgelistet. Hier können Sie einen XPath-Ausdruck eingeben, um den Wert zu generieren. Klicken Sie alternativ auf die Schaltfläche Bearbeiten und wählen Sie einen aus der Liste der automatisch generierten kontextbasierten Ausdrücke aus. Der XPath-Ausdruck in der Abbildung unten lautet: $FetchedRecords_A/Name, womit das in der Variablen $FetchedRecords_A enthaltene Feld Name ausgewählt wird (diese Variable ist eine weitere im aktuellen Eingabeformular definierte Variable, die die Felder des aktuellen Datensatzes enthält). •Wählen Sie in der Einstellung Felder die Felder der in der Variablen zu speichernden ausgewählten Datensätze aus. Wählen Sie nur die benötigten Felder aus, um den Speicherbedarf zu verringern. •Mit der Einstellung Wie oft legen Sie fest, wann die Variable aktualisiert werden soll: entweder einmal, wenn das Skript zum ersten Mal ausgeführt wird und bis der Datensatz fertig bearbeitet ist oder bei jeder Ausführung des Skripts. Wenn Sie die zweite Option auswählen, werden im Skript immer die aktuellsten Daten aus der Datenbank verwendet.
|
Sie können bei der Erstellung von Skripts für Aktionen, die (i) beim Speichern eines Datensatzes und (ii) bei Schaltflächenklick ausgeführt werden sollen, auf E-Mail hinzufügen klicken, um das Skript für zum Senden von E-Mails an ausgewählte Empfänger über eines der für die aktuelle Datentabelle definierten E-Mail Formulare einzurichten.
Bei Klick auf E-Mail hinzufügen, wird das Formular E-Mail senden angezeigt (Abbildung unten):
Im Formular wird Folgendes definiert:
•Welches E-Mail-Formular verwendet werden soll. Wählen Sie im Dropdown-Feld eines der für die Datentabelle definierten E-Mail-Formulare aus. Wenn keines vorhanden ist, erstellen Sie eines, wie im Kapitel E-Mail-Formulare beschrieben. •Wählen Sie durch Aktivieren des entsprechenden Kästchens Empfänger für die Zeilen An, Cc und/oder Bcc der E-Mail aus.
Auswählen von E-Mail-EmpfängernE-Mail-Empfänger können nach folgenden Kriterien ausgewählte werden:
•Bestimmte Benutzer nach Namen •Benutzer aus Benutzergruppen. Dabei stehen Option zur Verfügung, welche Gruppen und welche Benutzer in den Gruppen ausgewählt werden sollen (siehe Abbildung unten) •Alle Gruppenleiter
Beachten Sie, dass Sie mehr als ein Auswahlkriterium verwenden können.
|
Sie können zu den von Ihrem Skript durchgeführten Aktionen eine Meldung hinzufügen. So können Sie dem Benutzer etwa beim Start eines Schaltflächen-Skripts eine Meldung anzeigen lassen, die Informationen über den Inhalt des Skripts enthält.
Bei Klick auf Meldung hinzufügen, wird das Formular Meldung anzeigen angezeigt (Abbildung unten). Sie können (i) die Meldung direkt als Text (Fixwert) oder als XPath-Ausdruck (Berechnung) hinzufügen, (ii) die Farbe des angezeigten Texts auswählen (so ist z.B. die Fehler-Farbe Rot) und (iii) festlegen, dass die Meldung entweder sofort bei Auslösung der Aktion "Meldung hinzufügen" oder bei Beendung des Skripts angezeigt wird.
|
5. Skript bei Bearbeitung eines Child-Datensatzes
Wird wo definiert: | Als Eigenschaft des Child-Zeileneintrags einer Datentabelle (die eine Child-Datentabelle hat) |
Auslösung des Skripts: | Wenn eine Child-Zeile der Datentabelle bearbeitet wird |
Skriptaktionen: | Ändert Felder des Datensatzes, der den bearbeiteten Child-Datensatz enthält |
Mechanismen: | (i) Hinzufügung von Feldaktualisierungen; (ii) Hinzufügung von Bedingungen (oder Verzweigungen); (iii) Abrufen von Datensätzen |
Diese Art von Skript steht in Datentabellen, die Child-Zeilen haben, zur Verfügung. Im Eingabeformular einer solchen Datentabelle können Sie Child-Zeilen zu einer Tabellenzelle des Eingabeformulars hinzufügen. Aktivieren Sie in der Definition von Child-Zeilen die Option Bearbeitung von <Child> Datensätzen erlauben (Abbildung unten) und wählen Sie ein Eingabeformular der Child-Datentabelle aus. Sie können nun ein Skript der aktuellen Datentabelle definieren, das ausgeführt werden soll, wenn der Child-Datensatz (unten rot umrahmt) bearbeitet wird.
Mit dieser Art von Skripts können Sie (i) die zu aktualisierenden Felder und deren Werte definieren (Feldaktualisierung hinzufügen) und (ii) Bedingungen für die Aktualisierung festlegen (Verzweigung hinzufügen). Beide Optionen können mehrmals ausgewählt werden.
Bei Klick auf Feldaktualisierung hinzufügen, wird das Formular Feld aktualisieren angezeigt (Abbildung unten):
Hier können Sie einen neuen Wert für ein Datensatzfeld definieren:
•Wählen Sie in der Auswahlliste des Formulars aus, welches Feld des aktuellen Datensatzes bei Auslösung der Aktion aktualisiert werden soll. •Definieren Sie im Textfeld des Formulars den neuen Wert des Zielfelds. Wenn ein vordefinierter Wert verwendet werden soll, aktivieren Sie Fixwert und geben Sie den Wert ein. Wenn ein Wert dynamisch berechnet werden soll, aktivieren Sie Berechnung und geben Sie einen XPath-Ausdruck ein. •Da die Aktualisierung vom System und nicht von einem Benutzer durchgeführt wurde, wird sie unter Überwachen nicht automatisch markiert. Wenn die Aktualisierung in der Überwachung markiert erscheinen soll, aktivieren Sie das Kontrollkästchen Markieren.
|
Bei Klick auf Verzweigung hinzufügen, wird das Formular Verzweigung, wenn angezeigt (Abbildung unten). Mit Hilfe dieses Formulars können Sie einen Filter zur Auswahl des zu aktualisierenden Felds erstellen.
Über die Schaltflächen des Formulars können Sie Bedingungsverzweigungen hinzufügen. Eine Verzweigung hat die folgende Struktur: Überprüfung einer Gruppe von Bedingungen. Für jeden Fall (true oder false) wird die entsprechende Aktion für diese Art von Skript ausgeführt.
Für die einzelnen Skriptarten stehen die folgenden Aktionen zur Verfügung:
•Skript bei Datensatzspeicherung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails •Skript bei jeder Bearbeitung in diesem Formular: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters (siehe Abbildung unten). •Skript bei Feldbearbeitung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen •Skript hinter Schaltflächen: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Speichern eines Datensatzes; (iv) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails; (iii) Hinzufügung einer Meldung •Skript bei Änderung eines Child-Datensatzes: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters
Anmerkung: Sie können in den Parametern von Filtern XPath-Ausdrücke verwenden, um Parameterwerte zu generieren.
Nähere Informationen zur Verwendung der Schaltflächen des Formulars finden Sie unter Definieren von Bedingungsverzweigungen.
|
Bei Klick auf Datensätze abrufen erscheint das Formular mit dem Titel Gespeicherte Datensätze für Berechnungen abrufen (Abbildung unten). Mit Hilfe des Datensätze abrufen-Skripts können Sie Datensätze aus der Datenbank abrufen und in einer Variablen speichern. Mit Hilfe der Daten der Variablen können anschließend während der Bearbeitung des aktuellen Datensatzes Berechnungen durchgeführt werden. So können Sie z.B. einem Benutzer, während er die Daten einer Abteilung bearbeitet, eine Liste der Verträge dieser Abteilung anzeigen lassen. Dazu können Sie die Datensätze der Contract-Datentabelle abrufen und diese filtern, sodass nur die Verträge der aktuell ausgewählten Datentabelle angezeigt werden. In der Abbildung unten wird der Name der aktuellen Abteilung an den Parameter Department des Filters Expiring in 90 Days (läuft ab in 90 Tagen) übergeben. Folglich gibt der Filter nur diejenigen Datensätze zurück, in denen der Name der aktuellen Abteilung in dem Feld Contracting_Party eines Datensatzes enthalten ist.
Im Formular Datensätze abrufen geben Sie folgendermaßen an, welche Datensätze in einer Variablen enthalten sein sollen:
•Wählen Sie in der Auswahlliste Variable als Namen der Variablen einen der vordefinierten Werte aus. Dieser Variablenname muss innerhalb des Eingabeformulars eindeutig sein. •Wählen Sie in der Auswahlliste der Daten der Datentabelle die Datentabelle aus, aus der Datensätze in die Variable geladen werden sollen. •In der Auswahlliste Filter können Sie einen der Filter der Datentabelle auswählen, um ihn auf die Datenauswahl anzuwenden. Mit Hilfe eines Filters wird die Anzahl der zu ladenden Datensätze eingeschränkt, um so den Speicherbedarf zu verringern. Wenn für einen Filter Parameter definiert wurden, so wird jeder Parameter zusammen mit einem Eingabefeld für seinen Wert aufgelistet. Hier können Sie einen XPath-Ausdruck eingeben, um den Wert zu generieren. Klicken Sie alternativ auf die Schaltfläche Bearbeiten und wählen Sie einen aus der Liste der automatisch generierten kontextbasierten Ausdrücke aus. Der XPath-Ausdruck in der Abbildung unten lautet: $FetchedRecords_A/Name, womit das in der Variablen $FetchedRecords_A enthaltene Feld Name ausgewählt wird (diese Variable ist eine weitere im aktuellen Eingabeformular definierte Variable, die die Felder des aktuellen Datensatzes enthält). •Wählen Sie in der Einstellung Felder die Felder der in der Variablen zu speichernden ausgewählten Datensätze aus. Wählen Sie nur die benötigten Felder aus, um den Speicherbedarf zu verringern. •Mit der Einstellung Wie oft legen Sie fest, wann die Variable aktualisiert werden soll: entweder einmal, wenn das Skript zum ersten Mal ausgeführt wird und bis der Datensatz fertig bearbeitet ist oder bei jeder Ausführung des Skripts. Wenn Sie die zweite Option auswählen, werden im Skript immer die aktuellsten Daten aus der Datenbank verwendet.
|
6. Skript beim Datensatzladen oder bei Formularänderung
Wird wo definiert: | Kontrollkästchen im oberen Bereich des Eingabeformulars: Skript beim Datensatzladen oder bei Formularänderung |
Auslösung des Skripts: | Jedes Mal, wenn ein Datensatz geladen oder das Eingabeformular geändert wird |
Skriptaktionen: | (i) Aktualisiert Felder des Datensatzes; (ii) fügt Bedingungen hinzu; (iii) bearbeitet andere Datensätze; (iv) ruft Datensätze ab |
Mechanismen: | (i) Hinzufügung von Feldaktualisierungen; (ii) Hinzufügung von Bedingungen (oder Verzweigungen); (iii) Bearbeitung anderer Datensätze (für eine beliebige Datentabelle) oder Änderung/Löschung von Child-Datensätzen; (iv) Abrufen von Datensätzen |
Diese Art von Skript wird für das Eingabeformular definiert und jedes Mal, wenn ein Datensatz geladen oder vom Benutzer geändert wird, ausgelöst. Außerdem wird das Skript für Child-Datensätze ausgeführt, allerdings nur einmal, bei Laden des Datensatzes. Das bedeutet, das Skript wird beim Laden des Datensatzes ausgeführt. Es wird auch beim Laden eines Child-Datensatzes ausgeführt. Wenn der Benutzer zum Child-Datensatz zurückkehrt, wird das Skript nicht ausgelöst. Damit es ausgelöst wird, muss der Hauptdatensatz geändert werden.
Es ist die primäre Methode, um Daten (mit Hilfe des Datensätze abrufen Mechanismus) für die Verwendung im Formular aufzubereiten. Außerdem können Felder auch direkt, wenn ein Datensatz geladen wird, aktualisiert werden (mittels Feldaktualisierung hinzufügen). Solche Aktualisierungen können auch auf Basis von Bedingungen durchgeführt werden (indem Sie das Feld in eine Bedingung setzen, die mit dem Mechanismus Verzweigung hinzufügen hinzugefügt wird).
Sie können die folgenden Mechanismen zum Skript hinzufügen.
Bei Klick auf Feldaktualisierung hinzufügen, wird das Formular Feld aktualisieren angezeigt (Abbildung unten):
Hier können Sie einen neuen Wert für ein Datensatzfeld definieren:
•Wählen Sie in der Auswahlliste des Formulars aus, welches Feld des aktuellen Datensatzes bei Auslösung der Aktion aktualisiert werden soll. •Definieren Sie im Textfeld des Formulars den neuen Wert des Zielfelds. Wenn ein vordefinierter Wert verwendet werden soll, aktivieren Sie Fixwert und geben Sie den Wert ein. Wenn ein Wert dynamisch berechnet werden soll, aktivieren Sie Berechnung und geben Sie einen XPath-Ausdruck ein. •Da die Aktualisierung vom System und nicht von einem Benutzer durchgeführt wurde, wird sie unter Überwachen nicht automatisch markiert. Wenn die Aktualisierung in der Überwachung markiert erscheinen soll, aktivieren Sie das Kontrollkästchen Markieren.
|
Bei Klick auf Verzweigung hinzufügen, wird das Formular Verzweigung, wenn angezeigt (Abbildung unten). Mit Hilfe dieses Formulars können Sie einen Filter zur Auswahl des zu aktualisierenden Felds erstellen.
Über die Schaltflächen des Formulars können Sie Bedingungsverzweigungen hinzufügen. Eine Verzweigung hat die folgende Struktur: Überprüfung einer Gruppe von Bedingungen. Für jeden Fall (true oder false) wird die entsprechende Aktion für diese Art von Skript ausgeführt.
Für die einzelnen Skriptarten stehen die folgenden Aktionen zur Verfügung:
•Skript bei Datensatzspeicherung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails •Skript bei jeder Bearbeitung in diesem Formular: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters (siehe Abbildung unten). •Skript bei Feldbearbeitung: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen •Skript hinter Schaltflächen: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters; (iii) Speichern eines Datensatzes; (iv) Hinzufügung von anderen (über- oder untergeordneten) Datensätzen oder Änderung/Löschung von Child-Datensätzen; (iv) Hinzufügung von E-Mails; (iii) Hinzufügung einer Meldung •Skript bei Änderung eines Child-Datensatzes: (i) Hinzufügung einer Feldaktualisierung; (ii) Hinzufügung eines Filters
Anmerkung: Sie können in den Parametern von Filtern XPath-Ausdrücke verwenden, um Parameterwerte zu generieren.
Nähere Informationen zur Verwendung der Schaltflächen des Formulars finden Sie unter Definieren von Bedingungsverzweigungen.
|
Mit Hilfe dieser Option können Sie: (i) Child-Datensätze oder Datensätze für jede beliebige Datentabelle erstellen und (ii) Child-Datensätze ändern und löschen.
Bei Klick auf Andere Datensätze bearbeiten, wird das Formular Datentabelle auswählen angezeigt (Abbildung unten). Wählen Sie entweder (i) die Child-Datentabelle, in der ein Datensatz erstellt, geändert oder gelöscht werden soll, aus oder (ii) wählen Sie eine beliebige andere, nicht untergeordnete Datentabelle, in der ein Datensatz erstellt werden soll. Beachten Sie, dass Sie (i) Datensätze in jeder Datentabelle, die sich nicht unterhalb der Child-Ebene befindet, erstellen können, dass Sie aber (ii) nur Datensätze von Child-Datentabellen ändern oder löschen können.
Bei Klick auf Weiter, wird das Formular Skript angezeigt (Abbildung unten). Hier können Sie ein Skript erstellen, (i) um einen neuen Datensatz für eine Child-Datentabelle zu erstellen; (ii) einen neuen Datensatz für jede beliebige andere Datenbanktabelle, die sich nicht unterhalb der Child-Ebene befindet, zu erstellen; (iii) Datensätze einer Child-Datentabelle zu ändern und (iv) Datensätze einer Child-Datentabelle zu löschen. Da Sie die Datentabelle des/der zu erstellenden, ändernden, löschenden Datensatzes/Datensätze bereits im vorherigen Schritt ausgewählt haben, klicken Sie nun auf das entsprechende Register (Erstellen, Ändern oder Löschen) und erstellen Sie das Skript für diese Aktion.
Beachten Sie die folgenden Punkte:
•Wenn Sie einen neuen Datensatz in einer Nicht-Child-Datentabelle erstellen, kann es sein, dass Datensätze der Datentabelle denselben neuen Datensatz mehrmals erstellen. In einem solchen Fall, steht eine Ersetzen-Option zur Verfügung. Aktivieren Sie sie, damit der Datensatz nur einmal erstellt wird. •Wenn Sie einen neuen Datensatz erstellen oder einen bestehenden ändern, können Sie ein Feld mit Hilfe der Aktion Feldaktualisierung hinzufügen ausfüllen oder aktualisieren. •Mit Hilfe der Aktion Verzweigung hinzufügen können Sie eine Auswahl durch Bedingungen, Filter und Suchen einschränken, bevor Sie Aktualisierungsaktionen hinzufügen. •Sie können alle oder bestimmte Datensätze einer Child-Datentabelle ändern. Bestimmte Datensätze können mit Hilfe von Bedingungen, Filtern und Suchen ausgewählt werden. •Sie können festlegen, dass bei Änderung von Child-Datensätzen ein neuer Datensatz erstellt wird, falls der Datensatz nicht vorhanden ist. •Sie können alle oder bestimmte Datensätze einer Child-Datentabelle löschen. Wie auch bei Änderungen (siehe vorheriger Punkt) können bestimmte Datensätze mit Hilfe von Bedingungen, Filtern und Suchen ausgewählt werden.
|
Bei Klick auf Datensätze abrufen erscheint das Formular mit dem Titel Gespeicherte Datensätze für Berechnungen abrufen (Abbildung unten). Mit Hilfe des Datensätze abrufen-Skripts können Sie Datensätze aus der Datenbank abrufen und in einer Variablen speichern. Mit Hilfe der Daten der Variablen können anschließend während der Bearbeitung des aktuellen Datensatzes Berechnungen durchgeführt werden. So können Sie z.B. einem Benutzer, während er die Daten einer Abteilung bearbeitet, eine Liste der Verträge dieser Abteilung anzeigen lassen. Dazu können Sie die Datensätze der Contract-Datentabelle abrufen und diese filtern, sodass nur die Verträge der aktuell ausgewählten Datentabelle angezeigt werden. In der Abbildung unten wird der Name der aktuellen Abteilung an den Parameter Department des Filters Expiring in 90 Days (läuft ab in 90 Tagen) übergeben. Folglich gibt der Filter nur diejenigen Datensätze zurück, in denen der Name der aktuellen Abteilung in dem Feld Contracting_Party eines Datensatzes enthalten ist.
Im Formular Datensätze abrufen geben Sie folgendermaßen an, welche Datensätze in einer Variablen enthalten sein sollen:
•Wählen Sie in der Auswahlliste Variable als Namen der Variablen einen der vordefinierten Werte aus. Dieser Variablenname muss innerhalb des Eingabeformulars eindeutig sein. •Wählen Sie in der Auswahlliste der Daten der Datentabelle die Datentabelle aus, aus der Datensätze in die Variable geladen werden sollen. •In der Auswahlliste Filter können Sie einen der Filter der Datentabelle auswählen, um ihn auf die Datenauswahl anzuwenden. Mit Hilfe eines Filters wird die Anzahl der zu ladenden Datensätze eingeschränkt, um so den Speicherbedarf zu verringern. Wenn für einen Filter Parameter definiert wurden, so wird jeder Parameter zusammen mit einem Eingabefeld für seinen Wert aufgelistet. Hier können Sie einen XPath-Ausdruck eingeben, um den Wert zu generieren. Klicken Sie alternativ auf die Schaltfläche Bearbeiten und wählen Sie einen aus der Liste der automatisch generierten kontextbasierten Ausdrücke aus. Der XPath-Ausdruck in der Abbildung unten lautet: $FetchedRecords_A/Name, womit das in der Variablen $FetchedRecords_A enthaltene Feld Name ausgewählt wird (diese Variable ist eine weitere im aktuellen Eingabeformular definierte Variable, die die Felder des aktuellen Datensatzes enthält). •Wählen Sie in der Einstellung Felder die Felder der in der Variablen zu speichernden ausgewählten Datensätze aus. Wählen Sie nur die benötigten Felder aus, um den Speicherbedarf zu verringern. •Mit der Einstellung Wie oft legen Sie fest, wann die Variable aktualisiert werden soll: entweder einmal, wenn das Skript zum ersten Mal ausgeführt wird und bis der Datensatz fertig bearbeitet ist oder bei jeder Ausführung des Skripts. Wenn Sie die zweite Option auswählen, werden im Skript immer die aktuellsten Daten aus der Datenbank verwendet.
|