User Tools

Site Tools


en:infra-convert:dev:export:jsonv2_neu

This is an old revision of the document!


Administrator's Manual infra CONVERT > Export

Quality test plan format JSONV2


Available from
Program version 1.4.2.1

The test plan export format JSONV2 is the further development of the JSONV1 format, see Export > Test plan format JSONV1. The data format is “JSON” (for a description see at this place), the addition “V2” indicates the version 2 of the contained test plan data structure. JSON can be read with all common programming languages.

Compared to JSONV1, JSONV2 maps all test plan versions in an overall structure. JSONV1 is still maintained, but we recommend that you prefer JSONV2. The CSV and DFD test plan formats contain only a small part of the data generated in a project.

The JSONV2 export can be initiated either from the user interface (see User Manual > Functions > Export > Export test plan) or via a start parameter file (see Configuration and Import > Start Parameter File > Export test plans and stamped drawings).

An example of a JSONV2 export file can be found here: Attachment> Example Test plan export file JSONV2.

Inhalt

 • Basic Structure
 • Quality test plan version
 • Characteristics
 • Classes
 • Categories
 • Stamp templates
 • Labels


Basic Structure

A JSONV2 file is a closed export, meaning that no external resources or tables are required. “ExportFormatVersion and InfraConvertVersion identify the export format and the exporting system. The directory tree with the root “Project” contains the project data. The field “InspectionPlanVersions” lists the inspection plan versions with the respective drawing sheets and characteristics. The cross-project definitions for classes, categories, stamp templates and labels are expanded in the fields “Classes”, “Categories”, “StampTemplates” and “CharacteristicTags”. They are assigned to the characteristics using reference IDs (GUIDs). The structure within the fields is explained in detail in the following sections.

{
  "ExportFormatVersion": {
    "Major": 2,
    "Minor": 0
  },
  "InfraConvertVersion": "1.4.2.0",
  "Project": {
    "Name": "Beispielprojekt",
    "Description": "",
    "InspectionPlanVersions": [],
    "Classes": [],
    "Categories": [],
    "StampTemplates": [],
    "CharacteristicTags": []
  }
}
Parameter Typ Wert/Inhalt
Export​Format​Version Field Contains the version number of the JSON test plan format
└ Major Integer Main version number
└ Minor Integer Minor version number
Infra​Convert​Version String Program version of infra CONVERT
Project String Contains the project data
└ Name String Name bzw. Titel des Projekts
└ Description String Description of the project
└ Inspection​Plan​Versions Field Contains the test plan versions with the characteristics
└ Classes Field Contains the class definitions
└ Categories Field Contains the categroy deifinitions
└ Stamp​Templates Field Contains the definitions for the stamp templates
└ Characteristic​Tags Field Contains the label definitions


Quality test plan version

The field test plan versions lists all the test plan versions contained in a project with the respective assigned drawing sheets and characteristics.

See also
User manual infra CONVERT > User interface > Function window > Project overview
"InspectionPlanVersions": [
  {
    "Id": "7b80d8ef-6eef-4be1-af57-cca058828124",
    "Name": "Beispielprüfplan",
    "Version": "A",
    "Description": "",
    "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 Type Value/Content
Id String Globally unique identifier (GUID) of the project
Name String Name or itle of the test plan version
Version String Version number of the test plan version
Description String Description of the test plan version
Documents Field Enthält alle Zeichnungsblätter der Prüfplanversion
└ Id String GUID of the Drawing sheet
└ Name String Name of the drawing sheet
└ Extents Field Contains the outer dimensions of the drawing sheet
 └ MinX Double X-coordinate of the lower left corner in drawing units
 └ MinY Double Y-coordinate of the lower left corner in drawing units
 └ MinZ Double Z-coordinate of the lower left corner in drawing units
 └ MaxX Double X-Coordinate of the upper right corner in drawing units
 └ MaxY Double Y-Coordinate of the upper right corner in drawing units
 └ MaxZ Double Z-Coordinate of the upper right corner in drawing units
 └ Rotation​Angle Double Rotation angle of the drawing sheet in degrees
└ Characteristics Field Contains the characteristics assigned to a drawing sheet


Characteristics

The field Characteristics contains all characteristics assigned to a drawing sheet with their properties. The sequence of the characteristics corresponds to the list position in the inspection plan.

See also
User manual infra CONVERT > User interface > Function window > Characteristics

User Manual infra CONVERT > Further > Terms > Stamp/Stamps
"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": 1,
  "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
      }
    }
  }
],
Parameter Type Value/Content
Id String GUID of the characteristic
SourceId String GUID of the characteristic from which the characteristic was created by duplication
└ CompareSourceId String Original GUID of the feature from which the Characteristic was created by transferring or merging during drawing comparison. For several test plan versions, always refers to the very first characteristic in a link chain
└ Direct​Compare​SourceId String GUID of the characteristic from which the charactaristic was created by transfer or merge during drawing comparison. Always refers to the direct predecessor characteristic
IcpId Integer ID of the feature if it was imported from an ICP project file (“*.icp” is the file format of the predecessor software infra - CONVERT).
Characteristic​Type String Variable →Variable characteristics
Attributive →Attributive characteristics
ClassId String GUID of →Characteristic class
Special​Category​Id String GUID of →Characteristic category
Characteristic​Tag​Ids String GUIDs of the labels assigned to the characteristic
Value String Text as read from the drawing entry.
Label String Title of the characteristic
Nominal​Value String Nominal value (Numerical accuracy is maintained)
Upper​Tolerance String Upper dimension or limit value (Numerical accuracy is maintained)
LowerTolerance String lower dimension or limit value (Numerical accuracy is maintained)
Tolerance​Table String Name of the tolerance table
null No value assigned, because paramter soes not apply
Tolerance​Table​Column String Column in the tolerance table
MinMax String min Type of limit: Minimum size (the lower limit is given, the upper limit is naturally determined)
max Type of limit: Maximum size (The upper limit is given, the lowe limit is naturally determined)
None Both limit dimensions are specified or a limit dimension specification is not applicable.
Fit String Tolerance class
Conditions String Modifiers
Reference String References from a reference system according to DIN EN ISO 1101
Reference​System String References from reference systems other than DIN EN ISO 1101 (“B system”)
Comment String Comment
Count Integer Number of repetitions of the characteristic
Stamps Feld Contains the characteristics of the stamp
└ Id String GUID of the stamp
└ CompareSourceId String Original GUID of the stamp from which the stamp was created by transfer or merge when comparing drawings. For multiple test plan versions, always refers to the very first stamp in a link chain
└ Text String Stamp inscription
└ Field String Contains the key of the field in which the characteristic stamp is located

null Field key is not assigned
 └ Column String Value for the column
 └ Row String Value of the series
└ Position Feld Contains the coordinates of the position of the stamp on the drawing sheet

See also Function > Characteristics > Repositioning and aligning stamps
 └ X String X-coordinate of the stamp in drawing units
 └ Y String Y-coordinate of the stamp in drawing units
 └ Z String Z-coordinate of the stamp in drawing units
└ Target Field Contains the coordinates of the reference point of the stamp on the drawing sheet

See also Function > Characteristic > Reposition and align stamp
 └ X String X-Coordinate of the stamp reference point in drawing units
 └ Y String Y-Coordinate of the stamp reference point in drawing units
 └ Z String Z-Coordinate of the stamp reference point in drawing units


Classes

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)

en/infra-convert/dev/export/jsonv2_neu.1592572226.txt.gz · Last modified: 2020/06/19 15:10 by me