ELIAS GmbH
Produktdokumentationen

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
~~NOTOC~~

<WRAP noprint>

> Administratorhandbuch #@IC_HTML@# > Export

</WRAP>

<WRAP group>
<WRAP column 75%>
====== Prüfplanformat JSONV2 ======

----
</WRAP>
<WRAP column 20%>
> **Verfügbar ab**\\ Programmversion 1.4.2.1
</WRAP>
</WRAP>

Das Prüfplan-Exportformat **JSONV2** ist die Weiterentwicklung des JSONV1-Formats, siehe Export > [[de:infra-convert:dev:export:jsonv1|Prüfplanformat JSONV1]]. Das Datenformat ist "JSON" (eine Beschreibung finden Sie [[http://www.json.org/json-de.html|an dieser Stelle]]), der Zusatz "V2" kennzeichnet den Versionsstand 2 der enthaltenen Prüfplandatenstruktur. JSON kann mit allen gängigen Programmiersprachen gelesen werden.

Gegenüber JSONV1 bildet JSONV2 alle Prüfplanversionen in einer Gesamtstruktur ab. JSONV1 wird weiterhin gepflegt, wir empfehlen jedoch JSONV2 zu bevorzugen. Die Prüfplanformate CSV und DFD enthalten nur einen kleinen Teil der in einem Projekt erzeugten Daten.

Der JSONV2-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]]).

\\ 

