Overview of Enlighten 5.1 Release

1. The Redline functionality has been expanded to allow for the creation and management of Redline Projects, and their various Project Stages. Redline Layers are managed independently of Redline Projects and their associated Stages. Organizations can opt to implement the Projects method of Redline markups or continue with the standard Redline markup method.
2. The Redline functionality on the Redline Toolbar and Redline Task Pane includes the creation and management of:
   • Redline Layers can be generated for the different departments within the organization, enabling teams to create, view, and manage redline markups specific to their responsibilities throughout each project stage. Redline Notifications are setup per Layer to notify specified users or user groups by email whenever redline markups have been created or actioned. Redline Layers can be created for individual departments across the organization allowing the various teams to generate, view, and manage redline markups which are relevant to their roles and responsibilities at each stage of the project. Additionally, Redline Notifications can be configured per layer to automatically alert specific users or user groups when new redline markups are created or are updated.
     
   • Redline Collections allow redline editors to group multiple redline objects into a single, named collection. Collections are created by selecting redline objects on the map and grouping them using the Redline Pane on the selected layer. Each Redline Collection must be assigned a unique name. Collections can be associated with a specific Project or maintained independently.
     
   • Redline Projects for utilities, construction and infrastructure typically manage the improvement, modernization and expansion of infrastructure or facilities, and the project extents are defined by Enlighten Map users by drawing a polygon on the map to specify the project boundary when a new project is created. Each project includes a unique name, description, and a status of either Active or Inactive. The project's attributes can be viewed and edited via the Show Info pane. The Redline markups can now be used to represent the project requirements in terms of improvements, replacement and/or rehabilitation of utility infrastructure as well as the expansion of existing services. The creation and/or assignment of a Redline Projects is optional meaning that Redline markups can be created without selecting a Redline Project.
     
   • Project Stages  are configurable and represent the current phase in the project life-cycle and are also stored as an attribute with the individual projects. These stages are updated and maintained by assigned Project Managers as the project advances from preliminary design through to completion. To safeguard sensitive information, user permissions can be configured for each Project Stage. This ensures that only authorized users can view or interact with projects at specific stages in the life cycle.
     
   
   
3. Further enhancements for Enlighten 5.1 sees the Redline settings being moved from the web.config to the EN_SETTINGS table so that they can be edited using Enlighten's Site Administration > Configure Settings functionality without having to restart the website when parameters are updated.
4. Enlighten 5.1 introduces support for adding an ESRI Feature Service layer to the map as a remote, URL-based layer. This functionality is limited to adding a single Feature Service layer at a time per enlighten user. The feature is accessible via the Add/Manage Layers pane. 
5. In Enlighten 5.1, the hosting server can now host different versions of Enlighten React Viewer on the same server. Enlighten 5.0 React Viewer is installed in the folder C:\Program Files\OSGEO\MapGuide4\Web\www\viewer by default, and Enlighten 5.1 React Viewer is installed in the folder C:\Program Files\OSGEO\MapGuide4\Web\www\viewer5.1.0 by default. This is very useful when transitioning from one version to another where the sign-off on the new version is required before the older version is "switched off".
6. With the addition of new configuration settings in version 5.1, external users can be directed to use a different version of Enlighten which could be hosted in the cloud environment, versus a local version for office based users hosted on local servers within the organization.
7. Please consult the What's New in Enlighten 5.1 document for further details.

New Features

