Konfigurationsabweichungen

Beim Start von europa3000 werden verschiedene Bereiche auf fehlerhafte, fehlende oder unvollständige Konfigurationen geprüft.

Festgestellte Abweichungen werden im Fenster Konfigurationsabweichungen angezeigt.

Eine Konfigurationsabweichung muss nicht zwingend einen Fehler darstellen. Über Schweregrad wird angegeben, wie die festgestellte Abweichung einzustufen ist. Dabei wird beispielsweise zwischen Fehler , Warnung  und Info  unterschieden.

 

Fenster Konfigurationsabweichungen

Die Konfigurationsabweichungen aus den verschiedenen Bereichen und Modulen werden in einer gemeinsamen Übersicht angezeigt.

Die Übersicht enthält folgende Angaben:

Schweregrad
Gibt an, wie schwerwiegend die festgestellte Abweichung ist. Je nach Prüfung wird beispielsweise Fehler, Warnung oder Info angezeigt.

Bereich
Gibt den fachlichen Bereich an, aus dem die Prüfung stammt, beispielsweise Konfigurationsabweichungen für die DBModel-Prüfung oder Lohn für Prüfungen aus der Lohnbuchhaltung.

Titel
Beschreibt die festgestellte Abweichung.

Referenz
Gibt das Objekt an, auf das sich die Abweichung bezieht. Je nach Prüfung kann dies beispielsweise ein DBModel-Feld oder eine Adressnummer sein.

Ignore
Ermöglicht es, einzelne Meldungen als ignoriert zu kennzeichnen. Diese Funktion ist für Abweichungen vorgesehen, die geprüft wurden und bewusst akzeptiert werden können, beispielsweise kundenspezifische Anpassungen oder bekannte Besonderheiten, die keine Korrektur erfordern.

Die betreffenden Meldungen bleiben weiterhin in der Übersicht sichtbar und werden durch das aktivierte Kontrollkästchen als ignoriert gekennzeichnet.

Wichtig: Ignore sollte erst nach einer Prüfung der Abweichung aktiviert werden. Die Funktion behebt keine Fehler und ersetzt keine erforderliche Korrektur.

 

Wird ein Eintrag ausgewählt, werden auf der rechten Seite zusätzliche Informationen angezeigt:

Die Zusammenfassung beschreibt die festgestellte Abweichung. Unter Details werden zusätzliche Informationen angezeigt, die zur Analyse und Behebung der Abweichung benötigt werden. Konfigurationsabweichungen

Liste filtern

Mit F3 kann die Liste der Konfigurationsabweichungen nach Schweregrad und Bereich gefiltert werden.

Dadurch lässt sich die Anzeige auf bestimmte Arten von Abweichungen oder bestimmte Bereiche einschränken. 

Prüfung wiederholen

Nach einer Korrektur muss europa3000 nicht neu gestartet werden.

Mit F5 können die Konfigurationsprüfungen erneut durchgeführt werden. Während bereits eine Prüfung läuft, steht diese Funktion nicht zur Verfügung.

Ist die Ursache einer Abweichung behoben, wird diese bei der erneuten Prüfung nicht mehr angezeigt. 

 

DBModelcheck

Mit dem DBModelcheck wird geprüft, ob im DBModel benötigte Tabellen und Felder vorhanden und korrekt definiert sind. Zusätzlich werden die im DBModel definierten Feldreferenzen geprüft.

Ein Teil der Prüfung basiert auf der Datei DbModelConstraints.xml im Verzeichnis system/definitions

Die Datei definiert Tabellen und Tabellenfelder, die vorhanden und korrekt parametriert sein müssen.

 

DbModelConstraints.xml nicht ladbar

Kann die Datei DbModelConstraints.xml nicht geladen werden, können die darin definierten Tabellen- und Feldprüfungen nicht durchgeführt werden.

Dies kann beispielsweise der Fall sein, wenn die Datei fehlt oder aufgrund eines fehlerhaften Dateiformats nicht gelesen werden kann.

In diesem Fall wird folgendes Konfigurationsabweichung angezeigt:

Titel: DbModelConstraints konnte nicht geladen werden
Referenz: DbModelConstraints.xml

