The ESM Canvas option in Dynamic Planning

Overview

The ESM Canvas allows users to perform various actions, such as listing canvases, modifying data, and saving changes according to their access permissions. The ESM Canvas offers the following key features:

• Data Saving and Formatting: The user can store and structure data in a way that facilitates deployment.
• Shared Access: Formatted data can be shared with multiple users, granting them different access levels, such as Contributor and Reviewer.

Additional features of the ESM Canvas include:

• Filter Option: Users can utilize a filter to narrow down and sort the displayed content.
• Add New Canvas: Users can create a new canvas within the platform.
• Search Functionality: Users can quickly search for specific canvases using the Ctrl+F shortcut.

The ESM Canvas landing page caters to three types of users based on their login credentials:

• Design Users (Admin users)
• Input Users (End users)
• Design + Input Access (Admin + End users)

Design Users (Admin Users)

Design users are responsible for creating the canvas. The landing page for Design users includes the following sections:

• Canvas Name: Displays the canvas name in black text without hyperlinking.
• Description: Shows the descriptions for each canvas, with text wrapping if it exceeds the column width.
• CanvasAction: Provides options for Design, Duplicate, and Delete.

Input Users (End Users)

Input users are restricted to viewing only the canvases that have been specifically deployed for them. If users have been added to the deploy page but haven't deployed a canvas, they will not be able to see that canvas listed on the listing page. The landing page for Input Users incorporates the following features:

• Canvases are hyperlinked and can be opened in a new tab.
• The landing page includes two columns: Canvas Name and Description.
• Filter option is available.
• Ability to use Ctrl+F and search for a specific canvas.

Design + Input Access (Admin + End Users)

For users with both design and input access, the landing page distinguishes between deployed and undeployed canvases. Deployed canvases are displayed in blue with hyperlinks. Users with design and input access can perform various actions on deployed canvases, including inputting data, designing the canvas, duplicating it, and deleting it. 

Undeployed canvases, on the other hand, are shown in black. Users with design and input access can still perform actions on undeployed canvases, such as designing, duplicating, and deleting them.

Prerequisites

• Contact the Planful Support team to enable the ESM Canvas flag, to access the ESM Canvas. 
• The ESM Canvas is only accessible to the Super Admin. To provide the Super Admin access, follow these steps:

1. Navigate to Maintenance > Overview.
   
2. Click User & Role Management.
   
3. Under the User section, select the required user.
   
4. Click Navigation Role and select Super Admin role.
   
5. Click Navigation Access.
6. Expand the Dynamic Planning option, and select the ESM Canvas checkbox.
7. Under ESM Canvas, you have two types of permission; select the required permission:
   1. Design: This permission allows users to design the canvas. Once the design is complete, the same user can define access for other users by granting them Input access.
   2. Input: This permission allows users to view the assigned canvas and provide their input as needed.

Login Page

To access the ESM Canvas, you need to log in to the Planful application.

In Practice: To log in to the Planful application

1. Open the Planful application, and enter the below details:
   1. Username
   2. Password
2. Click Login.
   
3. Select Your Application, and click Launch.
   

ESM Canvas Landing Page

In Practice: To access the ESM Canvas

1. Navigate to Home > Dynamic Planning > ESM Canvas.
   
2. My Canvasespage appears. The following options are available:
   1. Canvas Name
   2. Description
   3. Canvas Actions
      Note:

      The landing page view may vary based on the user's permissions when logging in.
3. Canvas Action includes the following features:
   1. Design: This option enables admins to edit the canvas. Clicking on this option will direct the admin to the design tab for making modifications.
   2. Input: This option takes users to the end-user view of the canvas and provides them access to give any input if required.
   3. Duplicate: This feature duplicates the selected template and presents a pop-up window to update the name of the duplicated template.
   4. Delete: Admins can delete the template.
      Note:

      • The Canvas Actions feature will only be visible to users with design access.
      • Optionally, you can click the fullscreen icon to expand the view and see the My Canvases page in fullscreen mode.
      
4. Click the Filter icon to filter out the canvas by Canvas Name or Description.

Creating a New Canvas

In Practice: To create a new Canvas

1. Click + New Canvas.
   
   Note:

   Design access is mandatory to access the + New Canvas tab.
2. On the Define window, enter Canvas Name and Canvas Description.
   
   Notes:

   If both the Canvas Name and Description are valid, the user with Design access will be allowed to proceed to the Design step.

   • When adding a Canvas Name, the following criteria are mandatory:
     • The Canvas Name field must be filled, as it is mandatory.
     • Duplicate names are not allowed.
     • The Canvas Name can have a maximum length of 128 characters.
     • AlphaNumeric names are allowed in the Canvas Name field.
     • Special characters are permitted in the Canvas Name field.
     • Internationalization is supported, allowing for multilingual inputs in the Canvas Name field.
   • The Description for the canvas is optional and can have the following characteristics:
     • The Description field allows a maximum length of 512 characters.
     • AlphaNumeric content is permitted in the Description field.
     • Special characters are also allowed in the Description field.
     • The Description field supports internationalization, enabling the use of different languages and character sets.
3. Click Next or Save.
   
   Note:

   The Save option saves added information, while the Next option helps users move to further steps.
4. On the Design tab, Select Model from the dropdown list.
   
5. Upon selection, all the dimensions associated with the selected model appear.
   
   Notes:

   • By default, the first model in the list will be selected.
   • All Fields are added by default in the column section.
   • Only the models already defined in SpotlightXL will be listed here.
6. You can select the Page option for the model to select the map from the available list.
   
7. Once the map is selected, the corresponding dimensions will be listed, and the user can drag and drop them to the page section.
   
   Note:

   When adding a page section, at least one dimension must be dragged and dropped into it, and only four-page dimensions are supported. Once a dimension is added, selecting at least one unique member within that dimension is mandatory.

8. You have the following OLAP options available to select a member for the added dimension:
   
   1. Selected: Only the parent member is selected.
   2. Children: Select only the children of the selected member.
   3. All Children: Select all descendants of the selected member.
   4. Select + Children: Include the selected member and only its children.
   5. Select + All Children: Include the selected member and all its descendants.
   6. Leaves: Display all descendants of the selected member that have no children.
   7. Select + Leaves: Include the selected member and its leaf descendants.
      
      Note:

      Selecting one member for each dimension is mandatory.
9. Click Save to save the template.
10. Click Next to save the template and go to the Preview page.
    
11. On the Preview page, you can validate the added columns.
    
    Note:

    Once the Design and Define steps have been fully validated, they will be marked with a green tick.
12. Enter relevant data into the Select Layout Filter field to view specific data.
    
13. Click Save Canvas.
14. Click Next.
    
15. You can add the Contributors and Reviewers on the Deploy page.
    
    Note:

    The following limitations for each user:
    Contributors: Users can input, view, analyze, update, and collaborate.
    Reviewers: Users can view, analyze, and collaborate.
16. Click Deploy.
    
    Note:

    Once the canvas is deployed, it will automatically display in blue color and appear in the My Canvas list.