Service Automation GitHub resources
The Tools4ever GitHub account contains three types of resources for use with HelloID's Service Automation module:
Script templates for PowerShell Scheduled tasks
Code snippets for PowerShell Product tasks
To browse all repositories in the T4E GitHub account that contain pre-defined delegated forms, search GitHub for org:Tools4everBV topic:delegated-form:
Important
If no suitable pre-defined delegated form exists for your needs, you will need to create one from scratch. See Add a custom delegated form.
Each repository comprises a set of PowerShell scripts and JSON files:
Filename | Description |
|---|---|
[root]\readme.md | Readme file describing the repository's functionality. Includes any relevant special instructions, limitations, or recommendations. |
[root\All-in-one setup] | Folder containing resources to automatically set up the delegated form. |
[root\All-in-one setup]\createform.ps1 | The all-in-one automatic PowerShell setup script. |
[root\Manual resources] | Folder containing resources to manually set up the delegated form. |
[root\Manual resources]\datasource_{HelloID data source name}.ps1 | Data source manual setup script. |
[root\Manual resources]\task_{HelloID task name}.ps1 | Task manual setup script. |
[root\Manual resources]\dynamicform.json | Dynamic form manual setup JSON definition. |
[root\Assets] | Miscellaneous assets folder. |
There are two ways to bring a delegated form into your HelloID environment from GitHub: automated import or manual import.
Automatic import via delegated form catalog (recommended)
Manual import via all-in-one PowerShell script
To browse all repositories in the T4E GitHub account that contain PowerShell Scheduled tasks, search GitHub for org:Tools4everBV topic:scheduled-task:
Each repository comprises a PowerShell script and miscellaneous assets.
There is only one way to bring a task into your HelloID environment from GitHub: manual import.
Manual import via GitHub
Add a PowerShell scheduled task, and copy and paste the contents of the repository's .ps1 file into the body of the PowerShell script.
To browse all repositories in the T4E GitHub account that contain code snippets for PowerShell Product tasks, search GitHub for org:Tools4everBV topic:task topic:product topic:service-automation topic:powershell:
Tip
Repositories with this combination of four topics appear in the Code Snippet Library tab of PowerShell product tasks.
Most snippets are suitable to use either as standalone scripts, or as a portion of a larger custom script.
Each repository comprises the following files:
Filename | Description |
|---|---|
[root]\readme.md | Readme file describing the repository's functionality. Includes any relevant special instructions, limitations, or recommendations. |
[root]\action.ps1 | The code snippet. |
[root]\icon.png | An icon to use for the underlying dynamic form. |
Manual import via the code snippet library
Add a PowerShell product task, and on the Code Snippet Library tab, click a snippet's Copy To Clipboard button to copy the contents of the repository's .ps1 file. Paste it into your script.
Most snippets require you to create & link a dynamic form to the product, to collect the needed values for
$formObject. Each snippet's readme contains sample JSON that describes what the form needs to collect. For example, the "Azure Active Directory - User account update manager" snippet requires aUserIdentity, aUserPrincipalName, and aManagerIdentity:
To create & link your form:
Add a dynamic form with the necessary Form elements to capture the input values for the snippet. For example, the above snippet would need two appropriately scoped User Selector elements. If needed, use Data sources to populate your elements.
Additionally customize the snippet as needed. Be sure to thoroughly read its readme file.