• [ENLIGHTEN-4588] - New functionality added to Map Administration to Manage Redline Projects, Stages, and User Permissions.
• [ENLIGHTEN-4587] - ESRI_DEFAULT_URL setting is used to store the default URL for the ESRI Feature Service to allow users to add an ESRI Feature Layer to their maps via the Add/Manage External Layers option on the Main Toolbar. All ESRI Feature Services require a paid subscription or license, so please contact ESRI for your organization's plan details.
• [ENLIGHTEN-4543] - New functionality to add ESRI Feature Service layers to the map, and to be able to modify basic style formatting. The configured REST endpoint (URL) is unique per customer and is configured as part of enlighten's site settings.
• [ENLIGHTEN-4531] - The database design has been vastly improved for changes to the Redline functionality to cater for Redline Projects, Stages and Collections.
• [ENLIGHTEN-4618] - New functionality to create Project Stages and assign users via Enlighten Administrator > User Administration > Redline. The Redline Stages determine the various project flow stages the organization's project would typically follow from preliminary design up until the project is constructed and completed. As projects progress, stakeholders may request new features, changes in requirements or adjustments to the scope.
• [ENLIGHTEN-4620] - New functionality to assign specific users to a Project via Enlighten Administrator > Map Administration > Redline > Redline Projects. To enforce project confidentiality by overriding default project role assignments, a new table EN_PROJECT_OVERRIDE is introduced. This table is designed to store user-specific role overrides for particular projects, ensuring that only explicitly authorized users can access or perform certain actions within a project, regardless of their broader role-based permissions.
• [ENLIGHTEN-4628] - Permissions to the various configured Project Stages are granted to users via User Permissions Management Redlines tab.
• [ENLIGHTEN-4647] - A new configuration setting named ENABLE_RL_PROJECT has been added to EN_SETTINGS to control whether the Redline Project functionality is enabled for the organization. This is managed as part of the Enlighten Site Administration via the Configure Settings option.
• [ENLIGHTEN-4647] - A new function called REDLINE_PROJECTS can be assigned to user groups or individual users to enable Redline Project functionality in the Manage Redline Objects pane. This feature allows users to create project extents, assign a project stage and status, and capture Redline markups specific to a selected project, based on the user group or individual user permissions granted at the project stage level.
• [ENLIGHTEN-4649] - Implemented a Password toggle visibility feature on the Login screen allowing users to switch between showing and hiding their password input, thus enhancing usability and security. If using SSO then this feature will not apply.
• [ENLIGHTEN-4655] - The permissions for the Redline Toolbar function "Remove All" can be granted to designated users through the Assign Permissions feature in the Enlighten Administrator. This is potentially a very risky function and should only be assigned to users who fully understand the impact of removing all Redline markup objects from the selected redline layer
• [ENLIGHTEN-4660] - The state of the some of the Redline Toolbar functions will be greyed out if the functionality does not apply to the selection of objects on the map.
• [ENLIGHTEN-4662] - When creating a new Project or Collection, an error message is displayed if the entered Name is not unique.
• [ENLIGHTEN-4680] - Add the functionality to create a new Project boundary using the geometry of an existing map feature object which is either a polygon, rectangle or circle object type.

Improvements

• [ENLIGHTEN-4473] - A new Setting called ADMIN_LOGOUT_USERS, which permits administrators to log users out of the system, has been added to the configuration settings. This variable must be set to True to enable the Terminate Session on the Active Users pane.
• [ENLIGHTEN-4601] - Move some of the configurable enlighten settings from the Web.config to the EN_SETTINGS table for administraor user access.
• [ENLIGHTEN-4602] - Changes made to EN_SETTINGS through the Enlighten Site Administrator are effected by clearing the cache, without requiring a restart of the IIS application pool.
• [ENLIGHTEN-4609] - The initial load time of the Enlighten website has been significantly reduced.
• [ENLIGHTEN-4621] - When setting up Plot Applications for enPlot via the Enlighten Admin enPlot functionality, the Field for any DATE tag uses the date format configured in the EN_SETTINGS Core DATEFORMAT setting. This ensures the Plot Applications use the either the International date format of dd/mm/yyyy or the US date format of mm/dd/yyyy depending on what is configured as part of the EN_SETTINGS.
• [ENLIGHTEN-4634] - The hyperlink functionality on the Show Info forms has been expanded to accept hash keys allowing the linking to individual pages in a multi-page document, i.e. Albert Rd.pdf#page=23
• [ENLIGHTEN-4636] - Introduction of the Redline Toolbar for Redline object creation and moving functionality from the Manage Redline Objects pane to the toolbar.
• [ENLIGHTEN-4649] - Implemented a Password toggle visibility feature on the Login screen allowing users to switch between showing and hiding their password input, thus enhancing usability and security. If using SSO then this feature will not apply.
• [ENLIGHTEN-4654] - The Redline Settings for RL_SYMBOL_DEFAULT and RL_SYMBOL_PREFIX in the installation scripts are intentionally left as null values and must be configured as part of the initial setup using EMC for all new installations. If the RL_SYMBOL_PREFIX is left as a null value, the map will fail to load.
• [ENLIGHTEN-4656] - A Different confirmation message is displayed when deleting redline objects on layers which is configured for Notifications to those which are not.
• [ENLIGHTEN-4657] - When deleting a Collection, different confirmation messages will display for Collections drawn on a Layer where Notifications have been configured, to a Collection drawn on a layer without Notifications cofigured.
• [ENLIGHTEN-4658] - If more than one Type of Redline object is selected for editing of properties, the Manage Redline Objects pane will display the message Multiple Redline Geometry Types selected. Select a single Geometry type to enable Change Properties and all styling functions are hidden. To continue with styling Redline objects, clear the selection and only select objects of the same type.
• [ENLIGHTEN-4678] - The Redline Layer selected in the enlighten task pane is cached so that the selected layer is retained when re-opening the Manage Redline Objects pane.
• [ENLIGHTEN-4685] - Permissible characters in the form column name headers is very short and has been extended to permit '(' , ')', '\\', '/', including spaces, underscores and alphanumerics to permit the successful export to CSV from the Show Info form.

