~~NOTOC~~ > Administratorhandbuch #@IC_HTML@# > Export ====== Prüfplanformat JSONV2 ====== ---- > **Verfügbar ab**\\ Programmversion 1.4.2.1 Das Prüfplan-Exportformat **JSONVx** basiert auf dem, von allen gängigen Programmiersprachen lesbaren, Datenaustauschformat [[http://www.json.org/json-de.html|JSON]]. Gegenüber Austauschformaten wie CSV und DFD bildet es einen größeren Umfang der mit #@IC_HTML@# 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: |< 100% 10% 15% 75% >| ^ 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 > [[de:infra-convert:user:config:features#gruppe_„masse_mit_angabe_der_wiederholungen|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 > [[de:infra-convert:user:functions:cplanexport|Prüfplan exportieren]]\\  **Siehe** Konfiguration und Import > Startparameterdatei > [[de:infra-convert:dev:parameter#Prüfpläne und gestempelte Zeichnungen exportieren]] \\ //**__Inhalt__**//  • [[de:infra-convert:dev:export:jsonv2#Grundstruktur]]\\  • [[de:infra-convert:dev:export:jsonv2#Projekt]]\\  • [[de:infra-convert:dev:export:jsonv2#Prüfplanversion]]\\  • [[de:infra-convert:dev:export:jsonv2#Merkmale]]\\  • [[de:infra-convert:dev:export:jsonv2#Klassen]]\\  • [[de:infra-convert:dev:export:jsonv2#Kategorien]]\\  • [[de:infra-convert:dev:export:jsonv2#Kennzeichnungen]] \\ ====== Grundstruktur ====== 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": [] } } |< 100% 40% 12% 47% >| ^ Parameter ^ Typ ^ Wert/Inhalt ^ ^ Export​Format​Version | Feld | Enthält die Versionsnummer des JSON-Prüfplanformats | ^ └ Major | Integer | Hauptversionsnummer | ^ └ Minor | Integer | Nebenversionsnummer | ^ Infra​Convert​Version | String | Programmversion von #@IC_HTML@# | ^ Project | String | Enthält die Projektdaten | ^ └ Name | String | Name bzw. Titel des Projekts | ^ └ Description | String | Beschreibung des Projekts | ^ └ Inspection​Plan​Versions | Feld | Enthält die Prüfplanversionen mit den Merkmalen | ^ └ Classes | Feld | Enthält die Klassendefinitionen | ^ └ Categories | Feld | Enthält die Kategoriedefinitionen | ^ └ Stamp​Templates | Feld | Enthält die Definitionen für die Stempelvorlagen | ^ └ Characteristic​Tags| Feld | Enthält die Kennzeichnungsdefinitionen | \\ ====== Prüfplanversionen ====== Im Feld **Prüfplanversionen** werden alle in einem Projekt enthaltenen Prüfplanversionen mit den jeweils zugeordneten Zeichnungsblättern und Merkmalen gelistet. > **Siehe auch** > Benutzerhandbuch #@IC_HTML@# > Benutzeroberfläche > Funktionsfenster > [[de:infra-convert:user:interface:pexplorer|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": [] } } } ], |< 100% 33% 12% 54% >| ^ 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 | ^  └ Rotation​Angle | Double | Drehwinkel des Zeichnungsblatts in Grad | ^ └ Characteristics | Feld | Enthält die einem Zeichnungsblatt zugeordneten Merkmale | \\ ====== 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 #@IC_HTML@# > Benutzeroberfläche > Funktionsfenster > [[de:infra-convert:user:interface:feature|Merkmaleigenschaften]] > > Benutzerhandbuch #@IC_HTML@# > Weiteres > Begriffe > [[de:infra-convert:user:terms#Stempel/Stempeln|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" ] } } ], |< 100% 33% 12% 54% >| ^ 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 | ^ └ Direct​Compare​SourceId | 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 #@IC_OLD_HTML@#). | ^ Characteristic​Type | String | **Variable** →[[de:infra-convert:user:terms#Merkmal (Prüf-, Qualitäts-)|Variables Merkmal]]\\ **Attributive** →[[de:infra-convert:user:terms#Merkmal (Prüf-, Qualitäts-)|Attributives Merkmal]] | ^ ClassId | String | GUID der →[[de:infra-convert:user:terms#Klasse (Merkmal-)|Merkmalklasse]] | ^ Special​Category​Id | String | GUID der →[[de:infra-convert:user:terms#Kategorie (Merkmal-)|Merkmalkategorie]] | ^ Characteristic​Tag​Ids | 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 | ^ Nominal​Value | String | Nennmaß (Zahlengenauigkeit wird eingehalten) | ^ Upper​Tolerance | String | Oberes Abmaß oder Grenzmaß (Zahlengenauigkeit wird eingehalten) | ^ LowerTolerance | String | Unteres Abmaß oder Grenzmaß (Zahlengenauigkeit wird eingehalten) | ^ Tolerance​Table | String | Name der Toleranztabelle\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend | ^ Tolerance​Table​Column | 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 | ^ Reference​System | String | Bezüge aus anderen Bezugssystemen als nach DIN EN ISO 1101 (»B-System« | ^ Comment | String | Bemerkung |, ^ Count | Integer | Anzahl der Wiederholungen des Merkmals | ^ Multi​Characteristic​Split​Stamp​Texts | Feld | Liste der Stempel-/Merkmaltexte, wenn mehrere Einzelmerkmale abhängig von der Anzahl Wiederholungen erzeugt wurden (siehe »Einstellungen > Einstellungen > Merkmale > [[de:infra-convert:user:config:features#gruppe_„masse_mit_angabe_der_wiederholungen|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 | →[[de:infra-convert:user:terms#stempel_stempeln|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 > [[de:infra-convert:user:functions:balloonspos|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 > [[de:infra-convert:user:functions:balloonspos|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 | ^ └ Stamp​Graphic​Files | 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. > > {{ :de:infra-convert:user:terms:id-zuweisung_beim_zeichnungsvergleich.png?nolink |}} \\ ====== Klassen ====== Im Feld **Classes** werden alle im Projekt definierten Merkmalklassen gelistet. > **Siehe auch** > Konfiguration und Import > [[de:infra-convert:dev:characteristicclasses|Parameterdatei »CharacteristicClasses"]] > > Benutzerhandbuch #@IC_HTML@# > Weiteres > Begriffe > [[de:infra-convert:user:terms#Klasse (Merkmal-)|Klasse (Merkmal-)]] "Classes": [ { "Id": "e5391b02-6657-4b4e-adc4-200547aed6e9", "FriendlyName": "Chamfer", "Name": "Fase", "Description": "", "QdasClass": 0, "OldEliasId": 33, "NominalUnit": "None", "ToleranceUnit": "None" } ], |< 100% 33% 12% 54% >| ^ 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 →[[de:infra-convert:user:terms#mass_groessen|Maßeinheit]] | ^ ToleranceUnit | String | Den Toleranzgrenzen zuzuordnende →[[de:infra-convert:user:terms#mass_groessen|Maßeinheit]] | \\ ====== Kategorien ====== Im Feld **Categories** werden alle im Projekt definierten Merkmalkategorien gelistet. > **Siehe auch** > Konfiguration und Import > [[de:infra-convert:dev:specialcategories|Parameterdatei »StampTemplates"]] > > Benutzerhandbuch #@IC_HTML@# > Weiteres > Begriffe > [[de:infra-convert:user:terms#Kategorie (Merkmal-)|Kategorie (Merkmal-)]] "Categories": [ { "Id": "2bfa891e-ab74-4097-863d-ab5e5019abd7", "FriendlyName": "AuxiliaryDimension", "Name": "Hilfsmaß", "Description": "", "StampTemplateId": "4a9aa00c-1297-411b-994e-033db76f127b" } ], |< 100% 33% 12% 54% >| ^ 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 | \\ ====== Stempelvorlagen ====== Im Feld **StampTemplates** werden alle im Projekt definierten Stempelvorlagen gelistet. > **Siehe auch** > Konfiguration und Import > [[de:infra-convert:dev:stamptemplates|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": "" } ], |< 100% 33% 12% 54% >| ^ Parameter ^ Typ ^ Wert/Inhalt ^ ^ Id | String | GUID der Stempelvorlage | ^ Radius | Double | Größe des Stempels | ^ Form | Double | Form des Stempels | ^ Default​Position | Double | Orientierung des Stempels | ^ Min​Dinstance​For​Connection​Line | 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 | \\ ====== Kennzeichnungen ====== Im Feld **CharacteristicTags** werden alle im Projekt definierten Merkmalkennzeichnungen definiert. > **Siehe auch** > Konfiguration und Import > [[de:infra-convert:dev:characteristictags|Parameterdatei »CharacteristicTags"]] "CharacteristicTags": [ { "Id": "24c41ca8-871c-456e-b082-22ec2a20216d", "FriendlyName": "TagOne", "Priority": 1, "ColorString": "#FFF7931E", "Name": "Kennzeichnung Eins", "Description": "" } ] |< 100% 33% 12% 54% >| ^ 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 > [[de:infra-convert:dev:export:jsonv1|Prüfplanformat JSONV1]] **Weiterblättern**\\ Export > [[de:infra-convert:dev:export:dfd|Prüfplanformat DFD (ASCII Transferformat)]]