The Universal Connector web-part is a Powell 365 web-part. One example of this web-part can be found in many places on the Intranet. For example: the Human Resources Department.
The Universal Connector web-part is the perfect way to get elements from some external links and integrate them into your web-part.
Thanks to the Universal Connector web-part, you can expand the scope of the elements displayed on the web-part and configure it the way you want.
Universal Connector web-part on the “Human Resources Department” page
How to add the Universal Connector web-part
To configure the Universal Connector web-part, you need to :
- Click the plus sign to add a new web-part, where you want it on your page.
- Then search for "Powell Intranet Web-parts" from the list.
Select “Powell Intranet Webparts”
- After selecting the Powell Intranet Web-parts, you'll see an empty widget, you need to edit it and select the desired web-part (to do so, click the pencil icon on your empty widget).
- As you click the edit button for the Powell Intranet Web-parts, you will see a web-part form. (The image below).
- Fill in the required information
- In the widgets section, select "Universal Connector".
How to configure the Universal Connector web-part
After selecting the Universal Connector web-part, the following edit form will appear. You will see how to configure each section of it below.
If you already have a configuration that you imported from a previous Universal Connector web-part, you can directly click the "Import configuration" on the bottom of the page. If not, you can pursue this tutorial, and you will be able to export your newly made configuration by clicking the "Export configuration" button.
- To import your configuration, you'll just have to paste your configuration on the text area, and then click to "Import" on the bottom right of the pop-in. Then you can close it by clicking "Close" on the bottom right.
"Request block" configuration
In this section, you will be able to configure your requests. By clicking the bottom button "Create a request block", you will be able to add many requests to your web-part. You will also be able to delete them by clicking the delete button on the top right corner.
- First, you can specify the type of request your web-part will be linked to. You can select either if it's a GET, POST, PUT or DELETE request and add the url linked with your request.
- You can decide to add some header to you request if you click the "+ Add header" button, the following section will appear. You will be able to delete it, modify its key and its value.
- You can also add and delete Mappings to your request. The drop-down allows you to select between the body or the response, and to the right, you will be able to link a "Key" and a "Value" to it.
- A few advanced options are given to you. By clicking on "Advanced options" on the right, you will be able to configure :
- The Timeout
- The code you want to execute depending on the call results
- If you want cache or not. If yes, its lifespan
- Whether or not you want to use "Microsoft Graph" Token
- And if you want to use a proxy or not
- Before saving your web-part, you can test it by enabling the debug mode. If it's off, the "Test Request" button won't be displayed.
Here, you can configure the display of your results.
It can either be a defaults template or an input made by you.
- In case of a default template configuration, you will be able to :
- Choose between the templates given in the drop-down list
- Set the number of elements per row, based on the device
- And to select between the type of loaders you want. A default one made by Powell, or a custom one, where you can add the code snippet in a section that will appear in case it's your choice.
- Clear cache or preview the result, after you've made all the right configuration before this.
- In case of a custom configuration, you will be able to :
- Put the code linked to the desired template to the given section.
- Select between the types of loader you want. A default one made by Powell, or a custom one, where you can add the code snippet in a section that will appear in case it's your choice.
- Clear cache or preview the result, after you've made all the right configuration before this
Once you're finished, you can Save your work by clicking on the Save button, and you can also "Export" or "Import" configuration.