blue DAT • infra DAT
mdm TOOL
blue DAT • infra DAT
mdm TOOL
Administratorhandbuch infra CONVERT > Export
Verfügbar ab
Programmversion 1.4.2.1
Das Prüfplan-Exportformat JSONVx basiert auf dem, von allen gängigen Programmiersprachen lesbaren, Datenaustauschformat JSON. Gegenüber Austauschformaten wie CSV und DFD bildet es einen größeren Umfang der mit infra CONVERT erstellten Prüfplaninformationen ab.
Vx kennzeichnet den Versionsstand der enthaltenen Prüfplandatenstruktur. Die aktuelle Version ist JSONV2. JSONV1 wird weiterhin gepflegt. Wir empfehlen jedoch, JSONV2 zu bevorzugen.
Die Versionen des JSON-Prüfplanformats in der Übersicht:
Version* | Verfügbar | Wesentliches Charakteristikum / Änderungen gegenüber der Vorversion |
---|---|---|
1 | ab v1.0.0.0 | Abgebildet wird eine bestimmte Prüfplanversion eines Projekts. |
2.0 | ab v1.4.2.1 | Abgebildet werden alle Prüfplanversionen eines Projekts in einer Gesamtstruktur. |
2.1 | ab v2.7.9 | Optional anhand der Anzahl Wiederholungen gebildete Einzelmerkmale werden nicht mehr als einzelne, bis auf den Stempeltext identische, Merkmalkopien exportiert. Stattdessen wird nur noch ein Merkmalobjekt mit einer Liste der zugeordneten Stempeltexte exportiert (»MultiCharacteristicSplitStampTexts«. Siehe Benutzerhandbuch > Einstellungen > Einstellungen > Merkmale > Gruppe „Maße mit Angabe der Wiederholungen“ |
* – Haupt- und Nebenversionsnummer. Jeweils der neueste Hauptversionsstand wird für den entsprechende JSONVx-Export verwendet. |
Der JSONV2-Export kann entweder aus der Benutzeroberfläche heraus oder per Startparameteraufruf angestoßen werden.
Siehe Benutzerhandbuch > Funktionen > Export > Prüfplan exportieren
Siehe Konfiguration und Import > Startparameterdatei > Prüfpläne und gestempelte Zeichnungen exportieren
Inhalt
• Grundstruktur
• Projekt
• Prüfplanversion
• Merkmale
• Klassen
• Kategorien
• Kennzeichnungen
Bei einer JSONV2-Datei handelt es sich um einen geschlossenen Export, d. h. es werden keine externen Ressourcen oder Tabellen benötigt. »ExportFormatVersion« und »InfraConvertVersion« weisen das Exportformat und das exportierende System aus. Der Verzeichnisbaum mit der Wurzel »Project« enthält die Projektdaten. Im Feld »InspectionPlanVersions« sind die Prüfplanversionen mit den jeweiligen Zeichnungsblättern und Merkmalen gelistet. Die projektübergreifenden Definitionen für Klassen, Kategorien, Stempelvorlagen und Kennzeichnungen sind in den Feldern »Classes«, »Categories«, »StampTemplates« und »CharacteristicTags« aufgelöst. Sie werden den Merkmalen über Referenz-IDs (GUIDs) zugewiesen. Die Struktur innerhalb der Felder wird in den folgenden Abschnitten ausführlich erklärt.
{ "ExportFormatVersion": { "Major": 2, "Minor": 1 }, "InfraConvertVersion": "2.7.9", "Project": { "Name": "Beispielprojekt", "Description": "", "InspectionPlanVersions": [], "Classes": [], "Categories": [], "StampTemplates": [], "CharacteristicTags": [] } }
Parameter | Typ | Wert/Inhalt |
---|---|---|
ExportFormatVersion | Feld | Enthält die Versionsnummer des JSON-Prüfplanformats |
└ Major | Integer | Hauptversionsnummer |
└ Minor | Integer | Nebenversionsnummer |
InfraConvertVersion | String | Programmversion von infra CONVERT |
Project | String | Enthält die Projektdaten |
└ Name | String | Name bzw. Titel des Projekts |
└ Description | String | Beschreibung des Projekts |
└ InspectionPlanVersions | Feld | Enthält die Prüfplanversionen mit den Merkmalen |
└ Classes | Feld | Enthält die Klassendefinitionen |
└ Categories | Feld | Enthält die Kategoriedefinitionen |
└ StampTemplates | Feld | Enthält die Definitionen für die Stempelvorlagen |
└ CharacteristicTags | Feld | Enthält die Kennzeichnungsdefinitionen |
Im Feld Prüfplanversionen werden alle in einem Projekt enthaltenen Prüfplanversionen mit den jeweils zugeordneten Zeichnungsblättern und Merkmalen gelistet.
Siehe auch
Benutzerhandbuch infra CONVERT > Benutzeroberfläche > Funktionsfenster > Projektübersicht
"InspectionPlanVersions": [ { "Id": "7b80d8ef-6eef-4be1-af57-cca058828124", "Name": "Beispielprüfplan", "Version": "A", "Description": "", "Attributes": [ { "Key": "Owner", "Value": "" } ], "Documents": [ { "Id": "2755a199-752c-427e-aa7a-d0d19ee86007", "Name": "ez-29002675001-84-0_1.dwg", "Extents": { "MinX": 0.0, "MinY": 0.0, "MinZ": 0.0, "MaxX": 420.0, "MaxY": 297.0, "MaxZ": 0.0, "RotationAngle": 0.0 }, "Characteristics": [] } } } ],
Parameter | Typ | Wert/Inhalt |
---|---|---|
Id | String | Eindeutige Identifikationsnummer (GUID) des Projekts |
Name | String | Name bzw. Titel der Prüfplanversion |
Version | String | Versionsnummer der Prüfplanversion |
Description | String | Beschreibung der Prüfplanversion |
Attributes | Feld | Zusätzliche Prüfplanattribute (Verfügbar ab Programmversion 2.10.0) |
└ Key | String | Schlüssel des Prüfplanattributs |
└ Value | String | Wert des Prüfplanattributs |
Documents | Feld | Enthält alle Zeichnungsblätter der Prüfplanversion |
└ Id | String | GUID des Zeichnungsblatts |
└ Name | String | Name des Zeichnungsblatts |
└ Extents | Feld | Äußere Eckpunkte des Zeichnungsblatts |
└ MinX | Double | X-Koordinate der unteren linken Ecke in Zeichnungseinheiten |
└ MinY | Double | Y-Koordinate der unteren linken Ecke in Zeichnungseinheiten |
└ MinZ | Double | Z-Koordinate der unteren linken Ecke in Zeichnungseinheiten |
└ MaxX | Double | X-Koordinate der oberen rechten Ecke in Zeichnungseinheiten |
└ MaxY | Double | Y-Koordinate der oberen rechten Ecke in Zeichnungseinheiten |
└ MaxZ | Double | Z-Koordinate der oberen rechten Ecke in Zeichnungseinheiten |
└ RotationAngle | Double | Drehwinkel des Zeichnungsblatts in Grad |
└ Characteristics | Feld | Enthält die einem Zeichnungsblatt zugeordneten Merkmale |
Das Feld Characteristics enthält alle, einem Zeichnungsblatt zugeordneten, Merkmale mit ihren Eigenschaften. Die Reihenfolge der Merkmale entspricht der Listenposition im Prüfplan.
Am Ende dieses Abschnitts finden Sie ein Schaubild, welches die Vergabe der Ids veranschaulicht.
Siehe auch
Benutzerhandbuch infra CONVERT > Benutzeroberfläche > Funktionsfenster > Merkmaleigenschaften
Benutzerhandbuch infra CONVERT > Weiteres > Begriffe > Stempel/Stempeln
"Characteristics": [ { "Id": "23553146-b049-4875-80e4-33a40a0d5d1f", "SourceId": "00000000-0000-0000-0000-000000000000", "CompareSourceId": "00000000-0000-0000-0000-000000000000", "DirectCompareSourceId": "00000000-0000-0000-0000-000000000000", "IcpId": "1", "CharacteristicType": "Variable", "ClassId": "bea94ebe-84de-4653-86a5-dd600a45070e", "SpecialCategoryId": "6e626731-625f-4f71-a471-2a267d511e18", "CharacteristicTagIds": [ "24c41ca8-871c-456e-b082-22ec2a20216d" ], "Label": "Länge 8", "Value": "8", "NominalValue": "8", "UpperTolerance": "0.2", "LowerTolerance": "-0.2", "ToleranceTable": "DIN ISO 2768-1:1991-06", "ToleranceTableColumn": "m", "MinMax": "None", "Fit": "", "Conditions": "", "Reference": "", "ReferenceSystem": "", "Comment": "", "Count": 2, "MultiCharacteristicSplitStampTexts": [ "1.1", "1.2" ], "Stamp": { "Id": "61094ab8-c467-49ac-927d-0ef6333f7139", "CompareSourceId": "00000000-0000-0000-0000-000000000000", "Text": "1", "Field":{ "Column": "8", "Row": "A" }, "Position": { "X": 166.57601430037806, "Y": 232.21485376832985, "Z": 0.0 }, "Target": { "X": 166.4193231832, "Y": 225.87109451380002, "Z": 0.0 }, "StampGraphicFiles": [ "C:\\Users\\user1\\Desktop\\test.icpx\\JPG\\Beispielprüfplan_A_1.JPG", "C:\\Users\\user1\\Desktop\\test.icpx\\PNG\\Beispielprüfplan_A_1.PNG" ] } } ],
Parameter | Typ | Wert/Inhalt |
---|---|---|
Id | String | GUID des Merkmals |
SourceId | String | GUID des Merkmals, aus dem das Merkmal durch Duplizieren erstellt wurde |
└ CompareSourceId | String | Ursprüngliche GUID des Merkmals, aus welchem das Merkmal durch Übertragen oder Zusammenfügen beim Zeichnungsvergleich erstellt wurde. Bezieht sich bei mehreren Prüfplanversionen immer auf das allererste Merkmal einer Verknüpfungskette |
└ DirectCompareSourceId | String | GUID des Merkmals, aus welchem das Merkmal durch Übertragen oder Zusammenfügen beim Zeichnungsvergleich erstellt wurde. Bezieht sich immer auf das direkte Vorgängermerkmal |
IcpId | Integer | ID des Merkmals, wenn es aus einer ICP-Projektdatei importiert wurde (»*.icp« ist das Dateiformat der Vorgängersoftware infra - CONVERT). |
CharacteristicType | String | Variable →Variables Merkmal Attributive →Attributives Merkmal |
ClassId | String | GUID der →Merkmalklasse |
SpecialCategoryId | String | GUID der →Merkmalkategorie |
CharacteristicTagIds | String | GUIDs der Kennzeichnungen, welche dem Merkmal zugewiesen sind |
Value | String | Wert (Text, wie er aus einer Zeichnungseintragung gelesen wird.) |
Label | String | Titel des Merkmals |
NominalValue | String | Nennmaß (Zahlengenauigkeit wird eingehalten) |
UpperTolerance | String | Oberes Abmaß oder Grenzmaß (Zahlengenauigkeit wird eingehalten) |
LowerTolerance | String | Unteres Abmaß oder Grenzmaß (Zahlengenauigkeit wird eingehalten) |
ToleranceTable | String | Name der Toleranztabelle null Kein Wert zugewiesen, weil Parameter nicht zutreffend |
ToleranceTableColumn | String | Spalte in der Toleranztabelle |
MinMax | String | min Art der Grenze: Mindestmaß (Das untere Grenzmaß ist angegeben, die obere Grenze ist natürlich bestimmt) max Art der Grenze: Höchstmaß (Das obere Grenzmaß ist angegeben, die untere Grenze ist natürlich bestimmt) None Beide Grenzmaße sind angegeben oder eine Grenzmaßangabe ist nicht zutreffend. |
Fit | String | Toleranzklasse |
Conditions | String | Modifikatoren |
Reference | String | Bezüge aus einem Bezugssystem nach DIN EN ISO 1101 |
ReferenceSystem | String | Bezüge aus anderen Bezugssystemen als nach DIN EN ISO 1101 (»B-System« |
Comment | String | Bemerkung |
Count | Integer | Anzahl der Wiederholungen des Merkmals |
MultiCharacteristicSplitStampTexts | Feld | Liste der Stempel-/Merkmaltexte, wenn mehrere Einzelmerkmale abhängig von der Anzahl Wiederholungen erzeugt wurden (siehe »Einstellungen > Einstellungen > Merkmale > Gruppe „Maße mit Angabe der Wiederholungen““ Anmerkung Verfügbar ab Programmversion 2.7.5 |
Stamps | Feld | Enthält die Eigenschaften des Stempels |
└ Id | String | GUID des Stempels |
└ CompareSourceId | String | Ursprüngliche GUID des Stempels, aus welchem der Stempel durch Übertragen oder Zusammenfügen beim Zeichnungsvergleich erstellt wurde. Bezieht sich bei mehreren Prüfplanversionen immer auf den allerersten Stempel einer Verknüpfungskette |
└ Text | String | →Stempelbeschriftung |
└ Field | String | Enthält den Schlüssel des Feldes, in welchem sich der Stempel des Merkmals befindet null Feldschlüssel ist nicht zugewiesen |
└ Column | String | Wert für die Spalte |
└ Row | String | Wert für die Reihe |
└ Position | Feld | Enthält die Koordinaten der Position des Stempels auf dem Zeichnungsblatt Siehe auch Funktionen > Merkmale > Stempel neu positionieren und ausrichten |
└ X | String | X-Koordinate des Stempels in Zeichnungseinheiten |
└ Y | String | Y-Koordinate des Stempels in Zeichnungseinheiten |
└ Z | String | Z-Koordinate des Stempels in Zeichnungseinheiten |
└ Target | Feld | Enthält die Koordinaten des Bezugspunkts des Stempels auf dem Zeichnungsblatt Siehe auch Funktionen > Merkmale > Stempel neu positionieren und ausrichten |
└ X | String | X-Koordinate des Stempelbezugspunkts in Zeichnungseinheiten |
└ Y | String | Y-Koordinate des Stempelbezugspunkts in Zeichnungseinheiten |
└ Z | String | Z-Koordinate des Stempelbezugspunkts in Zeichnungseinheiten |
└ StampGraphicFiles | Feld | Für diesen Stempel exportierte Stempelgrafiken, angegeben als Dateipfad. Es werden chronologisch alle Exporte gelistet (erster Export, zweiter Export, …), die während einer Sitzung gelaufen sind. Für Stempelgrafiken, die per Startparameteraufruf exportiert werden, gilt: Die JSONV2-Targetdefinition muss nach den Stempelgrafik-Targetdefinition folgen Anmerkung Verfügbar ab Programmversion 2.7.5 |
Vergabe der Merkmal- und Stempel-IDs
Das folgende Schaubild soll die Vergabe der Ids (Guids) über die Prüfplanversionen hinweg verdeutlichen. In Fall 1 wird ein Merkmal von Prüfplanversion A nach B und von B nach C im Zeichnungsvergleich übertragen. Zum Beispiel findet sich »Guid C1« in Version B als CompareSourceId und als DirectCompareSourceId wieder, in C folglich nur noch als CompareSourceId. In Fall 2 wird Prüfplanversion B ausgelassen.
Im Feld Classes werden alle im Projekt definierten Merkmalklassen gelistet.
Siehe auch
Konfiguration und Import > Parameterdatei »CharacteristicClasses"
Benutzerhandbuch infra CONVERT > Weiteres > Begriffe > Klasse (Merkmal-)
"Classes": [ { "Id": "e5391b02-6657-4b4e-adc4-200547aed6e9", "FriendlyName": "Chamfer", "Name": "Fase", "Description": "", "QdasClass": 0, "OldEliasId": 33, "NominalUnit": "None", "ToleranceUnit": "None" } ],
Parameter | Typ | Wert/Inhalt |
---|---|---|
Id | String | GUID der Merkmalklasse |
FriendlyName | String | Bezeichnung der Merkmalklasse in Kurzform ohne Leerzeichen |
Name | String | Bezeichnung der Merkmalklasse in Langform |
Description | String | Ausführliche Beschreibung der Merkmalklasse |
QdasClass | String | Wert der Q-DAS-Klasse |
OldEliasId | String | ID der Merkmalklasse |
NominalUnit | String | Dem Nennmaß zuzuordnende →Maßeinheit |
ToleranceUnit | String | Den Toleranzgrenzen zuzuordnende →Maßeinheit |
Im Feld Categories werden alle im Projekt definierten Merkmalkategorien gelistet.
Siehe auch
Konfiguration und Import > Parameterdatei »StampTemplates"
Benutzerhandbuch infra CONVERT > Weiteres > Begriffe > Kategorie (Merkmal-)
"Categories": [ { "Id": "2bfa891e-ab74-4097-863d-ab5e5019abd7", "FriendlyName": "AuxiliaryDimension", "Name": "Hilfsmaß", "Description": "", "StampTemplateId": "4a9aa00c-1297-411b-994e-033db76f127b" } ],
Parameter | Typ | Wert/Inhalt |
---|---|---|
Id | String | GUID der Merkmalkategorie |
FriendlyName | String | Bezeichnung der Merkmalkategorie in Kurzform ohne Leerzeichen |
Name | String | Bezeichnung der Merkmalkategorie in Langform |
Description | String | Ausführliche Beschreibung der Merkmalkategorie |
Im Feld StampTemplates werden alle im Projekt definierten Stempelvorlagen gelistet.
Siehe auch
Konfiguration und Import > Parameterdatei »StampTemplates"
"StampTemplates": [ { "Id": "6929b308-651b-45b8-9967-6befeeb5e2d8", "Radius": 2.0, "Form": 0, "DefaultPosition": 0, "MinDistanceForConnectionLine": 10.0, "DistanceToText": 2.0, "FillStamp": true, "ColorString": "#FFD65532", "Name": "VDA-Stempel in Rot", "Description": "" } ],
Parameter | Typ | Wert/Inhalt |
---|---|---|
Id | String | GUID der Stempelvorlage |
Radius | Double | Größe des Stempels |
Form | Double | Form des Stempels |
DefaultPosition | Double | Orientierung des Stempels |
MinDinstanceForConnectionLine | Double | Mindestabstand des Stempels zum Bezugspunkt, ab welchem eine Verbindungslinie gezeichnet wird |
DistanceToText | Double | Abstand des Stempels zum Bezugspunkt |
FillStamp | String | Stempel füllen true Ja false Nein |
ColorString | String | Farbe des Stempels, hexadezimal mit Wert für den Alphakanal (ARGB) |
Name | String | Name der Stempelvorlage |
Description | String | Beschreibung der Stempelvorlage |
Im Feld CharacteristicTags werden alle im Projekt definierten Merkmalkennzeichnungen definiert.
Siehe auch
Konfiguration und Import > Parameterdatei »CharacteristicTags"
"CharacteristicTags": [ { "Id": "24c41ca8-871c-456e-b082-22ec2a20216d", "FriendlyName": "TagOne", "Priority": 1, "ColorString": "#FFF7931E", "Name": "Kennzeichnung Eins", "Description": "" } ]
Parameter | Typ | Wert/Inhalt |
---|---|---|
Id | String | GUID der Kennzeichnung |
FriendlyName | String | Bezeichnung der Kennzeichnung in Kurzform, ohne Leerzeichen |
Priority | Double | Priorität der Kennzeichnung |
ColorString | String | Farbe der Kennzeichnung, hexadezimal mit Wert für den Alphakanal (ARGB) |
Name | String | Name der Kennzeichnung in Langform |
Description | String | Beschreibung der Kennzeichnung |
Zurückblättern
Konfiguration und Import > Prüfplanformat JSONV1
Weiterblättern
Export > Prüfplanformat DFD (ASCII Transferformat)