Graphical Extension Setup
You specify your general COSMO Graphical Extension setup on the Graphical Extension Setup page.
To set up general Graphical Extension information
- Choose the
icon, enter Graphical Extension Setup, and then choose the related link. - On the Graphical Extension Setup page, fill in or update the fields as necessary.
General FastTab
The fields on the General FastTab are described in the following table.
| Field | Description |
|---|---|
| Enable Application Area | Makes pages and controls visible for COSMO Graphical Extension. The setting in this field in combination with the settings in the Product Configuration Management tool control the Application Areas in standard Microsoft Dynamics 365 Business Central. For more information, see Product Configuration Management Tool. |
| Web Service | Indicates whether the Web Service connection is working correctly. Updated when the Test Web Service action is run from the Actions menu. |
| Heartbeat Interval | Specifies a time interval in milliseconds in which every client periodically calls an internal function to signal its continued connection. This process ensures the system tracks which clients are actively connected and need updates. If a client fails to call the function within four consecutive intervals, it is considered inactive, and its session data is deleted. |
| Default Time Period | Determines the time period that will be used as the default in the different COSMO Graphical Extension pages. |
| Reverse Proxy URL | Specifies the OData Service URL. Set the value only if you want to specify an endpoint other than the default. The base URL must have the following syntax: http[s]://<hostname:port>/<instance>. This field is only used in On-Premises version. |
| URL Style Sheet Grid | Indicates the URL for downloading a custom CSS style sheet. The style sheets define the colors and the general appearance of the COSMO Graphical Extension control itself. |
| Style Grid Color | Indicates the default color of the grid section in the page. |
| Style Gantt Color | Indicates the default color of the Gantt section in the page. |
| Planning Horizon Start / Planning Horizon End | Limits the data used for COSMO Graphical Extension. For example, if a production order is created outside this range, COSMO Graphical Extension will ignore it completely. |
Authentication FastTab
The fields on the Authentication FastTab are described in the following table.
| Field | Description |
|---|---|
| Authentication Method | Indicates the Authentication Method that is used to allow users access to the Graphical Extension data. The options are: - None: No authentication necessary or windows built-in authentication. - NTLM: Windows built-in authentication and the NTLM option is enabled in the service tier configuration. - Basic Auth: If NAV User Password Authentication is enabled, the NavUser and the Web Service Access Key from the Users page is used. - OAuth 2.0: Enforced in the cloud environment. Standard Authentication Method in the internet. For more information, see Authentication Setup. |
| Callback URL | Indicates the callback URL that you will be redirected to after you have authorized the application. The callback URL must match the one you used during the application registration process, e.g., https://businesscentral.dynamics.com/OAuthLanding.htm for SaaS environments or http[s]://<hostname>/<instance>/OAuthLanding.htm for On-Premises environments. For more information, see Set Up Authentication Method = OAuth 2.0. |
| Authorization URL | Indicates the endpoint for the authorization server. This is used to get the authorization code, e.g., https://login.windows.net/<Your Tenant ID>/oauth2/authorize?resource=https://api.businesscentral.dynamics.com. For more information, see Set Up Authentication Method = OAuth 2.0. |
| Resource URL | The endpoint for authentication server. This is used to get the authorization, e.g., https://api.businesscentral.dynamics.com. For more information, see Set Up Authentication Method = OAuth 2.0. |
Manufacturing FastTab
The fields on the Manufacturing FastTab are described in the following table.
| Field | Description |
|---|---|
| Show Simulated Prod. Orders | Determines if simulated production orders are shown in the Graphical Extension pages. |
| Show Planned Prod. Orders | Determines if planned production orders are shown in the Graphical Extension pages. |
| Show Firm Planned Prod. Orders | Determines if firm planned production orders are shown in the Graphical Extension pages. |
| Show Released Prod. Orders | Determines if released production orders are shown in the Graphical Extension pages. |
| Show Finished Prod. Orders | Determines if finished production orders are shown in the Graphical Extension pages. |
| Prod. Order Progress Calculation Type | Specifies how the progress for a production order is calculated. The options are: - Quantity Based: Calculation is based on the total quantity and the posted output quantity. - Duration Based: Calculation is based on the posted time in relation to the predefined Run Time from the routing line. |
| No Planning Before Work Date | Determines if planning before the work date is allowed. |
| Simulated Prod. Order Color | Specifies the color of simulated production orders in the Graphical Extension pages. |
| Planned Prod. Order Color | Specifies the color of planned production orders in the Graphical Extension pages. |
| Firm Planned Prod. Order Color | Specifies the color of firm planned production orders in the Graphical Extension pages. |
| Released Prod. Order Color | Specifies the color of released production orders in the Graphical Extension pages. |
| Finished Prod. Order Color | Specifies the color of finished production orders in the Graphical Extension pages. |
| Default Routing Status | Specifies the color of routings with Routing Status = <blank> in the Graphical Prod. Order Planning view. If a custom status is added, this color will be used. |
| Planned Routing Status | Specifies the color of routings with Routing Status = Planned in the Graphical Prod. Order Planning view. |
| In Progress Routing Status | Specifies the color of routings with Routing Status = In Progress in the Graphical Prod. Order Planning view. |
| Finished Routing Status | Specifies the color of routings with Routing Status = Finished in the Graphical Prod. Order Planning view. |
| Prod. Order Sort Option | Specifies the sorting order for production orders. The options are Prod. Order No., Prod. Order Line No., Prod. Order Source No., Item No., Operation No., Status, Due Date, and Start Date-Time. |
Capacity Planning FastTab
The Capacity Planning FastTab includes fields that together determine how capacity overloads are visualized.
| Field | Description |
|---|---|
| Available Capacity Color | Specifies the color of available capacity in the Graphical Extension pages. |
| Default Capacity Color | Specifies the default capacity color in the Graphical Extension pages. |
| Percent Load Warning Level 1..3 / Load Warning Level 1..3 Color | Entering ranges in the Percent Load Warning Level X fields work with the color selected in the Load Warning Level X Color fields to show overloads in different colors based on these ranges. Examples are: - If Percent Load Warning Level 1 field is 100 and Percent Load Warning Level 2 field is 110, then the color defined in the Load Warning Level 1 Color field will be used for any capacity overloads greater than 101% and less than 110%. - If Percent Load Warning Level 2 field is 110 and Percent Load Warning Level 3 field is 150, then the color defined in the Load Warning Level 2 Color field will be used for any capacity overloads greater than 111% and less than 150%. - If the Percent Load Warning Level 3 field is 150, then the color defined in the Load Warning Level 3 Color field will be used for any capacity overloads over 150%. |
| Highlight Color | Determines the highlight color for filter views. For example, the color defined in this field will be used to indicate the time frame where the overload exists in the Graphical Prod. Order Planning page when opened from the Graphical Prod. Capacity Planning page. |
Actions
The Actions menu contains actions that are used with authentication, data rebuilding, and web service testing. Each is described in the following table.
| Menu | Action | Description |
|---|---|---|
| New | Data Encryption Management | See Prerequisite – Data Encryption. |
| Actions | About | Shows the current product version and copyright information. |
| Users | Opens the Users page where you can enter and enable users for accessing the COSMO Graphical Extension functionalities. | |
| Set OAuth Client ID & Secret | See Authentication Method = OAuth 2.0. | |
| Rebuild All Data | Rebuilds the data for all Graphical Extension modules for rendering if setup. This is necessary if setup fields like Planning Horizon or which production orders are to be displayed are changed. NOTE: After an upgrade, a rebuild of all data may be necessary to correctly visualize the data. |
|
| Rebuild Data | Rebuilds the Graphical Extension data for rendering if setup or authorization changes are made. | |
| Test Web Service | Tests if the Web Service connection is working correctly. If this action is run and the test is successful, the Web Service indicator on the General FastTab will be green and a confirmation message will open. The indicator will be red if the test is unsuccessful and a message will open. |
|
| Reset Reverse Proxy | Clears the Reverse Proxy URL field. This is necessary after migrating to the cloud. |
Feedback
Submit feedback for this page .