In den Details werden der Fehlercode und, sofern vorhanden, die beim Laden aufgetretene Fehlermeldung angezeigt.

 

Benötigte Tabellen

Der erste Teil der Datei DbModelConstraints.xml enthält unter RequiredTables die Tabellen, die im DBModel vorhanden sein müssen.

Beispiel:

Fehlt eine dieser Tabellenbeschreibungen im Unterverzeichnis config/DBModel wird die Abweichung

Pflichttabelle fehlt

angezeigt.

Fehlen beispielsweise die Tabellen T247 und T995, wird für jede fehlende Tabellenbeschreibung eine entsprechende Abweichung angezeigt.

 

Benötigte Felder

Der zweite Teil von DbModelConstraints.xml enthält einzelne Felder, die vorhanden und richtig parametriert sein müssen. Dabei handelt es sich fast immer um neuere Felder, die in älteren Systemen noch nicht vorhanden waren.

Beispiel:

Für T064.F122 sind damit unter anderem der Typ Color, die Länge 6 und EmptyAllowed=true vorgegeben.

Bei den definierten Feldern wird kontrolliert,

  1. ob das Feld in der Tabelle so vorhanden ist, wie es in DbModelConstraints.xml definiert ist,
  2. ob die definierten Eigenschaften vorhanden sind und mit den Vorgaben übereinstimmen.

Geprüft werden:

Pflichtfeld fehlt

Ist ein in DbModelConstraints.xml definiertes Pflichtfeld in der entsprechenden Tabellenbeschreibung nicht vorhanden, wird das Konfigurationsproblem

Pflichtfeld fehlt

angezeigt.

Beispiel T065.130:

Felddefinition weicht von DbModelConstraints ab

Ist das Feld vorhanden, entspricht aber eine seiner Eigenschaften nicht der Definition in DbModelConstraints.xml, wird eine entsprechende Abweichung gemeldet.

Beispiel:

Referenz: T064.F122

In den Details wird angezeigt:

In diesem Beispiel wird die aktuelle Definition von T064.F122 mit der erwarteten Definition aus DbModelConstraints.xml verglichen.

Für die Eigenschaften Aufsteigende Sortierung (AscendingOrder) und Duplikate erlaubt (DuplicatesAllowed) ist in DbModelConstraints.xml jeweils True vorgegeben. In der aktuellen Felddefinition sind diese Eigenschaften jedoch mit False definiert.

Für Gross-/Kleinschreibung beachten (CaseInsensitive) ist in DbModelConstraints.xml False vorgegeben, während die aktuelle Felddefinition den Wert True enthält.

Die Felddefinition weicht somit in mehreren Eigenschaften von der erwarteten Definition ab.

Über Erwartet wird der in DbModelConstraints.xml definierte Sollwert angezeigt. Aktuell zeigt den Wert aus der entsprechenden Tabellenbeschreibung unter config/DBModel. Dadurch ist unmittelbar ersichtlich, welche Eigenschaften voneinander abweichen.

 

 

Prüfung der Feldreferenzen in DBModel

Prüfung der Feldreferenzen

Unabhängig von den Prüfungen anhand der Datei DbModelConstraints.xml werden die in den Tabellenbeschreibungen unter config/DBModel definierten Feldreferenzen geprüft.

Referenziert ein Feld ein Feld einer anderen Tabelle, werden die entsprechenden Felddefinitionen direkt miteinander verglichen.

Dabei wird kontrolliert,

  1. ob das referenzierte Feld im DBModel vorhanden ist und
  2. ob die Länge des Quellfeldes mit der Länge des referenzierten Feldes übereinstimmt.

Feldlänge stimmt nicht mit dem referenzierten Feld überein

Stimmen die Feldlängen nicht überein, wird die Abweichung

Feldlänge stimmt nicht mit dem referenzierten Feld überein

angezeigt.

Beispiel:

Das Feld T159.F043 referenziert das Feld T065.F004.

Das Quellfeld T159.F043 ist in der entsprechenden Tabellenbeschreibung mit der Länge 60 definiert. Das referenzierte Feld T065.F004 besitzt in T065.xml dagegen die Länge 40.

Die Feldlängen stimmen somit nicht überein.

Zur Behebung sind die Definition des Quellfeldes und die Definition des referenzierten Feldes in config/DBModel zu prüfen.

