Administrator’s Manual infra CONVERT > Configuration and Import

Startup parameter file

The startup parameter file summarizes parameters to be passed when starting infra CONVERT in a file in JSON format. This page describes under Basics the call, the basic requirements, the start parameter “forceConfigDir” and in the following sections the individual parts of the start parameter file. Examples of start parameter scenarios can be found in section Examples for start parameter files.

Content

• Basics
• Setting the language
• Open or create project
• Open or create quality test plan
• Transfer drawing
• Export quality test plans and stamped drawings
• Invoke function
• Zoom on stamp
• Settings
• Parameter file for tags
• Parameter file for characteristic classes
• Parameter file for characteristic categories
• Parameter file for stamp templates
• Parameter file for showing/hiding/locking control elements
• Editing characteristics
• Editing tags
• Examples for start parameter files

Basics

Call up

The path to the start parameter file is passed to the command to run infra CONVERT with “parameter”. Example with any file path:

…/InfraConvertWPF.exe -parameter="C:/Windows/Temp/StartParameterFile.json"

Note Note that special characters in the name/path of the startup parameter file will only be passed correctly to infra CONVERT if they have been encoded correctly. This can be ensured in a batch file saved as UTF-8, for example, by specifying the code page CHCP 65001 for UTF-8. Example:
chcp 65001
…/InfraConvertWpf.exe -parameter="Démarrer.json"

Basic requirements for the startup parameter file

The character encoding UTF-8 is expected.
Paths can be specified absolute or relative.
The file can contain any part of the parameters presented here.
The file must adhere to the provisions of the JSON format.

Startup parameter »forceConfigDir«

Outside the start parameter file another call up parameter can be used. With “forceConfigDir” another location for the directory with configuration and template files can be defined than the directory “%ProgramData%/ELIAS GmbH/infra-Convert” created by default during installation.

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

It is also possible to pass both parameters at the same time:

…/InfraConvertWPF.exe -parameter="…/" -forceConfigDir="…/"

Note to When using “forceConfigDir”, make sure that you also adapt the paths for the directory with Excel template files (parameter ExcelReportsPath) and the directory with tolerance tables (parameter ToleranceTablePath) in the configuration file “settings.json”.

Setting the language

Use the LanguageCode field to specify the language of the user interface of infra CONVERT.

Without this code, the default language set in the operating system will automatically be used. If it is not supported by infra CONVERT, English will always be set.

See also
User’s Manual infra CONVERT > Settings > Settings > General > “Language” Group

"LanguageCode":"de",

Parameter	Type	Value/Content
LanguageCode	String	de German en English fr French it Italian es Spanish zh Chinese cs Czech bg Bulgarian

Open or create project

With the Project field, specify that an existing project should open or a new project be created when infra CONVERT is launched.

See also
User’s Manual infra CONVERT > Functions > Projects > Create new project

User’s Manual infra CONVERT > Functions > Projects > Open project

User’s Manual infra CONVERT > Functions > Projects > Save project

"Project": {
  "Path": "C:/Users/user1/Desktop/test.icpx",
  "Name":"Beispiel Projekt",
  "Action":"Open"
}

Parameter	Type	Value/Content
Path	String	Path to the location with the file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”) (Mandatory information)
Name	String	Project title Note This is required when creating (“Create”), ignored when opening (“Open”).
Action	String	Open Opens an existing project Create Creates a new project

Open or create quality test plan

With the InspectionPlanVersion field, specify that an existing quality test plan should open or a new quality test plan be created when infra CONVERT is launched.

A new quality test plan can only be created when a project has already been created.

See also
User’s Manual infra CONVERT > Functions > Quality test Plans > Create quality test plan

"InspectionPlanVersion": {
  "Name": "Zeichnungsstand",
  "Version": "0",
  "Action": "Create"
}

Parameter	Type	Value/Content
Name	String	Quality test plan title (Mandatory information)
Version	Decimal	Version of the quality test plan (Mandatory information)
Action	String	Open Opens an existing quality test plan Create Creates a new quality test plan

Transfer drawing

Use the Files field to import any number of drawing sheets in a quality test plan when infra CONVERT is launched.

See also
User’s Manual infra CONVERT > Functions > Drawings > Import drawings

User’s Manual infra CONVERT > More > Terms > Drawing date format

