Panel | ||||
---|---|---|---|---|
|
...
Your use of this download is governed by Stonebranch’s Terms of Use, which are available at Stonebranch Integration Hub - Terms of Use.
Version Information
Template Name | Extension Name | Extension Version |
---|---|---|
Jobs As Code | ue-jobs-as-code | 1.2.0 |
Refer to changelog Changelog for version history information.
...
Area | Description |
---|---|
Python Version | Requires Python version 3.7. Tested with the Universal Agent bundled Python distribution (python version 3.7.16) |
Python Libraries |
|
Universal Agent | Both Windows and Linux agents are supported:
|
Universal Controller | Universal Controller Version >= 7.2.0.0 |
Network and Connectivity | This integration needs outbound HTTPS connectivity with GitLab, GitHub, or Bitbucket Cloud for exporting and importing UAC Definitions in addition to HTTPS outbound connectivity to the Universal Controller for retrieving the UAC Definitions and importing them from Git. |
GitLab | Supported editions:
|
GitHub | Supported plans:
|
BitBucket | Support plans:
|
Azure DevOps | Supported plans:
|
...
Query UAC definitions prior to running an actual export to Git, to validate the selection criteria, without any write operations in the target repository. This feature should provide a list of UC
definitions that can later be exported to a Git repository.
Configuration examples
User Scenario: Query all UAC Definitions are stored in UAC except Scripts and Custom Days, without a proxy connection. | User Scenario: Query all UAC Definitions that are part of a workflow with the name 'test-workflow', with a proxy connection. |
...
Export selected UAC Definitions to the selected Git Repository. By using this feature, the UAC user can export the selected UAC Definitions to an external Git repository. After the export, this repository can be used as a backup or as a basis for developer collaboration on top of a source control versioning system.
Configuration examples
User Scenario: Export to Gitlab UAC Definitions contained in Bundle with name uc_bundle except for Email and Peoplesoft Connections. The selected definitions will be stored under the "/export folder" under the "export/7.3" branch in .yaml format. | User Scenario: Export to Azure DevOps UAC Definitions. Organization and repository names must be included in the Git Service Provider URL. |
...
Import UC definitions manually
User Scenario: Import the specified files stored in the corresponding paths of Add, Modify, and Remove Definitions Lists from GitHub to UAC. Files under the Add list will be added to UAC, and files under the Modify list will modify existing definitions. Definitions of their paths under the Remove list will be deleted from UAC. | User Scenario: Import from GitHub all the files that are stored under the "export/7.3" branch and modify the existing corresponding UAC Definitions. |
...
Field | Default value | Type | Required | Description | Introduced In Version |
---|---|---|---|---|---|
Action | List UAC Definitions | Choice | Required | Action performed upon the task execution. Available actions are as follows.
| 1.0.0 |
Universal Controller URL | - | Text | Required | The Universal Controller URL will be used to query and import UC Definitions. | 1.0.0 |
Universal Controller Credentials | - | Credentials | Required | Universal Controller credentials that provide access to the Universal Controller Web Services. The user should be configured with "Web Service Access=True". | 1.0.0 |
UC SSL Certificate Verification | True | Boolean | Required | Enables/Disables certificate verification against Universal Controller URL. For example, if self-signed certificates are used to connect with UAC. | 1.0.0 |
Selection Method | Business Service | Choice | Required | Select or filter specific UC Definitions for listing or exporting to Git repository.
Visible only when the selected action is List UAC Definitions or Export to Git Repository. | 1.0.0 |
Selection Name | - | Dynamic Choice | Required | The corresponding filter value for the Selection Method Field. When the selected Selection Method is Definition Name, the value provided in the Visible only when the selected action is List UAC Definitions or Export to Git Repository. | 1.0.0 |
Selection Exclude List | - | Choice | Optional | Exclude various UC Definition types of resources from the selection. Visible only when the selected action is List UAC Definitions or Export to Git Repository. | 1.0.0 |
Git SSL Certificate Verification | True | Boolean | Optional | Enables/Disables certificate verification against Git Service Provider URL. Visible only when the selected action is Import from Git Repository or Export to Git Repository. | 1.0.0 |
Git Service Provider | GitLab | Choice | Optional | The Git service provider the task is using.
Visible only when the selected action is Import from Git Repository or Export to Git Repository. | 1.0.0 |
Git Service Provider URL | - | Text | Optional | The Git service provider URL the task is using.
Visible only when the selected action is Import from Git Repository or Export to Git Repository. | 1.0.0 |
Git Credentials | - | Credentials | Optional | The credentials that should be used to access the Git repository. The Credentials definition should be as follows.
Visible only when the selected action is Import from Git Repository or Export to Git Repository. | 1.0.0 |
Git Repository | - | Dynamic Choice | Optional | The repository the task will use to import or export UAC Definitions. The list of values is retrieved from the Git Service Provider. Visible only when the selected action is Import from Git Repository or Export to Git Repository. | 1.0.0 |
Git Repository Branch | - | Dynamic Choice | Optional | The repository branch that the task will use to import or export UAC Definitions. The list of values is retrieved from the Git Service Provider. Visible only when the selected action is Import from Git Repository or Export to Git Repository. | 1.0.0 |
Git Repository Path | - | Text | Optional |
Visible only when the selected action is Import from Git Repository or Export to Git Repository. | 1.0.0 |
Git Repository File Format | Yaml | Choice | Required | The file format is used to read and write in the Git repository. The available options are as follows.
Visible only when the selected action is Import from Git Repository or Export to Git Repository. | 1.0.0 |
Git Commit Message | - | Text | Optional | The optional git commit message for the commits that will take place during export. The commit message Visible only when the selected action is Export to Git Repository. | 1.0.0 |
Add UC Definitions List | - | Text | Optional | The comma-separated list of Git file paths that should be used to create UC Definitions. Type "*" to select all files from Git provider and Visible only when the selected action is Import from Git Repository. | 1.0.0 |
Modify UC Definitions List | - | Text | optional | The comma-separated list of Git file paths that should be used to modify UC Definitions. Type "*" to select all files from Git provider and Visible only when the selected action is Import from Git Repository. | 1.0.0 |
Remove UC Definitions List | - | Text | Optional | The comma-separated list of Git file paths that should be used to remove UC Definitions. Type "*" to select all files from Git provider and Visible only when the selected action is Import from Git Repository. | 1.0.0 |
Proxy Type | -- None -- | Choice | Optional | What type of proxy is in use (if any). The available options are as follows.
| 1.0.0 |
Proxy | - | Text | Optional | Proxy server and port. | 1.0.0 |
Proxy Credentials | - | Credentials | Optional | Credentials to be used for the proxy when the selected Proxy Type is HTTPS With Credentials. | 1.0.0 |
Proxy CA Bundle File | - | Text | Optional | The path to a custom certificate bundle to use when establishing SSL/TLS connections with proxy. Visible only when the selected Proxy Type is HTTPS With Credentials. | 1.0.0 |
Webhook Payload | - | Text | Optional | Through this field the user can provide the Bitbucket webhook payload from which the task executed will extract the Added, Modified, and Removed Definition Lists. Note: Pass the webhook payload in this field only when integrating with Bitbucket. For all other Git webhook integrations, use the other three Definitions' List fields. | 1.1.0 |
...