Bug Fixes

• [ENLIGHTEN-4423] - The confirmation message for Multiple record editing on the Show Info form has been improved.
• [ENLIGHTEN-4446] - The network trace results page has been corrected to allow users to Add/Remove Parcel/Service and select the required feature objects on the map.
• [ENLIGHTEN-4565] - In the Show Info configuration form, any conversion parameters configured for any of the columns are saved correctly for both the List and Detail views.
• [ENLIGHTEN-4619] - Show Info form no longer overrides editable date fields as NULL value on posting to database. Valid dates are posted correctly.
• [ENLIGHTEN-4639] - Initial behavioural issues identified and corrected for Redline setup in Map Administration.
• [ENLIGHTEN-4641] - Show Info form behaviour corrected when updaing editable fields.
• [ENLIGHTEN-4643] - The SignalR component for the Notifications engine loads correctly.
• [ENLIGHTEN-4651] - When drawing a redline polygon markup, the undo previous option correctly steps the user back to the last point selected on the polygon.
• [ENLIGHTEN-4663] - A multip-page PDF file, exceeding 20 pages, can be used to process geo-scan images without failing.
• [ENLIGHTEN-4677] - The Manage Redline Objects pane retains the editing state after copying map feature objects or existing redline objects to new redline objects.

Tasks

• [ENLIGHTEN-4637] - All functionality pertaining to Projects, Stages and assignment of Users tested.
• [ENLIGHTEN-4640] - Sanity checks on all Redline Pallete and Toolbar functionality.
• [ENLIGHTEN-4642] - Knowledge Base article drafted to explain the SSO errors when connecting to enlighten via SSO using VPN vs RDP.
• [ENLIGHTEN-4672] - Remove the setting GEOSCAN_SERVERURL from the EN_SETTINGS, and remove all referencesfrom Admin Guide and Installation Guide as this setting is no longer required.

Known Issues

1. All external layers added during the enlighten session are temporary and are removed from the Layers pane once the enlighten session is closed. These external layers, including WMS/WFS Layers, are not available for inclusion when generating plots using the enPlot Plot Engine function , nor are the Layers available for inclusion in the QuickPlot function , both of which are available on the enlighten Toolbar.
2. There is a known issue in Enlighten 5.0 and 5.1 with the Plotting of Redline Objects on Pre-Defined Plots. Currently plotting of redline objects works for General Plots, not on Pre-Defined Plots.
3. When selecting map features on the map and viewing them in the Basic Info form, the user can scroll through the attributes for each selected feature while the feature in focus is highlighted on the map. When the user selects the Zoom to selected feature option on the Basic Form, the map is zoomed to the extents of the feature, however the selection outline on the map does not re-display correctly.