"Files": [
  {
  "Path":"C:/Users/user1/Desktop/drawing_1.dxf"
  },
  {
  "Path":"C:/Users/user1/Desktop/drawing_2.dwg",
  "ImportBehavior": "Ask"
  },
  {
  "Path":"C:/Users/user1/Desktop/drawing_3.igs"
  },
  {
  "Path":"C:/Users/user1/Desktop/drawing_4.pdf",
  "ImportBehavior": "ImportAllPages"
  },
  {
  "Path":"C:/Users/user1/Desktop/drawing_5.icp"
  },
  {
  "Path":"https://ftp.elias-gmbh.de/fictional_path/example.dwg"
  }
]

This applies to all imported drawings:

Parameter	Type	Value/Content
Path	String	Path to the location with the file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).

This applies to drawing imports in PDF format:

Parameter	Type	Value/Content
ImportBehavior	String	Behaviour when importing multi-page PDF files: Ask Allways ask before import ImportFirstPage Import first page only ImportAllPages Allways import all sheets

This applies to drawing imports in DXF and DWG format:

Parameter	Type	Value/Content
ImportBehavior	String	Behaviour when importing DXF and DWG files: Ask Allways ask before import ImportModel Always import model space only ImportPaperSpaces Always import all sheets from paper space ImportAllLayouts Allways import all sheets

This applies to the import of ICP project files:

Parameter	Type	Value/Content
ImportBehavior	String	Behavior when importing ICP files: Ask When reloading PDF, DXF and DWG drawing files, ask the user to select the page or sheet in the file ImportModel When reloading DXF and DWG files, always import the model space only Note The parameter is optional. If it is not specified, the first page is automatically selected from a PDF file or the model space is selected in a DXF and DWG file.

Export quality test plans and stamped drawings

With the Targets field, specify that when the Save project command is executed in quality test plans and/or stamped drawings and/or drawing details in infra CONVERT should be exported.

Exports are done in list order (from programme version 2.7.9). Test plans should be exported at the end. At least in JSONV2 format, the storage paths for stamp graphics are only listed if the target export has run beforehand.

Note We recommend you use the quality test plan format JSONV2 because it supports all the characteristics of infra CONVERT.

See also
Administrator’s Manual infra CONVERT > Export > Quality test plan format JSONV2

Administrator’s Manual infra CONVERT > Export > Quality test plan format JSONV1

Administrator’s Manual infra CONVERT > Export > Quality test plan format DFD

"Targets": [
  {
    "Format":"PDF",
    "ColorOption":"MonoColorStamp",
    "ExportOnSaveOnly": false,
    "Path":"Export/PDF/"
  },
  {
    "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":"JSONV2",
    "LanguageCode":"de",
    "Path":"Export/test plan.json"
  },
  {
    "Format":"JSONV1",
    "LanguageCode":"de",
    "Path":"Export/prüfplan.json",
    "InspectionPlanVersionExportMode": "Last"
  },
  {
    "Format":"CSV",
    "Path":"Export/test plan.csv"
  },
  {
    "Format":"DFD",
    "Path":"Export/DFD/",
    "ExportHint": "MultiFileExport"
  },
  {
    "Format":"DFD",
    "Path":"Export/prüfplan.dfd",
    "ExportHint": "CombinedExport"
  }
]

The following applies for the JSONV2 quality test plan format:

Parameter	Type	Value/Content
Format	String	JSONV2
LanguageCode	String	de German en English
ExportOnSaveOnly	String	When closing the programme, or closing the project, … true … do not trigger this export if no changes have been made to the project. false … trigger this export if no changes have been made to the project. (Default behaviour, applied if the parameter is not specified). Note Available from programme version 2.7.5
Path	String	Path to the location with the file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).

The following applies for the JSONV1 quality test plan format:

Parameter	Type	Value/Content
Format	String	JSONV1
LanguageCode	String	de German en English
ExportOnSaveOnly	String	When closing the programme, or closing the project, … true … do not trigger this export if no changes have been made to the project. false … trigger this export if no changes have been made to the project. (Default behaviour, applied if the parameter is not specified). Note Available from programme version 2.7.5
Path	String	Path to the location with the file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).
InspectionPlanVersionExportMode	String	Implicit Export the test plan version addressed by the “InspectionPlanVersion” parameter when the start parameter is called (default behavior, is applied if the parameter is not specified). Last The most recent inspection plan version at the time of export Note The “newest” inspection plan version is the inspection plan version with the highest lexical version number.

The following applies for the CSV quality test plan format:

Parameter	Type	Value/Content
Format	String	CSV
ExportOnSaveOnly	String	When closing the programme, or closing the project, … true … do not trigger this export if no changes have been made to the project. false … trigger this export if no changes have been made to the project. (Default behaviour, applied if the parameter is not specified). Note Available from programme version 2.7.5
Path	String	Path to the location with the file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).
InspectionPlanVersionExportMode	String	Implicit Export the test plan version addressed by the “InspectionPlanVersion” parameter when the start parameter is called (default behavior, is applied if the parameter is not specified). Last The most recent inspection plan version at the time of export Note The “newest” inspection plan version is the inspection plan version with the highest lexical version number.
ExportHint	String	AskForHeader Before export, show the export dialog to allow data entry for the header and export the header. Note This parameter is available from program version 2.2.8.

The following applies for the DFD quality test plan format:

Parameter	Type	Value/Content
Format	String	DFD
ExportOnSaveOnly	String	When closing the programme, or closing the project, … true … do not trigger this export if no changes have been made to the project. false … trigger this export if no changes have been made to the project. (Default behaviour, applied if the parameter is not specified). Note Available from programme version 2.7.5
Path	String	Path to the location without a file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).
InspectionPlanVersionExportMode	String	Implicit Export the test plan version addressed by the “InspectionPlanVersion” parameter when the start parameter is called (default behavior, is applied if the parameter is not specified). Last The most recent inspection plan version at the time of export Note The “newest” inspection plan version is the inspection plan version with the highest lexical version number.
ExportHint	String	MultiFileExport Export partial test plans to separate DFD files (default behavior, applied if parameter is not specified) CombinedExport Export partial test plans to collective DFD file

This applies to drawing exports in PDF format:

Parameter	Type	Value/Content
Format	String	PDF
ExportOnSaveOnly	String	When closing the programme, or closing the project, … true … do not trigger this export if no changes have been made to the project. false … trigger this export if no changes have been made to the project. (Default behaviour, applied if the parameter is not specified). Note Available from programme version 2.7.5
Path	String	Path to storage location, for multiple export (“MultiFileExport”) without file name, for combined export (“CombinedExport”) with file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).
ColorOption	String	Controls the color representation of the drawing and the stamps: NoPolicy Stamps as shown in the program, drawing as native Mono Stamps and drawing sheet in black and white Grayscale Stamps and drawing in grayscale MonoColorStamp Stamp as shown in the program, drawing monochrome
InspectionPlanVersionExportMode	String	Implicit Export the test plan version addressed by the “InspectionPlanVersion” parameter when the start parameter is called (default behavior, is applied if the parameter is not specified). Last The most recent inspection plan version at the time of export All Export all test plan versions contained in the project; the files are written to a subdirectory for each test plan version; the directory is named with the GUID of the test plan Note The “newest” inspection plan version is the inspection plan version with the highest lexical version number.

This applies to drawing exports in SVG format:

Parameter	Type	Value/Content
Format	String	SVG
ExportOnSaveOnly	String	When closing the programme, or closing the project, … true … do not trigger this export if no changes have been made to the project. false … trigger this export if no changes have been made to the project. (Default behaviour, applied if the parameter is not specified). Note Available from programme version 2.7.5
Path	String	Path to storage location, for multiple export (“MultiFileExport”) without file name, for combined export (“CombinedExport”) with file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).
InspectionPlanVersionExportMode	String	Implicit Export the test plan version addressed by the “InspectionPlanVersion” parameter when the start parameter is called (default behavior, is applied if the parameter is not specified). Last The most recent inspection plan version at the time of export All Export all test plan versions contained in the project; the files are written to a subdirectory for each test plan version; the directory is named with the GUID of the test plan Note The “newest” inspection plan version is the inspection plan version with the highest lexical version number.

This applies to drawing exports in PNG, JPG, BMP, TIF und GIF format:

