50.5 Erkennungsversionen

50.5.1 Warum es Versionen gibt

Die Erkennung ist der Teil des Programms, der die Werte von der PDF-Rechnung liest. Wir verbessern sie mit Updates - sie liest dann Layouts, an denen sie vorher gescheitert ist. Für ein eingerichtetes Profil darf ein Update aber nichts ändern: Ihre Regeln wurden mit einer bestimmten Erkennung abgeleitet, und Sie haben an den Beispieldateien bestätigt, dass sie richtig liest.

Deshalb trägt jede Fassung der Erkennung eine Nummer, die Erkennungsversion, und jedes Update bringt alle bisherigen Versionen unverändert mit. Ein Profil liest mit der Version, mit der es eingerichtet wurde, bis Sie es selbst umstellen. Das Programm stellt nie von selbst um.

Alles andere läuft immer im Stand des installierten Programms: die drei Prüfstufen (siehe Kapitel 50.1), das Erzeugen der E-Rechnung und die Umwandlung in PDF/A-3.

50.5.2 Wo die Version steht

Ort Anzeige
Profileinstellungen → Datenextrahierung Zeile "Erkennungsversion: n" über der Dateiauswahl (siehe Kapitel 8.5)
Regeleditor In der Statuszeile, etwa "Regeln aus Datei · Erkennungsversion 2" (siehe Kapitel 9)
Fehler- und Prüfordner Die Datei <Name> Felder.txt beginnt mit "Erkennungsversion: n"
Supportanfrage Das Archiv nennt die Version des Profils und die Versionen Ihres Programms (siehe Kapitel 80.3)

Gespeichert ist die Nummer in der Regeldatei Extrahierungsregeln.json im Beispielordner. Sie wandert damit in Sicherungen, Profilpakete und Supportanfragen mit. Ein Profil, das Sie mit einer Programmversion 1.0 eingerichtet haben, liest mit Erkennungsversion 1.

50.5.3 Nach einem Update: Vergleich

Bringt ein Update eine neuere Erkennungsversion mit, verarbeiten Ihre Profile weiter wie bisher. Nicht jede neue Version ändert, was gelesen wird: Manche verbessern nur das Einrichten neuer Profile oder sind technisch überarbeitet.

  • Die neue Version liest anders als die Version des Profils: In der Profilliste steht vor dem Namen des Profils ein kleines Hinweiszeichen (siehe Kapitel 4); es ist kein Warnsymbol.
  • Die neue Version ändert am Leseergebnis nichts: Es erscheint kein Hinweis. Das Profil kann bei seiner Version bleiben.

In beiden Fällen zeigt Profileinstellungen → Datenextrahierung die neue Version: Das Programm liest im Hintergrund alle Beispieldateien mit bestätigtem Soll mit der neuen Version und vergleicht sie mit dem Soll.

Profileinstellungen, Seite Datenextrahierung: Erkennungsversion 1, Version 2 ist verfügbar, ändert am Leseergebnis nichts und liest die bestätigten Beispieldateien wie bisher, daneben die Schaltfläche zum Umstellen
Anzeige Bedeutung
Version n ist verfügbar und liest die k bestätigten Beispieldateien wie bisher. Die neue Version kommt bei jeder bestätigten Datei zum selben Ergebnis
Version n ist verfügbar und liest i von k bestätigten Beispieldateien anders. Bei i Dateien weicht mindestens ein Feld vom bestätigten Soll ab
Version n ist verfügbar. Zum Vergleichen fehlen bestätigte Beispieldateien. Das Profil hat keine Regressionsbasis (siehe Kapitel 50.3)
Version n ist verfügbar. Sie ändert am Leseergebnis nichts und liest die k bestätigten Beispieldateien wie bisher - umstellen ist nicht nötig. Die neue Version liest nach unserer Messung wie die Version des Profils, und der Vergleich an Ihren Beispieldateien bestätigt das
Version n ist verfügbar. Sie ändert am Leseergebnis nichts - umstellen ist nicht nötig. Wie zuvor, das Profil hat aber keine Regressionsbasis zum Vergleichen

Der Vergleich ändert nichts am Profil. Er gilt auch dann, wenn die neue Version nach unserer Messung nichts ändert: Liest sie eine Ihrer bestätigten Beispieldateien doch anders, zeigt die Anzeige das an.

50.5.4 Umstellen

Sie müssen nicht umstellen: Ein Profil, das richtig liest, kann bei seiner Version bleiben. Umstellen lohnt sich, wenn die neue Version etwas liest, woran Ihr Profil bisher scheitert - was eine Version Neues bringt, nennt die Rückfrage beim Umstellen. Steht in der Anzeige "umstellen ist nicht nötig", bringt die neue Version für dieses Profil nichts Neues.

