Benutzer-Werkzeuge

Webseiten-Werkzeuge


de:infra-convert:dev:parameter
Administratorhandbuch infra CONVERT > Konfiguration und Import

Startparameterdatei


Die Startparameterdatei fasst Parameter, die beim Starten von infra CONVERT übergeben werden sollen, in einer Datei im JSON-Format zusammen. Auf dieser Seite werden unter Grundlagen der Aufruf, die grundlegenden Anforderungen, der Startparameter »forceConfigDir« und in den folgenden Abschnitten die einzelnen Teile der Startparameterdatei beschrieben. Beispiele für Startparameterszenarien finden sich im Abschnitt Beispiele für Startparameteraufrufe.


Grundlagen

Aufruf

Der Pfad zur Startparameterdatei wird dem Befehl zum Ausführen von infra CONVERT mit »parameter« übergeben. Beispiel mit einem beliebigen Dateipfad:

…/InfraConvertWPF.exe -parameter="C:/Windows/Temp/StartParameterFile.json"
Anmerkung Beachten Sie, dass Sonderzeichen im Namen/Pfad der Startparameterdatei nur dann korrekt an infra CONVERT übergeben werden, wenn sie korrekt codiert wurden. Dies kann in einer Batchdatei, die als UTF-8 gespeichert wurde, zum Beispiel durch Angabe der Codepage CHCP 65001 für UTF-8 sichergestellt werden. Beispiel:
chcp 65001
…/InfraConvertWpf.exe -parameter="Démarrer.json"

Grundlegende Anforderungen an die Startparameterdatei

  • Es wird die Zeichencodierung UTF-8 erwartet.
  • Pfade können absolut oder relativ angegeben werden.
  • Die Datei kann einen beliebigen Teil der hier vorgestellten Parameter beinhalten.
  • Die Datei muss sich an die Bestimmungen des JSON-Formats halten.

Startparameter »forceConfigDir«

Außerhalb der Startparameterdatei kann ein weiterer Aufrufparameter verwendet werden. Mit »forceConfigDir« kann ein anderer Speicherort für das Verzeichnis mit Konfigurations- und Vorlagendateien festgelegt werden, als das standardmäßig bei der Installation angelegte Verzeichnis »%ProgramData%/ELIAS GmbH/infra-Convert«.

…/InfraConvertWPF.exe -forceConfigDir="C:/ProgramData/ELIAS GmbH/infra-Convert"

Es können auch beide Parameter gleichzeitig übergeben werden:

…/InfraConvertWPF.exe -parameter="…/" -forceConfigDir="…/"
Anmerkung Achten Sie bei der Verwendung von »forceConfigDir« darauf, in der Konfigurationsdatei »settings.json« die Pfade für das Verzeichnis mit Excel-Vorlage-Dateien (Parameter ExcelReportsPath) und das Verzeichnis mit Toleranztabellen (Parameter ToleranceTablePath) ebenfalls anzupassen.


Sprache einstellen

Geben Sie mit dem Feld LanguageCode die Sprache der Benutzeroberfläche von infra CONVERT vor.

Ohne diesen Code wird automatisch die im Betriebssystem eingestellte Standardsprache verwendet. Falls diese nicht von infra CONVERT unterstützt wird, wird immer Englisch eingestellt.

Siehe auch
Benutzerhandbuch infra CONVERT > Anpassung > Einstellungen > Allgemein > Gruppe „Sprache“
"LanguageCode":"de"
Parameter Typ Wert/Inhalt
LanguageCode String de Deutsch
en Englisch
fr Französisch
it Italienisch
es Spanisch
zh Chinesisch
cs Tschechisch
bg Bulgarisch


Projekt öffnen oder anlegen

Legen Sie mit dem Feld Project fest, dass beim Start von infra CONVERT ein vorhandenes Projekt geöffnet oder ein neues Projekt angelegt wird.

Siehe auch
Benutzerhandbuch infra CONVERT > Funktionen > Projekte > Neues Projekt anlegen

Benutzerhandbuch infra CONVERT > Funktionen > Projekte > Projekt öffnen

Benutzerhandbuch infra CONVERT > Funktionen > Projekte > Projekt speichern
"Project": {
  "Path": "C:/Users/user1/Desktop/test.icpx",
  "Name":"Beispiel Projekt",
  "Action":"Open"
}
Parameter Typ Wert/Inhalt
Path String Pfad zum Speicherort mit dem Dateinamen; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen (Pflichtangabe)
Name String Titel des Projekts

Anmerkung Wird beim Anlegen (»Create«) zwingend benötigt. Wird beim Öffnen (»Open«) ignoriert.
Action String Open Öffnet ein vorhandenes Projekt
Create Legt ein neues Projekt an


Prüfplan öffnen oder anlegen

Legen Sie mit dem Feld InspectionPlanVersion fest, dass beim Start von infra CONVERT ein vorhandener Prüfplan geöffnet oder ein neuer Prüfplan angelegt wird.

Ein neuer Prüfplan kann nur angelegt werden, wenn bereits ein Projekt angelegt ist.