<WRAP noprint>
<WRAP group>
<WRAP column 20%>
//**__Inhalt__**//

 • [[de:infra-convert:dev:export:jsonv2#Grundstruktur]]\\ 
 • [[de:infra-convert:dev:export:jsonv2#Projekt]]\\ 
 • [[de:infra-convert:dev:export:jsonv2#Prüfplanversion]]\\ 
 • [[de:infra-convert:dev:export:jsonv2#Merkmale]]\\ 
 • [[de:infra-convert:dev:export:jsonv2#Klassen]]\\ 
 • [[de:infra-convert:dev:export:jsonv2#Kategorien]]\\ 
 • [[de:infra-convert:dev:export:jsonv2#Kennzeichnungen]]

</WRAP>
</WRAP>
</WRAP>

\\ 

====== Grundstruktur ======

<WRAP group>
<WRAP column 40%>

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.

</WRAP>
<WRAP column 55%>

<code javascript>
{
  "ExportFormatVersion": {
    "Major": 2,
    "Minor": 1
  },
  "InfraConvertVersion": "2.7.9",
  "Project": {
    "Name": "Beispielprojekt",
    "Description": "",
    "InspectionPlanVersions": [],
    "Classes": [],
    "Categories": [],
    "StampTemplates": [],
    "CharacteristicTags": []
  }
}
</code>

|< 100% 40% 12% 47% >|
^  Parameter  ^  Typ  ^  Wert/Inhalt  ^
^ ExportFormatVersion | Feld | Enthält die Versionsnummer des JSON-Prüfplanformats |
^ └ Major | Integer | Hauptversionsnummer |
^ └ Minor | Integer | Nebenversionsnummer |
^ InfraConvertVersion | String | Programmversion von #@IC_HTML@# |
^ Project | String | Enthält die Projektdaten |
^ └ Name | String | Name bzw. Titel des Projekts |
^ └ Description | String | Beschreibung des Projekts |
^ └ InspectionPlanVersions | Feld | Enthält die Prüfplanversionen mit den Merkmalen |
^ └ Classes | Feld | Enthält die Klassendefinitionen |
^ └ Categories | Feld | Enthält die Kategoriedefinitionen |
^ └ StampTemplates | Feld | Enthält die Definitionen für die Stempelvorlagen |
^ └ CharacteristicTags| Feld | Enthält die Kennzeichnungsdefinitionen |

</WRAP>
</WRAP>

\\ 

====== Prüfplanversionen ======

<WRAP group>
<WRAP column 40%>

Im Feld **Prüfplanversionen** werden alle in einem Projekt enthaltenen Prüfplanversionen mit den jeweils zugeordneten Zeichnungsblättern und Merkmalen gelistet.

> **Siehe auch**
> Benutzerhandbuch #@IC_HTML@# > Benutzeroberfläche > Funktionsfenster > [[de:infra-convert:user:interface:pexplorer|Projektübersicht]]

</WRAP>
<WRAP column 55%>

<code javascript>
"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": []
      }
    }
  }
],
        
</code>

|< 100% 33% 12% 54% >|
^  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 |
^ 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 |
^  └ RotationAngle | Double  | Drehwinkel des Zeichnungsblatts in Grad |
^ └ Characteristics | Feld | Enthält die einem Zeichnungsblatt zugeordneten Merkmale |

</WRAP>
</WRAP>

\\ 

====== Merkmale ======

<WRAP group>
<WRAP column 40%>

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 #@IC_HTML@# > Benutzeroberfläche > Funktionsfenster > [[de:infra-convert:user:interface:feature|Merkmaleigenschaften]]
>
> Benutzerhandbuch #@IC_HTML@# > Weiteres > Begriffe > [[de:infra-convert:user:terms#Stempel/Stempeln|Stempel/Stempeln]]

</WRAP>
<WRAP column 55%>

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

|< 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 |
^ └ 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 |
^ └ DirectCompareSourceId | 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 #@IC_OLD_HTML@#). |
^ CharacteristicType | 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 (Merkmal-)|Merkmalklasse]] |
^ SpecialCategoryId | 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 |
^ NominalValue | String | Nennmaß (Zahlengenauigkeit wird eingehalten) |
^ UpperTolerance | String | Oberes Abmaß oder Grenzmaß (Zahlengenauigkeit wird eingehalten) | 
^ LowerTolerance | String | Unteres Abmaß oder Grenzmaß (Zahlengenauigkeit wird eingehalten) |
^ ToleranceTable | String | Name der Toleranztabelle\\ **null** Kein Wert zugewiesen, weil Parameter nicht zutreffend |
^ ToleranceTableColumn | 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 |
^ ReferenceSystem | String | Bezüge aus anderen Bezugssystemen als nach DIN EN ISO 1101 ("B-System") |
^ Comment | String | Bemerkung |,
^ Count | Integer | Anzahl der Wiederholungen des Merkmals |
^ MultiCharacteristicSplitStampTexts | Feld | Liste der Stempel-/Merkmaltexte, wenn mehrere Einzelmerkmale abhängig von der Anzahl Wiederholungen erzeugt wurden (siehe "Einstellungen > Einstellungen > Merkmale > [[de:infra-convert:user:config:features#gruppe_„masse_mit_angabe_der_wiederholungen|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 | →[[de:infra-convert:user:terms#stempel_stempeln|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 > [[de:infra-convert:user:functions:balloonspos|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 > [[de:infra-convert:user:functions:balloonspos|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 |
^ └ StampGraphicFiles | Feld | Für diesen Stempel exportierte Stempelgrafiken, angegeben als Dateipfad. Es werden alle Exporte gelistet, 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 |

</WRAP>
</WRAP>

\\ 

> **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 ======

<WRAP group>
<WRAP column 40%>

Im Feld **Classes** werden alle im Projekt definierten Merkmalklassen gelistet.

> **Siehe auch**
> Konfiguration und Import > [[de:infra-convert:dev:characteristicclasses|Parameterdatei "CharacteristicClasses"]]
>
> Benutzerhandbuch #@IC_HTML@# > Weiteres > Begriffe > [[de:infra-convert:user:terms#Klasse (Merkmal-)|Klasse (Merkmal-)]]

</WRAP>
<WRAP column 55%>

<code javascript>
"Classes": [
  {
    "Id": "e5391b02-6657-4b4e-adc4-200547aed6e9",
    "FriendlyName": "Chamfer",
    "Name": "Fase",
    "Description": "",
    "QdasClass": 0,
    "OldEliasId": 33,
    "NominalUnit": "None",
    "ToleranceUnit": "None"
  }
],
</code>

|< 100% 33% 12% 54% >|
^  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 →[[de:infra-convert:user:terms#mass_groessen|Maßeinheit]] |
^ ToleranceUnit | String | Den Toleranzgrenzen zuzuordnende →[[de:infra-convert:user:terms#mass_groessen|Maßeinheit]] |

</WRAP>
</WRAP>

\\ 

====== Kategorien ======

<WRAP group>
<WRAP column 40%>

Im Feld **Categories** werden alle im Projekt definierten Merkmalkategorien gelistet.

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

</WRAP>
<WRAP column 55%>

<code javascript>
"Categories": [
  {
    "Id": "2bfa891e-ab74-4097-863d-ab5e5019abd7",
    "FriendlyName": "AuxiliaryDimension",
    "Name": "Hilfsmaß",
    "Description": "",
    "StampTemplateId": "4a9aa00c-1297-411b-994e-033db76f127b"
  }
],
</code>

|< 100% 33% 12% 54% >|
^  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 |

</WRAP>
</WRAP>

\\ 

====== Stempelvorlagen ======

<WRAP group>
<WRAP column 40%>

Im Feld **StampTemplates** werden alle  im Projekt definierten Stempelvorlagen gelistet.

> **Siehe auch**
> Konfiguration und Import > [[de:infra-convert:dev:stamptemplates|Parameterdatei "StampTemplates"]]

</WRAP>
<WRAP column 55%>

<code javascript>
"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": ""
  }
],
</code>

|< 100% 33% 12% 54% >|
^  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 |

</WRAP>
</WRAP>

\\ 

====== Kennzeichnungen ======

<WRAP group>
<WRAP column 40%>

Im Feld **CharacteristicTags** werden alle im Projekt definierten Merkmalkennzeichnungen definiert.

> **Siehe auch**
> Konfiguration und Import > [[de:infra-convert:dev:characteristictags|Parameterdatei "CharacteristicTags"]]

</WRAP>
<WRAP column 55%>

<code javascript>
"CharacteristicTags": [
  {
    "Id": "24c41ca8-871c-456e-b082-22ec2a20216d",
    "FriendlyName": "TagOne",
    "Priority": 1,
    "ColorString": "#FFF7931E",
    "Name": "Kennzeichnung Eins",
    "Description": ""
  }
]
</code>

|< 100% 33% 12% 54% >|
^  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  |

</WRAP>
</WRAP>

<WRAP noprint>

----

<WRAP group>
<WRAP col2>

<WRAP rightalign>
**Zurückblättern**\\ 
Konfiguration und Import > [[de:infra-convert:dev:export:jsonv1|Prüfplanformat JSONV1]]
</WRAP>

**Weiterblättern**\\ 
Export > [[de:infra-convert:dev:export:dfd|Prüfplanformat DFD (ASCII Transferformat)]]

</WRAP>
</WRAP>

</WRAP>
ELIAS GmbHProduktdokumentationen

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge

ELIAS GmbH
Produktdokumentationen
