GitHub Integration (via Microsoft Power Automate) - Merge a Pull Request
IntegrationIntroduction
You can integrate third-party systems with Service Manager in many ways. The method you select will depend on business requirements, architectural and security constraints as well as the characteristics specific to each third-party application or service.
This document describes an integration process that has already been implemented in a customer context.
To find out more about this integration (e.g. scripts to be used), please do not hesitate to contact your EasyVista contact, or your service provider and integrator.
Overview of the integration
GitHub is an online service that hosts websites and source code files, and provides distributed version control using Git. It is also a collaborative space where each user can contribute content to online public projects.
This integration enables you to create an action in the timeline of a Service Manager ticket when a pull request is merged in GitHub, via Microsoft Power Automate.
- The comment in the pull request is retrieved from GitHub.
- A direct link to the pull request in GitHub is added.
Note: GitHub and Service Manager are linked using a standard comment added to the pull request. This comment must include the Service Manager ticket number and the ID of the Azure DevOps Bug work item associated with the ticket.
Preview of the tools used in this integration
- Microsoft Power Automate (formerly known as Microsoft Flow) enables you to automate recurrent tasks by building workflows using Web applications. These applications use MS Power Automate connectors (based on Microsoft Azure Logic Apps) or the MS Graph gateway for interfacing with any endpoint via HTTP/HTTPS.
Integration Data Feed (direction) | Authentication Type | Integration Connector Options | ||
---|---|---|---|---|
|
|
|
Available versions | ||
---|---|---|
SaaS-based | On-premises | |
Service Manager | ![]() |
![]() |
Third-Party Product | ![]() |
N/A |
GitHub - definitions
Definitions_GitHub
- GitHub is an online service that hosts websites and source code files, and provides distributed version control using Git. It is also a collaborative space where each user can contribute content to online public projects.
- Git is a distributed version control system for tracking project changes and saving them in different versions, thus enabling you to revert back to an older version at any time.
- In Git, the copy of all project files and versions is called a repository. This is a storage space on the centralized GitHub server that contains each source code.
- Issues are created to initiate discussions among developers, bug reports, proposed developments, etc.
- A pull request is a procedure that enables an external contributor to propose changes to the original code (request), integrate feedback and resubmit them (pull).
- A review is used to evaluate, comment and validate the changed code in the pull request. Once code changes are approved by the review, the pull request is merged with the original version.
Microsoft Power Automate flows
The integration between Service Manager and GitHub will trigger a flow in Microsoft Power Automate when a pull request associated with a Service Manager ticket is merged.
==> Merge a pull request in GitHub flow
Prerequisites
- You must have an Azure subscription. If this is not the case, you can create a free account, or you can buy an Azure Pay-As-You-Go subscription.
- You must have a GitHub account.
- You must ask EasyVista to create two fields in the SD_REQUEST table which will be specific to Azure DevOps and GitHub.
- You must add a standard comment to the pull request when it is merged.
See the procedure.
Best Practice
BestPractice
- The procedure describes all of the steps for creating Microsoft Power Automate flows. To facilitate integration, the ZIP folders shipped with this integration contain pre-configured flows. Once you have downloaded them, you should specify the parameters specific to your environment, i.e. Azure account credentials, EasyVista server address, credentials of your Service Manager platform, etc.
- Use the search field to find the connectors and actions to be created in the MS Power Automate workflow easily.
example Find the actions for the Azure DevOps connector
Caution
Caution_TitleActionInPowerAutomateFlow
- When you create workflow actions in Microsoft Power Automate, you must rename them as indicated in the procedure. This is because certain items of information in the name refer to the title of the action. If you do not respect the naming convention, the workflow will not be triggered correctly.
example The split(body('Analyze_Ticket_Info')'')?['AVAILABLE_FIELD_6'],',') instruction refers to the action called Analyze Ticket Info
Note: Spaces in the title will automatically be replaced by the underscore _.
Integration process
Prerequisite Ask EasyVista to create two fields in the SD_REQUEST table which will be specific to Azure DevOps and GitHub. Add them to the ticket form. See the detailed procedure.
1. Create the MS Power Automate flow that will be triggered when a pull request is merged. See the detailed procedure.
- Note: This requires a connection to GitHub.
Import the preconfigured flow below containing all of the steps to MS Power Automate.
See the procedure for importing flows.
2. Create a standard comment for the pull request when it is merged. See the detailed procedure.
Note: You must add a standard comment each time a pull request associated with a Service Manager ticket is merged.
Step-by-Step Integration Process
AddDevOpsFieldsInTicketForm_Procedure
Add fields specific to Azure DevOps and GitHub to the SD_REQUEST table
Step 1: Ask EasyVista to add fields to the database
1. Ask EasyVista to add the following two fields.
- Field called E_ADO_NUMBER, nvarchar data type, size 20. This will store the ID of the Azure DevOps work item associated with the Service Manager ticket.
- Field called E_PR_NUMBER, nvarchar data type, size 20. This will store the number of the GitHub pull request associated with the Service Manager ticket.
Step 2: Add fields to the Ticket forms, i.e. Incident and Request forms
See the detailed procedure
1. Open each Ticket form, i.e. Incident and Request forms.
2. Click in the top banner and select Edit Form.
The main form presentation will appear.
3. Select and place the two fields in the form.
4. Click Save and click Save and Close.
The form will be refreshed.
Import the workflow to Microsoft Power Automate
Note: This requires a connection to GitHub.
Step 1: Download the flow
1. Download the file below to your workstation.
ImportFlowInMicrosoftPowerAutomate_Procedure
Step 2: Import the flow to Microsoft Power Automate
1. Log in to the Microsoft Power Automate website using your account credentials.
2. Click My flows in the left pane.
A list of your MS Power Automate flows will appear.
3. Click Import in the menu bar and select the file you downloaded.
- Once imported, the package contents will appear.
- The
icon indicates that the connection for the resource was not found.
Step 3: Create the connections required for the flow
1. Click the Select during import link in the Import Setup column for the relevant resource.
The window for configuring the import will appear.
2. Create a new connection for the resource or select an existing connection.
There is an existing connection for the resource
- Select the connection.
- Click Save.
There is no existing connection for the resource
- Click + Create.
- An MS Power Automate instance will appear in a new Web browser tab.
- The list of existing connections will appear.
- Click + New connection.
- Find the connection you want using the search field and select it from the list.
example Find the GitHub connection
A window displaying the list of permissions to be granted to Microsoft Power Platform will appear.
- Click Create to create the new connection.
- Click Accept to accept the conditions and authorize Microsoft Power Platform access.
- You will return to the tab displaying the list of MS Power Automate flows.
- The new connection for the resource will appear in the list.
example New GitHub connection
- Close your Web browser tab.
You will return to the tab displaying the details of the imported package.
- Click Refresh List.
The new connection for the resource will appear in the window for configuring the import.
- Select the connection and click Save.
Theicon indicates that the connection for the resource has been correctly established.
3. Repeat the procedure for each connection required for the flow.
Step 4: Import package resources
1. Click Import.
The icon next to each package resource indicates that the flow has been correctly imported.
Step 5: Configure package resources
Note: You should perform this step if a message at the top of the page informs you that package resources must be configured.
1. Click Save as new flow in the message displayed at the top of the page.
- An MS Power Automate instance will appear in a new Web browser tab.
- The workflow of the imported package will appear.
2. Click the action indicating an invalid connection.
The list of all existing connections for the selected type of resource will appear.
2. Click the connection defined for the type of resource.
The properties of the action will appear. The properties displayed depend on the type of resource.
example Unspecified properties for an action using the Azure DevOps resource
3. Specify the connection information for the action.
example Properties for an action using the Azure DevOps resource
- Organization Name: Select the name of your organization.
- Project Name: Select the name of your DevOps project.
4. Repeat the procedure for each action indicating an invalid connection.
5. Click Save.
- The error message for the action will disappear.
example Action for the Azure DevOps resource
- You have configured all of the connections required for the flow.
- The workflow will be created.
Step 6: Configure the workflow
1. Move your cursor over the name of the flow and click .
The workflow will appear.
2. See the procedure for configuring the imported flow.
Create the MS Power Automate flow
Description of the Merge a pull request in GitHub workflow
![]() |
|
Step 1: Create the step that will trigger the flow
==> The flow is triggered when a pull request is merged in GitHub.
1. Create a When a Pull Request is created or modified action for triggering the workflow (GitHub connector > Triggers).
![]() |
|
Step 2: Initialize variables
1. Define the following variables by creating Initialize variable actions in the order listed below.
![]() |
Variable 1: To store the number of the Service Manager ticket
|
Variable 2:
|
Step 3: Find the Service Manager ticket number when the merge date of the pull request is specified
Step 3.a: Define a condition to check if there is a merge date for the pull request
1. Create a Condition action.
![]() |
|
2. Define the actions to be performed when the merge date of the pull request is specified (condition for the Condition if the PR is merged action).
- Go to the If Yes branch.
- Add the actions from step 3.b by selecting Add an action.
Step 3.b: Find the standard comment containing the Resources section when the merge date is specified
1. Create a HTTP action to read all comments in the pull request.
![]() |
|
2. Create a JSON Analysis action to retrieve information on the comments.
![]() |
|
Step 3.c: Define a condition to retrieve the Resources section from the standard comment
1. Create an Apply to each action.
![]() |
|
2. Create a HTTP action to read each comment in the pull request.
![]() |
|
3. Create a JSON Analysis action to retrieve information on the comment.
![]() |
|
4. Create a Condition action to check if there is a Resources section among the information retrieved in the Parse JSON Get a comment step.
![]() |
|
5. Define the actions to be performed when the Resources section is found (condition for the Condition if comment is EZV action).
- Go to the If Yes branch.
- Add the actions from step 3.d by selecting Add an action.
Step 3.d: Define a condition to check if there is a Service Manager ticket number in the Resources section
1. Define the following Compose actions in the order listed below to break down the contents of the Resources section.
![]() |
Compose 1:
|
Compose 2:
|
|
Compose 3:
|
|
Compose 4:
|
2. Create a Set variable action to store the Service Manager ticket number in the RFC NUMBER variable.
![]() |
|
3. Create a Condition action to check if there is a Service Manager ticket number in the RFC NUMBER variable.
![]() |
|
4. Define the actions to be performed when the RFC NUMBER variable contains a Service Manager ticket number (conditions for the Condition if there is a RFC Number action).
- Go to the If Yes branch.
- Add the actions from step 4 by selecting Add an action.
Step 4: Create an action in the timeline of the Service Manager ticket when the RFC NUMBER variable contains a ticket number
1. Create a HTTP action to find the Service Manager ticket corresponding to the RFC NUMBER variable.
![]() |
|
2. Create a JSON Analysis action to retrieve information on the Service Manager ticket.
![]() |
|
3. Create an Apply to each action.
![]() |
|
4. Create a HTTP action to define a Merge a pull request action in the timeline of the Service Manager ticket.
![]() |
|
Step 5: Save the configuration of the workflow
1. Click Save at the bottom of the flow.
Create the standard comment for the pull request
Note: You must add a standard comment each time a pull request associated with a Service Manager ticket is merged.
CreatePullRequestTypeComment_Procedure
Step 1: Log in to GitHub
1. Log in to GitHub using your account credentials.
2. Select the account of the GitHub repository owner and the GitHub repository where the pull request is committed.
Step 2: Find the pull request
1. Select the Pull requests tab.
The list of pull requests will appear.
2. Click the pull request to be processed.
The actions that can be performed on the pull request will appear.
Step 3: Create the standard comment for the pull request
1. Click Comment at the bottom of the pull request.
2. Enter the following standard comment in the Write tab. Replace the values highlighted in yellow with your values.
- RXXXXXX_XXXXXX: Number of the Service Manager ticket
- ID_Azure: Azure DevOps Bug work item associated with the ticket
## Resources
| Resource | URL |
|------------------------|:----------------:|
| Ticket number | [RXXXXXX_XXXXXX](https://autoconnect_link) |
| ADO | [ID Azure](https://dev.azure.com/Organization/Project_Name/_workitems/edit/ID_Azure) |
3. Click Comment.
The comment will automatically be refreshed in the pull request. It displays the number of the Service Manager ticket and the ID of the associated Azure DevOps Bug work item.
Links to other integrations
- Microsoft Power Automate integration (formerly known as Microsoft Flow)
- Azure DevOps integration (via Microsoft Power Automate)
- Azure DevOps integration (via Microsoft Power Automate) - Create Bug and Task work items
- GitHub integration (via Microsoft Power Automate) - Approve a review
- GitHub integration (via Microsoft Power Automate) - Close a pull request
- GitHub integration (via Microsoft Power Automate) - Close a Service Manager ticket associated with a pull request
List of files to download
Note: To find out more, see the step-by-step integration process.