Siehe auch
Benutzerhandbuch infra CONVERT > Funktionen > Prüfpläne > Prüfplan anlegen
"InspectionPlanVersion": {
  "Name": "Zeichnungsstand",
  "Version": "0",
  "Action": "Create"
}
Parameter Typ Wert/Inhalt
Name String Titel des Prüfplans (Pflichtangabe)
Version Dezimal Versionsstand des Prüfplans (Pflichtangabe)
Action String Open Öffnet einen vorhandenen Prüfplan
Create Legt einen neuen Prüfplan an


Zeichnungen übergeben

Importieren Sie mit dem Feld Files beim Start von infra CONVERT eine beliebige Anzahl von Zeichnungsblättern in einen Prüfplan.

Siehe auch
Benutzerhandbuch infra CONVERT > Funktionen > Zeichnungen > Zeichnung importieren

Benutzerhandbuch infra CONVERT > Weiteres > Begriffe > Zeichnungsdatenformat
"Files": [
  {
  "Path":"C:/Users/user1/Desktop/zeichnung_1.dxf"
  },
  {
  "Path":"C:/Users/user1/Desktop/zeichnung_2.dwg",
  "ImportBehavior": "Ask"
  },
  {
  "Path":"C:/Users/user1/Desktop/zeichnung_3.igs"
  },
  {
  "Path":"C:/Users/user1/Desktop/zeichnung_4.pdf",
  "ImportBehavior": "ImportAllPages"
  },
  {
  "Path":"C:/Users/user1/Desktop/zeichnung_5.icp"
  },
  {
  "Path":"https://ftp.elias-gmbh.de/fictional_path/example.dwg"
  }
]

Für alle Zeichnungsimporte gilt:

Parameter Typ Wert/Inhalt
Path String Pfad zum Speicherort mit dem Dateinamen; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen

Für Zeichnungsimporte im PDF-Format gilt:

Parameter Typ Wert/Inhalt
ImportBehavior String Verhalten beim Import von mehrseitigen PDF-Dateien:
Ask Vor dem Import immer fragen
ImportFirstPage Nur erste Seite importieren
ImportAllPages Immer alle Seiten importieren

Anmerkung Der Parameter ist optional. Wird er nicht angegeben, wird nur das erste Blatt importiert.

Für Zeichnungsimporte im DXF- und DWG-Format gilt:

Parameter Typ Wert/Inhalt
ImportBehavior String Verhalten beim Import von DXF- und DWG-Dateien:
Ask Vor dem Import immer fragen
ImportModel Immer ausschließlich Modellbereich importieren
ImportPaperSpaces Immer alle Blätter aus Papierbereich importieren
ImportAllLayouts Immer alle Blätter importieren

Anmerkung Der Parameter ist optional. Wird er nicht angegeben, wird das Blatt aus dem Modellbereich importiert.

Für den Import von ICP-Projektdateien gilt:

Parameter Typ Wert/Inhalt
ImportBehavior String Verhalten beim Import von ICP-Dateien:
Ask Beim Nachladen von PDF-, DXF- und DWG-Zeichnungsdateien den Benutzer um Auswahl der Seite bzw. des Blattes in der Datei bitten
ImportModel Beim Nachladen von DXF- und DWG-Dateien immer ausschließlich den Modellbereich importieren

Anmerkung Der Parameter ist optional. Wird er nicht angegeben, wird automatisch aus einer PDF-Datei die erste Seite gewählt bzw. wird in einer DXF- und DWG-Datei der Modellbereich gewählt.


Prüfpläne und gestempelte Zeichnungen exportieren

Legen Sie mit dem Feld Targets fest, dass beim Ausführen des Befehls Projekt speichern in infra CONVERT Prüfpläne und/oder gestempelte Zeichnungen bzw. Zeichnungsausschnitte exportiert werden.

Die Exporte erfolgen in Listenreihenfolge (ab Programmversion 2.7.9). Prüfpläne sollten zum Abschluss exportiert werden. Zumindest im JSONV2-Format werden die Speicherpfade für Stempelgrafiken nur dann gelistet, wenn der Targetexport vorher gelaufen ist.

Hinweis Wir empfehlen, das Prüfplanformat JSONV2 zu verwenden, weil dieses alle Features von infra CONVERT unterstützt.
Siehe auch
Administratorhandbuch infra CONVERT > Export > Prüfplanformat JSONV2

Administratorhandbuch infra CONVERT > Export > Prüfplanformat JSONV1

