Convert PureConnect Handler steps to draw.io format.
Before you convert handler files to draw.io files, you need to save your handler files as XML format. There are 2 ways to save as XML files.
- Open your handler ihd file with Interaction Designer
- Select Publish
- Select File->Export To XML...
- Save as XML format
- Create a list of handlers you want to convert. If your custom handlers are saved in x:\I3\IC\Handlers\Custom, create a handlers files list file as HandlerList.lst.
Note: x = PureConnect installed drive letter, typically D
cd x:\I3\IC\Handlers\Customdir /b *.ihd > HandlerList.lst
- Create a folder to save xml files
md xml
- Run x:\i3\ic\server\idu.exe with following options:
/HandlerOpenAutoXMLPath=x:\I3\IC\Handlers\Custom\xml /IntermediatePublish:HandlerList.lst /ForcePublishClose
Intermediate CSV files for draw.io will be created after the XML file imports complete.
draw.io will load intermediate CSV files and create handler steps.
There are 2 ways to edit flowcharts:
- Open with draw.io (web/desktop app)
- If you need to amend contents in a flowchart, select shape, and press CTRL+M
- Open with Visio
Note: The draw.io.exe included in this app was customized for batch processing, so you can NOT use the "SAVE AS" functionality. You should install official draw.io desktop app or use Visio.
-
Install, or validate installed, .NET 6.0 (required)
https://aka.ms/dotnet-core-applaunch?framework=Microsoft.NETCore.App&framework_version=6.0.0&arch=x64&rid=win10-x64 -
Install draw.io desktop
https://github.com/jgraph/drawio-desktop/releases/download/v20.7.4/draw.io-20.7.4-windows-installer.exe -
Download the latest binary from Releases page
-
Create HandlerVisualizer folder
-
Unzip HandlerVisualizer.ZIP to HandlerVisualizer folder
- Copy XML files to Handlers folder under HandlerVisualizer
- Run HandlerVisualizer
Note: Replace sample values for handler file name with your actual values.
- Convert single file
Run
HandlerVisualizer.exe .\Handlers\YourHandlerName.xml - Convert multiple files
Run
HandlerVisualizer.exe -h
- You should now see draw.io files of each handler in .\flow folder
| Argument | Description |
|---|---|
| -d | Create draw.io file |
| -v | Create draw.io, then convert to Visio format |
| -n | Create draw.io, then convert to png format |
| -h | Load all xml files in Handlers folder |
Change config values in appsettings.json
| Variables | Description | Default |
|---|---|---|
| appendDateTimeToFileName | Append dateTime value to fileName | false |
| customizationPointFirstString | Paint step color in red if tool step label start with the following strings | "*" "Customized_" |
| showStepParameters | Show Input/Output variables or formula of each tool step | false |
| colorNode | Paint shapes | true |
| nodeRound | Draw rounded shapes | false |
| lineRound | Draw rounded lines | true |
| convertToVisio | Always convert to Visio format without specifying -v option | false |
| convertToPng | Always convert to png format without specifying -n option | true |
| layout | Draw style. Possible values are horizontalflow or verticalFlow |
horizontalflow |
-
To optimize created handler flow readability and impact, consider reviewing and updating tool step labels from default values.
-
It may take an hour or more to create diagram, if you have hundreds of XML files.
-
While creating flowcharts, draw.io.exe repeatedly starts and stops. Please do not use your computer until flowchart creation completes.
-
If you see a GPU process exited unexpectedly error during convertion to png file(s), please check to see if the png file created successfully.
-
You can convert to png or Visio format later with the following draw.io command line:
-
Convert Sample_Handler.drawio to Sample_Handler.png
.\draw.io -x -f png .\Sample_Handler.drawio -o Sample_Handler.png -
Convert Sample_Handler.drawio to Sample_Handler.vsdx
.\draw.io -x -f vsdx .\Sample_Handler.drawio -o Sample_Handler.vsdx -
Convert all .drawio files in c:\temp\flow to visio format, then save to c:\temp\visio
.\draw.io -x -f vsdx c:\temp\flow -o c:\temp\visio
-