CARF Qualitool – XML-Schlüsselwörter: Datei, Geometrie & Referenzen
Schnelle Antworten zu den XML-Schlüsselwörtern für Sachdaten, Materialien, Referenzen, DGN-Libs, Modelle, Dateinamen, Skalierung, Dateiformat, Global-Origin, Auflösung, Arbeitseinheiten und Leerdateierkennung. Frage nicht gefunden? Nutzen Sie das Feedback-Feld am Seitenende – dort können Sie ein Ticket im Support-Portal erstellen.
SACHDATEN – TAG-Setnamen prüfen
Wie prüfe ich, welche TAG-Setnamen (Sachdatensätze) im Designfile erlaubt sind?
SACHDATEN zeigt die Setnamen der vorhandenen Tags an (SETNAMES). Sind Setnamen angegeben, sind nur diese zulässig; alle anderen werden als Fehler gemeldet. Die Liste kann automatisch über das Designfile befüllt werden.
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > SACHDATEN
MATERIAL – Materialien prüfen
Wie prüfe ich, ob verwendete Materialien im ENV vorhanden sind?
Das Schlüsselwort MATERIAL (Wert: JA, YES oder 1) aktiviert den Abgleich der im DGN verwendeten Materialien mit dem ENV. Elemente, deren Materialien im ENV nicht gefunden werden, erscheinen im Protokoll als fehlerhaft. Der Suchpfad für Materialien ist z. B. ..\\env\\db\\vent\\Hersteller oder ..\\env\\db\\root_material\\Hersteller.
Beispiel: <MATERIAL>JA</MATERIAL>
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > MATERIAL
REFERENZEN – Referenzen anzeigen und prüfen
Wie prüfe ich angehängte Referenzen auf korrekte Attribute?
REFERENZEN ermöglicht zwei Modi:
-
SHOW-REF– Referenzen werden nur als Information im Protokoll aufgelistet, nicht geprüft. -
Prüfung: Konfigurationsdatei mit einer Zeile je Referenz im Format
#MODELL-Name ; LOGISCHER-NAME ; FILENAME ; SKALIERUNG ; ROTATION ; MOVE (DX,DY,DZ).
Beispiel: Default; TESTREF1; testref1.dgn ; 0.5; 30.0; 20,0,0
Steht im Modellnamen ein -, wird die Referenz für alle Modelle geprüft und muss in allen vorhanden sein. Der Logische Name kann ebenfalls mit - übersprungen werden. Stimmt ein Wert nicht überein, erscheint eine Fehlermeldung. Die Liste lässt sich am besten über „Liste über DGN einfüllen" erstellen.
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > REFERENZEN
REFERENZEN_ERLAUBT – Erlaubte Referenzdateien definieren
Wie lege ich fest, welche Referenzdateien erlaubt sind?
REFERENZEN_ERLAUBT enthält eine Liste erlaubter Referenz-Dateinamen, Wildcards sind zulässig (z. B. vent_*.dgn). Wird ein Logischer Name (Logical) mit Doppelpunkt angegeben (z. B. KECS_999_999:va000003_000_prw.dgn), wird dieser beim Vergleich berücksichtigt. Ohne Logischen Namen wird der Pfad ignoriert.
Über $ENDUNG$ kann die erlaubte Dateiendung beschränkt werden:
-
$ENDUNG$.dgn→ nur.dgn-Dateien erlaubt -
$ENDUNG$.dwg→ nur.dwg-Dateien erlaubt
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > REFERENZEN_ERLAUBT
DGNLIB – Erlaubte DGN-Bibliotheken
Wie lege ich fest, welche DGN-Libs angehängt sein dürfen?
DGNLIB enthält eine Liste erlaubter DGN-Libs (ein Eintrag pro Zeile). Besondere Syntaxelemente:
-
FOLDER: \\\\Server\\Pfad– alle.dgnlib-Dateien aus dem Ordner sind erlaubt. -
*name.dgnlib– Präfix*bedeutet: diese DGN-Lib darf vorhanden sein, muss aber nicht. Keine Fehlermeldung, wenn sie fehlt. -
*.*– alle weiteren angehängten DGN-Libs sind erlaubt; nur explizit aufgelistete müssen tatsächlich angehängt sein.
Die Liste kann automatisch über das Designfile befüllt werden.
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > DGNLIB
MODEL – Erlaubte Modelle und Modellanzahl
Wie steuere ich, welche Modelle im DGN vorhanden sein dürfen?
MODEL verweist auf eine Konfigurationsdatei, in der erlaubte Modelle und die maximale Modellanzahl definiert sind. Mit ANZ_MAX: wird die Höchstzahl der Modelle begrenzt. Modellnamen können mit Wildcards (*) angegeben werden; das Format ist Name, Typ (2D/3D), Art (Normal/Sheet).
Beispiele:
-
*, 3D, Sheet– alle 3D-Sheet-Modelle erlaubt, unabhängig vom Namen -
*, *, *– alle Modelle erlaubt -
Kein Eintrag für einen Modelltyp → dieser Typ ist verboten
Die Liste kann automatisch über das Designfile befüllt werden.
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > MODEL
MODEL_NO_CHECK – Modelle von der Prüfung ausschließen
Wie schließe ich bestimmte Modelle von der Prüfung aus?
MODEL_NO_CHECK enthält eine Liste der Modellnamen, die bei der Prüfung übersprungen werden (ein Eintrag pro Zeile).
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > MODEL_NO_CHECK
DGN_NAME – Gewerk aus Dateinamen ableiten
Wie weise ich anhand des Dateinamens ein Gewerk zu?
DGN_NAME verweist auf eine Konfigurationsdatei, die Dateinamen-Muster (mit Wildcards) einem Gewerk zuordnet. Format: Gewerk … Dateiname-Muster. Beispiel: Alle Dateien, die vent im Namen enthalten, werden dem Gewerk „Lueftung" zugeordnet.
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > DGN_NAME
DGN_ACTIVE_SCALE – Aktive Skalierung prüfen
Wie prüfe ich die aktive Skalierung des DGN?
DGN_ACTIVE_SCALE prüft, ob die aktive Skalierung des DGN einem erlaubten Wert entspricht. Fehler erscheinen im Protokollbaum unter „Allgemeine Fehler". Erlaubte Werte können direkt in der Regel oder über eine Konfigurationsdatei angegeben werden.
Beispiele:
-
<DGN_ACTIVE_SCALE>LISTE:dgn_active_scale.cfg</DGN_ACTIVE_SCALE> -
<DGN_ACTIVE_SCALE>1.0 1.0 1.0</DGN_ACTIVE_SCALE>
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > DGN_ACTIVE_SCALE
ORIGINAL_DGN_FILE_FORMAT – Ursprüngliches Dateiformat prüfen
Wie prüfe ich die Dateieigenschaft „Ursprüngliches Dateiformat"?
ORIGINAL_DGN_FILE_FORMAT prüft die Dateieigenschaft „Ursprüngliches Dateiformat". Erlaubte Werte sind: DGNV7, DGNV8, DWG, DXF. Ist das Dateiformat nicht in der Liste enthalten, erscheint ein Fehler im Protokoll.
Beispiel: <ORIGINAL_DGN_FILE_FORMAT>LISTE:originalFileFormat.cfg</ORIGINAL_DGN_FILE_FORMAT>
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > ORIGINAL_DGN_FILE_FORMAT
GLOBAL-ORIGIN – Globalen Ursprung prüfen
Wie prüfe ich, ob der korrekte Global Origin gesetzt ist?
GLOBAL-ORIGIN gibt einen oder mehrere erlaubte Koordinatensätze für den globalen Ursprung an. Die Koordinaten werden durch Leerzeichen getrennt (Dezimalzeichen: Punkt). Optional kann als vierte Zahl die Anzahl der zu prüfenden Kommastellen angegeben werden.
Mehrere Einträge sind über eine Listendatei möglich (LISTE:go.cfg). Beim ersten Eintrag in der Datei wird z. B. auf 3 Kommastellen geprüft, beim zweiten auf 13 Kommastellen – die Genauigkeit erscheint auch im Protokoll.
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > GLOBAL-ORIGIN
RESOLUTION_UNIT – Auflösung prüfen
Wie prüfe ich die Auflösung einer DGN-Datei?
RESOLUTION_UNIT prüft die Auflösung des DGN gegen eine Konfigurationsdatei. Format der Datei: Auflösung/Einheit, z. B. 10000/Meter oder 1.0000/Kilometer.
Beispiel: <RESOLUTION_UNIT>LISTE:resolutionUnits.cfg</RESOLUTION_UNIT>
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > RESOLUTION_UNIT
CHECK_WORKING_UNITS – Arbeitseinheiten der Elemente prüfen
Wofür steht CHECK_WORKING_UNITS und was wird dabei geprüft?
CHECK_WORKING_UNITS (Wert: JA, YES oder 1) prüft die Arbeitseinheiten einzelner Elemente. Dabei wird erkannt, ob Elemente mit falschen Arbeitseinheiten erstellt wurden. Konkret geprüft wird: Stimmen die CONNPTS (Connection Points)? Stimmt die Länge im DB-String mit der tatsächlichen Elementlänge überein?
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > CHECK_WORKING_UNITS
ARBEITSEINHEITEN – Erlaubte Arbeitseinheiten definieren
Wie lege ich die erlaubten Arbeitseinheiten für das DGN fest?
ARBEITSEINHEITEN enthält die erlaubten Haupteinheit/Untereinheit-Kombinationen samt Skalierungsfaktoren. Format (neu): Haupteinheit/Untereinheit Faktor1/Faktor2.
Beispiel: Meter/Millimeter 1/10 – Haupteinheit Meter, Untereinheit Millimeter, Auflösung 1/1000 mm.
Das alte Format (m/mm 1/10) wird noch unterstützt, sollte aber nicht mehr verwendet werden. Mehrere Einträge können als Liste angegeben werden.
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > ARBEITSEINHEITEN
EMPTY_FILE – Leerdateien erkennen
Wie erkenne ich automatisch Leerdateien bei der Prüfung?
EMPTY_FILE verweist auf eine Konfigurationsdatei, in der Bedingungen definiert sind, unter denen eine Datei als „leer" gilt. Format: ATTRIBUT OPERATOR WERT. Alle Zeilen müssen erfüllt sein, damit die Leerdatei-Meldung erscheint.
Wichtige Attribute:
-
QualiType = 1→ Fehler, Prüf-Status FEHLER;QualiType = 2→ nur Information, Status OK -
ElementCount < 6– Anzahl Elemente -
NumberOfReferences < 1– Anzahl Referenzen -
FileSize < 50000– Dateigröße in Bytes -
Levels < 3– Anzahl Ebenen insgesamt -
LevelsUsed <= 3– Anzahl verwendeter Ebenen
Operatoren: <, >, =, >=, <=. Weitere Keywords aus der Bentley ECSchema-Datei sind ebenfalls verwendbar.
Quelle: Handbuch CARF Qualitool > XML Einstellungsdatei > Schlüsselwörter > EMPTY_FILE