Referenziertes Feld konnte nicht gefunden werden

Zusätzlich wird geprüft, ob ein in einer Feldreferenz angegebenes Feld im DBModel vorhanden ist.

Kann das referenzierte Feld in der entsprechenden Tabellenbeschreibung unter config/DBModel nicht gefunden werden, wird die Abweichung

Referenziertes Feld konnte nicht gefunden werden

angezeigt.

In den Details werden das Quellfeld und das referenzierte Feld angezeigt.

 

Hinweis zur Bezeichnung „Referenz“

Die Spalte Referenz bezeichnet das Objekt, bei dem die Abweichung festgestellt wurde.

Bei einer Meldung für T159.F043 ist somit T159.F043 die Referenz der Konfigurationsabweichung. Das von diesem Feld referenzierte Datenbankfeld ist dagegen T065.F004.

Diese beiden Bedeutungen von „Referenz“ sind zu unterscheiden.

 

Mögliche Abweichungen beim DBModelcheck

Beim DBModelcheck können folgende Abweichungen auftreten:

  • Pflichttabelle fehlt
  • Pflichtfeld fehlt
  • Felddefinition weicht von DbModelConstraints ab
  • Feldlänge stimmt nicht mit dem referenzierten Feld überein
  • Referenziertes Feld konnte nicht gefunden werden
  • DbModelConstraints konnte nicht geladen werden

 

Weitere Prüfbereiche

Das Fenster Konfigurationsabweichungen ist nicht auf den DBModelcheck beschränkt. Auch andere Module können eigene Prüfungen durchführen und festgestellte Abweichungen in dieser Liste ausgeben.

Beispiel Lohnbuchhaltung

Im Modul Payroll werden unter anderem aktive Mitarbeiter auf bestimmte Konfigurationen geprüft.

Mögliche Meldungen sind:

[Bild einfügen: Konfigurationsabweichungen Lohn]

Beim Arbeitskanton wird geprüft, ob der für den Mitarbeiter zum Stichtag gültige Arbeitskanton in den Firmenzuordnungen vorhanden ist.

Im Beispiel ist beim Mitarbeiter mit der Adressnummer 000017 der Arbeitskanton AG hinterlegt. Dieser ist jedoch in keiner Firmenzuordnung vorhanden.

In den Details werden unter anderem angezeigt:

Zusätzlich weist die Meldung darauf hin, dass andernfalls beim ELM-Lohndeklarationsprozess eine workplaceIDRef erzeugt werden kann, für die kein Workplace-Schlüssel existiert. Konfigurationsabweichungen

Statusanzeige der Konfigurationsabweichungen

In der oberen rechten Ecke des europa3000-Hauptfensters wird ein Statussymbol angezeigt, das über den aktuellen Zustand der Konfigurationsabweichungen informiert.

Die Farbe des Symbols richtet sich nach dem höchsten Schweregrad der nicht ignorierten Meldungen:

  • Rot – Fehler: Es liegt mindestens eine aktive Konfigurationsabweichung mit dem Schweregrad Fehler vor.

  • Gelb – Warnung: Es liegen keine aktiven Fehler, jedoch mindestens eine aktive Warnung vor

  •  Blau – Info: Es liegen ausschliesslich aktive Informationsmeldungen vor.

  • – Ignoriert: Alle vorhandenen Konfigurationsabweichungen wurden als ignoriert gekennzeichnet.

Beim Bewegen des Mauszeigers über das Statussymbol erscheint ein Hinweis mit der Anzahl der aktiven und ignorierten Konfigurationsabweichungen.

Beispiele:

Die Statusanzeige ermöglicht es, den Zustand der Konfigurationsprüfung jederzeit zu erkennen, ohne die Übersicht der Konfigurationsabweichungen öffnen zu müssen.

Hinweis: Ignorierte Meldungen bleiben weiterhin vorhanden, beeinflussen jedoch die farbliche Statusanzeige nicht. Das graue Symbol bedeutet daher nicht, dass keine Konfigurationsabweichungen existieren, sondern dass sämtliche vorhandenen Meldungen als ignoriert gekennzeichnet wurden.

 

TextId: 3145 | TopicId: — | Hierarchy: —