Administratorhandbuch infra CONVERT > Export > Prüfplanformat DFD
"Targets": [
  {
    "Format":"PDF",
    "ExportOnSaveOnly": false,
    "ColorOption":"MonoColorStamp",
    "Path":"Export/"
  },
  {
    "Format":"Png",
    "ExportOnSaveOnly": true,
    "Path":"Export/Graphics/",
    "ImageOptions":{
      "Width":5000,
      "Height":3500,
      "Bit":24,
      "SupersamplingAlgorithm":"Bilinear",
      "SupersamplingFactor":3      
    },
    "StampImageOptions":{
      "Width":1500,
      "Height":1000,
      "Bit":24,
      "SupersamplingAlgorithm":"Bilinear",
      "SupersamplingFactor":2      
    }
  },
  {
    "Format":"Tif",
    "Path":"Export/Graphics/",
    "Mode":"Drawing",
    "ImageOptions":{
      "SupersamplingFactor":3,
      "SupersamplingAlgorithm":"Lanczos3"
    }
  },
  {
    "Format":"Bmp",
    "ExportOnSaveOnly": true,
    "Path":"Export/Graphics/",
    "Mode":"Stamps"
  },
  {
    "Format":"JSONV1",
    "LanguageCode":"de",
    "Path":"Export/prüfplan.json",
    "InspectionPlanVersionExportMode":"Last"
  },
  {
    "Format":"JSONV2",
    "LanguageCode":"de",
    "Path":"Export/prüfplan.json"
  },
  {
    "Format":"CSV",
    "Path":"Export/prüfplan.csv"
  },
  {
    "Format":"DFD",
    "Path":"Export/DFD/",
    "ExportHint":"MultiFileExport"
  },
  {
    "Format":"DFD",
    "Path":"Export/prüfplan.dfd",
    "ExportHint":"CombinedExport"
  }
]

Für das JSONV2-Prüfplanformat gilt:

Parameter Typ Wert/Inhalt
Format String JSONV2
LanguageCode String de Deutsch
en Englisch
Export​On​Save​Only String Beim Schließen des Programms, bzw. Schließen des Projekts, …
true … diesen Export nicht anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden.
false … diesen Export anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird).

Anmerkung Verfügbar ab Programmversion 2.7.5
Path String Pfad zum Speicherort mit dem Dateinamen; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen

Für das JSONV1-Prüfplanformat gilt:

Parameter Typ Wert/Inhalt
Format String JSONV1
LanguageCode String de Deutsch
en Englisch
Export​On​Save​Only String Beim Schließen des Programms, bzw. Schließen des Projekts, …
true … diesen Export nicht anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden.
false … diesen Export anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird).

Anmerkung Verfügbar ab Programmversion 2.7.5
Path String Pfad zum Speicherort mit dem Dateinamen; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen
Inspection​Plan​Version​Export​Mode String Implicit Die beim Startparameteraufruf mit dem Parameter »InspectionPlanVersion« angesprochene Prüfplanversion exportieren (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird)
Last Die zum Zeitpunkt des Exports neueste Prüfplanversion

Anmerkung Als »neueste« Prüfplanversion versteht sich die mit der lexikalisch höchsten Versionsnummer versehene Prüfplanversion

Für das CSV-Prüfplanformat gilt:

Parameter Typ Wert/Inhalt
Format String CSV
Export​On​Save​Only String Beim Schließen des Programms, bzw. Schließen des Projekts, …
true … diesen Export nicht anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden.
false … diesen Export anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird).

Anmerkung Verfügbar ab Programmversion 2.7.5
Path String Pfad zum Speicherort mit dem Dateinamen; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen
Inspection​Plan​Version​Export​Mode String Implicit Die beim Startparameteraufruf mit dem Parameter »InspectionPlanVersion« angesprochene Prüfplanversion exportieren (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird)
Last Die zum Zeitpunkt des Exports neueste Prüfplanversion

Anmerkung Als »neueste« Prüfplanversion versteht sich die mit der lexikalisch höchsten Versionsnummer versehene Prüfplanversion
ExportHint String AskForHeader Vor dem Export den Exportdialog zeigen, um die Dateneingabe für die Titelzeile zu ermöglichen und die Titelzeile zu exportieren.

Anmerkung Dieser Parameter ist verfügbar ab Programmversion 2.2.8.

Für das DFD-Prüfplanformat gilt:

Parameter Typ Wert/Inhalt
Format String DFD
Export​On​Save​Only String Beim Schließen des Programms, bzw. Schließen des Projekts, …
true … diesen Export nicht anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden.
false … diesen Export anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird).

Anmerkung Verfügbar ab Programmversion 2.7.5
Path String Pfad zum Speicherort, beim Mehrfachexport (»MultiFileExport«) ohne einen Dateinamen, beim kombinierten Export (»CombinedExport«) mit Dateinamen; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen
Inspection​Plan​Version​Export​Mode String Implicit Die beim Startparameteraufruf mit dem Parameter »InspectionPlanVersion« angesprochene Prüfplanversion exportieren (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird)
Last Die zum Zeitpunkt des Exports neueste Prüfplanversion

Anmerkung Als »neueste« Prüfplanversion versteht sich die mit der lexikalisch höchsten Versionsnummer versehene Prüfplanversion
ExportHint String MultiFileExport Teilprüfpläne in separate DFD-Dateien exportieren (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird)
CombinedExport Teilprüfpläne in gemeinsame DFD-Datei exportieren

Für Zeichnungsexporte im PDF-Format gilt:

