Command Line

Command Line

Caristix Workgroup allows you to execute common tasks using a command line. This allows you to automate operations, such as data conversion, de-identification, test execution, etc. To automate operations, you will be able to use the WorkgroupConsole executable located in the software’s installation folder (typically C:\Program Files (x86)\Caristix\Caristix Workgroup).

You can open a command prompt and type the following command to get a list of available commands
WorkgroupConsole.exe help

To get help on a particular command, type
WorkgroupConsole.exe help <command-name>

Available Commands

This command will convert HL7v2 messages from HL7v2-ER7 format (pipe-delimited) to the HL7v2-XML format. To get help with this command, type: WorkgroupConsole.exe help Convert-HL7-to-XML
C:\Program Files (x86)\Caristix\Caristix Workgroup>WorkgroupConsole.exe help Convert-HL7-to-XML

** Convert-HL7-To-XML **

e.g. Convert-HL7-To-XML C:\first-document.hl7 D:\second-document.hl7 [-cp  -ConformanceProfile "C:\
HL7Reference\HL7 v2.5.1.cxp"] [-r  -Results "D:\results\"] [-lp  -LogsFilePath "C:\logs.txt"]

Source files : The documents to Convert (can also be folders).
-cp [required] : Conformance Profile file path. The value has to be a .cxp path.
-r [optional] : Result folder path. The value has to be a folder [default: .\Results].
-lp [optional] : Logs file path.
This command will convert HL7v2 messages from HL7v2-XML format to the HL7v2-ER7 (pipe-delimited). To get help with this command, type: WorkgroupConsole.exe help Convert-XML-to-HL7
C:\Program Files (x86)\Caristix\Caristix Workgroup>WorkgroupConsole.exe help Convert-XML-to-HL7

** Convert-XML-To-HL7 **

e.g. Convert-XML-To-HL7 C:\first-document.xml D:\second-document.xml [-r  -Results "D:\results\"] [-rt  
-ResultType "MessageCount 100"] [-lp  -LogsFilePath "C:\logs.txt"]

Source files : The documents to Convert (can also be folders).
-r [optional] : Result file path. The value has to be a file by default. [default: .\result.txt].
-rt [optional] : Result format type: 'InitialFileStructure' to reflect the initial file structure (-r is 
required for InitialFileStructure. The -r value has to be a folder)
'CustomizedSize' to split by file size, in MB, followed by the size amount (The -r value has to be a file)
'MessageCount' to split by message count, followed by the amount (The -r value has to be a file)
'NoSplit' to save the result to a single file (default value) (The -r value has to be a file)
-lp [optional] : Logs file path.
This command will de-identify HL7v2-ER7 messages. To get help with this command, type: WorkgroupConsole.exe help De-Identify-HL7
C:\Program Files (x86)\Caristix\Caristix Workgroup>WorkgroupConsole.exe help De-Identify-HL7

** De-Identify-HL7 **

e.g. De-Identify-HL7 C:\first-document.hl7 D:\second-document.hl7 -de  -DeIdentificationRules "C:\My DeId
entification settings.cxd" [-cp  -ConformanceProfile "C:\HL7Reference\HL7 v2.5.1.cxp"] [-pi  -PersistentId
entities "D:\persistence-xml.dic"] [-r  -Results "D:\results.hl7"] [-rt MessageCount 100] [-opt  -Options 
GenerateValueOnEmptyField|IgnoreQuote] [-mbd  -MessageBeginningDelimiter "regex"] [-med  -MessageEndingDel
imiter "regex"] [-sed  -SegmentEndingDelimiter "regex"] [-lp  -LogsFilePath "C:\logs.txt"]

Source files : The documents to De-Identify (can also be folders).
-de required : De-identification settings file path.
-cp [optional] : Conformance Profile file path. Required if your de-identification file contains data-type 
settings, or if any de-identification settings have a precondition.
-pi [optional] : Persisted identities file path (if the file already exists, the context will be loaded fr
om it).
-r [optional] : Result file path. [default: .\results.txt].
-rt [optional] : Result format type: 'InitialFileStructure' to reflect the initial file structure (-r is r
equired for InitialFileStructure. The -r value has to be a folder)
'CustomizedSize' to split by file size, in MB, followed by the size amount (The -r value has to be a file)
'MessageCount' to split by message count, followed by the amount (The -r value has to be a file)
'NoSplit' to save the result to a single file (default value) (The -r value has to be a file)
-opt [optional] : Set de-identification options: 'ConsiderIdAsNumeric' to consider 001234 and 1234 as equi
valent
'GenerateValueOnEmptyField' to populate empty field with generated values if applicable
'IgnoreQuote' to consider '1234', "1234" and 1234 as equivalent
remark: GenerateValueOnEmptyField|IgnoreQuote will enable both options.
-mbd [optional] : Message beginning delimiter (in regex format)
-med [optional] : Message ending delimiter (in regex format)
-sed [optional] : Segment ending delimiter (in regex format)
-lp [optional] : Logs file path.
This command will de-identify HL7v2-XML messages, HL7v3 documents, or FHIR-XML resources. To get help with this command, type: WorkgroupConsole.exe help De-Identify-XML
C:\Program Files (x86)\Caristix\Caristix Workgroup>WorkgroupConsole.exe help De-Identify-XML

** De-Identify-Xml **