Auf Version n umstellen... neben der Anzeige führt je nach Ergebnis des Vergleichs weiter:

  • Liest wie bisher: Eine Rückfrage genügt. Danach liest das Profil mit der neuen Version.
  • Keine bestätigten Beispieldateien: Die Rückfrage weist darauf hin, dass sich das Ergebnis nicht vergleichen ließ. Prüfen Sie die nächsten Rechnungen; erhöhen Sie dafür die Einlernphase (siehe Kapitel 8.7).
  • Liest anders: Die Rückfrage nennt die Dateien mit bisherigem und neuem Wert. Danach öffnet sich der Regeleditor mit der neuen Version. Prüfen Sie dort die Ergebnisse, passen Sie die Regeln an und bestätigen Sie, was richtig gelesen wird (siehe Kapitel 9). Umgestellt ist das Profil erst, wenn Sie den Regeleditor mit OK oder Übernehmen verlassen; mit Abbrechen bleibt es bei der bisherigen Version.

Die Umstellung lässt sich im Programm nicht zurücknehmen. Deshalb legt das Programm vor jeder Umstellung den bisherigen Stand ab: Im Ordner der Beispieldateien entsteht der Unterordner Stand mit Erkennungsversion n mit der Regeldatei Extrahierungsregeln.json und dem Ordner Erwartet (den bestätigten Ergebnissen), wie sie mit der bisherigen Version galten. Gelingt die Ablage nicht, wird nicht umgestellt. Verlassen Sie den Regeleditor mit Abbrechen, ohne etwas bestätigt zu haben, entfernt das Programm die Ablage wieder.

So kehren Sie von Hand zum abgelegten Stand zurück:

  1. Deaktivieren Sie das Profil.
  2. Ersetzen Sie im Ordner der Beispieldateien die Datei Extrahierungsregeln.json und den Ordner Erwartet durch die Fassungen aus dem Unterordner.
  3. Aktivieren Sie das Profil wieder. Es liest danach wieder mit der bisherigen Erkennungsversion.

Dieselben Schritte stehen in der Datei Hinweis.txt im Unterordner. Das Programm verändert den Unterordner nicht mehr; Sie können ihn löschen, wenn Sie ihn nicht mehr brauchen. Er wandert in Sicherungen und Profilpakete mit.

50.5.5 Neue Profile

Ein neues Profil beginnt mit der neuesten Erkennungsversion. Werden damit nicht alle Beispieldateien gültig, versucht der Regeleditor im Hintergrund die älteren Versionen. Kommt eine von ihnen zu einem anderen Ergebnis, erscheint oben im Regeleditor ein Hinweis mit den Zahlen beider Versionen und der Schaltfläche Mit Version n einrichten. Sonst wird nichts gefragt.

Das ist ein Ausweg für den Einzelfall. Melden Sie uns ein Layout, das eine ältere Version besser liest als die neueste (siehe Kapitel 80.3).

50.5.6 Zurückgezogene Version

Stellt sich eine Erkennungsversion als fehlerhaft heraus, ziehen wir sie mit einem Update zurück. Profile, die auf ihr stehen, lesen weiter mit ihr. Die Anzeige lautet dann "Erkennungsversion: n (zurückgezogen)", und der Hinweis in der Profilliste bittet darum, auf die neueste Version umzustellen. Vergleich und Umstellen laufen wie in 50.5.3 und 50.5.4.

50.5.7 Profil aus einer neueren Programmversion

Verlangen die Regeln eines Profils eine Erkennungsversion, die das installierte Programm nicht enthält, liest das Programm dieses Profil nicht - auch nicht ersatzweise mit einer anderen Version. Die Meldung lautet "Erkennungsversion n ist in diesem Programm nicht vorhanden - das Profil wurde mit einer neueren Programmversion eingerichtet. Bitte das Programm aktualisieren." Das Profil wird übersprungen, seine Eingangsdateien bleiben liegen (siehe Kapitel 4). Das kommt vor, wenn Sie ein Profilpaket oder eine Sicherung aus einer neueren Programmversion einspielen oder zu einer älteren Programmversion zurückkehren.

Müssen Sie bei der älteren Programmversion bleiben, gibt es für ein umgestelltes Profil den Rückweg von Hand: Der Unterordner Stand mit Erkennungsversion n im Ordner der Beispieldateien enthält Regeln und bestätigte Ergebnisse von vor der Umstellung (siehe Kapitel 50.5.4). Profile, die nie umgestellt wurden, sind nicht betroffen.

Ein Programm der Version 1.0 kennt die Angabe noch nicht und liest jedes Profil mit Erkennungsversion 1. Liest es damit eine bestätigte Beispieldatei anders als ihr Soll, sperrt die Regressionsprüfung das Profil (siehe Kapitel 50.3).