Parameter	Type	Value/Content
Format	String	Png All drawing sheets and/or all stamped characteristics in extracts as PNG files Tif All drawing sheets and/or all stamped characteristics in extracts as TIF files Jpg All drawing sheets and/or all stamped characteristics in extracts as JPG files Bmp All drawing sheets and/or all stamped characteristics in extracts as BMP files Gif All drawing sheets and/or all stamped characteristics in extracts as GIF files Note The use of PNG and TIF file formats is recommended, especially the JPG format is not suitable for technical drawings
Mode	String	Drawing Export only drawing sheets DrawingWithoutStamps Export only drawing sheets without stamps Stamps Export only stamp graphics If Mode is not specified, drawing and stamp graphics are exported together
ImageOptions	Field	Controls the rendering of the drawing graphics If ImageOptions is not specified, the current export settings (Settings > Export > Drawing graphic) are used
└ Width	Integer	Width of the image in number of pixels
└ Height	Integer	Height of the image in number of pixels
└ Bit	Integer	Colour depth: 8 8 Bit 24 24 Bit (not at GIF)
└ SupersamplingAlgorithm	String	Supersampling method (→Antialiasing): None Do not apply supersampling Box Average Bilinear Linear Bicubic Cubic Bspline B-Spline Catmullrom Catmull-Rom Lanczos3 Lanczos 3 Note Available from program version 2.2.4
└ SupersamplingFactor	Integer	Quality level for supersampling (→Antialiasing): 1 Do not apply supersampling 2 to 5 Levels 2 to 5 Note Available from program version 2.2.4
StampImageOptions	Field	Controls the rendering of the stamp graphic If StampImageOptions is not specified, the current export settings (Settings > Export > Stamp graphic) are used
└ Width	Integer	Width of the image in number of pixels
└ Height	Integer	Height of the image in number of pixels
└ SupersamplingAlgorithm	String	Supersampling method (→Antialiasing): None Do not apply supersampling Box Average Bilinear Linear Bicubic Cubic Bspline B-Spline Catmullrom Catmull-Rom Lanczos3 Lanczos 3 Note Available from program version 2.2.4
└ SupersamplingFactor	Integer	Quality level for supersampling (→Antialiasing): 1 Do not apply supersampling 2 to 5 Levels 2 to 5 Note Available from program version 2.2.4
ExportOnSaveOnly	String	When closing the programme, or closing the project, … true … do not trigger this export if no changes have been made to the project. false … trigger this export if no changes have been made to the project. (Default behaviour, applied if the parameter is not specified). Note Available from programme version 2.7.5
Path	String	Path to the location without a file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).
InspectionPlanVersionExportMode	String	Implicit Export the test plan version addressed by the “InspectionPlanVersion” parameter when the start parameter is called (default behavior, is applied if the parameter is not specified). Last The most recent inspection plan version at the time of export All Export all test plan versions contained in the project; the files are written to a subdirectory for each test plan version; the directory is named with the GUID of the test plan Note The “newest” inspection plan version is the inspection plan version with the highest lexical version number.

Invoke function

With the Mode field, call up a function in infra CONVERT when it is launched. The function will not be executed, but it will be opened and is thus directly available to the user. The following functions are currently available (more will follow):

Tag tool
AddCharacteristicTag
Calls up the tag tool function, see User’s Manual > Functions > characteristics > Tag.

Drawing comparison
Compare Documents
Calls up the drawing comparison, see User's manual > User interface > Function window > Drawing comparison and User’s Manual > Functions > Zeichnungen vergleichen (Basic version) respectively Drawing comparison (Pro version).

The following applies for the Tag tool function:

"Mode": {
  "Name": "AddCharacteristicTag",
  "ItemId": "{5D1110CA-6093-4381-B372-CF983D515044}"
}

Parameter	Type	Value/Content
Name	String	AddCharacteristicTag
ItemId	String	GUID of the tag

The following applies for the Drawing comparison function:

"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	Type	Value/Content
Name	String	CompareDocuments
SourceInspectionPlanVersion	Field
└ Name	String	Name of the source test plan version
└ Version	String	Version number of the source test plan version
TargetInspectionPlanVersion	Field
└ Name	String	Name of the target test plan version
└ Version	String	Version number of the target test plan version
SourceDocumentOriginalFileName	String	File name of the source drawing sheet
TargetDocumentOriginalFileName	String	File name of the target drawing sheet

Zoom on stamp

When opening a project, you can set the view in the drawing window to a specific stamp. infra CONVERT focuses the stamp and zooms in so far that the corresponding drawing entry including the surrounding area is fitted into the window.

Each stamp in an ICPX file is assigned a GUID. Pass it in the field ZoomToStampGuid. If characteristics have been linked by transfer or merge in the drawing comparison, you can also transfer the ID of the original stamp, then the system zooms to the corresponding stamp of the latest inspection plan version.