Parameter Typ Wert/Inhalt
Format String PDF
ColorOption String Steuert die farbliche Darstellung der Zeichnung und der Stempel:
NoPolicy Stempel wie im Programm dargestellt, Zeichnung wie nativ vorgesehen
Mono Stempel und Zeichnungsblatt in Schwarz-Weiß
Grayscale Stempel und Zeichnung in Graustufen
MonoColorStamp Stempel wie im Programm dargestellt, Zeichnung monochrom
Export​On​Save​Only String Beim Schließen des Programms, bzw. Schließen des Projekts, …
true … diesen Export nicht anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden.
false … diesen Export anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird).

Anmerkung Verfügbar ab Programmversion 2.7.5
Path String Pfad zum Speicherort ohne einen Dateinamen; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen
Inspection​Plan​Version​Export​Mode String Implicit Die beim Startparameteraufruf mit dem Parameter »InspectionPlanVersion« angesprochene Prüfplanversion exportieren (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird)
Last Die zum Zeitpunkt des Exports neueste Prüfplanversion
All Alle im Projekt enthaltenen Prüfplanversionen exportieren; die Dateien werden je Prüfplanversion in ein Unterverzeichnis geschrieben; das Verzeichnis wird mit der GUID des Prüfplans benannt

Anmerkung Als »neueste« Prüfplanversion versteht sich die mit der lexikalisch höchsten Versionsnummer versehene Prüfplanversion

Für Zeichnungsexporte im SVG-Format gilt:

Parameter Typ Wert/Inhalt
Format String SVG
Export​On​Save​Only String Beim Schließen des Programms, bzw. Schließen des Projekts, …
true … diesen Export nicht anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden.
false … diesen Export anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird).

Anmerkung Verfügbar ab Programmversion 2.7.5
Path String Pfad zum Speicherort ohne einen Dateinamen; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen
Inspection​Plan​Version​Export​Mode String Implicit Die beim Startparameteraufruf mit dem Parameter »InspectionPlanVersion« angesprochene Prüfplanversion exportieren (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird)
Last Die zum Zeitpunkt des Exports neueste Prüfplanversion
All Alle im Projekt enthaltenen Prüfplanversionen exportieren; die Dateien werden je Prüfplanversion in ein Unterverzeichnis geschrieben; das Verzeichnis wird mit der GUID des Prüfplans benannt

Anmerkung Als »neueste« Prüfplanversion versteht sich die mit der lexikalisch höchsten Versionsnummer versehene Prüfplanversion

Für Zeichnungsexporte im PNG-, JPG-, BMP-, TIF- und GIF-Format gilt:

Parameter Typ Wert/Inhalt
Format String Png Alle Zeichnungsblätter und/oder alle gestempelten Merkmale ausschnittsweise jeweils als PNG-Datei
Tif Alle Zeichnungsblätter sowie alle gestempelten Merkmale ausschnittsweise jeweils als TIF-Datei
Jpg Alle Zeichnungsblätter und/oder alle gestempelten Merkmale ausschnittsweise jeweils als JPG-Datei
Bmp Alle Zeichnungsblätter und/oder alle gestempelten Merkmale ausschnittsweise jeweils als BMP-Datei
Gif Alle Zeichnungsblätter und/oder alle gestempelten Merkmale ausschnittsweise jeweils als GIF-Datei

Anmerkung Die Verwendung der Dateiformate PNG und TIF wird empfohlen, insbesondere das JPG-Format eignet sich nicht für technische Zeichnungen
Mode String Drawing Nur die Zeichnungsblätter exportieren
DrawingWithoutStamps Nur die Zeichnungsblätter ohne Stempel exportieren
Stamps Nur die Stempelgrafiken exportieren

Wird Mode nicht angegeben, werden Zeichnungs- und Stempelgrafiken zusammen exportiert
Image​Options Feld Steuert das Rendering der Zeichnungsgrafiken

Wird ImageOptions nicht angegeben, werden die aktuellen Exporteinstellungen (Einstellungen > Export > Zeichnungsgrafik) verwendet
└ Width Integer Breite des Bildes in Anzahl Pixel
└ Height Integer Höhe des Bildes in Anzahl Pixel
└ Bit Integer Farbtiefe:
8 8 Bit
24 24 Bit (nicht bei GIF)
└ Super​sampling​Algorithm String Supersampling-Methode (→Kantenglättung):
None Kein Supersampling anwenden
Box Durchschnitt
Bilinear Linear
Bicubic Kubisch
Bspline B-Spline
Catmullrom Catmull-Rom
Lanczos3 Lanczos 3

Anmerkung Supersampling funktioniert nur mit einer Farbtiefe von 24 Bit

Anmerkung Verfügbar ab 2.2.4
└ Supersampling​Factor Integer Qualitätsstufe für das Supersampling (→Kantenglättung):
1 Kein Supersampling anwenden
2 bis 5 Stufen 2 bis 5

Anmerkung Verfügbar ab Programmversion 2.2.4
└ Mode String Wahl zwischen Hardware- und Softwarerendering:
Auto Automatisch
Hardware Hardwarebeschleunigt
Software Software

Anmerkung Verfügbar ab Programmversion 4.2.12
Stamp​Image​Options Feld Steuert das Rendering der Stempelgrafik

