infra CONVERT
blue DAT • infra DAT
mdm TOOL
infra CONVERT
blue DAT • infra DAT
mdm TOOL
This is an old revision of the document!
Administrator's Manual infra CONVERT > Export
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
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 |
---|---|---|
ExportFormatVersion | Field | Contains the version number of the JSON test plan format |
└ Major | Integer | Main version number |
└ Minor | Integer | Minor version number |
InfraConvertVersion | 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 |
└ InspectionPlanVersions | Field | Contains the test plan versions with the characteristics |
└ Classes | Field | Contains the class definitions |
└ Categories | Field | Contains the categroy deifinitions |
└ StampTemplates | Field | Contains the definitions for the stamp templates |
└ CharacteristicTags | Field | Contains the label definitions |
The field test plan versions lists all the test plan versions contained in a project with the respective assigned drawing sheets and characteristics.
"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 |
└ RotationAngle | Double | Rotation angle of the drawing sheet in degrees |
└ Characteristics | Field | Contains the characteristics assigned to a drawing sheet |
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 |
└ DirectCompareSourceId | 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). |
CharacteristicType | String | Variable →Variable characteristics Attributive →Attributive characteristics |
ClassId | String | GUID of →Characteristic class |
SpecialCategoryId | String | GUID of →Characteristic category |
CharacteristicTagIds | String | GUIDs of the labels assigned to the characteristic |
Value | String | Text as read from the drawing entry. |
Label | String | Title of the characteristic |
NominalValue | String | Nominal value (Numerical accuracy is maintained) |
UpperTolerance | String | Upper dimension or limit value (Numerical accuracy is maintained) |
LowerTolerance | String | lower dimension or limit value (Numerical accuracy is maintained) |
ToleranceTable | String | Name of the tolerance table null No value assigned, because paramter soes not apply |
ToleranceTableColumn | 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 |
ReferenceSystem | 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 |
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 |
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 |
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 |
DefaultPosition | Double | Orientierung des Stempels |
MinDinstanceForConnectionLine | 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 |
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)