If ICP files are loaded into a project, the GUIDs of the stamps may not be known. In this case, you can also pass the stamp ID. Use the field ZoomToStampIcpId. In this field you must also specify the test plan version and the name of the ICP file, because the ID from infra - CONVERT is only valid within an ICP project.

Note
infra CONVERT can also be used as a viewer with the zoom functionality. Disable user interface controls (see “Configuration and Import > Parameter file "UiAccess"”) to prevent data corruption. To view ICP files, temporarily create an ICPX project and load the ICP file into a test plan version.

The GUID of the stamp is known:

"ZoomToStampGuid":{  
   "Id":"{56422575-2376-497f-b633-8dbe06626fab}"
}

Parameter	Type	Value/Content
Id	String	GUID of the stamps

Only the ID of the stamp in the ICP file is known:

"ZoomToStampIcpId":{
   "InspectionPlanVersion":{  
      "Name":"Neuer Prüfplan",
      "Version":"A"
   },
   "DocumentName":"ez-29002675001-84-0_1.icp",
   "Id":"3"
}

Parameter	Type	Value/Content
InspectionPlanVersion	Feld
└ Name	String	Title of the test plan version
└ Version	String	Version number
DocumentName	String	Name of the ICP file
Id	String	ICP ID

Settings

The path to the parameter file Settings.json is specified in the Settings field. infra CONVERT obtains the global settings from this file.

See also
Administrator’s Manual infra CONVERT > Run program > Parameter file "Settings"

Administrator’s Manual infra CONVERT > Configuration and Import > “Settings” Parameter file > List of the settings > Settings with no control elements in user interfaces

User’s Manual infra CONVERT > Settings > Settings > General

"Settings": {
  "Path": "C:/ProgramData/ELIAS GmbH/infra-CONVERT/Settings.json",
  "Force": true
}

Parameter	Type	Value/Content
Path	String	Path to the location and file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).
Force	String	Reading order of the parameters passed by start parameter and a user-defined “settings.json”: true Force the “settings.json” passed by start parameter to be read from AppData after the “settings.json”, thus overwriting user-defined settings false Default behaviour (also applies if parameter “Force” is not specified) Note Available from program version 2.0.0.0

Parameter file for tags

The path to the parameter file CharacteristicTags.json is specified in the CharacteristicTagsDefinition field. infra CONVERT obtains the definitions for tags with which the project is saved from this file.

If this file does not exist, it will be created with the default settings.

See also
Administrator’s Manual infra CONVERT > Run program > Parameter file "CharacteristicTags"

User’s Manual infra CONVERT > Settings > Project settings > Tags

"CharacteristicTagsDefinition": {
  "Path": "C:/Users/user1/AppData/CharacteristicTags.json",
}

Parameter	Type	Value/Content
Path	String	Path to the location and file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).

Parameter file for characteristic classes

The path to the parameter file CharacteristicClasses.json is specified in the CharacteristicClassesDefinition field. infra CONVERT obtains the definitions for characteristic classes with which the project is saved from this file.

See also
Administrator’s Manual infra CONVERT > Configuration and Import > Parameter file "CharacteristicClasses"

User’s Manual infra CONVERT > More > Terms > Class (characteristic-)

"CharacteristicClassesDefinition": {
  "Path": "C:/Users/user1/AppData/CharacteristicClasses.json"
}

Parameter	Type	Value/Content
Path	String	Path to the location and file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).

Parameter file for feature categories

The path to the parameter file SpecialCategories.json is specified in the SpecialCategoriesDefinition field. infra CONVERT obtains the definitions for characteristic categories with which the project is saved from this file.

See also
User’s Manual infra CONVERT > Settings > Project settings > Categories

User’s Manual infra CONVERT > More > Terms > Category (characteristic)

"SpecialCategoriesDefinition": {
  "Path": "C:/Users/user1/AppData/SpecialCategories.json"
}

Parameter	Typ	Value/Content
Path	String	Path to the location and file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).

Parameter file for stamp templates

The path to the parameter file StampTemplates.json is specified in the StampTemplatesDefinition field. infra CONVERT obtains the definitions for stamp templates which are saved with the project, from this file.

See also
Administrator’s Manual infra CONVERT > Configuration and Import > Parameter file "StampTemplates"

User’s Manual infra CONVERT > Settings > Project settings > Stamp templates

"StampTemplatesDefinition": {
  "Path": "C:/Users/user1/AppData/StampTemplates.json"
}

Parameter	Typ	Value/Content
Path	String	Path to the location and file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).

Parameter file for showing/hiding/locking control elements

