Administratorhandbuch infra CONVERT > 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 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


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": []
  }
}
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 infra CONVERT
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 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
 └ 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 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
└ 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 infra - CONVERT).
Characteristic​Type String Variable →Variables Merkmal
Attributive →Attributives Merkmal
ClassId String GUID der →Merkmalklasse
Special​Category​Id String GUID der →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 > 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
└ 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.


Klassen

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


Kategorien

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


Stempelvorlagen

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
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 > 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)