Wird StampImageOptions nicht angegeben, werden die aktuellen Exporteinstellungen (Einstellungen > Export > Stempelgrafik) verwendet
└ Width Integer Breite des Bildes in Anzahl Pixel
└ Height Integer Höhe des Bildes in Anzahl Pixel
└ Bit Integer Farbtiefe:
8 8 Bit
24 24 Bit (nicht bei GIF)
└ Super​sampling​Algorithm String Supersampling-Methode (→Kantenglättung):
None Kein Supersampling anwenden
Box Durchschnitt
Bilinear Linear
Bicubic Kubisch
Bspline B-Spline
Catmullrom Catmull-Rom
Lanczos3 Lanczos 3

Anmerkung Supersampling funktioniert nur mit einer Farbtiefe von 24 Bit

Anmerkung Verfügbar ab Programmversion 2.2.4
└ Supersampling​Factor Integer Qualitätsstufe für das Supersampling (→Kantenglättung):
1 Kein Supersampling anwenden
2 bis 5 Stufen 2 bis 5

Anmerkung Verfügbar ab Programmversion 2.2.4
└ Mode String Wahl zwischen Hardware- und Softwarerendering:
Auto Automatisch
Hardware Hardwarebeschleunigt
Software Software

Anmerkung Verfügbar ab Programmversion 4.2.12
Export​On​Save​Only String Beim Schließen des Programms, bzw. Schließen des Projekts, …
true … diesen Export nicht anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden.
false … diesen Export anstoßen, wenn keine Änderungen am Projekt vorgenommen wurden (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird).

Anmerkung Verfügbar ab Programmversion 2.7.5
Path String Pfad zum Speicherort ohne einen Dateinamen; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen
Inspection​Plan​Version​Export​Mode String Implicit Die beim Startparameteraufruf mit dem Parameter »InspectionPlanVersion« angesprochene Prüfplanversion exportieren (Standardverhalten, wird angewendet, wenn der Parameter nicht angegeben wird)
Last Die zum Zeitpunkt des Exports neueste Prüfplanversion
All Alle im Projekt enthaltenen Prüfplanversionen exportieren; die Dateien werden je Prüfplanversion in ein Unterverzeichnis geschrieben; das Verzeichnis wird mit der GUID des Prüfplans benannt

Anmerkung Als »neueste« Prüfplanversion versteht sich die mit der lexikalisch höchsten Versionsnummer versehene Prüfplanversion


Funktion aufrufen

Rufen Sie mit dem Feld Mode beim Start eine Funktion in infra CONVERT auf. Die Funktion wird nicht ausgeführt, sondern geöffnet und steht dem Benutzer damit direkt zur Verfügung. Zur Zeit stehen folgende Funktionen zur Verfügung (weitere folgen):

  • Kennzeichnen-Werkzeug
    AddCharacteristicTag
    Ruft das Kennzeichnen-Werkzeug auf, siehe Benutzerhandbuch > Funktionen > Merkmale > Kennzeichnen.

Für die Funktion Kennzeichnen-Werkzeug gilt:

"Mode": {
  "Name": "AddCharacteristicTag",
  "ItemId": "{5D1110CA-6093-4381-B372-CF983D515044}"
}
Parameter Typ Wert/Inhalt
Name String AddCharacteristicTag
ItemId String GUID der Kennzeichnung

Für die Funktion Zeichnungsvergleich gilt:

"Mode":{  
   "Name":"CompareDocuments",
   "SourceInspectionPlanVersion":{  
      "Name":"Neuer Prüfplan",
      "Version":"A"
   },
   "TargetInspectionPlanVersion":{  
      "Name":"Neuer Prüfplan",
      "Version":"B"
   },
   "SourceDocumentOriginalFileName":"ez-29002675001-84-0_1.dxf",
   "TargetDocumentOriginalFileName":"ez-29002675001-84-a_1.dxf"
}
Parameter Typ Wert/Inhalt
Name String CompareDocuments
Source​Inspection​Plan​Version Feld
└ Name String Name der Quell-Prüfplanversion
└ Version String Versionsnummer der Quell-Prüfplanversion
Target​Inspection​Plan​Version Feld
└ Name String Name der Ziel-Prüfplanversion
└ Version String Versionsnummer der Ziel-Prüfplanversion
Source​Document​Original​File​Name String Dateiname des Quell-Zeichnungsblatts
Target​Document​Original​File​Name String Dateiname des Ziel-Zeichnungsblatts


Auf Stempel zoomen

Sie können beim Öffnen eines Projekts die Ansicht im Zeichnungsfenster auf einen bestimmten Stempel festlegen. infra CONVERT fokussiert den Stempel und zoomt soweit heran, dass der zugehörige Zeichnungseintrag inklusive umgebenden Bereich ins Fenster eingepasst ist.

Jedem Stempel in einer ICPX-Datei ist eine GUID zugewiesen. Übergeben Sie diese im Feld ZoomToStampGuid. Sind Merkmale durch Übertragen oder Zusammenfügen im Zeichnungsvergleich verknüpft worden, können Sie auch die ID des ursprünglichen Stempels übergeben, gezoomt wird dann auf den zugehörigen Stempel der neuesten Prüfplanversion.

