Adding a Layer

The Layer Gallery in the Maptaskr Power Maps app lets you organize, configure, and manage map layers for your organization. This comprehensive guide explains how to create layer groups, add new layers (from URLs or Dataverse), configure their core properties including names and descriptions, set up filtering rules, and optimize performance settings. By following these steps, you can ensure your map layers are structured, secure, and tailored to your business needs.

Layer Groups

Layer Groups help you organize related map layers. At least one group is required before adding layers.

To create or edit a Layer Group:

1. Open the Maptaskr Power Maps app and navigate to Configuration > Galleries > Layer Gallery.

2. Click Edit Groups in the heading.

3. Type the name of the new group in the text box. You can also update or delete existing groups.

4. Click Save Changes when done.

   

Adding Layers

You can add layers from a URL or from Dataverse. Each layer must belong to a group.

Adding a URL Layer

1. In the Layer Gallery, click Add Layer (top right).

2. Select the Connection tab.

3. Fill in:

   • Layer Type (ArcGIS or Azure Maps)
   • Layer Group
   • Layer URL
   • (Optional) Enable authentication if required

4. Click Query to test the connection. If successful, a success message appears.

   info

   If authentication is required, select an auth profile. Learn more

5. Go to the Details tab and complete:

Field	Description
Layer Title	The title of the layer.
Layer Description	Can be predefined by the layer query.
Layer Security	Limit access to security groups or teams.
Gallery Banner	Thumbnail image or an icon for the gallery.

6. Continue to Common Layer Configuration.

Can I change a layer url after I have added it?

Yes, you can change a layer URL. Before you do, note the following:

• If the new URL is invalid, or points to a layer with different attributes or styles, it can negatively affect your Maptaskr Power Maps configuration.

• You will need to manually re-cache offline data for this layer after changing the URL.

• If the URL points to a different data source, contains different attributes or styles, create a new layer from the Layer Gallery instead of replacing the existing one.

  warning

  This function is intended for cases where the layer URL needs to be updated due to changes in the source, such as a new server or endpoint, while keeping the same data structure and styling. Always ensure that the new URL is compatible with your existing configuration to avoid issues.

To change a layer URL:

1. Open the layer you want to update in Layer Gallery.

2. On the Connect tab, click Edit Layer URL.

3. Update the Replacement Layer URL and all child layer URLs, ensuring that no URLs are referring to your old layer URL

4. To complete the change, check the confirmation checkbox.

5. Click Save Changes.

Adding a Dataverse Layer

1. In the Layer Gallery, click Add Layer (top right).

2. Select the Connection tab.

3. Fill in:

   • Layer Type (Dataverse layer)
   • Layer Group
   • Layer Table

4. Click Query to test the connection. If successful, a success message appears.

   

   info

   If this is your first layer, create a group first. Learn more

5. Go to the Details tab and complete the fields as above.

6. Continue to Common Layer Configuration.

Common Layer Configuration

After adding a layer, configure its features and properties:

1. Select the Features tab.

2. Review available layers and enable the ones you want. Click a layer name to manage its features. Selecting the root layer applies actions to all sub-layers.

3. Configure the following options:

Feature	Description
Layer Details	Configure fundamental properties including layer name, description, filtering rules, and performance settings. Learn more
Layer Features	Enable quantization, add a description, and manage filtering. Learn more
Layer Styles	Customize styles. Enable Always use latest styles to sync with the API. Learn more
Layer Attributes	Manage attributes. Enable for Dynamics, set visibility, reorder, and adjust display type. Learn more
Layer Actions	Configure actions for events: ExecuteJs, HTTPRequest, OpenD365Modal, SetAttribute, URLNavigate. Learn more

Additional Resources

• Authentication Manager
• Layer Features
• Layer Styles
• Layer Attributes
• Layer Actions