Benutzer-Werkzeuge

Webseiten-Werkzeuge


de:infra-convert:dev:export:jsonv2

Dies ist eine alte Version des Dokuments!


Administratorhandbuch infra CONVERT > Export

Prüfplanformat JSONV2


Das Prüfplan-Exportformat JSONV2 ist die Weiterentwicklung des JSONV1-Formats, siehe vorangegangenen Seite. Es handelt sich um eine JSON-Datei (eine Beschreibung finden Sie an dieser Stelle), welche alle für einen Prüfplan relevanten Informationen enthält. JSON-Dateien können von allen gängigen Programmiersprachen gelesen werden. Der Namenszusatz „V2“ kennzeichnet die Dateistruktur mit dem Versionsstand 2.

Hinweise Wir empfehlen, das JSONV2- oder das JSONV1-Format gegenüber dem DFD-Format zur Anbindung an Ihr Softwarepaket zu bevorzugen. Es beinhaltet den größeren Umfang an übertragbaren Informationen und unterstützt alle Features von infra CONVERT. Weiterhin haben Sie den Vorteil, dass auch spätere Versionen des JSONV2-Formats (nach Implementierung) mit Ihrer Software kompatibel sein werden.

Den Export können Sie in der Startparameterdatei anstoßen, siehe Konfiguration und Import > Startparameterdatei > Prüfpläne und gestempelte Zeichnungen exportieren.

Ein Beispiel für eine JSONV1-Exportdatei finden Sie an dieser Stelle: Anhang > Beispiel Prüfplan-Exportdatei JSONV1.

Inhalt

 • Grundstruktur
 • Projekt
 • Prüfplanversion
 • Merkmale
 • Klassen
 • Kategorien
 • 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": {}
}  
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 hinterlegt.

Siehe auch
Benutzerhandbuch infra CONVERT > Benutzeroberfläche > Funktionsfenster > 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",
      "Files": [
        {
          "Id": "d5a413e5-a329-4021-8cbb-7e174990d5ad",
          "Name": "A.dwg"
        },
        {
          "Id": "803960e2-415f-4a56-b558-87036988c6fb",
          "Name": "B.dxf"
        }
      ]
    }
  ]
},
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 hinterlegt.

"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"
    }
  ]
},
},
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
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


Merkmale

Im Feld Characteristics werden alle Merkmale des Prüfplans mit ihren Eigenschaften hinterlegt.

Die Reihenfolge der Merkmale entspricht der Listenposition im Prüfplan. Die zeichnungsblattbezogenen Prüfplanabschnitte werden entsprechend der Blattreihenfolge aneinander gehangen.

Siehe auch
Benutzerhandbuch infra CONVERT > Benutzeroberfläche > Funktionsfenster > Merkmalseigenschaften

Benutzerhandbuch infra CONVERT > Weiteres > Begriffe > 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"
        },
        "DrawingQuadrant": "B7",
        "PositionX": "0333",
        "PositionY": "0244",
        "TargetX": "0320",
        "TargetY": "0241",
        "Radius": "0019"
      }
    ]
  }
],
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 infra - CONVERT).
Characteristic​Type String Variable →Variables Merkmal
Attributive →Attributives Merkmal
ClassId String GUID der →Merkmalsklasse
Special​Category​Id String GUID der →Merkmalkategorie
CharacteristicTagIds String GUIDs der Kennzeichnungen, welche dem Merkmal zugewiesen sind
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
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
└ 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)


Klassen

Im Feld Classes werden alle im Prüfplan verwendeten Merkmalsklassen hinterlegt. Alle verfügbaren Klassen sind in der Parameterdatei CharacteristicClasses.json gespeichert.

Siehe auch
Konfiguration und Import > Parameterdatei "CharacteristicClasses"

Benutzerhandbuch infra CONVERT > Weiteres > Begriffe > Klasse (Merkmals-)
"Classes": [
  {
    "Id": "e5391b02-6657-4b4e-adc4-200547aed6e9",
    "FriendlyName": "Chamfer",
    "Name": "Chamfer",
    "Description": ""
  }
]
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 hinterlegt. Alle verfügbaren Kategorien sind in der Parameterdatei SpecialCategories.json gespeichert.

Siehe auch
Konfiguration und Import > Parameterdatei "StampTemplates"

Benutzerhandbuch infra CONVERT > Weiteres > Begriffe > Kategorie (Merkmal-)
"Categories": [
  {
 
    "Id": "2bfa891e-ab74-4097-863d-ab5e5019abd7",
    "UserId": 1,
    "Id": "6e626731-625f-4f71-a471-2a267d511e18",
    "FriendlyName": "CommonCharacteristic",
    "Name": "Standard-Merkmal",
    "Description": ""  }
]
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 Kategorien für Merkmale hinterlegt. Alle verfügbaren Kategorien sind in der Parameterdatei CharacteristicTags.json gespeichert.

Siehe auch
Konfiguration und Import > Parameterdatei "CharacteristicTags"
"CharacteristicTags": [
  {
    "Id": "24c41ca8-871c-456e-b082-22ec2a20216d",
    "FriendlyName": "TagOne",
    "Name": "Tag One",
    "Description": ""
  },
]
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 > Prüfplanformat JSONV1

Weiterblättern
Export > Prüfplanformat DFD (ASCII Transferformat)

de/infra-convert/dev/export/jsonv2.1575475487.txt.gz · Zuletzt geändert: 2019/12/04 17:04 von me