Configure the schedule board to open from a URL in Universal Resource Scheduling

Use URL parameters to control how the Dynamics 365 schedule board opens for users. You can copy a preconfigured board link, build and encode parameters manually, and add the URL to app navigation. Use the parameter reference to set options such as tab, map visibility, view type, view mode, start date, and column width.

Use the parameter reference to set options such as tab, map visibility, view type, view mode, start date, and column width.

Understand the URL structure

The base URL is https://<domain>/main.aspx?pagetype=webresource&webresourceName=msdyn_/ScheduleBoard/index.html?data=<parameters>

• <domain> is the domain of your organization. For example, contoso.onmicrosoft.com.
• <parameters> are URI-encoded and stringified JSON objects that include key-value pairs that define the focus of the schedule board.

Access the URL

1. Configure the schedule board as you prefer.

2. From the schedule board, select More options (…), and choose Copy link.

   

   The generated link includes the parameters currently configured on your board.

You can also construct the URL manually and extend that URL with parameters to refine the experience.

Create parameters

Use the browser console to create the parameters. Learn more in Console and DevTools in Microsoft Edge.

1. Open the console in the browser.

2. Construct the command like encodeURIComponent(JSON.stringify({parameter1: "value", parameter2: "value", ...})) and enter it in the console. For example, to show the map and set the view mode to daily, the command is: encodeURIComponent(JSON.stringify({map: "true", viewmode: "daily"})), which results in %7B%22map%22%3A%22true%22%2C%22viewmode%22%3A%22daily%22%7D.

   More parameters and values are listed in Parameter reference.

3. Append the resulting stringified object to the base URL to create a functional URL that launches the schedule board with the parameters set accordingly. For example: https://contoso.onmicrosoft.com/main.aspx?pagetype=webresource&webresourceName=msdyn_/ScheduleBoard/index.html?data=%7B%22map%22%3A%22true%22%2C%22viewmode%22%3A%22daily%22%7D.

Append parameters based on Unified Interface

Optionally, following the schedule board URL parameters, add non-encoded parameters for the Unified Interface of Dynamics 365.

The following parameters open the schedule board in a separate browser window without navigation elements: &cmdbar=false&navbar=off&newWindow=true. When you open the schedule board by using these parameters, the system automatically adds some parameters, such as forceUCI=1 and appid=<ID>.

Add parameters to a sitemap

You can customize the navigation of a model-driven app in Power Apps. Learn more in Create a model-driven app site map using the site map designer.

Use the constructed URL to add a new navigation point or override the schedule board settings path. In the URL field, enter /main.aspx?pagetype=entitylist&etn=msdyn_scheduleboardsetting and encoded parameters like ?data=%7B%22map%22%3A%22true%22%2C%22viewmode%22%3A%22daily%22%7D.

Parameter reference

Pass the following parameters to the schedule board.

• Schedule board tab

  tab : "<tab ID>"

  Get the tab IDs by using this browser query: https://<domain>/api/data/v9.1/msdyn_scheduleboardsettinges?$select=msdyn_tabname,msdyn_scheduleboardsettingid

• Map section visible

  map : "true/false"

• Schedule board view type

  viewtype : "gantt/list"

• Schedule board view mode

  viewmode : "hourly/daily/weekly/monthly"

• Start date for the schedule board

  startdate : "YYYY-MM-DD"

  The date takes the time zone configured for the schedule board. You can only define the start date in ISO format. The system sets the date to the start of the week or month that the given date is in.

• Column width

  columnwidth : "1...100"

  Changes the width of the columns for the gantt view type. Defines the percentage and gets converted based on the view mode.