HelloID

Go to Delegation > Delegated Forms and click Edit for the relevant form.

For this example, we'll edit our Weather report delegated form.

Go to the Task tab.

We can choose to get any code snippet from our code snippet library or start with an default script. In our case we are starting with the default script.

Click Set Default Script to populate the task with a default script template.

The key points about the script template are as follows. Examples are shown later in this article.

Customize the script according to what should happen when a user submits this delegated form. For example, make API calls into external systems based on the data available in the form or requester objects.

For this example, we will query a weather API (similar to the script demonstrated in the Add a PowerShell data source article), and show some important variables in action. We'll use the following script:

#######################################################################
# Template: HelloID SA Delegated form task
# Name: Weather report DGF
# Date: 8.9.2023
#######################################################################

#region init

$VerbosePreference = "SilentlyContinue"
$InformationPreference = "Continue"
$WarningPreference = "Continue"

# global variables (Automation --> Variable libary):
$globalVarExample = $companyName

# variables configured in form:
$formVarExample = $($form.tempUnitDropdown.tempUnitValue)

# other variables
$requesterUsernameExample = $requester.userName
$requesterUserGUIDExample = $requester.userGUID

#endregion init

#region functions

Function Get-Current-NYC-Weather {
    $locationEndpoint = "https://api.open-meteo.com/v1/forecast?latitude=40.71&longitude=-74.01&hourly=temperature_2m&temperature_unit=$formVarExample&windspeed_unit=mph&precipitation_unit=inch"
    $response = Invoke-RestMethod -uri $locationEndpoint
    Write-Information "Response: $response"
    return @{weather = "Current time: $($response.hourly.time[0]); current temperature: $($response.hourly.temperature_2m[0]) degrees $formVarExample"}
}

#endregion functions

#region task
try {
    Write-Verbose "Looking up NYC weather for [$requesterUsernameExample ($requesterUserGUIDExample)], in product $productName"

    $result = Get-Current-NYC-Weather
    Write-Information "Result: $($result.weather)"

    $Log = @{
        Action = "Undefined"
        System = "OpenMeteo"
        Message = "Successfully executed action for [$requesterUsernameExample ($requesterUserGUIDExample)]"
        IsError = $false
        TargetDisplayName = $requesterUsernameExample
        TargetIdentifier = $([string]$requesterUserGUIDExample)
    }

    Write-Information -Tags "Audit" -MessageData $log
	
    $email = @{
        from = "[email protected]"
        to = "[email protected]"
        subject = "Your weather report"
        body = "<strong>$($result.weather)</strong>"
        confidential= $false
    }
  
	Write-Information -Tags "Email" $email
} catch {
    $ex = $PSItem
    Write-Warning "Error at Line '$($ex.InvocationInfo.ScriptLineNumber)': $($ex.InvocationInfo.Line). Error: $($ex.Exception.Message)"

    Write-Error "Error executing action for [$requesterUsernameExample ($requesterUserGUIDExample)]. Error Message: $($ex.Exception.Message)"

    $Log = @{
        Action = "Undefined"
        System = "OpenMeteo"
        Message = "Error executing action for [$requesterUsernameExample ($requesterUserGUIDExample)]. Error Message: $($ex.Exception.Message)"
        IsError = $true
        TargetDisplayName = $requesterUsernameExample
        TargetIdentifier = $([string]$requesterUserGUIDExample)
    }

    Write-Information -Tags "Audit" -MessageData $log
}
#endregion task

If your script relies on form data, enter JSON in the Input tab to simulate form input.

For this example, we'll enter the following JSON to simulate input from our Weather report form:

{
   "tempUnitDropdown": {
      "tempUnitLabel": "Fahrenheit",
      "tempUnitValue": "fahrenheit"
   }
}

To test your script, click Execute PowerShell. View the results on the Received Logs and Received Audit Logs tabs.

For this example, the NYC weather has been fetched and logged.

Click Save.