Anleitung

So installieren Sie VAMPIRE JS mit npm

VAMPIRE JS erwerben Sie im Shop von invoicePress.de. Sie erhalten das Paket als .tgz-Datei, und npm installiert es direkt aus dieser Datei. Eine öffentliche Paketquelle oder Zugangsdaten brauchen Sie dafür nicht.

VAMPIRE JS im Shop erwerben
Zu Ihrem Konto im Shop

1 · Im Shop erwerben
auf invoicePress.de
2 · Datei ablegen
in einem Ordner Ihres Projekts
3 · Installieren
npm install aus der .tgz-Datei
4 · Selbsttest
npx einvoice-validate-js selftest
Von der Datei zur ersten Prüfung: erwerben, ablegen, installieren und mit dem Selbsttest bestätigen.

So legen Sie das Paket in Ihr Projekt

Legen Sie die .tgz-Datei in einen Ordner Ihres Projekts, zum Beispiel in vendor-packages/. Dann installieren Sie das Paket von dort:

npm install ./vendor-packages/<datei>.tgz

<datei> steht für den Namen der Datei, die Sie erhalten haben. npm trägt den Pfad in Ihre package.json ein. Das sieht zum Beispiel so aus:

"dependencies": {
  "@specialpress/einvoice-validator-js": "file:vendor-packages/<datei>.tgz"
}

⚠️ Die Datei gehört zu Ihrer Lizenz. Legen Sie sie deshalb nicht in ein öffentliches Repository. In einem privaten Repository darf sie liegen, und dann läuft die Installation auf jedem Rechner gleich.


So läuft die Installation in einer Pipeline

Liegt die Datei in Ihrem privaten Repository, genügt in der Pipeline der Befehl npm ci. Liegt sie dort nicht, kopieren Sie sie vor diesem Befehl aus Ihrer eigenen, geschützten Ablage in denselben Ordner.


Was im Paket liegt

Teil Inhalt
die Bibliothek erkennt das passende Regelwerk, prüft das Schema, wertet die Regeln aus, erstellt den positiven Prüfbericht und den Bericht im Format des KoSIT-Validators
einvoice-validate-js die Kommandozeile
vampire/ die Regelpakete, die Strukturmodelle für die Schemaprüfung, vampire.js für den Browser, die Datei NOTICE und die Lizenztexte
der XML-Parser für Node; er ist im Paket enthalten, damit die Installation keine weitere Quelle braucht

So prüfen Sie, ob die Installation geklappt hat

npx einvoice-validate-js selftest

Der Selbsttest zeigt, wie viele Regelwerke und Zuordnungsregeln geladen sind, und prüft dann ein Probedokument. Läuft er durch, ist VAMPIRE JS einsatzbereit.


So bekommen Sie neue Versionen

Eine neue Version mit neuen Regelständen erhalten Sie als neue Datei. Sie ersetzen die alte Datei in Ihrem Ordner, passen den Dateinamen in package.json an und rufen npm install auf. Eine neue Version trägt nie den alten Dateinamen. Der Grund dafür: npm merkt sich in package-lock.json die Prüfsumme der Datei, und eine geänderte Datei unter demselben Namen würde nicht mehr zu dieser Prüfsumme passen.

Wie Sie danach Ihre erste Rechnung prüfen, steht in der Dokumentation für JavaScript.


VAMPIRE PHP frei, VAMPIRE JS im Shop.

VAMPIRE PHP und alle Regelpakete sind frei und liegen auf GitHub und Packagist. VAMPIRE JS erwerben Sie im Shop von invoicePress.de.

Zum Projekt auf GitHub
VAMPIRE JS im Shop erwerben