The UiAccessDefinition field sets the path to the UiAccess.json parameter file. It can be used to control which control elements in the infra CONVERT user interface should be visible, locked or hidden.

If the file does not exist, it will be created with the usual default settings.

See also
Administrator's Manual infra CONVERT > Configuration and Import > Parameter file "UiAccess"

"UiAccessDefinition": {
  "Path": "C:/Users/user1/AppData/UiAccess.json",
}

Parameter	Typ	Value/Content
Path	String	Path to the location and file name; the directory names must be separated by slash characters (“/”) or double backslash characters (“\\”).

Editing characteristics

The Characteristics field allows you to communicate to infra CONVERT which characteristics have changed in an existing project since it was last edited. If new tags were assigned in a CAQ system, for instance, this method allows them to also be reassigned in the project.

See also
User’s Manual infra CONVERT > User interface > Function window > characteristic properties

"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	Type	Value/Content
CharacteristicId	String	GUID of the characteristic Note The GUID of the characteristic from which the characteristic searched for in the drawing comparison emerged (“DirectCompareSourceId”) or originally emerged (“CompareSourceId”) can also be transferred.
Action	String	Update Action: update
CharacteristicTags	String	GUID of the tag
SpecialCategory	String	GUID of the category

Editing tags

The CharacteristicTags field allows you to communicate to infra CONVERT which tags have been added or changed since the last time a project was edited.

See also
User’s Manual infra CONVERT > Settings > Project settings > Tags

"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	Type	Value/Content
Action	String	AddOrUpdate Add or change a tag, depending on whether or not the tag exists Add Add a tag that does not exist (“AddOrUpdate” should be used preferentially) Remove Delete a tag ResetDefault Set a tag added or addressed with this as the new default. Existing tags are deleted. All characteristics are assigned this tag
CharacteristicTag	Feld	Contains all the properties of the tag
└ Id	String	GUID of the tag
└ Priority	Integer	Rank in the order of existing tags
└ FriendlyName	String	Name of the tag
└ Color	Feld	Stamp color of a characteristic with this tag
└ Type	String	RGB “RGB” color system
└ R	Integer	Color value for red: 0…255
└ G	Integer	Color value for green: 0…255
└ B	Integer	Color value for blue: 0…255
└ LocalizedProperties	Feld	Name of the tag (possible for multiple languages)
└ Name	String	User-friendly name of the tag
└ Description	String	Description of the tag (optional)
└ LanguageCode	String	de German en English

Examples for start parameter files

A compilation of different start parameter scenarios can be downloaded here: infra_CONVERT_Parametertest.zip, size: 2 MB. The examples are designed in such a way that you can execute each scenario directly with the included BAT file.

Start with specific parameter files
10 - Start with specific parameter files

The user starts after starting infra CONVERT on the start page. A selection of settings (“settings.json”) are set at start-up. If the user creates a project, the transferred templates (stamp templates, categories, tags and classes) are used.

Create project and export when closing
20 - Create project and export

After the start a new project “Project-001” with two drawing files in a test plan version “Test plan A” is automatically created. If the user saves the project, a test plan “Test plan-001” in JSON format and drawing and stamp views are exported in JPG format in a subdirectory “Export”.

Create new test plan version and start drawing comparison
30 - Compare drawings

An already existing project “Project-001” is loaded. The project contains two stamped drawing sheets in a test plan version “Test plan A”. At startup, a new test plan version “Test plan B” is created with a new version of each of the two drawing sheets. The user starts the drawing comparison with sheet 1.

Zoom to stamp via GUID
40 - Zoom to stamp via GUID

A stamp in an existing project is zoomed in by specifying the GUID of the stamp. In the example, the GUID was read from the previously exported test plan “Test plan-001.json”.

Zoom to stamp via ICP-ID
41 - Zoom to stamp via ICP-ID

A (temporary) project is created and an ICP file (project file from infra - CONVERT) is loaded. Only the ID (“ICP-ID”) of the characteristic or the stamp in the ICP file is known.

Zoom to stamp via CompareSourceId
42 - Zoom to stamp via CompareSourceId

A stamp in the more recent of two test plan versions is zoomed in. Only the GUID of the stamp in the original version of the test plan versions is known. This GUID is transferred to the transferred or merged characteristic during the drawing comparison using the CompareSourceId.

Go to previous page
Introduction > Overview

Go to next page
Configuration and Import > Parameter file "Settings"