Add a new question to the Frontline worker app

Completed

In this exercise, you'll create a new column in the Immunization table in Dataverse to represent a new question to ask a resident during their immunization appointment. Then, you'll add that new column as a field on the form in the Frontline worker app.

Task 1: Create a new column in your MVM In A Day environment

In this task, you'll create a new column in the Immunization table that will allow a resident to inform the frontline worker of their favorite color. This information will be tracked and later used for reporting in the Microsoft Vaccination Management command center.

  1. Launch an internet browser in InPrivate or Incognito mode and then go to Power Apps.

  2. Sign in by using the credentials that were supplied in the training for your user.

  3. Select the correct environment from the Environment dropdown menu in the upper-right corner.

    Screenshot of the Environment dropdown menu.

  4. Select Solutions on the left navigation pane.

  5. Find and open the solution that you created in 01: Post-deployment configuration.

  6. On the top menu bar, select + Add existing and then select Table.

    Screenshot of the top menu bar with Add existing selected to reveal the choices of App, Dashboard, Dialog, or Table.

  7. Search for and select the Immunization table and then select Next.

    Screenshot of the Add existing tables page with Immunization selected in the search results.

  8. Leave the boxes cleared and then select Add.

    Screenshot of the Selected tables page with the boxes for Include all components and Include table metadata left cleared.

  9. Select the newly added Immunization table and then select Edit.

    Screenshot of MVM Test Solution with the Immunization table selected and the Edit button showing on the upper edge.

  10. Select + Add column on the upper menu bar.

    Screenshot of the upper menu bar showing the Add column option.

  11. In the pop-out screen, enter Favorite Color as the Display name and then leave the other fields as defaults. Select Done.

    Screenshot of the pop-out screen with Favorite Color as the Display name.

  12. Select the Save Table button in the lower-right corner of the screen.

    Screenshot of the Immunization page with the Favorite Color table added showing the Save Table button in the lower right.

  13. Return to the solution by selecting the solution name in the breadcrumb.

    Screenshot of the breadcrumbs with the solution name MVM Test Solution.

  14. Select Publish all customizations on the upper menu bar.

    Screenshot of the upper menu bar with the Publish all customizations button.

Congratulations, you've successfully added a new field to a solution in Dataverse.

Task 2: Add the new column as a field in the Frontline worker app

In this task, you'll modify the Frontline worker app by adding a field to the form. This field will be a new question that vaccination site workers will ask residents during the vaccination process.

  1. Launch an internet browser in InPrivate or Incognito mode and then go to Power Apps.

  2. Sign in by using the credentials that were supplied in the training for your user.

  3. Select the correct environment from the Environment dropdown menu in the upper-right corner.

    Screenshot of the Environment dropdown menu with MVMInADay selected.

  4. Select Solutions on the left navigation pane and then select the solution that you've created.

  5. On the upper menu, select + Add existing > App > Canvas app.

    Screenshot of the upper menu with Add existing and App selected to reveal options for Canvas app and Model-driven app.

  6. Select Frontline worker app and then select Add.

    Screenshot of the Add existing canvas apps page with Frontline worker app selected.

  7. Select Frontline worker app and then select Edit.

    Screenshot of the MVM Test Solution with Frontline worker app selected, showing the Edit button in the upper menu bar.

  8. When the canvas app opens, select to expand the pgDose1 screen.

    Screenshot of the Screens tab in the Tree view page showing a list of screens with pgDose1 selected.

  9. Scroll down and select pgDose1ImmunizationForm and then select Edit fields on the EDIT menu.

    Screenshot of pgDose1 expanded to show a list of nested pages with pgDose1ImmunizationForm selected.

    Screenshot of pgDose1ImmunizationForm properties showing the Edit fields action link.

  10. Select Add field to add the Favorite Color field that you created in the previous task.

    Screenshot of the Fields list showing the Add field button at the top.

  11. Search for and select the "Favorite Color" field and then select Add.

    Screenshot of the Choose a field dialog box with Favorite Color selected.

  12. The Favorite Color field will now be added to the bottom of the data card and will overlap the Dose Number field.

    Screenshot of the dose number data card showing the overlapping fields.

  13. Select the Dose Number data card and drag it lower on the form so that it doesn't overlap the Favorite Color field.

    Screenshot of the dose number data card with the overlapping fields issue fixed.

  14. Select the Favorite Color label and change the font to Segoe UI 11, font size to 11, and color to black. Drag the label to the left so that it aligns with other labels on the form.

    Screenshot of the Favorite Color card with the label selected.

  15. Select the text box and change the font to Segoe UI, font size to 11, and height to 35. You can change other configurations to suit your needs.

    Screenshot of the Favorite Color card with the text box selected.

  16. Go to File > Save.

  17. Go to File > Publish > Publish this version.

  18. Select Close.

Congratulations, you've successfully added a new field to a form in the Frontline worker app.

Task 3: Test the new scenario

In this task, you'll test the new scenario by checking in and recording the vaccination details of the third resident (Kayle Lewis) that you created in 03: Registration and booking process in the Frontline worker app by using your internet browser.

  1. Launch an internet browser in InPrivate or Incognito mode and then go to Power Apps.

  2. Sign in by using the credentials that were supplied in the training for your user.

  3. Select the correct environment from the Environment dropdown menu in the upper-right corner.

    Screenshot of the Environment dropdown menu with MVMInAday selected.

  4. Select Apps on the left navigation pane.

  5. Select Frontline worker app.

  6. Go though the steps to check in another resident. Select Vaccinate now and then select Dose 1.

  7. The Favorite Color field should be added to the form. Fill out the various fields and then select Complete Vaccination.

    Screenshot of the Dose 1 page with Favorite Color set to blue, other fields filled out, and showing the Complete vaccination button.

  8. For the Do you want to mark vaccination complete for the selected patient screen, select Yes.

    Screenshot of the dialog box asking whether to mark the vaccination complete for the selected patient.

    Screenshot of the Vaccination Complete page.

  9. Return to the Vaccination site management app and then go to Registration. Under Data Sharing, a Vaccination Data Sharing Notification Log will show for each resident that you vaccinated.

    Screenshot of the Active Vaccination Data Sharing Notification Logs page.

Note

The HL7 message generation is triggered after the vaccination has been administered and the vaccinator has selected Complete vaccination in the Frontline worker app. This action creates a vaccination record in Dataverse that can be viewed in the Vaccination site management app under Vaccination. After the business logic to associate vaccination documents is complete, the Completed flag on the vaccination record is set. This action will trigger the message generation plug-in. Each message generation will create a record in the Vaccination Data Sharing Notification Log.

After the message is generated successfully, a Vaccination Data Sharing Notification Log is created for the vaccination. This log will trigger the plug-in to send the HL7 message to the state agency's immunization system. The response from the immunization system will be stored in the same record. The message generation can also be triggered by setting the Generate HL7 flag on the vaccination record in the Vaccination site management app under Vaccination. This action will allow the administrator, in case of errors when sending the data to the state, to fix data issues that pertain to vaccination and then regenerate the message.

The message structure to report the vaccination information to state healthcare agencies varies across states and countries. The message generation and sharing capability in Vaccination Management provides a template and reference design for integration with the state agency's immunization system. As an implementor, you'll need to ascertain the structure of the message that is being generated and then make necessary modifications to adapt the message structure according to the respective immunization system.

Congratulations, you tested the end-to-end scenario by vaccinating a resident, recording vaccination details with the Frontline worker app, and viewing the Vaccination Data Sharing record in the Vaccination site management app.