Wenn ICP-Dateien in ein Projekt geladen werden, sind ggf. die GUIDs der Stempel nicht bekannt. In diesem Fall können Sie auch die ID des Stempels übergeben. Nutzen Sie dazu das Feld ZoomToStampIcpId. Hierin müssen Sie auch die Prüfplanversion sowie den Namen der ICP-Datei angeben, weil die ID seitens infra - CONVERT nur innerhalb eines ICP-Projekts gültig ist.

Hinweis
infra CONVERT kann mit der Zoom-Funktionalität auch als Viewer verwendet werden. Schalten Sie Steuerelemente der Benutzeroberfläche ab (siehe »Konfiguration und Import > Parameterdatei »UiAccess««), um ein Verfälschen von Daten zu verhindern. Zum Betrachten von ICP-Dateien erstellen Sie temporär ein ICPX-Projekt und laden die ICP-Datei in eine Prüfplanversion.

Die GUID des Stempels ist bekannt:

"ZoomToStampGuid":{  
   "Id":"{56422575-2376-497f-b633-8dbe06626fab}"
}
Parameter Typ Wert/Inhalt
Id String GUID des Stempels

Nur die ID des Stempels in der ICP-Datei ist bekannt:

"ZoomToStampIcpId":{
   "InspectionPlanVersion":{  
      "Name":"Neuer Prüfplan",
      "Version":"A"
   },
   "DocumentName":"ez-29002675001-84-0_1.icp",
   "Id":"3"
}
Parameter Typ Wert/Inhalt
InspectionPlanVersion Feld
└ Name String Titel der Prüfplanversion
└ Version String Versionsnummer
DocumentName String Name der ICP-Datei
Id String ICP-ID


Einstellungen

Mit dem Feld Settings wird der Pfad zur Parameterdatei settings.json festgelegt. Aus dieser bezieht infra CONVERT die globalen Einstellungen.

Siehe auch
Administratorhandbuch infra CONVERT > Programmaufruf > Parameterdatei »Settings«

Administratorhandbuch infra CONVERT > Konfiguration und Import > Parameterdatei »Settings« > Liste der Einstellungen > Einstellungen ohne Steuerelemente in der Benutzeroberfläche

Benutzerhandbuch infra CONVERT > Anpassung > Einstellungen > Allgemein
"Settings": {
  "Path": "C:/ProgramData/ELIAS GmbH/infra-CONVERT/Settings.json",
  "Force": true
},
Parameter Typ Wert/Inhalt
Path String Pfad zum Speicherort und Dateiname; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen
Force String Lesereihenfolge der per Startparameter übergebenen und einer benutzerdefinierten »settings.json«:
true Erzwingen, dass die per Startparameter übergebene »settings.json« nach der »settings.json« aus AppData gelesen wird, benutzerdefinierte Einstellungen also überschrieben werden
false Standardverhalten (gilt auch, wenn Parameter »Force« nicht angegeben wird)

Anmerkung Verfügbar ab Programmverion 2.0.0.0


Parameterdatei für Kennzeichnungen

Mit dem Feld CharacteristicTagsDefinition wird der Pfad zur Parameterdatei CharacteristicTags.json festgelegt. Aus dieser bezieht infra CONVERT Definitionen für Kennzeichnungen, welche mit dem Projekt gespeichert werden.

Sollte die Datei nicht existieren, so wird sie mit den üblichen Voreinstellungen angelegt.

Siehe auch
Administratorhandbuch infra CONVERT > Programmaufruf > Parameterdatei »CharacteristicTags«

Benutzerhandbuch infra CONVERT > Anpassung > Projekteinstellungen > Kennzeichnungen
"CharacteristicTagsDefinition": {
  "Path": "C:/Users/user1/AppData/CharacteristicTags.json"
}
Parameter Typ Wert/Inhalt
Path String Pfad zum Speicherort und Dateiname; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen


Parameterdatei für Merkmalsklassen

Mit dem Feld CharacteristicClassesDefinition wird der Pfad zur Parameterdatei »CharacteristicClasses.json« festgelegt. Aus dieser bezieht infra CONVERT die Definitionen für Merkmalsklassen, welche mit dem Projekt gespeichert werden.

Siehe auch
Administratorhandbuch infra CONVERT > Konfiguration und Import > Parameterdatei »CharacteristicClasses«

Benutzerhandbuch infra CONVERT > Weiteres > Begriffe > Klasse (Merkmals-)
"CharacteristicClassesDefinition": {
  "Path": "C:/Users/user1/AppData/CharacteristicClasses.json"
}
Parameter Typ Wert/Inhalt
Path String Pfad zum Speicherort und Dateiname; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen


Parameterdatei für Merkmalkategorien

Mit dem Feld SpecialCategoriesDefinition wird der Pfad zur Parameterdatei SpecialCategories.json festgelegt. Aus dieser bezieht infra CONVERT die Definitionen für Merkmalkategorien, welche mit dem Projekt gespeichert werden.

