Skip to main content

Custom Entities Configuration

Maptaskr can be configured to visualise custom entities. This section covers how to configure these entities.

Mapping Custom Entities to Maptaskr

  1. Navigate to the data sources tab under Settings from the left navigation bar.

    Figure 122: Maptaskr Settings Menu.

  2. To add a new entity, click on +New in the ribbon to add a custom entity.

    Figure 123: Ribbon Panel.

  3. A new Maptaskr data source form will appear.

    Figure 124: Data Source Form.

  4. Fill-in the required field mappings.

    Figure 125: Data Source Form Filled With Custom Entity Details.

  5. Click on Save & Close and the custom entity will be mapped to the data source.

Adding Maptaskr to a Custom Entity Form

  1. Navigate to the advanced setting page.

    Figure 126: Advanced Settings Page.

  2. Click on the drop down and navigate to solutions page.

    Figure 127: Solutions in Advanced Settings.

  3. Create a new custom solution and add the custom entity to it.

    Figure 128: Add the New Custom Entity.

  4. Navigate to main form, from the entity in the left navigation panel and click on the form that has form type set to Main.

    Figure 129: Active Forms List.

    Figure 130: Main Form.

  5. Navigate to Insert tab in the ribbon, click on the One Column tab to insert it on the form.

    Figure 131: Insert Column.

    Figure 132: Tab Added in Form.

  6. Double Click on the tab to rename it.

    Figure 133: Tab Properties.

  7. Select the section tab under the Maptaskr tab.

    Figure 134: Section.

  8. Click on the Web Resource component on the Ribbon.

    Figure 135: Web Resource.

  9. Update the web resource properties. In the general tab, on the Web resource section, set the Web resource field to: maptaskr_/app/shapeeditor.html.

    In the Field Name and Properties section, set the Name to: maptaskr_shapeeditor and the Label to maptaskr_shapeeditor.

    In the Visibility section click the checkbox Enable for Mobile: Yes.

    Figure 136: Web Resource Properties.

  10. Update the number of Rows in the Formatting tab (will be shown on the map, for best user experience use between 12-20)

    Figure 137: Formatting - Web Resource Properties.

  11. Click OK to save the web resource properties.

  12. Navigate to HOME in the ribbon and click on the Form Properties.

    Figure 138: Form Properties.

  13. In the Events tabs, in the Event list section under the Form Libraries subsection, click on Add.

    Figure 139: Form Properties.

  14. Search for the look up record maptaskr_/app/assets/lib/js/form_datasource_autocomplete.js and click on Add.

    Figure 140: Library Properties.

  15. In the Events tabs, in the Event list section under the Event Handlers subsection, click on Add and set the function to initShapeEntity for the above Maptaskr library.

  16. In the parameters section click check box Pass execution context as first parameter to Yes.

    Figure 141: Handler Properties.

    Figure 142: Final Form Properties.

  17. Click on OK to add the form property changes.

  18. Finally, click on Save and then click on Publish the changes.

    Figure 143: Save and Publish Maptaskr Form.

  19. The custom entity form now should include Maptaskr tab under the custom entity.

Adding a Dashboard Level Map to a Model-Driven App

A dashboard level map can also be added as a navigation item within a model-driven app.

  1. Log into to make.powerapps.com, select the environment you are targeting and edit the App you wish to add the map to.

  2. Click the + New top left to add page

    Figure 144: Add New Page to Model-Driven App.

  3. Select Web Resource

    Figure 145: Selecting Web Resource as the Content of the Page.

  4. Set the Title you wish to use for the navigation of the Dashboard page.

    Figure 146: Changing the Title of the Page.

  5. Set the icon in the right panel.

    Figure 147: Changing the Icon of the Page.

    Figure 148: Selecting the Icon for the Page.

  6. Move the page as required in the navigation bar.

    Figure 149: Moving Page in Navigation Bar.

  7. Save and Publish the model-driven app.

  8. Your Dashboard will be saved as a Web resource.

    Figure 150: Saved Maptaskr Dashboard.