Zu Export-Job hinzufügen
Ereignisaktion - Kurzfassung
Zweck: Eine einzelne Entität eines exportierbaren Typs, die als Bezugsobjekt vorliegt, wird einem vorhandenen oder neu erstellten Export Job hinzugefügt.
Die Zu Export-Job hinzufügen-Ereignisaktion versucht, einer als Bezugsobjekt vorliegende Entität einem vorhandenen oder neu erstellten Export Job hinzuzufügen.
Als Bezugsobjekt wird eine exportierbare Entität (s. Meta Exchange Erweiterung) erwartet.
Liegt "Kein Wert" ($null) als Bezugsobjekt vor, dann ist die Ereignisaktion wirkungslos.
Ist das Bezugsobjekt keine Entität, dann wird beim Ausführen von Zu Export-Job hinzufügen eine Fehlermeldung (und ggf. ein Rollback) ausgelöst.
Ist das Bezugsobjekt eine Entität eines Typs, der nicht exportierbar ist, dann ist die Ereignisaktion wirkungslos.
Wenn zur Laufzeit im Kontext der Sitzung bereits ein Export Job existiert, wird diesem das aktuelle Bezugsobjekt (inkl. aller abhängigen Entitäten) hinzugefügt.
Existiert noch kein Export Job, dann wird beim Ausführen der Zu Export-Job hinzufügen-Ereignisaktion ein neuer angelegt.
►HINWEISE◄
Die Zu Export-Job hinzufügen-Ereignisaktion steht in Ereignisbehandlungen und Client Workflows zur Verfügung.
Die Zu Export-Job hinzufügen-Ereignisaktion wird in Tests für Ereignisbehandlungen nicht ausgeführt, im Testmodus für den Formulardesigner beim Aufruf in einem Client Workflow dagegen sehr wohl.
Interaktiver Export vs. Automatisierung
Das Ausführen der Ereignisaktion Zu Export-Job hinzufügen entspricht weitgehend dem Ausführen des Ribbon-Makro-Befehls "Export/Exportieren" (s. Verfügbare Befehle) im Kontext einer Entität.
Ob die im Ausführungskontext anwendbare Rolle der Session über die Berechtigung zum Exportieren (~/Export/Exportieren) für den konkreten Entitätstyp verfügt, dem das Bezugsobjekt angehört wird nicht geprüft.
Die Ereignisaktion kann also auch für Entitäten ausgeführt werden, in deren Kontext der Ribbon-Befehl "Export/Exportieren" nicht verfügbar ist.
Während der interaktive Export im Kontext einer Übersicht für eine Mehrfachauswahl von Entitäten (desselben Typs) ausgeführt werden kann, akzeptiert die Ereignisaktion Zu Export-Job hinzufügen keine Liste von Entitäten als Bezugsobjekt. Um einem Export Job automatisiert mehrere Entitäten hinzuzufügen, müssen also mehrere Instanzen der Zu Export-Job hinzufügen-Ereignisaktion oder eine Für jeden Eintrag wiederholen (Schleife)-Ereignisaktion eingesetzt werden.
Konfiguration
Die Zu Export-Job hinzufügen-Ereignisaktion verwendet keine Parameter.
Beispiele
Einfacher Anwendungsfall
Im Kontext einer Ereignisbehandlung soll das Benutzerkonto, mit dem die Firma der Session erstellt wurde, dem aktuellen Export Job hinzugefügt werden.
Konfiguration:
Innerhalb der rechts abgebildeten Ausführen mit-Ereignisaktion ermittelt die Wert-Konfiguration für den Parameter Objekt-Wertauflöser das zu exportierende Bezugsobjekt über die folgende Wertauflöserkette (s. Verketteter Wertauflöser):
Im Aktionsblock der Ausführen mit-Ereignisaktion fügt die Zu Export-Job hinzufügen-Ereignisaktion das ermittelte Benutzerkonto an den Export Job. |
|
Komplexerer Anwendungsfall
Im Kontext einer Ereignisbehandlung sollen einem Export Job alle Feiertagsgruppen (s. Feiertagsübersicht) hinzugefügt werden, die mindestens einen Eintrag für das aktuelle Jahr enthalten.
Anschließend soll eine View für den Export Job geöffnet werden, sofern dies nicht bereits der Fall ist.
Konfiguration:
Die zu exportierenden Feiertagsgruppen werden vorab mit der rechts abgebildeten Suche-Ereignisaktion ermittelt:
►ANMERKUNG◄ Der Verzicht auf die Auswahl einer Zeitzone impliziert, dass die im Ausführungskontext anwendbare Zeitzone verwendet wird. Dies geschieht hier in der Annahme, dass die Einträge in der Feiertagsgruppe mit Bezug zu derselben Zeitzone gepflegt wurden. Dies kann durchaus Auswirkungen auf das Suchergebnis haben, wie das folgende Beispiel zeigt:
|
|
Der Screenshot rechts zeigt die oben ausführlich beschriebene Suche-Ereignisaktion (hier: zugeklappt), nach der eine Für jeden Eintrag wiederholen (Schleife)-Ereignisaktion ausgeführt wird:
►ANMERKUNG◄ Zur Vereinfachung haben wir hier angenommen, dass die Ereignisbehandlung im Kontext einer Sitzung mit der "Super User"-Rolle (oder zumindest entsprechenden Berechtigungen) ausgeführt wird. Wenn ein Export Job ausgeführt werden soll, ist dies grundsätzlich zu empfehlen. Falls die Suche Besitzereinschränkungen berücksichtigen soll, sodass nur Feiertagsgruppen exportiert werden, die die Firma der Session "lesen" darf, muss die Suche im Aktionsblock einer Ausführen als-Ereignisaktion mit einer "beschränkten" Rolle eingesetzt werden. |
|
Der Screenshot rechts zeigt die Konfiguration für eine Öffne View (Aktion), die eine View für den Export Job öffnet, sofern noch keine existiert:
►HINWEIS◄ Der Menüknotenname kann nur verwendet werden, um die Zu öffnende View anzugeben, wenn der Menüpunkt Export Job in der Sitzung verfügbar ist. Das ist nur dann der Fall, wenn für die Rolle der Session die Berechtigung "Verwaltung/System/Import Job" (administration/system/importJob) vorliegt. Über den Viewnamen kann die Öffne View (Aktion) die View für den Export Job dagegen auch in einer Sitzung anzeigen, in der die Berechtigung "Verwaltung/System/Import Job" nicht vorliegt und in der die Menüpunkte Export Job und Import Job nicht verfügbar sind: de.lobster.scm.exchange::ExchangeIndex|listDetailsWindow Bei der Export Job-View handelt es sich um eine kombinierte Ansicht für die Klasse "Exchange-Index" (ExchangeIndex). |
|