e.g. De-Identify-Xml C:\first-document.xml D:\second-document.xml -de <or> -DeIdentificationR
ules "C:\My DeIdentification rules.cxdx" [-cp <or> -ConformanceProfile "C:\HL7Reference\CCD (
Continuity of Care).cxpx"] [-pi <or> -PersistentIdentities "D:\persistence-xml.dic"] [-r <or>
 -Results "D:\results\"] [-lp <or> -LogsFilePath "C:\logs.txt"]

Source files : The documents to De-Identify (can also be folders).
-de required : DeIdentification rules file path.
-cp [optional] : Conformance Profile file path.
-pi [optional] : Persisted identities file path (if the file already exists, the context will
 be loaded from it).
-r [optional] : Result folder path. The value has to be a folder [default: .\Results].
-lp [optional] : Logs file path.
This command will execute a Caristix Scenario Suite. To get help with this command, type: WorkgroupConsole.exe help Execute-Test
C:\Program Files (x86)\Caristix\Caristix Workgroup>WorkgroupConsole.exe help Execute-Test

** Execute-Test **

e.g. Execute-Test C:\myScenarioSuite.cxs [-r <or> -ReportingEnabled y] [-rp <or> -ReportPath C:\resultingR
eport.xlsx] [-e <or> -LogExecutionEnabled y] [-ep <or> -LogExecutionPath "C:\ProgramData\Caristix\Caristix 
Test\Execution logs\"] [-run <or> -PathsToRun "scenario 1/action 1" "scenario 2/Action 1/task 1"] [-skip <
or> -PathsToSkip "scenario 1/action 1" "scenario 2/Action 1/task 1"] [-lp <or> -LogsFilePath "C:\customLog
Path.log"] [ -var <or> -EditVariables "${MyVariable}[0].LimitationMax=5" ] [ -env <or> -Environments "MyEn
vironment" ]

Source file : The ScenarioSuite file to execute
-r [optional] : Output an Excel report file or not (y or n, default is n)
-rp [optional] : Excel report file path (default is '.\report.xlsx')
-er [optional] : Include extended report details. (y or n, default is y)
-e [optional] : Save execution result (y or n, default is n)
-ep [optional] : Execution result path (default is '.\result.xml')
-run [optional] : List of scenarios, actions and tasks to run in the scenario suite (cannot be used with 
-skip)
-skip[optional] : List of scenarios, actions and tasks to skip in the scenario suite (cannot be used with 
-run)
-skip "scenario 1" should skip the scenario 1
-skip "scenario 1/action 2" should skip the action 2 in scenario 1
-skip "scenario 1/action 2/task 1" should skip the task 1 in scenario 1/action 2
-lp [optional] : Logs file path (default is 'TestConsole.log')
-var [optional] : List of scenario suite variables to edit while running the suite.
-env [optional] : Active environment name (default is the environment active set in the scenario suite)

This command will compare 2 sets of HL7v2-ER7 messages and create a report listing differences.

To get help with this command, type: WorkgroupConsole.exe help Message-Comparison-HL7

C:\Program Files (x86)\Caristix\Caristix Workgroup>WorkgroupConsole.exe help Message-Compar
ison-HL7 ** Message-Comparison-HL7 ** e.g. Message-Comparison-HL7 C:\first-document.hl7 C:\second-document.hl7 [-cfg -Configurat
ion "C:\Message Comparison Configuration.xml"] [-r -Report "C:\reportpdf"] [-rc -ReportCo
mments ""] [-or -OpenReport] [-lp -LogsFilePath "C:\logs.txt"] Source files : The documents to Convert (can also be folders). -cfg [optional] : Message Comparison Configuration file path -r [optional] : Report file path (pdf or .xlsx) -rc [optional] : Report comments -or [optional] : Open the report after the generation is completed -lp [optional] : Logs file path.

This command will extract a subset of HL7v2-ER7 messages, according to the provided filter rules.

To get help with this command, type: WorkgroupConsole.exe help Search-And-Filter-HL7

C:\Program Files (x86)\Caristix\Caristix Workgroup>WorkgroupConsole.exe help Search-And-Filter-HL7

** Search-And-Filter-HL7 **

e.g. Search-And-Filter-HL7 C:\first-document.hl7 D:\second-document.hl7 -sfr  -SearchAndFilterRules
"C:\MySearchAndFilterRules.cxf" [-cp -ConformanceProfile "C:\HL7Reference\HL7 v2.5.1.cxp"] [-r -R
esults "D:\results.hl7"] [-rt -ResultType "MessageCount 100"] [-lp -LogsFilePath "C:\logs.txt"] Source files : The documents to Search And Filter (can also be folders). -sfr [required] : Search-and-filter rules file path. -cp [optional] : Conformance Profile file path. Required if SearchAndFilterRules need reference to
the spec. -r [optional] : Result file path. efault: .\result.txt]. -rt [optional] : Result format type: 'InitialFileStructure' to reflect the initial file structure
(-r is required for InitialFileStructure. The -r value has to be a folder) 'CustomizedSize' to split by file size, in MB, followed by
the size amount (The -r value has to be a file) 'MessageCount' to split by message count, followed by the
amount (The -r value has to be a file) 'NoSplit' to save the result to a single file (default value)
(The -r value has to be a file) -lp [optional] : Logs file path.

Support and Documentation