Recently I came across a requirement to create an interface between SharePoint and 3rd party project management tool.
Click here login with your Ofice365 account. Click on Data > Custom Connector menu option from left navigation pane.
Click on "New Custom Connector" from top right corner.
Select Create from blank. You can now see a new connector creation screen.
General Tab
Provide the host URL and API end point URL. Click on "Security" tab select the authentication method that the source tool is using.
Security Tab
Based on your selection rest of the input controls will be be shows, Lets assume you have selected 0Auth 2.0.
You should now see columns like
- Client ID : is id from app registered in project management tool to consume API.
- Client Secret : is a secret key generated by the source from where you are to consume API.
- Authorization URL : is token generation endpoint URL.
- Token URL : is Refresh token URL.
- Scope : Specify if the API documentation has any details for it.
- Redirect URI : This is auto generated by power automate, you need to copy this and configure it in your app that you register to consume API's in source system.
Now, lets go the the definition tab.
You can create 3 things here.
- Actions: Allows you to create an action from one API endpoint. Actions are basic components that we use while creating a Flow ex. GetItems, GetFileName and so on...
- Triggers: Triggers are events that would result into starting the flow execution.
- Policies: Policies can be used to perform actions like replacing the endpoint url before the call is made. We can also create a policy that ensures a set of headers is always passed with each call and so on.
Definition Tab
To create an action, click on "New Action" buttonFill the Summary, Description and Operation ID. Operation ID is the one that will be visible as action title. Description is that we see while adding the action in power automate flow.
- None: Shows properly to take input, when action is added.
- Advanced: These input boxes are mostly of not required type and will be visible only when "Show Advanced Mode" is clicked.
- Internal: Internal visibility is used when you have static values of calculated values to be passed.
- Important: Important ensures that field is shown on top.
Request
Select verb, add the end point URL, headers and default body if necessary.
Click on "Import" button. this will handle the request body part.
Note: You can add Query String and body parameters to the request URL, this can be modified later. You can also attach dependent actions to get dropdown options for lookup values.
Response
You can add default response by clicking on "Add default response". You can rename the response title as well.
You are done with custom connector.
Note: you can update each Request/Response properties display name and description.
Test Tab
You can now click on test tab, select your action and perform a test.
Comments
Post a Comment