Zurück zu agorum core docform mit Meldung (Spezialfall Fileworkflow)

agorum core docform und der agorum core fileworkflow hängen eng zusammen. So ruft agorum core docform nach der Erkennung von Metadaten immer den agorum core fileworkflow auf.

In dem hier beschriebenen Spezialfall wird im agorum core fileworkflow mithilfe von agorum core docform verify ein Fehler am Dokument festgestellt. Dieses Dokument soll nun nochmals in agorum core docform geschickt werden, allerdings mit einer Meldung, dass etwas korrigiert werden muss.

Hinweis: Diese Funktion steht im Workflow 3.0 nicht zur Verfügung. Bieten Sie stattdessen in der UI eine Option zur Wertanpassung an. Das docform-Training kann so zwar nicht angepasst werden, aber Sie können etwa mit einer Notiz an dem Dokument die docform-Trainer um eine Anpassung bitten.

docform-Workflow aus dem agorum core fileworkflow aufrufen

Im ersten Schritt wird durch eine Regel erkannt, dass etwas nicht stimmt. Im nächsten Schritt wird dann nochmals der Workflow für agorum core docform aufgerufen. Dabei werden zwei Parameter an docform übergeben:

Parameter 1, der dafür sorgt, dass das Dokument im Audit stehen bleibt.
Parameter 2, der eine Meldung ausgibt.

Beispiel

Die Regel in diesem Beispiel ist, dass eines der zwei Metadaten (fertigungdocbsp_keineNIO oder fertigungdocbsp_eineMehrNIO), den Wert "true" besitzt.
Normalerweise geschieht die Erfassung der Felder bereits in der Produktion auf dem Formular:

Erfassung der Felder in der Produktion

Wurde das Formular nicht korrekt ausgefüllt, wird die Bedingung, dass beide Metadaten gleichzeitig false sind, erfüllt und somit erneut der agorum core docform-Workflow aufgerufen.

Beide Felder nicht korrekt ausgefüllt

Dabei werden die Parameter "hidden_forceAudit" und "hidden_auditRemark" gesetzt. Durch den Präfix "hidden_" wird der Parameter nicht als Metadatum auf das Dokument gesetzt. Der erste Parameter zwingt das Dokument im Audit zu bleiben, während im zweiten Parameter als Wert die in agorum core docform anzuzeigende Meldung eingetragen wird.

Bedingung und Parameter / Werte der Regel "Workflow starten"

Tipp: Sie können der Meldung Styles hinzufügen, sofern diese HTML-konform sind. Im obigen Beispiel wurde der Text mit folgendem Code modifiziert:

<span style="color:red;font-weight:bold;">

In agorum core docform selbst wird die Maske folgendermaßen aufgebaut:

Aufbaue der Maske in agorum core docform

Nun muss eins der beiden Felder manuell angekreuzt werden. Danach kann das Dokument normal weiterverarbeitet werden.

JavaScript in hidden_auditRemark

Um in der Fehlerausgabe in DocForm noch einzubringen, was genau falsch ist, kann z. B. noch ausgegeben werden, was in einem bestimmten Metadatum steht.

Ein JavaScript wird mit "${js:" eingeleitet und endet immer mit "}".

Beispiel der Eingabe

In diesem JavaScript wird auf die Metadaten docformdemoverify_lieferscheinReFehlen und docformdemoverify_lieferscheinNrNotFound zugegriffen, in dem die Fehlerbeschreibung genau ausgegeben werden können. Hier in diesem Falle wird ausgegeben, wie viele und welche Lieferscheine noch fehlen. Alles muss in einer Zeile eingegeben werden:

${js: let ret = ''; if (docformdemoverify_lieferscheinReFehlen === 1) ret='Es fehlt noch 1 Lieferschein'; else  ret='Es fehlen noch ' + docformdemoverify_lieferscheinReFehlen + ' Lieferscheine'; ret + ':\n' + docformdemoverify_lieferscheinNrNotFound ;}

Beispiel kombiniert mit einer roten Ausgabe

Alles muss in einer Zeile eingegeben werden:

<span style="color:red;font-weight:bold;">${js: let ret = ''; if (docformdemoverify_lieferscheinReFehlen === 1) ret='Es fehlt noch 1 Lieferschein'; else  ret='Es fehlen noch ' + docformdemoverify_lieferscheinReFehlen + ' Lieferscheine'; ret + ':\n' + docformdemoverify_lieferscheinNrNotFound ;}</span>

Beispiel inklusive Link, der eine agorum core smart assistant action aufruft

Alles muss in einer Zeile eingegeben werden.

Hinweis: Hier kann nur eine Serveraktion aufgerufen werden. Der Aktion kann einzig die ID des Objektes mitgegeben werden, auf die sich diese Aktion bezieht. Alle benötigten Parameter, die diese Aktion benötigt, müssen als Parameter an dem übergebenen Objekt als Metadaten angehängt sein.

<span style="color:red;font-weight:bold;">${js: let ret = ''; ret = 'Lieferantennummer "' + demo_df_supplierNumber + '" nicht vorhanden. </br>Bitte Lieferantenakte anlegen.: <a href="JavaScript:Actions.action(\'demo_LieferantenakteanlegenüberDokument\', \''+id+'\')">Anlegen</a>'; ret;}</span>

Beschreibung des JavaScript, das eingebunden wurde:

JavaScript:Actions.action('<interner ASA-Aktion Name>', '<ObjectID>')

Hier im Beispiel wird die smart assistant-Aktion "demo_LieferantenakteanlegenüberDokument" aufgerufen. Über "id" wird die ID übergeben, die aktuell dem Objekt zugeordnet ist, mit dem der Fileworkflow gerade arbeitet.

Es wird die Aktion "<interner ASA-Aktion Name>" aufgerufen. Wenn diese Aktion Parameter benötigt, um eine Maske zu initialisieren, müssen diese an dem Objekt mit der <ObjectID> hängen. Die Aktion wird ganz normal geöffnet und startet mit "JavaScript (Initialisierung)", d. h. wie wenn die Aktion per rechte Maustaste auf dem Objekt mit <ObjectID> aufgerufen wir.