Introduction
Powell Teams authorizes users with the Automation service to add additional functions and logic to the team, created through a Powell Teams template.
Powell Teams automation service supports three connector types:
- Azure Automation
- Azure functions
- Power Automate
They can be associated to a Powell Teams template and executed at the end of a team creation, after an approval workflow has been sent or after a report creation
With Azure Automation, users will create a code in Azure and link it to Powell Teams. They will be able to import any functionality they need.
How to use the Powell Teams Automation service
Step 1: Link your Azure function or Azure automation in Powell Teams in the automation section.
- Go to the Global administration in the Menu and click the page automation.
- Click on the button "create a new automation."
- Start filling in the form:
-
- Name: put the name of the function
- Description: put the description of the function
- Trigger: select the trigger.
1. Trigger will run when approval is started. It allows, for example, to notify a 3rd party app like ServiceNow that you need to manage action in Powell Teams.
2. The trigger will run after the application of the template
3. After a tag value change in an existing team: All along a team lifecycle, its information can evolve following a business process. It is possible to be informed about a team's tag value change with automation.
- Confirm
Step 2: Associate your Powell Teams automation to your Powell Teams template, tag, or report:
Associate your Powell Teams automation to your Powell Teams template:
- Go to "Microsoft Team template" "in the admin menu
- Choose the template from the list
- Go to the governance in the template settings
- Go to the "Automation" section in the template settings
- Choose the automation you created from the dropdown list
You can now associate multiple automations in a Powell Teams template to trigger multiple events. Note: there is no order in the automation executions, all are launched at the same time.
- Save the changes
Associate your Powell Teams automation to your tag:
Go to your tags and edit or create a new one; you will find an option to associate existing automation to your tag.
Step 3: Action the trigger or wait for the automation to be triggered
Depending on the type of trigger you chose, you can trigger the automation manually if the trigger is awakened after the application of a template, after an approval request, or a tag value change.
Find the Microsoft documentation explaining how to use an HTTP webhook with Logic Apps.
Edit the automation
- Trigger: the trigger will run after the application of the template. Once the provisioning has taken place, it will bring through the code and pass some information along with it. Check out the example of the existing automation below:
- Automation: Azure automation has been chosen as automation technology in tab automation.
- Settings: the selected URL In the settings tab is where it will trigger.
And just below, you have the list of details displaying the information which will pass through depending on the type of trigger chosen:
- team ID
- team name
- template ID
- template name
- owners of the team
- members of the team
- requestor ID: who's the actual request come from (requestor does not necessarily have to be the owner)
- tag values: tags assigned to that particular team
You have a JSON schema exemple of what you will receive after the automation has been triggered. This schema can be downloaded to help you to contruct your scenario easily.
You have the list of templates associated with the automation as you scroll down.