Workflow-Regeln
Mit Workflow-Regeln kann die Ausführung einer bestimmten Anzahl von Aktionen beim Eintreten von besonderen Ereignissen in X3 Software definiert werden.
Folgende Aktionen sind möglich:
- Versand einer Nachricht über das Mailprogramm
- Anzeige von Benachrichtigungen in der Planungsmaske
- Datenaktualisierung durch Ausführen von Aktionen, entweder direkt bei Eintreten des Ereignisses oder später, wenn der / die Empfänger der Benachrichtigungen reagiert hat / haben (Visa- oder Signaturaktion im Arbeitsplan, Klick auf den Link in der Nachricht, Doppelklick, um in einen verknüpften Kontext zu gelangen oder manuell Aktualisierungen durchzuführen)
Daten, die aus dem Auslösekontext stammen, können in Nachrichten, Benachrichtigungen und Aktionen verwendet werden.
Einer Workflow-Regel zugrunde liegende Ereignisse können verschiedenartig sein:
- Aktion eines Benutzers in der Objektverwaltung (Erstellen, Ändern, Auslösen einer Aktion)
- Ausführen einer Batchaufgabe, eines Importes, einer Ausgabe
- Signaturaktion für eine frühere Benachrichtigung (in diesem Fall können komplexe Kreise geschachtelter Signaturen auftreten)
- Batchverarbeitung, die mehrere Haupttabellen durchläuft
Der Versand der Nachrichten wird durch die Verwendung eines Mailprogramms bedingt, das beim Versand von einem Client eine MAPI-Schnittstelle und beim Versand von einem Server eine SMTP POP3-Schnittstelle (wie bei den meisten handelsüblichen Mailprogrammen der Fall) akzeptiert.
Die Empfänger der Workflow-Benachrichtigungen können entweder direkt in der Regel parametriert werden oder mithilfe eines Benutzercodes oder über einen Personenkontencode und einen Kontakttyp beim Personenkonto. Es ist auch möglich, Tabellen mit mehreren Kriterien namens Zuweisungsregeln zu erstellen, damit andere Benutzer Empfänger in Abhängigkeit von vordefinierten Kriterienwerten festlegen können.
Vorbedingungen
Siehe Dokumentation Umsetzung
Maskenverwaltung
Die Parametrierungsmaske der Workflow-Regeln besteht aus 5 Registern, wobei die ersten 3 Register zur Basisparametrierung gehören (für einfache Benachrichtigungen müssen in diesen drei Masken nur die Hauptfelder ausgefüllt werden). In den beiden anderen Registern wird die erweiterte Parametrierung vorgenommen:
- Im ersten Register wird der Kontext für das Auslösen der Regel definiert.
- Im zweiten Register erscheint die Liste der Empfänger der Nachricht oder der Benachrichtigungen.
- Im dritten Register können der Text für zu versendende Nachrichten eingegeben und mögliche Anhänge festgelegt werden.
- Im vierten Register werden eventuelle Signaturbedingungen festgelegt, sofern eine Workflow-Regel eine Abfolge weiterer Etappen und einen Signaturprozess vorsieht.
- Das fünfte Register wird verwendet, wenn besondere Aktionen ausgelöst werden sollen (wobei unter einer Aktion normalisierte Unterprogramme verstanden werden, entweder vordefinierte und dokumentierte, z. B. die Aktionen im Zusammenhang mit einer Budgetverpflichtung, oder spezifische Programme, die über einen Integrator realisiert werden, weil sie besondere Anforderungen erfüllen müssen).
Kopfzeile
Übersicht
Eine Regel ist durch einen Code identifiziert. Aus organisatorischen Gründen ist es auch möglich, einer Regel eine Kategorie zuzuweisen, die in einer sonstigen Tabelle definiert wird. In der Kopfzeile werden diese Informationen angezeigt.
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Blocknummer 1
| Dieses Feld identifiziert die Workflow-Regel. |
| Ermöglicht die Definition einer Bezeichnung für jeden Datensatz. |
Blocknummer 2
| Dieses Feld ermöglicht die Gruppierung der Workflow-Regeln nach Typologie. |
| Ist diese Option nicht ausgewählt, kann die Workflow-Regel nicht ausgelöst werden. |
Schließen
Register Allgemeine Angaben
Übersicht
In diesem Register wird der Auslösekontext definiert, der durch einen Ereignistyp, den dazugehörigen Code und in einigen Fällen durch zusätzliche Arbeitsgangcodes vorgegeben wird. Das Register enthält außerdem eine Bedingungstabelle: Diese Tabelle muss durchlaufen werden, damit eine Regel ausgelöst wird. Für bestimmte Ereignisse, die nach dem Schema Kopfzeile und Zeilen organisierte Daten beeinflussen, muss angegeben werden, auf welcher Ebene die Bedingungen operieren sollen.
Es ist auch möglich, eine Regel mit einem Datenmodell zu verknüpfen, das eine Reihe von Zusatztabellen beschreibt, die beim Test der Regel durchlaufen werden. Im Fall einer Regel vom Typ Manuell, ist dieses Datenmodell obligatorisch, weil der einzige existierende Kontext mit dem Modell verknüpft ist. Im Fall von Regeln, die mit Objekten oder sonstigen Ereignissen verbunden sind, ist dieses Modell optional und dient nur zur Vervollständigung der Online-Tabellen.
In Abhängigkeit vom Regel- oder Modelltyp, der der Regel zugewiesen ist, kann festgelegt werden, ob der Workflow die Kopfzeilen- oder Zeileninformationen betreffen soll. Gegebenenfalls muss definiert werden, wie die Zeilen gruppiert werden sollen.
Es kann darüber hinaus eine Zuweisungsregel bestimmt werden, um festzulegen, wie die Empfänger einer Nachricht definiert werden sollen. Diese Regel kann einen oder mehrere Empfänger betreffen. Die entsprechenden Empfänger können die mit der Regel verbundene Benachrichtigung erhalten oder zur nächsten Regel weitergeleitet werden, wenn es sich um verkettete Signaturen handelt.
Im technischen Anhang befindet sich die Auskunft der im Ausführungskontext enthaltenen Informationen.
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Auslöser
| Der Workflow-Ereginistyp kann folgende Werte annehmen:
|
| Dieses Feld ermöglicht die Angabe des Auslösekontextes, je nach Typ, der zuvor definiert wurde:
Dieses Feld ist nur für den Ereignistyp Sonstige erforderlich. Ist es nicht erfasst, wird das Ereignis generisch ausgelöst. Es ist immer möglich, den Kontext auf Selektivität zu testen (insbesondere aufgrund der Variablen GFONCTION, GOLDETAT...) |
| Dem Code zugeordneter Titel, der in der vorherigen Rubrik erfasst wurde. |
| Dieses Feld ermöglicht die genaue Angabe des Ausführungskontextes der Workflow-Regel. Je nach Workflow-Typ unterscheiden sich die erfassten Informationen:
|
| Wird eine Datei eines einfachen Objekts geändert, kann der Workflow vor der Aktualisierung der Tabellen ausgelöst werden (dies ermöglicht die Definition der Kriterien in den Klassen [F] und [M] oder am Ende der Änderungstransaktion (nach der Aktualisierung der Tabellen)). |
Blocknummer 4
| Hier kann ein Datenmodell angegeben werden, das alle verknüpften Tabellen definiert, die im Workflow-Kontext verfügbar sein müssen. Im Fall eines Ereignisses vom Typ Manuell ist dieser Code erforderlich, um den Ausführungskontext zu definieren; in den anderen Fällen ermöglicht er einfach die Vervollständigung des Kontextes. |
| Dieses Feld ermöglicht die externe Definition der Zuweisungsregeln der Workflow-Empfänger. Es bezieht sich auf eine Regeltabelle, in der eine Liste mit Feldern definiert wird, auf die sich die Zuweisungskriterien der Empfänger beziehen. Eine Regel wird zum Zeitpunkt des Workflow-Starts in Abhängigkeit vom Kontext bewertet und sendet einen oder mehrere definierte Benutzer über eine Tabelle mit lokalen Variablen [L]USER zurück, wodurch eine Empfängerliste für einen gegebenen Workflow oder eine Empfängerkette für eine Regelverkettung ausgegeben werden kann. Wichtiger Hinweis:
|
Blocknummer 5
| Definiert, ob ein Workflow in jeder Detailzeile oder nur in der Kopfzeile ausgelöst wird. Dieses Feld ist nicht erfasst, sondern angezeigt:
Ist keine Zuweisungsregel vorgegeben, es ist aber ein Modell zugeordnet, dass die Verknüpfungen (1,N) integriert, wird das Feld erfasst. Hier kann daher ausgewählt werden, ob das Auslösen in der Zeile oder der Kopfzeile ausgeführt wird (die Zeilen können gruppiert werden, um eine Benachrichtigung pro Gruppe versenden zu können). |
| Ermöglicht die Definition des Zeilenfelds für eine Regel, bei der der Kontext die Kopfzeilentabellen und die Zeilentabellen integriert. |
|
|
| Dieses Feld ermöglicht die Definition der Gruppierungskriterien durch die Angabe einer Ausdrucksliste (oder Felderliste), durch Semikolon getrennt. Dies ermöglicht die Gruppierung der Detailzeilen, um nur einen Workflow bei jeder Fehlmenge auszulösen für die von diesen Ausdrücken definierten Werten. Dies ist in zwei Fällen möglich:
|
Tabelle Bedingungen
| Ist das Workflow-Ereignis vom Typ Zeile, können die Bedingungen auf der Kopfzeile oder der Zeile basieren, je nach hier erfasster Auswahl. |
| Diese Felder ermöglichen die zusätzlichen Bedingungen in Form von logischen Ausdrücken (Berechnungsformel) einschließlich der Variablen in Zeile zum Zeitpunkt der Regelausführung (Inhalt der Masken oder Tabellen in Zeilen, je nach Kontextbeschreibung...). Sind die Bedingungen alle richtig, wird die Meldung gesendet und das Log in der Logdatei geschrieben. Hinweis: Ist der Kontext vom Typ Kopfzeile und Zeilen, kann man einen Teil der mit einer Kopfzeile verknüpften Zeilen filtern, indem man die Zeilenbedingungen definiert, um die Zeilen, für die die Bedingung falsch ist, nicht zu berücksichtigen. Bleibt mindestens eine betroffene Zeile übrig und sind die Bedingungen der Kopfzeile richtig, wird trotzdem ausgelöst. |
Verwaltung
| Indikator, mit dem das Senden der im entsprechenden Register angegebenen Meldungen aktiviert werden kann oder nicht. |
| Indikator, mit dem das Auslösen der im entsprechenden Register angegebenen Aktionen aktiviert werden kann oder nicht. |
| Dieses Feld ermöglicht die externe Definition der Zuweisungsregeln der Workflow-Empfänger. Es bezieht sich auf eine Regeltabelle, in der eine Liste mit Feldern definiert wird, auf die sich die Zuweisungskriterien der Empfänger beziehen. Eine Regel wird zum Zeitpunkt des Workflow-Starts in Abhängigkeit vom Kontext bewertet und sendet einen oder mehrere definierte Benutzer über eine Tabelle mit lokalen Variablen [L]USER zurück, wodurch eine Empfängerliste für einen gegebenen Workflow oder eine Empfängerkette für eine Regelverkettung ausgegeben werden kann. Wichtiger Hinweis:
|
| Indikator, mit dem eine Entwicklungshilfe aktiviert werden kann. Wird eine Regel ausgeführt und ist diese Option aktiviert, sendet die Workflow-Engine die eventuellen Bewertungsfehlermeldungen in Bezug auf die Bedingungen, den Log und die Meldung an die Meldungsmaske. |
|
|
Schließen
Register Empfänger
Übersicht
In diesem Register kann die Liste der Empfänger von Nachrichten und Benachrichtigungen erfasst werden. Ein Empfänger kann als Benutzer (in diesem Fall erscheint seine E-Mail-Adresse im Benutzerdatenblatt) oder als Personenkonto (in diesem Fall werden die betroffenen Kontakte durch ihre Funktion identifiziert) definiert werden.
Jede Zeile der Tabelle definiert einen oder mehrere Empfänger (entsprechend der aktivierten Vertretung). Diese Empfänger können:
- eine Meldung
- eine Benachrichtigung mit einfacher Rückmeldung (Visa) oder Signatur
- oder beides erhalten.
Die Gruppe der Empfänger, die durch eine Zeile der Tabelle definiert wird, wird hinsichtlich der Signaturen als zusammenhaltend betrachtet: Es ist ausreichend, dass ein Benutzer aus der Gruppe unterzeichnet hat, damit die ganze Zeile als unterzeichnet betrachtet wird (der Name des Unterzeichners erscheint in den erwarteten Signaturen für die Gruppe).
Existieren hingegen mehrere Zeilen, wird die Signatur eines Empfängers einer Zeile nicht auf andere Zeilen übertragen. In diesem Fall kann in einem Signaturkontext die Anzahl der schon unterzeichneten Gruppen (und Zeilen) geprüft werden, um eine Aktualisierung auszulösen, die eventuell die anderen Unterzeichner berücksichtigt.
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Tabelle Empfänger
| Dieses Feld ermöglicht die Definition einer logischen Bedingung. Sendet die Bewertung dieser Bedingung einen falschen Wert (d.h. Null), ist die Zielzeile nicht vom Ereignis betroffen. Hinweis: Man verfügt außer über die mit dem Ereigniskontext verknüpften Variablen auch über die Variablentabelle [L]COND, mit der man sich in einer gegebenen Zeile auf die Bedingung der Zeile Nummer N (N steht für den Index) beziehen kann. Beispiel: wenn man auf der ersten Zeile der Tabelle eine Bedingung ausdrückt, verwendet man in der zweiten Zeile den Ausdruck: not [L]COND(1), das heißt, dass die Empfänger der zweiten Zeile berücksichtigt werden, wenn die Bedingung der ersten Zeile falsch ist. |
| In der Anwendung Sage X3 kann der Empfänger verknüpft sein mit:
In der Anwendung Sage HRM kann der Empfänger verknüpft sein mit:
In der Anwendung Sage Warehousing kann der Empfänger verknüpft sein mit:
|
|
|
| Diese Information wird nur erfasst, wenn der Empfängertyp ein Personenkonto ist. Sie bezieht sich auf das lokale Menü, das die Funktionen der Gesprächspartner in der Personenkontendatei definiert. |
| Hier können drei Werte erfasst werden, die die Empfänger der Zeile betreffen:
|
| Dieser Indikator gibt an, ob die Empfänger der Zeile eine Benachrichtigung im Arbeitsplan erhalten, je nach erfasstem Wert:
Wird eine Benachrichtigung an mindestens eine der Empfängerzeilen gesendet, definiert das Register Rückmeldung den Text, der in der Rückmeldung erscheint, sowie die Antworten, die bei Unterschriftenanfragen gegeben werden können. |
| Dieses Feld kann verwendet werden, um die Rückmeldungszeilen nach Kategorie zu ordnen. Vor allem ein Kriterium kann im Arbeitsplan angezeigt oder als Filter für ein Register verwendet werden. |
| Dieses Feld ermöglicht die Angabe, wie verwaltet wird, dass der identifizierte Empfänger in der Zeile fehlt (d.h. dass ein Vertreter für eine bestimmte Zeit definiert wird, einschließlich dem Zeitpunkt, zu dem die Regel ausgelöst wird). Wurden Vertreter Mit Vollmacht definiert, definiert der Feldwert den Empfänger der Benachrichtigung oder Meldung:
|
Schließen
Register Meldung
Übersicht
Mit diesem Register kann der Inhalt der Nachricht festgelegt werden, die an die entsprechenden Empfänger gesendet wird. Eine Nachricht besteht aus:
- einem Feld "Objekt" (ausgedrückt in Form einer X3-Formel, wenn nötig einschließlich Konstanten, Funktionen und Variablen aus dem Kontext). Dieser Kontext wird im technischen Anhang der Dokumentation näher definiert.
- einem Haupttext, der im entsprechenden Block definiert wird. Es ist möglich, X3-Formeln darin aufzunehmen, wenn sie mit vertikalen Strichen umrahmt werden. Das laufende Datum wird beispielsweise im Format | date$ | und der aktuelle Benutzercode im Format | GUSER | ausgedrückt. Es ist möglich, einen Clob (max. 5) in der Form |CLB/CLOB einzufügen, wobei CLOB einer Variable des Typs Clob oder einem Ausdruck entspricht, dessen Ergebnis ein Clob ist.
- einem eventuellen Zeilentext, der einem Unterdetail einer Zeile entspricht, wenn es sich um einen Workflow vom Typ Kopfzeile/Zeile handelt. Die Tabelle mit den Zeilen, die zu jeder Kopfzeile gehören, wird dort in den Haupttext eingefügt, wo die |LIG|-Formel festgelegt wurde.
- eventuellen Links zum Auslösen von Signaturen durch Aufruf eines HTTP-Servers. Diese Links werden in Formeln vom Typ |SIG/CODE/MESSAGE| geschrieben, wobei CODE der Code der Antwort ist, die erstellt wird.
Sie könnten z. B. wie folgt lauten:
|SIG/VAL/"Klicken Sie auf den folgenden Link, um zu unterzeichnen:"|
|SIG/REJ/"Klicken Sie auf den folgenden Link, um abzulehnen:"|
Im Nachrichtentext steht dementsprechend:
Klicken Sie auf den folgenden Link, um zu unterzeichnen Link zum Aktivieren der Signatur
Klicken Sie auf den folgenden Link, um abzulehnen Link zum Aktivieren der Ablehnung
Bei diesen Links handelt es sich um veränderliche HTTP-Links, die den notwendigen Kontext zur Übertragung der Informationen enthalten.
Unabhängig von diesen Elementen, werden durch mehrere Zusatzfelder die Bedingungen für den Versand und die Informationen (Anlagen), die in die Nachricht eingefügt werden können, definiert.
Sollen Anlagen versendet werden, muss der allgemeine Parameter TYPMES auf Server stehen. Ist das nicht der Fall, wird nur die erste Anlage versendet (wird ein Versand durch Client durchgeführt, erscheint dazu ein Hinweis). Im Übrigen müssen die Anlagen vom Anwendungsserver aus zugänglich sein (über einen Netzwerkpfad, wenn sie nicht in der Datenbank gespeichert sind).
Der Versand der Nachrichten wird durch die Verwendung eines Mailprogramms bedingt, das beim Versand von einem Client eine MAPI-Schnittstelle und beim Versand von einem Server eine SMTP POP3-Schnittstelle (wie bei den meisten handelsüblichen Mailprogrammen der Fall) akzeptiert.
Die Empfänger der Workflow-Benachrichtigungen können entweder direkt in der Regel parametriert werden oder mithilfe eines Benutzercodes oder über einen Personenkontencode und einen Kontakttyp beim Personenkonto. Es ist auch möglich, Tabellen mit mehreren Kriterien namens Zuweisungsregeln zu erstellen, damit andere Benutzer Empfänger in Abhängigkeit von vordefinierten Kriterienwerten festlegen können.
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Meldung
|
|
| Dieses Feld ermöglicht die Definition des Feldinhalts Objektder gesendeten Nachricht, in Form eines berechneten Ausdrucks, der zum Zeitpunkt der Ereignisauslösung bewertet wird. |
Text
| Dieses Feld ermöglicht die Definition des Hauptinhalts der Nachricht. Geschrieben wird in Form von freiem Text einschließlich der logischen Ausdrücke (Berechnungsformel) zwischen zwei vertikalen Balken, die als Trennzeichen dienen. So kann man z.B. Inhalte schreiben, wie: Das Ereignis am | num$(date$) | führte zu dieser Sendung über| GUSER | Besondere Tags: "LIG" ermöglicht das Einfügen des im Feld "Zeile" der Workflow-Regel definierten Ausdrucks. |
Verwaltung
| Der erfasste berechnete Ausdruck in diesem Feld wird bewertet, zum Zeitpunkt des Ereignisstarts, für jede Detailzeile (im Fall eines Workflows vom Typ Zeile mit einer Datengruppierung). Jede so berechnete Zeile wird in den Nachrichtentext dort eingefügt, wo sich die Formel |LIG| befindet. Abhängig von der Zeilenlänge muss man teilweise den Ausdruck "chr$(13)+chr$(10)" in der Formel hinzufügen, um einen Zeilenumbruch zwischen jeder Zeile zu erzwingen. |
Verwaltung
| Dieses Feld ermöglicht die Angabe, ob lokal vom Arbeitsplatz (über die Schnittstelle MAPI), vom Server (über SMTP) oder egal ob vom einen oder vom anderen (in diesem Fall definiert dies ein allgemeiner Parameter TYPMES) gesendet werden muss. |
| Ist diese Option ausgewählt, kann in der Anlage der gesendeten Nachricht ein Symbol mit dem Kontext eingefügt werden, der die Datei aufruft (über einen Doppelklick). Achtung: Dies funktioniert nur mit einer Client-Server-Verbindung. |
| Ist ein Symbol, das die Rückkehr zu X3 ermöglicht, im Meldungstext angehängt, ermöglicht dieses Feld die Angabe einer Retourfunktion, die sich von der Funktion unterscheidet, die den Workflow ausgelöst hat. Wird eine Datei erstellt oder geändert, ermöglicht ein Workflow-Objekt anstelle der Verbindung zur Standarddatei die Verbindung zu einer verknüpften Datei (z.B. die Datei des Benutzers, der die Information, die den Workflow ausgelöst hat, erstellt oder geändert hat). |
| Ist die Option Zurückausgewählt, ermöglicht dieses Feld die Definition der Funktion, mit der der Benutzer nach einem Doppelklick auf das in der Meldung vorhandene Symbol verbunden wird. Ist die Funktion Zurück vom Typ Objekt, muss die Funktion nur erfasst werden, wenn sie sich vom Ursprungsobjekt unterscheidet. Bei einem Workflow Manuell ist dieser Funktionscode erforderlich, wenn das Symbol Zurück vorhanden ist (in diesem Fall kann er keinen Standardwert haben). |
Blocknummer 6
|
|
|
|
|
|
|
|
Blocknummer 7
| Mit diesem Indikator kann die Nachricht vor dem Senden geändert werden: eine Maske öffnet sich für die Erfassung der Änderungen. Dies ist nur möglich, wenn das Auslösen des Workflows interaktiv stattfindet (andernfalls öffnet sich das Fenster nicht). Achtung: Wird diese Option ausgewählt, führt dies zu einer vorübergehenden Unterbrechung des Workflow-Prozesses, da eine Freigabe des Benutzers aussteht. Wird das Workflow-Ereignis ausgeführt, obwohl gerade eine Transaktion läuft (was über die Bedingung adxlog<>0 getestet werden kann), werden die anderen konkurrierenden Workflow-Ereignisse durch diese Erfassung blockiert. Diese Option sollte daher nur ausgewählt werden, wenn Ereignisse außerhalb der Transaktion durchgeführt werden (außer eventuell zur vorübergehenden Fehlerbeseitigung). Um sich gegen dieses Risiko abzusichern, kann man in den Auslösekriterien eines Ereignisses diesen Typs die Bedingung adxlog=0 hinzufügen (damit wird das Auslösen von Ereignissen dieser Art verhindert). |
| Erstellt ein Workflow-Ereignis mehrere Benachrichtigungen, dient diese Option zur Gruppierung der vom Ereignis erstellten Meldungen. Ist der Workflow vom Typ "Zeile" oder handelt es sich um das Spezialereignis "ANU" (ausgelöst durch Abbruch der Unterschrift), gibt es mehrere Benachrichtigungen. Die Benachrichtigungen sind untereinander gruppiert, wenn sie die folgenden gemeinsamen Eigenschaften haben:
|
| Ist diese Option ausgewählt, kann die Nachricht mit der Bitte um eine Empfangsbestätigung gesendet werden. Achtung: Dies funktioniert nur, wenn die Nachricht vom Arbeitsplatzrechner und nicht vom Server aus gesendet wird. |
Anlagen
| Diese Option kann nur angegeben werden, wenn das Auslöserereignis dem Ende einer Batchaufgabe entspricht. Ist sie ausgewählt, wird in diesem Fall die der Batchaufrage zugeordnete Logdatei der gesendeten Nachricht angehängt. |
| Über dieses Feld kann einer Nachricht eine Anlage zugewiesen werden, indem der Netzwerkzugriffspfad als berechneter Ausdruck angegeben wird, der zum Zeitpunkt der Ereignisauslösung bewertet wird. |
| Ist diese Option für einen Workflow vom Typ Objekt ausgewählt, können die Anlagen der Datei als Anlagen der Nachricht gesendet werden. |
| Ist die Option Alle Typen nicht ausgewählt, ermöglicht dieses Feld die Definition eines Feldes für den Typ der Dateianlagen (sonstige Tabelle 902), die mit der Nachricht gesendet werden müssen. |
|
|
| Dieses Feld wird nur in folgenden Fällen erfasst:
Ist diese Option ausgewählt, werden alle Anlagenkategorien, die den Workflow auslösen, als der Meldung angehängte Belege versendet. Andernfalls wird die betroffene Kategorie erfasst. |
| Müssen die einer Datei angehängten Belege als Anlage einer Nachricht gesendet werden, ermöglicht dieses Feld das Filtern der verknüpften Belege nach Kategorie (lokales Menü 96) |
Schließen
Register Rückmeldung
Übersicht
Mit diesem Register kann definiert werden, wie Benachrichtigungen vom Typ Rückmeldung in den Arbeitsplänen der Empfänger durchgeführt werden sollen und welche Bedingungen für die Signatur gelten, sofern anwendbar. Diese Signaturbedingungen sind nur anwendbar, wenn den Empfängern in der Empfängertabelle des entsprechenden Registers die Rückmeldung Mit Signatur zugewiesen ist.
Die im Arbeitsplan zu erscheinende Nachricht und das Endedatum der Unterschrift – sofern gefordert – werden in Form von ausgewerteten Ausdrücken definiert.
Anschließend können in einer Tabelle die Antworten erfasst werden, die der Benutzer bei der Signatur anfertigen kann. Dabei ist es möglich, ein Feld des laufenden Datenblatts direkt zu aktualisieren, wenn es sich um einen Workflow des Typs Objekt handelt.
Die ausgewerteten Elemente in der Tabelle der Antworten werden sofort aktualisiert, die Elemente bezüglich der verbundenen Benachrichtigung oder Nachricht werden aktualisiert, wenn der ursprüngliche Workflow ausgelöst wird. Das bedeutet, dass der Kontext nicht mehr genau derselbe ist. In einem Workflow vom Typ Objekt sind folgende Elemente online:
- beim Auslösen alle Variablen der mit dem Objekt verknüpften Masken und Tabellen sowie die mit einem Datenmodell oder einer Zuweisungsregel verbundenen Zusatztabellen und die mit dem Kontext des Unterzeichners (GUSER ist der Benutzercode, der das Ereignis ausgelöst hat) zusammenhängenden globalen Variablen
- bei der Signatur der Datensatz der Haupttabelle des Objekts sowie die Tabellen, die in einem Datenmodell und eventuell in einer Zuweisungsregel beschrieben sind. Allerdings sind keine Masken online und die globalen Variablen entsprechen den Variablen des Signaturkontextes (GUSER ist in diesem Fall der Code des unterzeichnenden Benutzers).
Sollen Werte des Auslösekontextes zu einem Signaturkontext übertragen werden, steht dazu eine Tabelle namens Kontext zur Verfügung. Die hier beschriebenen Ausdrücke werden bei der Signatur ausgewertet und in Form einer Tabelle mit lokalen Variablen namens [L]CTX übertragen. Diese Variablen können anschließend sowohl in der Parametrierung der Arbeitspläne, in den mit der Signatur zusammenhängenden Bedingungen und Werten als auch in den Werten und Variablen verwendet werden, die mit den Aktionen des nächsten Registers verknüpft sind, wenn die entsprechende Aktion während der Signatur ausgelöst wurde.
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Text
| Dieses Feld enthält einen Ausdruck, der zum Zeitpunkt des Workflow-Starts bewertet wurde. Das Ergebnis dieser Bewertung ist eine alphanumerische Kette, die in der Variable [AWS]TEXSUI gespeichert ist. Dieser Wert wird normalerweise im Workflow-Monitor angezeigt, um das zu unterzeichnende Ereignis zu bezeichnen. |
Signatur
| Ist diese Option ausgewählt, erfolgt ein Unterschriftenprozess: In der Tabelle am Maskenende erscheint eine bestimmte Anzahl an möglichen Signaturen. |
| Ist die Option Unterschrift ausgewählt, kann ein Ausdruck vom Typ Datum definiert werden, der das Datum definiert, ab dem ein Verzug angezeigt wird, wenn die Unterschrift noch nicht stattgefunden hat. Der entsprechende Feldwert ist im Feld DATREL der Rückmeldungstabelle AWRKHISSUI gespeichert. Dieses Feld kann im Workflow-Monitor angewendet werden, um eine Klassifizierungsreihenfolge, eine Auswertung nach besonderem Stil (z.B. Bedingung vom Typ Datum$>=[AWS]DATREL+1) zu definieren. Es kann auch für die Verwaltung der Neustarts der ausstehenden Ereignisunterschriften angewendet werden, wenn das Feld [AWS]NBREL das Zählen der bereits erledigten Neustarts ermöglicht. |
Tabelle Kontext
| Diese Tabelle enthält Ausdrücke, die zum Zeitpunkt eines Workflow-Starts bewertet wurden. Diese Variablen sind:
Diese Variablen können die Übertragung von Informationen ermöglichen, die nicht in den Ursprungstabellen des Auslösekontextes platziert sind, und die nicht automatisch von einem Ereignis zur Unterschrift oder zum nächsten Ereignis übertragen werden. Die Objekttabellen oder die der Zuweisungsregel werden automatisch übertragen. Nicht übertragen werden hingegen:
Dieser Variablentyp ist also wichtig, um über den Kontext zu übertragen. Im Kontext können auch im Kontext übertragene Variablen definiert werden, einfach um sie im Workflow-Monitor anzeigen zu können. |
Tabelle Antwort
| Diese Tabelle bezieht sich auf die sonstige Tabelle Nummer 54, die die Auswahlmöglichkeiten für die Unterschrift definiert (z.B. Freigabe, abgelehnt). Im Arbeitsplan der Unterschriften wird durch einen Rechtsklick auf die zu unterzeichnende Zeile eine Auswahlliste aus der Liste vorgeschlagen, für die die Bedingung geprüft wurde. |
| Dieser Vorgangscode, der in der sonstigen Tabelle 55 definiert ist, ist der Code, der die abgeschlossene Unterschrift bezeichnet. Er entspricht dem Vorgangscode, der in einem Ereignis vom Typ Unterschrift nach dem unterzeichneten Ereignis verwendet wird. Hinweis: Mehrere Zeilen können den gleichen Vorgangscode tragen. Dieser Code wird nicht in der Workflow-Chronik bei der Ausgabe der Unterschrift gespeichert. Der Wert des Feldes Antwort das keine Homonyme zwischen den verschiedenen Zeilen zulässt, wird gespeichert. |
| Diese Zeile enthält einen logischen Ausdruck, der zum Zeitpunkt der Unterschrift bewertet wird. Wird die Bedingung erfüllt, wird die in der Zeile definierte Antwort unter den Auswahlmöglichkeiten vorgeschlagen. Dadurch erhält man z.B. mehrere Unterschriftenebenen in Abhängigkeit der Anzahl an Unterzeichnern, die bereits unterschrieben haben (nur der letzte Unterzeichner mit Zugriff auf eine Unterschrift, die eine finale Aktualisierung auslöst). Ebenso ist es möglich, eine scheinbar unmögliche Auswahl zu definieren (über eine immer falsche Bedingung vom Typ 1=0). Diese Auswahl kann von einer Unterschriftenaktion erzwungen werden, die von einem anderen Workflow-Ereignis ausgelöst wird. So werden in den Standardparametern die Eskalationen in den Unterschriftenprozessen verarbeitet. |
| Diese Spalte ermöglicht die Angabe einer Nummer einer sonstigen Tabelle, die die Antwortmotive enthält. |
| Diese Spalte enthält den Namen eines Feldes aus einer der Tabellen des Auslöserkontextes. Dieses Feld wird über den berechneten Wert aus dem folgenden Ausdruck während des Unterschriftenprozesses berechnet. So kann man z.B. ein Feld wie ENAFLG (Indikator Activ des aktuellen Objekts während eines Unterschriftenprozesses aktualisieren. |
| Diese Spalte ermöglicht die Definition des Ausdrucks eines berechneten Wertes zum Zeitpunkt der Unterschrift. Der Wert, der der ausgewählten Antwortzeile entspricht, wird im Fall einer Unterschrift verwendet:
|
| Hat das Feld den Wert Ja, wird der berechnete Wert in der entsprechenden Spalte vorgeschlagen, nach der Wahl der Unterschrift, damit eine mögliche Änderung vorgenommen werden kann. Dies ermöglicht z.B. die Erfassung einer detaillierten Änderung. Der Wert aus der Erfassung wird dazu verwendet, die Aktualisierung durchzuführen und die Übertragung der Variable [L]RESULT für die Anwendung über eine zusätzliche Aktion. |
Schließen
Register Aktion
Übersicht
Dieses Register enthält zwei Tabellen. Die erste Tabelle enthält eine Liste der Aktionen, die beim Auslösen des Ereignisses oder in der Signaturphase aktiviert werden können. Somit können dafür vordefinierte Standardaktionen (eine Liste dieser Aktionen befindet sich im entsprechenden technischen Anhang) oder spezifische Aktionen aktiviert werden. Die entsprechende Aktion wird nur aktiviert, wenn die Ausführungsbedingung erfüllt ist.
Die nachstehende Tabelle wird automatisch mit der Liste der Aktionsparameter belegt, um eine Liste von im Kontext ausgewerteter Ausdrücke zu erfassen und zu übertragen (entweder als Werte oder als Pointer, wobei im letztgenannten Fall die Antwortwerte weiterverwendet werden können).
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Tabelle Aktion
| Dieses Feld enthält einen Aktionscode, dessen Ausführung gestartet werden kann, wenn die Bedingungen erfüllt sind. Hinweis: für diese Aktion muss die Option Workflow ausgewählt sein und sie darf nicht in die Benutzerschnittstelle eingreifen (kein zugeordnetes Fenster). |
| Dieses Feld, dessen Werte im lokalen Menü 2923 definiert sind, definiert die Auslösebedingungen des Workflows. Die folgenden Werte können verwendet werden.
Aus Transaktionssicht muss darauf hingewiesen werden, dass die Aktion Teil der Transaktion des Meldungs-Workflows ist (wenn ein Rollback während der Meldungserstellung durchgeführt wurde, sind die in der Aktion durchgeführten Aktualisierungen betroffen). Eine unabhängige Transaktion wird für die Rückmeldung durchgeführt (da diese Transaktion aber anschließend durchgeführt wird, können die zurückgesendeten Werte von der Aktion verwendet werden). Im speziellen Fall des Workflows zum Objekt kann alles in einer einzigen Transaktion durchgeführt werden. Anders ausgedrückt, schlägt die Erstellung oder Änderung einer Datei fehl, wird ein Rollback für alle von der Aktion ausgelösten Aktualisierungen durchgeführt. Das gleiche gilt für die Rückmeldung: die Transaktion, die auf die Erfassung der Rückmeldung folgt, beinhaltet das Auslösen der Aktionen. |
| Hier wird ein logischer Ausdruck erfasst, der im Auslösekontext der Aktion bewertet wurde. Ist das Ergebnis der Bewertung richtig (d.h. nicht Null), wird die Aktion gestartet. Ist das Ergebnis falsch, wird sie nicht gestartet. Ist kein Ausdruck erfasst, wird die Aktion immer gestartet. |
Tabelle Einstellungen
|
|
|
|
|
|
| Hier wird ein bewerteter Ausdruck erfasst, der als Aktionsargument übertragen wird, oder der Code einer Variable, die einen Retourcode enthält (wenn das Argument vom Typ Pointer ist). Alle Variablen des Workflow-Kontextes können hier verwendet werden. |
Schließen
Spezielle Buttons
Im über diese Schaltfläche geöffneten Fenster befinden sich die folgenden Felder: : Blocknummer 1
Blocknummer 2
Schließen Mit diesem Button kann ein Workflow-Ereignis durch Angabe seines Codes in einen anderen Ordner kopiert werden. Es öffnet sich ein Fenster, in dem mithilfe eines Kontrollkästchens die Weiterleitung in alle Ordner durchgeführt werden kann, die in der Tabelle der laufenden Ordner enthalten sind. |
Menüleiste
Option / Manueller Workflow
Mit dieser Option kann ein Workflow des Typs manuell direkt ausgelöst werden. In einem Dialogfenster können eventuell verknüpfte Parameter eingegeben werden.
Dokumentation / Absätze
Mit dieser Funktion kann auf die Dokumentationsverwaltung und auf den ersten Absatz der Dokumentation (sofern vorhanden) zum aktuellen Datenblatt zugegriffen werden.
Dokumentation / Verknüpfungen
Mit dieser Funktion kann auf die Linkverwaltung zugegriffen werden. Die Funktion definiert Links zwischen dem aktuellen Datenblatt und anderen Datenblättern (z. B. Links zwischen Funktionen und Parametern). Diese Links dienen lediglich Dokumentationszwecken: Aus ihnen wird der Generierungsprozess der Dokumentationsgliederungen gespeist.
Dokumentation / Generierung
Über dieses Menü wird die Dokumentationsgenerierung angestoßen. Die Generierung kann auch per Klick auf den Button [Generieren] im unteren Fensterbereich gestartet werden.
Es gibt drei Generierungstypen, die einzeln oder gleichzeitig verwendet werden können:
- Generierung der Dokumentationsgliederung aus dem Dictionary (Tabellen ADOCUMENT, ADOCBLB, ADOCCLB)
- Generierung der Dokumentation aus obigen Tabellen
- Generierung der Felddokumentation
In den standardmäßig vorgeschlagenen Bereichen ist das aktuelle Datenblatt berücksichtigt. Die Bereiche können jedoch beim Aufruf der Funktion geändert werden.
Fehlermeldungen
Während der Erfassung können außer den generischen Meldungen folgende Fehlermeldungen auftreten: :
Diese Regel muss das Modell XXXX verwenden
Im ersten Register wurde eine Zuweisungsregel bestimmt, die nicht auf einem zuvor definierten Datenmodell basiert.
Export, Import?
Beginn, Ende?
In einem Workflow-Ereignis, das mit einem Import / Export verknüpft ist, muss das Vorgangsfeld durch eine Kombination von Codes (I oder E und D oder F) angegeben werden, wenn das Ereignis während eines Imports oder Exports bzw. zu Beginn oder am Ende ausgelöst wird.
X: Operation nicht korrekt
In einem Workflow-Ereignis, das mit einem Objekt verknüpft ist, existiert der eingegebene Vorgang X nicht.
Verknüpfungsschlüssel enthält fehlerhafte Elemente
Die eingegebene Syntax entspricht keinem gültigen Beziehungsausdruck.
XXX: Dieses Modell ist nicht mit dem Ereignistyp "Manuell" (Beziehungstyp 1,N) kompatibel.
In einem Workflow des Typs manuell kann eine Struktur mit Beziehungen (1,N) nicht durchlaufen werden. Vom feinsten Detail ausgehend müssen Beziehungen (1,1) zur Kopfzeile erstellt werden. Mithilfe des Gruppierungskriteriums ist es dennoch möglich, anschließend die Zeilen anhand des Schlüsselwertes der Kopfzeile zu gruppieren.
Für diese Aufgabe ist die Option Benutzermeldung nicht aktiviert
Es handelt sich lediglich um einen Hinweis, der angezeigt wird, wenn eine Workflow-Regel am Ende einer Batch-Aufgabe erstellt und eine Aufgabe angegeben wird, für die die Benutzermeldung nicht aktiviert ist.