Demo - Displaying a list of apps
To demonstrate the use of this connector, here's a screenshot of how to display a list of available apps in an environment by adding a gallery control, and setting the Items property to the return value of the GetApps method.
To highlight the schema of the data that GetApps returns, here's what we see when we collect the result into a collection. The notable fields in this data structure are:
- name - this returns the unique identifier for an app
- id - this is the fully qualified identifier that we use to launch an app
- properties - this is a record that returns app details such as the display name, app icon, create user, and create date of the app.
- tags - this is a record that returns details such as the form factor of the app (eg phone, tablet), the dimensions, and published version number.
Here's what we see when we drill into the properties field for a record. Here, we can see details such as the display name, description, and icon for an app.
How to carry out common tasks with the GetApps method
There are a few things to be aware of when we work with the results of the GetApps method. Here are some highlights of tasks that we typically carry out with this method.
The pertinent app details are stored in the properties record. Therefore, to show the friendly 'app name' in a gallery, we would set the text property of the label to the following:
Likewise, we would refer to the backgroundImageUri field in the properties record if we want to display the app icon. Note that the built-in icons typically use a white foreground colour. Therefore it's important to set the back colour property of the image control in order for the icon to display properly.
To filter the results of GetApps, we can apply all the typical data shaping functions that are available such as Filter, and Search etc. For example, here's the formula to return only those apps with a display name that starts with "b".
To launch an app, we call the launch function and pass the fully qualified identifier (that is, the value that looks like this: "/providers/Microsoft.PowerApps/apps/f342faaf-5f82-4ace-a64b-7c1b01499231" ). For example in a gallery control, we can add a button and call the following function to launch the app that corresponds to the selected row.
How to use the 'Power Apps for Admins' connector
The 'Power Apps for Admins' Connector works almost identically to the 'Power Apps for Makers' connector. The main difference is that it works at an administrative level. That is, it return lists of resources at a tenant level, rather than only those that the user has access to.
The documentation for this admin connector is here, and a summary of the methods is shown beneath: