Advanced Add-ons

Maptaskr Power Maps provides advanced add-on solutions to enhance security and automate key processes. These add-ons are optional for some deployments, but both are required when a Power Pages site uses Maptaskr-provided basemaps. They are also recommended when map layers use server-side authentication, offline cache synchronization, or portal cleanup.

Power Pages requirement

Install both the Maptaskr Power Map Flow Helpers and Maptaskr Power Map Flows solutions for Power Pages sites that use Maptaskr-provided basemaps. The Maptaskr Authentication Profile Renewal flow must be enabled, connected to Dataverse, and running successfully.

Power Pages is intentionally not granted access to authentication request records because they can contain secrets. The scheduled flow performs the authentication request server-side and stores only the resulting short-lived response for the map to consume. This prevents credentials from being exposed in browser requests on a potentially public website.

1. Flow Helpers Solution

• Purpose:
  • Enables secure server-side processing for Power Automate flows.
  • Does not expose the host URL or sensitive credentials to the client.
  • Provides C# code for secure processing, simplifying the implementation of flows.
• Why use it?
  • Protects client IDs, secrets, and tokens from being exposed to users or browsers.
  • Required for advanced security and automation features.

info

Maptaskr Power Maps requires a custom connector to utilize advanced add-on solutions. This may require approval from your cyber security team. For more information, see the custom connector documentation.

2. Flows Solution

This solution contains three pre-built Power Automate flows. You can enable whichever flows suit your requirements:

Flow 1: Maptaskr Authentication Profile Renewal

• Purpose:
  • Updates authentication tokens for your map layers.
  • Prevents clients from accessing secure tokens, client IDs, and secrets.
• When is it important?
  • Portal access to secure layers.
  • Protecting usernames or secrets.
• What does it do?
  • Runs every 15 minutes and refreshes eligible authentication profiles before their responses expire.
  • Reads protected authentication request details, calls the configured authentication endpoint, and writes the resulting response and expiry to the authentication profile.

Flow 2: OfflineCacheRefresh

• Purpose:
  • Updates offline data rows, which are then synced to offline mobile profiles.
• When is it important?
  • Keeping offline data up to date for mobile users.
  • Periodically refreshing offline data.
• What does it do?
  • Automates the refresh and sync of offline cache data.

Flow 3: CleanupShapes

• Purpose:
  • Cleans up orphaned map shapes that may be created if a user starts but does not complete a form submission.
  • Assigns correct relationships to shapes missing a related ID.
• When is it important?
  • Maintaining referential integrity for Maptaskr Power Maps shapes.
  • Minimizing orphaned shapes in your system.
• What does it do?
  • Finds and fixes shapes without relationships, ensuring data integrity.

Installation Order

1. Core Solution (mandatory for all Maptaskr Power Maps functionality)
2. Flow Helpers Solution
3. Flows Solution

All solutions use the same versioning scheme and must match. You cannot install the Flows Solution without first installing the Core Solution and Custom Connector.

If you intend to install the security or automation solutions at a later date, please ensure you have the latest version of the Core Solution installed.

Verify the Power Pages Authentication Flow

After installation:

1. Open Power Automate and locate Maptaskr Authentication Profile Renewal.
2. Confirm the flow is turned on.
3. Confirm its Dataverse connection reference is valid.
4. Run the flow or wait for its scheduled run, then confirm that the latest run succeeded.
5. Open the Power Pages site and verify that the Maptaskr basemap loads without missing-token or 403 Forbidden tile errors.

If the flow is disabled or failing, Power Pages cannot safely obtain a replacement token. Maptaskr-provided basemaps will stop loading after the previously cached token expires.

tip

The required .zip file(s) for installation can be found at the following path: "Maptaskr Power Maps for Power Apps/Releases/Downloads"