Link Search Menu Expand Document

The premier Star Wars Fan club is growing and the club officers would like to upgrade from their existing member tracking worksheet to a mobile application that would be available to their members all over the world. The members would also like to see information about their favorite Star Wars movies and characters in the application that would update as new shows and movies are released.

In this exercise, you will be using Star Wars API with Azure API Management instance that you created in part three of this lab. The Excel worksheet of member profiles will serve as the primary backing data source and will be used to generate a base application. You will export the Star Wars API from API Management as a Power Platform Custom Connector so that the Canvas App can access real-time Star Wars character information. For each of the Fan Club members, you can then search the Star Wars API character data and show information about their favorite character in the Canvas App.

Note: This exercise requires access to Power Apps Premium connectors. Sign up for a free Developer Plan.

Create a custom connector

From the existing Star Wars API Api in Azure API Management, click the ellipsis and select the Create Power Connector option to generate a custom connector in your Power Platform environment.

If you are unable to create a Power Connector from Azure API Management, you can also export an OpenAPI v2 (JSON) file that can be imported as a Custom Connector within Power Platform. You can find a sample here.

View your custom connector in Power Platform

  1. Go to https://make.powerapps.com and sign in with your organizational account.
  2. Select Data from the left pane, and then select Custom Connectors to see your generated custom connector to your API Management API.

  1. From here, select the pencil icon to edit the custom connector.
  2. On the Definition screen, we need to define a search query string for people so that the Power App can search for character records by name. Select the GetPeople action, and in the Request section, select + Import from sample. Enter a sample request URL with the search query string:

https://apim-star-wars-xxxx.azure-api.net/sw/people?search=Luke

  1. In the Response section of the getpeople action, select the 200 response and then select + Import from sample. Copy and paste a sample JSON response into the Body section of the response. Close the import panel and select Update connector.

Repeat this import for the getpeoplebyid action.

  1. On the Test screen, create a new connection instance in the Connections section. You will then be redirected to the Connections area in Power Platform where your connection was created. Navigate back to the Custom Connectors page and edit the Star Wars API again. Return to the Test page and test each of the API actions.

Generate the Star Wars Fan Club Application

Connect to the backing data source

  1. Download the FanClubMembers.xlsx workbook and save it to your OneDrive for Business account.
  2. Back in the Power Apps Editor, in the left pane, select Home.
  3. Under Start from data , select Other data sources and then select New from the left pane.
  4. Select OneDrive for Business data source, and then Phone layout.
  5. Under OneDrive for Business , select Create.
  6. Under Connections , select OneDrive for Business and browse to the file location. You might need to select New Connection to see the OneDrive for Business connection.
  7. Under Choose an Excel file , select the FanClubMembers.xlsx file.
  8. Under Choose a table , select the Members table.
  9. Select Connect on the bottom right.
  10. Power Apps will generate the app by inspecting your data and matching it with Power Apps screens.

Add Favorite Character information

Your generated app will now be in edit mode in the Power Apps Studio.

Add the Star Wars API Data Source

  1. Select Data from the left pane and then select + Add data from the drop-down menu.
  2. Search for Star Wars in the search field and choose the connection to the Star Wars API.

Customize the generated app

Your generated app will now be in edit mode in the Power Apps Studio.

You can customize your app theme using the Theme drop-down menu and selecting an option. You can change or format the fields that are shown in the Gallery by selecting Tree view in the left pane, clicking on the BrowseGallery1, and making edits in the right formatting pane.

Add controls to the View Detail screen

  1. In the Tree view, select DetailScreen1.
  2. Select the + icon on the left side of the screen to bring up the Insert panel.
  3. Select Text Label and add labels for the Favorite Character section header and for each one of the character description fields.
  4. For each label control, change the Text property in the right-side Properties panel to describe each field.
  5. Drag the controls on the screen so they are below the header and are aligned with the center of the screen.

Connect the Detail Screen to the Star Wars API

  1. In the left pane, select the Tree view and then the BrowseGallery1 on Browsescreen1.
  2. Using the drop-down menu, select the OnSelect action that will be executed when a user selects a Fan Club member from the gallery.
  3. In the OnSelect function, we will navigate to DetailScreen1 and call the Star Wars API to get the character details for the member's favorite character.
Navigate(DetailScreen1, ScreenTransition.None);

ClearCollect(characterCollection, StarWarsAPI.getpeople({search: ThisItem.MemberFavoriteCharacter}).results);

Show the Star Wars character information on the Detail Screen

  1. For each of the description labels on DetailScreen1 , change the Text property in the right-side Properties panel to include the data from the API. For example, for the Name: label:

"Name:" & " " & First(characterCollection).name

  1. Select Play in the upper-right corner to practice using the app.