Siehe auch
Benutzerhandbuch infra CONVERT > Anpassung > Projekteinstellungen > Kategorien

Benutzerhandbuch infra CONVERT > Weiteres > Begriffe > Kategorie (Merkmal-)
"SpecialCategoriesDefinition": {
  "Path": "C:/Users/user1/AppData/SpecialCategories.json"
}
Parameter Typ Wert/Inhalt
Path String Pfad zum Speicherort und Dateiname; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen


Parameterdatei für Stempelvorlagen

Mit dem Feld StampTemplatesDefinition wird der Pfad zur Parameterdatei StampTemplates.json festgelegt. Aus dieser bezieht infra CONVERT die Definitionen für Stempelvorlagen, welche mit dem Projekt gespeichert werden.

Siehe auch
Administratorhandbuch infra CONVERT > Konfiguration und Import > Parameterdatei »StampTemplates«

Benutzerhandbuch infra CONVERT > Anpassung > Projekteinstellungen > Stempelvorlagen
"StampTemplatesDefinition": {
  "Path": "C:/Users/user1/AppData/StampTemplates.json"
}
Parameter Typ Wert/Inhalt
Path String Pfad zum Speicherort und Dateiname; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen


Parameterdatei zum Ein-/Ausblenden/Sperren von Steuerelementen

Mit dem Feld UiAccessDefinition wird der Pfad zur Parameterdatei UiAccess.json festgelegt. Mit dieser kann gesteuert werden, welche Steuerelemente in der Benutzeroberfläche von infra CONVERT sichtbar, gesperrt oder ausgeblendet werden sollen.

Sollte die Datei nicht existieren, so wird sie mit den üblichen Voreinstellungen angelegt.

Siehe auch
Administratorhandbuch infra CONVERT > Programmaufruf > Parameterdatei »UiAccess«
"UiAccessDefinition": {
  "Path": "C:/Users/user1/AppData/UiAccess.json"
}
Parameter Typ Wert/Inhalt
Path String Pfad zum Speicherort und Dateiname; die Verzeichnisnamen sind durch Slash-Zeichen (»/«) oder Doppel-Backslash-Zeichen (»\\«) zu trennen


Merkmale bearbeiten

Mit dem Feld Characteristics können Sie infra CONVERT mitteilen, welche Merkmale sich seit der letzten Bearbeitung in einem bestehenden Projekt verändert haben. Wurden in einem CAQ-System z. B. neue Kennzeichnungen zugewiesen, können diese hierüber auch im Projekt neu zugewiesen werden.

Siehe auch
Benutzerhandbuch infra CONVERT > Benutzeroberfläche > Funktionsfenster > Merkmalseigenschaften
"Characteristics": [
  {
    "CharacteristicId": "66a58671-5b11-4135-8210-32701be6f4a5",
    "Action":"Update",
    "CharacteristicTags": [
      "5D1110CA-6093-4381-B372-CF983D515044",
      "24C41CA8-871C-456E-B082-22EC2A20216D"
    ],
    "SpecialCategory":"{3E298F8F-02F1-49CD-82BF-BCDF26DA11FE}"
  },
  {
    "CharacteristicId": "b29bfa80-294a-4ca6-ae8f-81f4e63a39be",
    "Action":"Update",
    "CharacteristicTags": [ "5D1110CA-6093-4381-B372-CF983D515044" ],
    "SpecialCategory":"{3E298F8F-02F1-49CD-82BF-BCDF26DA11FE}"
  }
]
Parameter Typ Wert/Inhalt
CharacteristicId String GUID des Merkmals

Anmerkung Übergeben werden kann auch die GUID des Merkmals, aus dem das gesuchte Merkmal im Zeichnungsvergleich hervorgegangen (»DirectCompareSourceId«) oder ursprünglich hervorgegangen ist (»CompareSourceId«).
Action String Update Aktion: Aktualisieren
CharacteristicTags String GUID der Kennzeichnung
SpecialCategory String GUID der Kategorie


Kennzeichnungen bearbeiten

Mit dem Feld CharacteristicTags können Sie infra CONVERT mitteilen, welche Kennzeichnungen seit der letzten Bearbeitung eines Projekts hinzugefügt wurden oder sich geändert haben.

Siehe auch
Benutzerhandbuch infra CONVERT > Anpassung > Projekteinstellungen > Kennzeichnungen
"CharacteristicTags": [
  {
    "Action": "AddOrUpdate",
    "CharacteristicTag":{
      "Id": "69A6290C-89E2-438B-A2D7-F0AA645409CA",
      "Priority": 2,
      "FriendlyName": "TagThree",
      "Color": {
        "Type": "RGB",
        "R": 0,
        "G": 255,
        "B": 0
      },
      "LocalizedProperties": [
        {
          "Name": "Tag Three ",
          "Description":"",
          "LanguageCode": "en"
        },
        {
          "Name": "Kennzeichnung Drei",
          "Description": "",
          "LanguageCode": "de"
        }
      ]
    }
  },
  {
    "Action": "AddOrUpdate",
    "CharacteristicTag":{
      "Id": "5D1110CA-6093-4381-B372-CF983D515044",
      "Priority": 2,
      "FriendlyName": "",
      "Color": {
        "Type": "RGB",
        "R": 0,
        "G": 0,
        "B": 255
      },
      "LocalizedProperties": [
        {
          "Name": "Tag Four ",
          "Description":"",
          "LanguageCode": "en"
        },
        {
          "Name": "Kennzeichnung Vier",
          "Description": "",
          "LanguageCode": "de"
        }
      ]
    }
  }
]
Parameter Typ Wert/Inhalt
Action String AddOrUpdate Hinzufügen oder ändern einer Kennzeichnung, abhängig vom Vorhandensein oder Nicht-Vorhandensein der Kennzeichnung
Add Eine nicht vorhandene Kennzeichnung hinzufügen (»AddOrUpdate« sollte bevorzugt verwendet werden)
Remove Eine Kennzeichnung löschen
ResetDefault Eine hiermit hinzugefügte oder angesprochene Kennzeichnung als neuen Standard festlegen. Bestehende Kennzeichnungen werden gelöscht. Allen Merkmalen wird diese Kennzeichnung zugewiesen
CharacteristicTag Feld Enthält alle Eigenschaften der Kennzeichnung
└ Id String GUID der Kennzeichnung
└ Priority Integer Rang in der Reihenfolge der vorhandenen Kennzeichnungen
└ FriendlyName String Name der Kennzeichnung
└ Color Feld Stempelfarbe eines mit dieser Kennzeichnung versehenen Merkmals
 └ Type String RGB Farbsystem »RGB«
 └ R Integer Farbwert für Rot: 0…255
 └ G Integer Farbwert für Grün: 0…255
 └ B Integer Farbwert für Blau: 0…255
└ LocalizedProperties Feld Bezeichnung der Kennzeichnung (für mehrere Sprachen möglich)
 └ Name String Benutzerfreundlicher Name der Kennzeichnung
 └ Description String Beschreibung der Kennzeichnung (optional)
 └ LanguageCode String de Deutsch
en Englisch


Beispiele für Startparameteraufrufe

Eine Zusammenstellung verschiedener Startparameterszenarien können Sie hier herunterladen: infra_CONVERT_Parametertest.zip, Größe: 2 MB. Die Beispiele sind so gestaltet, dass Sie jedes Szenario mit dem enthaltenen BAT-Datei direkt ausführen können.

Start mit bestimmten Parameterdateien
  10 - Start with specific parameter files

Der Benutzer beginnt nach dem Start von infra CONVERT auf der Startseite. Eine Auswahl von Einstellungen (»settings.json«) werden beim Start gesetzt. Erstellt der Benutzer ein Projekt, werden die übergebenen Vorlagen (Stempelvorlagen, Kategorien, Kennzeichnungen und Klassen) verwendet.

Projekt erstellen und beim Schließen exportieren
  20 - Create project and export

Nach dem Start wird automatisch ein neues Projekt »Project-001« mit zwei Zeichnungsdateien in einer Prüfplanversion »Test plan A« erstellt. Speichert der Benutzer das Projekt, werden ein Prüfplan »Test plan-001« im JSON-Format sowie Zeichnungs- und Stempelansichten in einem Unterverzeichnis »Export« im JPG-Format exportiert.

Neue Prüfplanversion anlegen und Zeichnungsvergleich starten
  30 - Compare drawings

Es wird ein bereits bestehendes Projekt »Project-001« geladen. Das Projekt enthält zwei gestempelte Zeichnungsblättern in einer Prüfplanversion »Test plan A«. Beim Start wird eine neue Prüfplanversion »Test plan B« mit jeweils einer neuen Version der beiden Zeichnungsblätter geladen. Der Benutzer startet im Zeichnungsvergleich mit Blatt 1.

Auf Stempel zoomen per GUID
  40 - Zoom to stamp via GUID

Es wird auf einen Stempel in einem bestehenden Projekt durch Angabe der GUID des Stempels gezoomt. Die GUID wurde in dem Beispiel aus dem zuvor exportierten Prüfplan »Test plan-001.json« gelesen.

Auf Stempel zoomen per ICP-ID
  41 - Zoom to stamp via ICP-ID

Es wird ein (temporäres) Projekt erstellt und eine ICP-Datei (Projektdatei aus infra - CONVERT) geladen. Nur die ID (»ICP-ID«) des Merkmals beziehungsweise des Stempels in der ICP-Datei ist bekannt.

Auf Stempel zoomen per CompareSourceId
  42 - Zoom to stamp via CompareSourceId

Es wird auf einen Stempel in der aktuelleren von zwei Prüfplanversionen gezoomt. Es ist nur die GUID des Stempels in der ursprünglichen Prüfplanversion bekannt. Diese GUID wird beim Zeichnungsvergleich über die CompareSourceId an das übertragene oder zusammengefügte Merkmal weitergegeben.


Zurückblättern
Installation > Lizenzservice

Weiterblättern
Konfiguration und Import > Parameterdatei »Settings«

de/infra-convert/dev/parameter.txt · Zuletzt geändert: 2023/11/28 14:33 von me