Portals FAQs

Important

This article only applies to outbound marketing.

Read this article to find answers to common questions and solutions to known issues associated with using Power Apps portals in the outbound marketing area of Dynamics 365 Customer Insights.

How can I fix occasional portal issues?

Marketing pages and the event website both run on Power Apps portals. Sometimes, you may notice that settings you make in Customer Insights - Journeys aren't reflected on the portal right away, such as (for the event website): updates to banner images, speaker images, or payment gateway assignments—or, your portal may become unresponsive or otherwise unreliable. You can often solve all of these issues either by clearing the portal cache, or restarting it. It's faster to clear the cache, but restarting it will sometimes solve more or other issues.

Clear the portal cache

You can solve many portal issues by clearing the portal cache. Once you have a portal user set up and configured as an administrator, this is faster and easier than restarting the portal, though some problem may still require a restart.

The subsections below explain how to set up the required portal user and then run the clear-cache command. If you already have a portal user that's configured as an administrator, just skip ahead to Step 3: Clear the portal cache.

Step 1: Create an account on your portal

Start by adding yourself as a portal user, just as your contacts would do when registering themselves and others for an event (this is not the same as your Dynamics 365 user account). To do this:

  1. Open your event website, for example by opening any event record and selecting the globe button next to the Event URL field.
  2. On the event website, select the Sign In button at the top of the page.
  3. On the sign-in page, go to the Register tab and fill out the fields to create a new account. You must use an email address that doesn't already belong to a contact in your database. Be sure to make a note of your user name and password.
  4. The Profile page opens. Enter your first and last names in the fields provided and select Update.
  5. Your account is now created.

Step 2: Grant your new account permission to clear the portals cache

Once you have your account and password set up, you must configure that account as an event-portal administrator. To do this:

  1. Sign into Customer Insights - Journeys and use the app selector to go to the Dynamics 365—custom app.

    The app-selector menu

  2. In the custom app, go to the area selector menu in the lower left and select Portals. Then, in the left navigation pane, go to Security > Contacts.

  3. The portal contacts page opens. Open the system-view selector menu and choose the All Contacts view.

    The system-view selector

  4. Find your portal user in the list and open it.

  5. Open the form-view selector and switch to the Portal contact form view.

    Switch to the 'Portal contact' form view

  6. Go to the Details tab, then scroll down to the Web Roles section.

  7. Select Add Existing Web Role to add a role, then select the magnifying glass icon to open the role menu, and finally select the Administrators Event Portal role to add that role to your contact.

    Assign the admin role

  8. Select the Add button in the bottom corner. Your user account is now an administrator for your event website.

Step 3: Clear the portal cache

Once you have your portal-administration account set up, you can use it to clear the portal cache at any time. To do this:

  1. Open your event website, for example by opening any event record and selecting the globe button next to the Event URL field.

  2. On the event website, select the Sign In button at the top of the page.

  3. Sign in as a user that you have set up as an event-portal administrator.

  4. Enter the following URL: https://<YourPortalDomain>/_services/about where <YourPortalDomain> is the domain of your portal. You can find it by looking at the URL shown when you signed into the portal.

  5. A portal-administration page opens. Select Clear cache.

    Select the Clear cache button

  6. Your portal cache is cleared, which also has the effect of signing you out of the portal.

Restart the portal

If clearing the cache didn't fix your portal issues, restarting it may help. This operation takes a bit longer than clearing cache, and your portal will be offline until the process is complete.

To restart your portal:

  1. Open the installation management area and go to Resources > Portals on the left navigation pane.

  2. Each configured portal app is listed using the name of the Dynamics 365 instance it is assigned to (so it probably doesn't have "portal" in its name), and shows a value of Configured in the Status column. Find and select your portal in the list and then select Manage in top navigation ribbon.

    Manage your portal

  3. The portals manager opens. Select Portal actions in the side panel, and then select the Restart tile to restart the portal.

    Open portal actions and then select restart

  4. You'll be asked to confirm the action. Choose Restart to continue and then allow a few minutes for the process to complete.

How can I fix my portal after changing my instance name?

The Power Platform admin center enables you to change the name of any of your instances at any time. If you do so, then the URL for the affected instance will also change to match and, as a result, your portal will no longer be configured correctly and will stop working. To fix it, you must reconfigure your portal as follows:

  1. Open the installation management area and go to Resources > Portals on the left navigation pane.

  2. Each configured portal app is listed using the name of the Dynamics 365 instance it is assigned to (so it probably doesn't have "portal" in its name), and shows a value of Configured in the Status column. Find and select your portal in the list and then select Manage top ribbon.

    Select your portal

  3. The portals manager opens. Select Portal actions in the side panel, and then select the Update Dynamics 365 URL tile to update the URL.

    Open portal actions and then update the URL

  4. You'll be asked to confirm the action. Choose Update URL to continue and then allow a few minutes for the process to complete.