Verifizierung mit agorum core docform verify durchführen

agorum core docform verify gewährleistet die hohe Qualität der erfassten Metadaten, indem es per JavaScript erfasste Daten innerhalb der Dokumente automatisch abgleicht.

Anwendungsbeispiele

• Gesamtsummen rechnerisch prüfen lassen.
  • etwa:
    • Positionseinzelpreis mal Positionsmenge = Positionsbetrag
    • Gesamtbetrag der Rechnung = Summe aller Positionen
    • Mehrwertsteuer + Nettobetrag = Gesamtbetrag
  • Bestellnummer muss ausgelesen werden (entweder als Positionsmetadatum oder als Kopfmetdatum).
    • Beide Werte stellen optionale Metadaten dar, aber agorum core docform verify kann per Skript sicherstellen, dass einer dieser beiden Metadaten einen Wert aufweisen muss.

Technische Informationen

• Zusatzmodul für agorum core docform

Verifizierung mit JavaScript

Bei der Verifizierung durch JavaScript geben Sie das Skript als Parameter an. Das JavaScript muss als Ergebnis entweder true oder false liefern.

Beispiel: Prüfung aller Rechnungsbeträge

Der Bruttobetrag-Nettobetrag muss die MwSt. ergeben. Stimmen die aus dem Dokument gelesenen Werte nicht mit den tatsächlichen Beträgen im Dokument überein, würde eine entsprechende Verifizierung einen Fehler melden. Sie müssten das Dokument folglich im Audit manuell prüfen.

Sie können die Verifizierung auf verschiedene Art und Weise durchführen.
 

Möglichkeit 1
Sie schreiben In Parameter ein JavaScript, das direkt aufgerufen wird. Das aufgerufene JavaScript liegt in einem Pfad, in dem kein require notwendig ist.

Name der Verifizierung:     Brutto - Netto = MwSt
Interner Name:              BruttoNettoMwSt
Verifizierung:              JavaScript
Parameter:                  AC.eq(nl_bruttoBetrag-nl_nettoBetrag,nl_mwstBetrag,2);

Ist das Ergebnis dieses JavaScripts false, gibt das System folgenden Text im agorum core docform aus und der Prozess bleibt im Audit stehen.

"Brutto - Netto = MwSt"

Möglichkeit 2
Sie schreiben das gesamte JavaScript direkt in Parameter (also das Skript, das hinter AC.eq(...) steht).

Parameter:                  let precision = 2;
                            let c = Math.pow(10, precision);
                            let x = nl_bruttoBetrag-nl_nettoBetrag;
                                x = Math.round(Math.round(x * c * 1000) / 1000) / c;
                            let y = nl_mwstBetrag;
                                y = Math.round(Math.round(y * c * 1000) / 1000) / c;
                            x === y

Möglichkeit 3
Sie schreiben in Parameter ein JavaScript, das durch require aufgerufen wird. In dem require tragen Sie den kompletten Pfad ein. Das System ruft dann die Funktion eq(...) auf.

Parameter:                require('/agorum/roi/Scripting/Libraries/AC').eq(nl_bruttoBetrag-nl_nettoBetrag,nl_mwstBetrag,2);

Möglichkeit 4
Sie schreiben in Parameter ein JavaScript, das durch require aufgerufen wird. In dem require tragen Sie nur AC ein, da sich AC in einem Standard-Pfad befindet. Das System ruft dann die Funktion eq(...) auf.

Parameter:                  require('AC').eq(nl_bruttoBetrag-nl_nettoBetrag,nl_mwstBetrag,2);

Wenn Sie dieselbe Verifizierung mehrmals verwenden, verpacken Sie sie in eine JavaScript-Datei und rufen Sie dann nur die entsprechende Funktion in Parameter auf.

Wenn Sie es nur an einer Stelle benötigen, schreiben Sie das Skript direkt in Parameter.

Beispiel: Format überprüfen

Sie lesen in agorum core docform das Metadatum BelegNummer aus. Der Wert soll einem bestimmten Format entsprechen. In diesem Beispiel kann die Belegnummer folgende Werte haben:

Sie hinterlegen folgenden regulären Ausdruck im Dokumententyp in dem dafür definierten Verify-Feld als Parameter:

/^(LE|LA|UF)\d{7,7}$/.test(BelegNummer)

/agorum/roi/Scripting/Libraries/AC.js