Skip to main content

Installation

Base Platform - Configure file size limit and file extensions​

To install Maptaskr for Dynamics 365 & Power Apps, you will need to configure the file size limit and files extensions on the base platform.

An overview of these settings can be found at the following Microsoft Learn page - Enable file attachments1.

Configure file size limit​

The file size limit is configured from the classic D365 style System Settings page. This page can be accessed from the classic style settings.

To access the classic style settings from a Model-Driven App

  • Click on the cogwheel on the top right corner of the main Dynamics 365 ribbon.
Figure 2: Advanced Settings​

Figure 2: Advanced Settings

  • In the dropdown that appeared select Advanced Settings.
  • You should now be in the classic style settings.

To access the classic style settings from the Power Platform admin center

  • Select your environment, select "Settings" from the environment ribbon.
Figure 3: Power Platform admin center - Settings​

Graphical user interface, text, application, chat or text message

  • Select the Resources drop-down and then select All legacy settings.

A picture containing graphical user interface

  • You should now be in the classic style settings.

Once you are in the classic style settings Pages

From there click on the Settings chevron on the top ribbon and select Administration located in the System column.

Figure 4: Classic - System Administration​

Graphical user interface, application, Teams

The System Settings are on the top-right of the results displayed.

Figure 5: System Settings​

In the System Settings configure the Set file size limit for attachments to 25Mb.

  1. In the System Settings window, go to the Email tab.
  2. Go to the Set file size limit for attachments section, and in the Maximum file size (in kilobytes) field, enter the value in kilobytes 25,600.
Figure 6: Configure file size limit.​

Installation Via AppSource Marketplace​

The primary way to install Maptaskr is via the Microsoft Business Application Marketplace - AppSource.

The following versions of Maptaskr can be installed to your environment

Figure 1: Maptaskr versions available via AppSource Marketplace.​

Note Installing Maptaskr from AppSource is currently only available for new installations. If you are a current Maptaskr customer or have previously installed Maptaskr into your target environment, you will receive available updates directly from the Maptaskr Team. Alternatively, please reach out to the Maptaskr Team support@maptaskr.com to request access to updates.

For the purposes of this instruction manual, we will be using our Maptaskr for Dynamics 365 offering as the example solution as the installation and configuration of Maptaskr for Power Apps will be identical unless explicitly stated.

To install either of the Maptaskr solutions to your environment -

  1. Navigate to the Maptaskr solution offering on AppSource ensuring you are logged in with the appropriate Microsoft account you wish to use for installation purposes. Click on Free trial to commence with the install if the user is logged in.

    Figure 2: AppSource Installation.​

  2. You will be taken to the Power Platform admin center and authenticated with you user account as appropriate. Select the Power Platform or D365 environment where you wish Maptaskr to be installed. Note: You must have an environment already provisioned and ready to select for Maptaskr installation.

    Figure 3: Select an environment to install Maptaskr.​

  3. The installation process will take from 20mins – 30mins. Keep this screen open and periodically refresh to check for status updates.

    Figure 4: Maptaskr installing.​

  4. Once the solution has finished installation, the status will update to Installed. At this stage you can navigate to the environment in which you choose to install Maptaskr, and in the Apps you will now see the Maptaskr app available in the Published Apps section click on Maptaskr for Dynamics or Maptaskr for Power Apps to use Maptaskr app.

    Figure 5: Maptaskr is installed and published.​

Manual Installation​

In the case where you have a Maptaskr solution file which needs to be installed manually, there are two (2) methods for installation –

  1. Installation via Power Apps Admin Portal
  2. Installation via Classic Admin Portal

Maptaskr solution files comprise of a .zip package file with the following naming convention – {ProductType}_{ReleaseType}_{Version}_Managed.zip

e.g., D365_RC_2.1.5.39_Managed.zip

{ProductType} – will either be D365 or PA for Dynamics 365 or Power Apps Premium

{ReleaseType} – will be BETA (fresh off the press – no regression testing conducted), RC (release candidate – regression testing underway) or be absent, meaning it is an app source release and has completed regression testing.

{Version} – the version number will take the form W.X.Y.Z where W is the Major build, X is the Minor build, Y is the Patch, and Z is the Build number. The following sections provide an overview of how to manually deploy the Maptaskr solution file via the available methods, you need choose only one (1) method for installation.

Installation Via Power Apps Admin​

To install Maptaskr via the Power Apps Admin Portal, navigate to https://make.powerapps.com/ and select the environment you wish to install or upgrade Maptaskr into.

Figure 6: Select Environment for Installation.​

  1. Once you have selected the correct environment, navigate to the Solution menu item in the left navigation and click on Import solution button.

    Figure 7: PowerApps method installation.​

  2. Once the Import a solution panel appears, click on Browse and select solution file you wish to import for installation.

    Figure 8: Import a solution - select the solution file.​

  3. Click Next to import the solution.

    Figure 9: Import a solution - solution file selected.​

  4. Once the file is processed, click Import to commence installation of the solution.

    Figure 10: Import a solution.​

  5. As installation occurs, you will be prompted with a notification to track the import progress.

    Figure 11: PowerApps method installation.​

  6. Once the solution has finished installation, the status will update to Installed. At this stage you can navigate to the environment in which you choose to install Maptaskr, and in the Apps you will now see the Maptaskr app available in the Published Apps section click on Maptaskr to use Maptaskr app.

    Figure 12: Maptaskr is installed and published.​

Installation Via Classic Admin Portal​

To install Maptaskr via the Classic Admin Portal, navigate to https://admin.powerplatform.microsoft.com/environments, login with an appropriate account and select the environment you wish to install or upgrade Maptaskr into.

  1. Once in the environment summary page click Open to navigate to the environments landing page.

    Figure 13: Launch environment landing page.​

  2. Once there, from the cog main navigation item in the top right, select Advanced Settings.

    Figure 14: Select Advanced Settings.​

  3. From the Settings top navigation mega menu, navigate to Solutions.

    Figure 15: Settings to Solutions.​

  4. Once at the Solutions settings screen, click Import.

    Figure 16: Classic method installation.​

    1. Choose the solution file you wish to install and then click 'Next` to progress.
      Figure 17: Choose solution file.​
    2. Validate the solution details. Click Next
      Figure 18: Validate solution file.​
    3. If you are re-installing (upgrading) in an environment that already has Maptaskr installed, you will be prompted select upgrade method. Ensure Maintain customizations (recommended) is selected and click Import.
      Figure 19: Upgrade method.​
    4. An Import customizations pop-up page will track the progress of the package installation.
      Figure 20: Import progress.​
    5. Once Installation is completed, refresh your page, and Maptaskr will be installed.
      Figure 21: Maptaskr installed.​

Footnotes​

  1. https://learn.microsoft.com/en-us/dynamics365/customer-service/enable-file-attachments ↩