Snow Automation Platform: How to pre-populate a parameter using a PowerShell webservice

A PowerShell web service can be used to assist the user when selecting AD group by searching the Active Directory.

If you are not familiar please search for and read the following articles:

• How to Create a Service to Manage AD Membership

• How to Pre-populate a Parameter Value on Checkout

The workflow Add user to group is used for this example.

NOTE: PowerShell web services can be connected to parameters on Activity, Workflow and Service level.

Create PowerShell Script

Write a PowerShell script

Example:

function MyFunction {
    param($search)
    Import-Module APCommon 
    FindADObject -adObject $search -filterTypes Group -includeWildcards $true
}

Create a PowerShell web service

1. Select PowerShell web service from Administrator menu.

2. Select Add web service.

3. Name the web service Get AD Group

4. Save.

The PowerShell web service has been created.

Attach a PowerShell web service to a Parameter in a workflow

1. Select Workflow admin from the administer menu.

2. Select and expand the workflow Add user to group

3. Select and expland the activity adduser

4. Select and expand the parameter Group.

5. Select the Value Population tab.

6. Select Autocomplete as the kind of input field to use.

7. Select Get AD Groupfrom the PowerShell web service dropdown option.

8. Enter {0} as the parameterName. This represents the input from the user.

9. Enter DisplayName as the Display attribute. This is name that user will see at Checkout.

10. Enter SamAccoountName as the Value attribute. This is the value that is used by the activity.

11. Save All changes.

The PowerShell web service is now connected to the parameter in the workflow.

Test that the parameter auto-populates correctly

1. Find and Select the service from the Service Catelog

2. Add the service to the cart.

3. Go to Checkout.

4. Begin filling in the name of an AD group. The field pre-populates.

5. Select Submit.

6. Select Request Monitor from the Administer menu.

7. Verify the request is processed as expected.