~~NOTOC~~ > Administratorhandbuch #@IC_HTML@# > Export ====== Prüfplanformat JSONV1 ====== ---- Das Prüfplan-Exportformat **JSONV1** enthält deutlich mehr Informationen als die Formate CSV und DFD. Das Datenformat ist »JSON« (eine Beschreibung finden Sie [[http://www.json.org/json-de.html|an dieser Stelle]]), der Zusatz »V1« kennzeichnet den Versionsstand 1 der enthaltenen Prüfplandatenstruktur. JSON kann mit allen gängigen Programmiersprachen gelesen werden. Der JSONV1-Export kann entweder aus der Benutzeroberfläche heraus (siehe Benutzerhandbuch > Funktionen > Export > [[de:infra-convert:user:functions:cplanexport|Prüfplan exportieren]]) oder per Startparameterdatei angestoßen werden (siehe Konfiguration und Import > Startparameterdatei > [[de:infra-convert:dev:parameter#Prüfpläne und gestempelte Zeichnungen exportieren]]). \\ //**__Inhalt__**//  • [[de:infra-convert:dev:export:jsonv1#Grundstruktur]]\\  • [[de:infra-convert:dev:export:jsonv1#Projekt]]\\  • [[de:infra-convert:dev:export:jsonv1#Prüfplanversion]]\\  • [[de:infra-convert:dev:export:jsonv1#Merkmale]]\\  • [[de:infra-convert:dev:export:jsonv1#Klassen]]\\  • [[de:infra-convert:dev:export:jsonv1#Kategorien]]\\  • [[de:infra-convert:dev:export:jsonv1#Kennzeichnungen]] \\ ====== Grundstruktur ====== Bei einer JSONV1-Datei handelt es sich immer um einen geschlossenen Export, d. h. es werden keine externen Ressourcen oder Tabellen benötigt. Die in der Merkmalsliste **Characteristics** verwendeten eindeutigen Referenz-IDs (GUID) für Klassen, Kategorien und Kennzeichnungen werden innerhalb der Exportdatei referenziert. Sie werden am Ende der Datei unter der entsprechenden GUID aufgelöst. Die Grundstruktur des JSONV1-Formats setzt sich aus den nebenstehenden Feldern zusammen. Die Struktur innerhalb der Felder wird in den folgenden Abschnitten ausführlich erklärt. { "Project": {}, "InspectionPlanVersion": {}, "Characteristics": [], "Classes": [], "Categories": [], "CharacteristicTags": [] } |< 100% 33% 12% 54% >| ^ Parameter ^ Typ ^ Wert/Inhalt ^ ^ Projekt | Feld | Grundlegende Informationen zum exportierten Projekt | ^ InspectionPlanVersion | Feld | Grundlegende Informationen zum exportierten Prüfplan | ^ Characteristics | Feld | Alle Merkmale und Stempel | ^ Classes | Feld | Alle verwendeten Merkmalsklassen | ^ Categories | Feld | Alle verwendeten Merkmalskategorien | ^ CharacteristicTags| Feld | Alle verwendeten Kennzeichnungen für Merkmale | \\ ====== Projekt ====== Im Feld **Project** werden allgemeine Informationen zur Projektdatei ausgegeben. > **Siehe auch** > Benutzerhandbuch #@IC_HTML@# > Benutzeroberfläche > Funktionsfenster > [[de:infra-convert:user:interface:pexplorer|Projektübersicht]] "Project": { "Id": "be6d7da6-8e3c-4752-8029-534e3cf4ca3a", "Path": null, "Name": "Testprojekt", "Description": "Testbeschreibung", "InspectionPlanVersions": [ { "Id": "743b56e7-e352-4c01-9dc5-69bdcc68d986", "Name": "Testprüfplan", "Version": "A", "Description": "Testbeschreibung", "Attributes": [ { "Key": "Owner", "Value": "" } ], "Files": [ { "Id": "d5a413e5-a329-4021-8cbb-7e174990d5ad", "Name": "A.dwg" }, { "Id": "803960e2-415f-4a56-b558-87036988c6fb", "Name": "B.dxf" } ] } ] }, |< 100% 33% 12% 54% >| ^ Parameter ^ Typ ^ Wert/Inhalt ^ ^ ID | String | Eindeutige Identifikationsnummer (GUID) des Projekts | ^ Path | String | Pfad zur Projektdatei, aus welcher der Prüfpan exportiert wurde | ^ Name | String | Titel des Projekts | ^ Description | String | Beschreibung | ^ InspectionPlanVersions | Feld | Listet alle Prüfplanversionen mit enthaltenen Zeichnungsdateien | ^ └ Id | String | GUID der Prüfplanversion | ^ └ Name | String | Name der Prüfplanversion | ^ └ Version | String | Versionsnummer der Prüfplanversion | ^ └ Description | String | Beschreibung zu der Prüfplanversion | ^ └ Files | Feld | Zugeordnete Zeichnungsdateien bzw. -blätter | ^ └ Id | String | GUID des Zeichnungsblattes\\ \\ (Verfügbar ab Programmversion 1.3.9.5) | ^  └ Name | String | Dateiname des Zeichnungsblattes | \\ ====== Prüfplanversion ====== Im Feld **InspectionPlanVersion** werden grundlegende Informationen zum Prüfplan ausgegeben. "InspectionPlanVersion": { "Id": "743b56e7-e352-4c01-9dc5-69bdcc68d986", "Name": "Testprüfplan", "Version": "A", "Description": "Testbeschreibung", "Files": [ { "Id": "d5a413e5-a329-4021-8cbb-7e174990d5ad", "Name": "A.dwg" }, { "Id": "803960e2-415f-4a56-b558-87036988c6fb", "Name": "B.dxf" } ] }, }, |< 100% 33% 12% 54% >| ^ Parameter ^ Typ ^ Wert/Inhalt ^ ^ Id | String | GUID der Prüfplanversion | ^ Name | String | Name der Prüfplanversion | ^ Version | String | Versionsnummer der Prüfplanversion | ^ Description | String | Beschreibung zu 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 | ^ Files | Feld | Zugeordnete Zeichnungsdateien bzw. -blätter | ^ └ Id | String | GUID des Zeichnungsblattes | ^ └ Name | String | Dateiname des Zeichnungsblattes | \\ ====== Merkmale ====== Im Feld **Characteristics** werden alle Merkmale des Prüfplans mit ihren Eigenschaften ausgegeben. Die Reihenfolge der Merkmale entspricht der Listenposition im Prüfplan. Die zeichnungsblattbezogenen Prüfplanabschnitte werden entsprechend der Blattreihenfolge aneinander gehangen. 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|Merkmalseigenschaften]] > > Benutzerhandbuch #@IC_HTML@# > Weiteres > Begriffe > [[de:infra-convert:user:terms#Stempel/Stempeln|Stempel/Stempeln]] "Characteristics": [ { "Id": "77170b5d-ec65-4748-97f2-72e0b9db4275", "SourceId": null, "CompareSourceId": "00000000-0000-0000-0000-000000000000", "DirectCompareSourceId": "00000000-0000-0000-0000-000000000000" "CharacteristicType": "Variable", "ClassId": "5ebc991e-8b53-4d15-8c2b-358b793228d8", "SpecialCategoryId": "3e298f8f-02f1-49cd-82bf-bcdf26da11fe", "CharacteristicTagIds": [], "Label": "Gemittelte Rautiefe Rz 63", "Value": "Rz 63", "NominalValue": "", "NominalUnit": "Micrometer", "UpperTolerance": "63", "LowerTolerance": "", "ToleranceUnit": "Micrometer", "ToleranceTable": null, "ToleranceTableColumn": null, "MinMax": "None", "Fit": null, "Conditions": "None", "Reference": null, "ReferenceSystem": null, "Comment": "", "Count": "1", "Stamps": [ { "Id": "f2b0386f-fb4a-47ca-a6d3-e4afacb576b4", "CompareSourceId": "00000000-0000-0000-0000-000000000000", "Text": "2B", "File": { "Id": "d5a413e5-a329-4021-8cbb-7e174990d5ad", "Name": "A.dwg" }, "StampGraphicFile": "Test plan_A_1.jpg", "DrawingQuadrant": "B7", "PositionX": "0333", "PositionY": "0244", "TargetX": "0320", "TargetY": "0241", "Radius": "0019" } ] } ], |< 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\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend | ^ └ 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\\ (Verfügbar ab Programmversion 1.3.0.1) | ^ └ 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\\ (Verfügbar ab Programmversion 1.3.0.3) | ^ 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 (Merkmals-)|Merkmalsklasse]] | ^ Special​Category​Id | String | GUID der →[[de:infra-convert:user:terms#Kategorie (Merkmal-)|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 (Langtext) | ^ Nominal​Value | String | Nennmaß (Zahlengenauigkeit wird eingehalten)\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend | ^ Nominal​Unit | String | **Millimeter** Einheit des Nennmaßes: Millimeter\\ **Micrometer** Einheit des Nennmaßes: Mikrometer\\ **Inch** Einheit des Nennmaßes: Inch/Zoll\\ **Degree** Einheit des Nennmaßes: Grad\\ **None** Kein Wert ausgewählt\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend | ^ Upper​Tolerance | String | Oberes Abmaß oder Grenzmaß (Zahlengenauigkeit wird eingehalten)\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend | ^ LowerTolerance | String | Unteres Abmaß oder Grenzmaß (Zahlengenauigkeit wird eingehalten)\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend | ^ Tolerance​Unit | String | **Millimeter** Einheit des Toleranzmaßes: Millimeter\\ **Micrometer** Einheit des Toleranzmaßes: Mikrometer\\ **Inch** Einheit des Toleranzmaßes: Inch/Zoll\\ **Degree** Einheit des Toleranzmaßes: Grad\\ **None** Kein Wert ausgewählt\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend | ^ Tolerance​Table | String | Name der Toleranztabelle\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend | ^ Tolerance​Table​Column | String | Spalte in der Toleranztabelle\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend | ^ 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\\ **null** Kein Wert zugewiesen | ^ Conditions | String| Modifikatoren\\ **null** Kein Wert zugewiesen | ^ Reference | String | Bezüge aus einem Bezugssystem nach DIN EN ISO 1101\\ **null** Kein Wert zugewiesen | ^ Reference​System | String | Bezüge aus anderen Bezugssystemen als nach DIN EN ISO 1101.\\ **null** Kein Wert zugewiesen | ^ Comment | String | Bemerkung\\ **null** Kein Wert zugewiesen | ^ Count | Integer | Anzahl der Wiederholungen des Merkmals | ^ Stamps | Feld | Enthält die Eigenschaften des Stempels\\ \\ **Anmerkung** Jedem Merkmal wird genau ein Stempel zugeordnet, auch wenn sich dieser in einem Feld befindet. | ^ └ 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\\ \\ (Verfügbar ab Programmversion 1.2.0.21) | ^ └ Text | String | Merkmalnummer (inklusive Präfix und Suffix) | ^ └ File | String | Zeichnungsblatt, auf welchem sich der Stempel befindet | ^  └ Id | String | GUID des Zeichnungsblattes\\ \\ (Verfügbar ab Programmversion 1.3.9.5) | ^  └ Name | String | Dateiname des Zeichnungsblattes | ^ └ DrawingQuadrant | String | Schlüssel des Feldes, in welchem sich das Merkmal auf dem Zeichnungsblatt befindet | ^ └ StampGraphicFile | String | Dateiname der Stempelgrafik\\ \\ (Verfügbar ab Programmversion 2.5.1) | ^ └ PositionX | String | X-Koordinate des Stempels in Pixeln auf der Zeichnungsgrafik\\ \\ (Verfügbar ab Programmversion 1.2.0.21) | ^ └ PositionY | String | Y-Koordinate des Stempels in Pixeln auf der Zeichnungsgrafik\\ \\ (Verfügbar ab Programmversion 1.2.0.21) | ^ └ TargetX | String | X-Koordinate des Bezugspunkts (Zielpunkt, Ursprungspunkt) des Stempels in Pixeln auf der Zeichnungsgrafik\\ \\ (Verfügbar ab Programmversion 1.2.0.21) | ^ └ TargetY | String | Y-Koordinate des Bezugspunkts des Stempels in Pixeln auf der Zeichnungsgrafik\\ \\ (Verfügbar ab Programmversion 1.2.0.21) | ^ └ Radius | String | Größe des Stempels, angegeben als Radius in Pixeln auf der Zeichnungsgrafik\\ \\ (Verfügbar ab Programmversion 1.2.0.21) | \\ > **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&850 |}} \\ ====== Klassen ====== Im Feld **Classes** werden alle im Prüfplan verwendeten Merkmalsklassen ausgegeben. Alle verfügbaren Klassen sind in der Parameterdatei CharacteristicClasses.json gespeichert. > **Siehe auch** > Konfiguration und Import > [[de:infra-convert:dev:characteristicclasses|Parameterdatei »CharacteristicClasses«]] > > Benutzerhandbuch #@IC_HTML@# > Weiteres > Begriffe > [[de:infra-convert:user:terms#Klasse (Merkmals-)|Klasse (Merkmals-)]] "Classes": [ { "Id": "e5391b02-6657-4b4e-adc4-200547aed6e9", "FriendlyName": "Chamfer", "Name": "Chamfer", "Description": "" } ] |< 100% 33% 12% 54% >| ^ Parameter ^ Typ ^ Wert/Inhalt ^ ^ Id | String | GUID der Merkmalsklasse | ^ FriendlyName | String | Bezeichnung der Merkmalsklasse in Kurzform ohne Leerzeichen | ^ Name | String | Bezeichnung der Merkmalsklasse in Langform | ^ Description | String | Ausführliche Beschreibung der Merkmalsklasse | \\ ====== Kategorien ====== Im Feld **Categories** werden alle im Prüfplan verwendeten Merkmalskategorien ausgegeben. Alle verfügbaren Kategorien sind in der Parameterdatei SpecialCategories.json gespeichert. > **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", "UserId": 1, "Id": "6e626731-625f-4f71-a471-2a267d511e18", "FriendlyName": "CommonCharacteristic", "Name": "Standard-Merkmal", "Description": "" } ] |< 100% 33% 12% 54% >| ^ Parameter ^ Typ ^ Wert/Inhalt ^ ^ UserId | String | Benutzerfreundliche ID der Merkmalskategorie | ^ Id | String | GUID der Merkmalskategorie | ^ FriendlyName | String | Bezeichnung der Merkmalskategorie in Kurzform ohne Leerzeichen | ^ Name | String | Bezeichnung der Merkmalskategorie in Langform | ^ Description | String | ausführliche Beschreibung der Merkmalskategorie | \\ ====== Kennzeichnungen ====== Im Feld **CharacteristicTags** werden alle im Prüfplan verwendeten Kennzeichnungen für Merkmale ausgegeben. Alle verfügbaren Kennzeichnungen sind in der Parameterdatei CharacteristicTags.json gespeichert. > **Siehe auch** > Konfiguration und Import > [[de:infra-convert:dev:characteristictags|Parameterdatei »CharacteristicTags«]] "CharacteristicTags": [ { "Id": "24c41ca8-871c-456e-b082-22ec2a20216d", "FriendlyName": "TagOne", "Name": "Tag One", "Description": "" }, ] |< 100% 33% 12% 54% >| ^ Parameter ^ Typ ^ Wert/Inhalt ^ ^ Id | String | GUID der Kennzeichnung | ^ FriendlyName | String | Bezeichnung der Kennzeichnung in Kurzform, ohne Leerzeichen | ^ Name | String | Bezeichnung der Kennzeichnung in Langform | ^ Description | String | Ausführliche Beschreibung der Kennzeichnung | ---- **Zurückblättern**\\ Konfiguration und Import > [[de:infra-convert:dev:toltab|Toleranztabellen]] **Weiterblättern**\\ Export > [[de:infra-convert:dev:export:jsonv2|Prüfplanformat JSONV2]]