Introduction

Easit Process Runner, or EPR for short, makes it possible to integrate Easit GO with your existing PowerShell scripts. EPR consist of a java application running in an instance of Apache Tomcat, installed as a Windows service.

Once started, EPR listens for incoming request using a REST service. When a request is received, the JSON body of the request is passed on as a argument to a script file with the same name as the value of "importHandlerIdentifier" in the body.

    {
        "importHandlerIdentifier":"testService.ps1",
        "itemToImport":[
            {
                "property":[
                    {
                        "content":"123456",
                        "name":"requestId",
                        "rawValue":null
                    },{
                        "content":"aValue",
                        "name":"aProperty",
                        "rawValue":null
                    }
                ],
                "attachment":[],
                "id":"123456:2",
                "uid":"123456"
            }
        ],
        "genericRequestProperty":[
            {
                "content":"testService.ps1",
                "name":"identifier"
            },{
                "content":"MC0CFHnd2e81XFZezdFIHPj5i+A/6dbPAhUAkUKMTyjRZtJ7SZ6c/3KL0aeZKd4=",
                "name":"initializedByXmlExport"
            }
        ]
    }

To put in to context, the command executed by the java application, with the example above would be as shows below.

    C:\Users\administrator> pwsh.exe -ExecutionPolicy Bypass -File "Path/To/Scripts/scriptName.ps1 requestJsonBody"

To further exemplify this, our script scriptName.ps1 looks like this:

    [CmdletBinding()]
    param(
        [Parameter(Mandatory,Position=0)]
        [string]$StringInput
    )
    $exportObject = $StringInput | ConvertFrom-Json
    $easitObject = $exportObject.itemToImport[0]
    Write-Host "Received exported item $($easitObject.uid)"
    # To access the properties..
    foreach ($property in $easitObject.property) {
        Write-Host "$($property.Name) = $($property.Content) (rawValue: $($property.rawValue))"
    }
    # Access a specific property
    $easitObject.property | Where-Object {$_.Name -like "requestId"}

and will produce this output:

    Received exported item 123456
    requestId = 123456
    aProperty = aValue

    content name      rawValue
    ------- ----      --------
    123456  requestId

Once the script have completed, EPR will evaluate LASTEXITCODE. If LASTEXITCODE is anything else than 0 the java application will treat it as an error or failure.