Point Release v7.5.0

1st June 2023

We're pleased to announce the next point release of sharedo - version 7.5 - is in general availability as of this morning, 1st June 2023.

This release includes 51 new or enhanced features and 91 assorted defect and usability fixes. 7.5 also incorporates a roll up of new features and defects shipped in all patch releases since 7.4.0.

Feature and enhancement highlights for 7.5

A few highlights of the new features in this release - a full list is shown below.

Email UX improvements

There have been a number of enhancements around how emails are handled within the platform. 

Email failure notifications

Firstly, should an email fail to send for whatever reason, rather than silently failing with just the state of the task moving to "failed", or having to write a workflow to alert the user in some way, a new standard notification has been added to the system that will tell the user when an email they submit fails to be sent.

As with all notifications, this can be turned on and off via the notifications settings on your profile menu.

Warning when sending mail outside of the organisation

When an email is being sent from sharedo to a participant that is external to the organisation, the system can now warn the user to ensure they are aware that this is occurring. This is configured in the “Outbound Email” global feature by turning on the “Warn if sending email to external address” option, specifying the domains considered internal, and a message to show to users.

When composing the outbound email, if the recipients includes any address that is not on the internal domain list, the configured warning will be presented.

Persistence of CC/BCC preferences

A small, but time saving feature is that now, the email blade will remember your preference for whether or not to show the CC and BCC fields.

Major rework to the usability of participant controls

The control used to select email recipients has been overhauled to make composing emails faster and more intuitive. You can still choose to open the list of existing  participants to select from as before, but now, all the search and selection can be done directly within the recipient fields themselves. You can enter a free form email address just as before, or, where you choose an existing participant that does not have the necessary contact details, the system will signpost you to the appropriate place to enter it and automatically update.

Image

More intuitive “refresh content” actions when using templates

Prior to 7.5, creating an outbound email using a template, the insertion and refreshing of the template content wasn't obvious. After selecting a template to insert, the body content would be replaced, finding the button to refresh the content from the template was cumbersome, and it would replace your content with no warning should you click it after making edits.

The buttons to insert and reload from the template have been made clearer, and the system will warn you should you reload and risk losing any edits you have made.

Custom phase features

When creating workflows etc, it's generally best to rely on abstractions rather than specifics. For example, a workflow fired on phase change might check if the phase being moved to is a very specific phase. Whilst this is fine, it's not reusable or portable between work types with differing phase models. Instead, it would be better to check if the phase being moved to has some flag set against it governing the behaviour your workflow will implement. In doing so, the workflow can be fired against various types, with differing phase plans, and still behave accordingly as the phases would be marked as having a particular feature rather than checking for specific phase names.

In 7.5 we have introduced the concept of custom features, allowing you to define these flags and attach them to phases, specifically for this purpose.

From the phase plan editor, when editing a phase, you will see features that can be tagged and configured against it.

Notice the new + button on the section title. This will allow you to define your own custom phase features. Describe your feature and it's intent and click save.

You are then able to enable that feature on phases and can check these flags in workflows.

To make this even easier however, the concept has been carried through into the workflow triggers configuration, where now, for phase events, you can define the trigger to run when a phase feature is enabled rather than specifying the individual phases to trigger on. Here for example, we are defining a trigger to run a workflow on any phase change for any work type, where the phase has our “Work item abandoned” feature enabled.

Multi-stage form aggregator

Some work items involve a lot of complex data capture that can become fragmented across multiple screens. Some may be found in the participants screen, others on the key facts blade, and some in individual forms to be opened to capture discreet pieces of data.

Whilst that is fine, and process combined with data quality rules etc can ensure the correct data is captured at the right times, we may want to present a cohesive list of all the key data, showing completeness of the capture, what data is still to be done etc.

The new multiple form view aggregator widget is ideal for this purpose. It allows you to configure different sections of display content (using data composer), set visibility conditions, define ready/not ready validations (using data composer expressions), and then add calls to action (any valid menu commands) to direct users to the correct screen to complete the capture.

By composing aggregate forms and data in this way, you are able to create relatively complex, yet intuitive data capture wizards for your users. As this feature is relatively involved, a full guide will be made available.

Scorecard modeller

The underlying scorecard system has been enhanced and brought into the modelling tools to configure your own scorecards based on metrics and measures you define.

By enabling the “Scorecard” global feature and opening it, you will have access to the scorecard modelling tools to define the metrics, aggregation and resultant bands for cards and attach them to various work types. These are then managed and visualised in portals (sample above). Typical use cases include tracking risk profiles or business value.

Voice notes

You can now add the recording and play back of voice notes to work items. To begin, enable the voice notes global feature and configure how it will name the recording files, plus the maximum recording length and bit rate (quality) to record at.

Once enabled, the “Related Documents” aspect can be used on work types, and it will now have configuration to enable voice notes to be captured against work items.

With this enabled, the related documents aspect will update to allow direct recording of voice notes.

Clicking the “Record new voice note” button will open a blade to allow you to start recording and preview it once done. After doing so, the recording will be ready for upload to the work item, where it will be added to the DMS using the file naming convention defined in the feature.

The related documents aspect will also allow for playback from the list of files.

Public API for external filing integration

Several clients leverage their own filing applications to receive documents and file them into their CMS. These applications are typically built in house, or at least integrated by an in-house team. For example, PaperRiver.

To support filing into Sharedo from external applications, the public API has been extended to allow easy querying of DMS folders for a work item, to obtain the user's most recent work items, most viewed, bookmarked etc, along with other enhancements to the related documents and work item search APIs.

For more information, see the public API guide within modeller.

Finance enhancements

Several enhancements have been made to the finance system including adding the ability to support ranges across fee sections and supporting fee elements that are negative. Additional commands have been added to the menu system also to allow editing of fee estimates and actuals to be added to menus and calls to action etc.

Custom plugin enhancements

Sharedo features a plugin system to allow for extension by developers and third parties. This has been extended significantly to round out the experience and capability of the plugin infrastructure to allow for custom physical data models to implemented, custom content to be shipped (independent of the in-built IDE), and new coded start up tasks to run when a plugin is installed or updated.

Workflow enhancements

Over 10 new or enhanced features have been added to the visual workflow toolset. 

Highlights of new actions added include the ability to add  comments to work items, to be able to deliver documents via channels such as email and eSignature, the ability to name individual running instances of workflows and the capability to send and receive SMS messages.

The runtime for workflow also now has the capability to stop an executing workflow from the UI, which is also available as a workflow action. For example, during perhaps a case abandonment procedure, a workflow may need to find and stop all other running workflows against the case to stop all processing.

When defining a trigger for a workflow against an event, it is also now possible to inspect the event payload to understand what fields and data are provided in the trigger to map them to workflow fields. From the list of available events, clicking the blue “I” circle will open the list of data fields provided by that event.

Search indexing optimisation

All the lists and searches within the application are driven off an index that is optimised for dynamic searching. This index is kept in sync with the transactional data via a combination of synchronous and asynchronous mechanisms. For example, when data is updated against a work item, it is immediately reflected both in the transactional data and in the index (immediate consistency), but, given the way the index is optimised to “de-normalise” certain data fields from related data, that change can require other work items to also be refreshed in the index. This is done asynchronously (eventual consistency).

This asynchronous mechanic could, in certain circumstances, prove inefficient. Multiple consecutive updates to the same data, in a short space of time, could require discovery and re-indexing of the same related work items multiple times.

The indexer has been optimised to avoid unnecessary indexing operations. Rather than discovery potentially re-queuing the same work items multiple times, the indexer now maintains state to understand what work items are queued and when they were last re-indexed. Where data is being changed by one or more users that then would typically require the same sets of work items to be re-indexed, the indexer will intelligently ensure this is only done once.

In addition, the operation of the indexer has been tuned with an average 80% gain in throughput for batch processing (in other words, if the indexer could manage 3000 work items per minute before, it will now handle 5400 with no additional resources).

Features/Enhancements in 7.5

Full list of all feature and enhancement tickets shipped in this release:

106946 [Power BI] Convert Client Report To Use Model
106758 [Power BI] Convert Matter Report To Use Model
106947 [Power BI] Convert Settlement Report To Use Model
106623 [Power BI] Convert Tasks Report To Use Model
105826 [Action Plans] [UX] Action plan item nav count
105870 [Email] [UX] Add a system notification on email failed
105864 [Email] [UX] Add a warning if email outside of the organisation
105858 [Email] [UX] CC / BCC settings chosen by the user should be persistent for the user
105866 [Email] [UX] Enhanced UX for the email picker component
105867 [Email] [UX] Refresh content actions is not obvious
100367 [Feature flags] Add UI for adding / configuring feature flags for phases
105141 [Form Builder] Multiple Form aggregator with Progress bar widget
83427 [Scorecards] - Modeller
102063 [Voice Notes] Ability to record voice notes
102829 [Bundling] [Import Export] Support for document bundle templates in import/export
100150 [Bundling] Clone Bundle including accessing completed ones
105917 [DMS] Enhance functionality to flow user context to existing background processes
105924 [Integrations] Extend Public API to enable full featured integration with external filing applications such as Paper River
103401 [Matter Inception] Add additional resolver to spawn pipeline to use an identity if one is present; therefore enabling spawn to be triggered from workflows
105919 [SCIM] Ability to differentiate internal and external users in SCIM and allocate UserTypes based on discriminators/source
99204 [Workflow] [Toolbox] Ability to add comments
103783 [Budget Status] Support for configuring additional sections.
102867 [Finance] [Fees] Ability to support ranges across fee sections
104038 [Finance] [Fees] Menu commands
104039 [Finance] [Fees] Support fee elements that are negative (by nature)
100983 [Plugin] Support for custom tables in Plugins to enable hydration for custom models such as fee split / zego shifts
104528 [Plugins] Ability to disable plugin signature verification via a web.config flag
104385 [Plugins] Adding support for custom content and assets to be embedded and delivered from custom plugins.
105076 [Plugins] Should be able to run "startup tasks" for scenarios where plain migrations are not able to fulfil requirements
107588 [Workflow] [Document Deliver Channels] Support for eSignature channel
101200 [Workflow] [Event Trigger] - Additional Config/Parameter for form-builder-fields-updated events
103332 [Workflow] Ability to stop a workflow from the list of processes
104216 [Workflow] Delivery Channel Toolbox Item(s)
106307 [Workflow] Enhance phase change event to support additional scenarios
106372 [Workflow] Enhanced curation of participant events for visual workflow
106971 [Workflow] Event information panel
99234 [Workflow] Should be able to name individual visual workflow instances
106065 [Workflow] SMS outgoing and incoming "request/response"
99943 [Workflow] Work Instance Manipulation Toolbox Item - ability to "stop" other running workflows
98799 [Search Indexes] Efficiency Improvements for Indexing large volumes of work items
105114 [Bundling] Document bunding and generation should have a "job log" that's visible in the client
101536 [Data composer] - add ability to retrieve Statement of Work coverage dates.
100812 [Data Composer] Budget Phase History
106018 [Data Composer] Copy Calculated fields to derived work types by default with option to exclude if necessary
103916 [Data Composer] Enclosures tag is missing from Document context
106846 [DocGen] - enhance document testing page
99392 [Document Assembly] FormsEvo Feature
106508 [Document Generation] - ensure compatability with bighand smartprint add-in
104626 [Electronic Signature] Additional Docusign field support
104205 [Participants] Implement delete framework for Participant Roles
104631 Document Expectation task blade - Enable Configuration as to whether drag and drop area on blade automatic performs a phase transition on upload

Defects resolved in 7.5

Full list of issues resolved in this release:

101168 Failing phase guards throw error during automated doc delivery
106872 [Reporting SSIS] - Core incremental job does not pick up additions or changes to people tags and organisation tags
99581 [Work Item Merge] - CTA's on tasks moved to Target Matter still point at the Source matter
106914 Reassign/Delegate Task issue - participant role permissions
106377 [Core APIs] Deadlock on PeopleAPIs around save of LocationTypes
107097 [Finance] Drawdown service returning "Unable to update payment" as GetUserId is hardcoded to test SharedoId
107361 [EE Plan] Using fluent key date interface to mark date as complete doesn't always work
105890 [Chronology] Participant filter is sometimes incomplete
102028 [Chronology] Chronology header dates can be different to item dates
107012 [Payments] Raise UI event when editing bank details
100298 [Locations] Participant location being defaulted by UI, causing confusion for tags / searching
107175 [Form builder] Fields don't align with other controls on blade
105184 [Form builder] Participant picker doesn't let you add new participants
107889 [Instruction UX] View portal link missing from instruction blade toolbar
105828 [Login] Lack of header padding when theme sets a background colour
106674 [Reference Generators] Deadlock handling is sub-optimal in new sequence generation service
106444 Error message when adding a Org participant to an inbound call
105920 [Date picker] Chromes auto date filler opens and hides the Date Picker with previous date options when the date picker is close to the bottom of the widget
99977 [Key Dates] Key date changes do not get audited and Chronology feature required these to be enabled individually
103644 [Navigation] Left nav selection confusing when only two sub-items
102871 [Participant Types Modeller] - Deleting Profile Summary from User Profile Aspects throws an error
107748 [Participant UX] Close existing blades when opening a participant blade
101506 [Portal Modeller] - Ampersand character formats as '&' on various Portal components
104621 [Portal Modeller] No confirmation prompt before deletion
102381 [Security] - User without permission to send SMS still has option on Edit details blade but throws an error
106964 [Task Details] Priority flag does not bind to saved setting
107165 [Email] [UX] - Email validation issue
105146 Align iManage document entity fields with underlying iManage table defn
105138 [Participants] Show locations does not show an address if there are no lat / long
104404 SSIS - incremental job blanks out matter closed data
102154 possible bug with message 'warning - matter type not linked to an instruction'
104921 [Locations] Clicking Save more than once on a Participants Location clears the form.
105900 [UX] Blade tear off and document preview should open in bigger window
106808 [Import/Export] - Participant Role menus missing following import export
101201 [SCIM] Adding a Manager connection in the SCIM model fails
100990 [SCIM] SCIM Patch operations do not provide the displayName mapping and do not allow us to update certain aspects of the user.
104770 [Time] Links to Work Items from Time Entries in Portal Time Menu are not opening the related items
104317 [Workflow] Apostrophe in task 'Action name' causes error
106075 [Fees] Fees should be read only when a work item is closed
97767 [Finance] - Matter (Payments summary): Payment request submission resets the figures to zero in the payment summary widget
106943 [Finance] Create Invoice/Payment Request toolbox blocks do not handle transaction amount variables of zero value
106844 [Finance][Budgets] - The Budgets Status widget should allow users to select budget structures which are not applicable to the work type to facilitate configuration at an abstract level
97422 Matter (invoice / fees) - The payor participant is unlinked after the 'save' option is activated - An odd behaviour
106841 Some events are missing the curated data entries required to map them in Visual Modeller
106933 [Finance] Currency fields in Form Builder are formatted incorrectly
104757 [Finance] Invoice Transaction item is sometimes not defaulted when only one type allowed by config
106533 Add Method of contact to reporting database
107217 [EventEngine] Possible for the "process exited" event to become disconnected so roles do not recover after crashing
107371 [EventEngine] EE service can fail to start on server reboot due to slow response from sharedo
104206 [Import Export] Missing a dependency check from Search Scopes to Permissions
107218 [EventEngine] Always restart should be applied everywhere now, regardless of config
96285 [Import/Export] Participant Roles - not handling the nulling of ODS Settings Location types
106392 [Workflow] Date and Reminder Calculation Block should support variable substitution
105162 [Workflow] Editing a menu item that's mapped to a visual workflow loses the workflow variable bindings
107018 [Workflow] Prep doc block does not allow you to set the output folder or document title
105175 [Workflow] Using the "when" step with a count always triggers after 2
98666 [Import/Export][Option Sets] Issues Exporting Option Set if Matching Rule has been disassociated.
106282 [Workflow] can't select contact details using the "Load ODS Data" block in visual workflows
107840 Event Engine Node Sync can fail
105183 [DMS] - iManage - rename of file with reserved characters fails
100360 [Document Management] iManage - download / preview latest version
105832 [Imanage] Issues when using umlauts in Output File Names of Documents
105167 [Active Data Load] Organisation Participant Data Load doesn't create Locations for the Participant
105835 [Imanage] [Outlook] Emails containing an umlaut in the Output File Name are sent, but not saved.
105862 Unable to export data from ODS list views into an Excel document
105107 Legacy "Address List" aspect fails to save with invalid column errors
102847 [Workflow] If Block doesnt not allow reordering of rules AND corrupts on delete
103917 [Mentions] Error message when using mentions in task notes
104802 [Participant list] Cannot be exported
102831 [Portal] - Matter title change isn't picked up by Key Facts widget and breadcrumb until page is refreshed.
100001 [Visual Wokflow] - After deleting a plan the list of plans does not refresh automatically
100103 [Visual Wokflow] - It is possible to delete an input parameter or a variable without warning the user
100310 Key Dates which have lapsed get an error #5991
105771 IManage Linked Service - Test connection can return too many results
106020 [Budgets] Budgets should be read only when a work item is closed
103927 [Finance] [Payments] [Invoices] Cannot create a new invoice transaction item type or payment transaction item type
102443 [Import Export] Email templates are causing timeouts - performance issue
105882 Email template content blocks can result in recursive behaviour and infinite loops
108246 [Document Templates] - Import/Export breaks for template packages pre legal forms
106375 [Finance] [Budgets] Drawdown does not account for budget transaction statuses
106920 [Phase Guards] Mandatory Participants phase guard spins and cannot be created if another phase guard is present
106770 [Channels] - Inbound Email - Repository setting is saved, but not shown on user interface
106283 [Data Composer] - the collection indexer on the To/Cc/Bcc recipients lists in the Outbound and Inbound detail aspects doesn't work
106251 [Document Delivery] - availibility rules don't always load when configuring postal methods and production types
107744 [Document Templates] - handle corrupt data when trying to delete document template
106507 [Document Templates] - saving html templates throws an error when version number is greater than 99
106453 [Document Templates] - Template in emails is not selected when template is configured to not show in menus
102345 [Prep Doc] - When To party is changed any previously populated fields that are now null persist
103362 [Tag Browser] List of Connections blank for Participants selected via Document Questionnaire Participant Picker
104775 SetAbsenceDatesPrompt aspect doesn't work
106506 [Document Delivery] - delivery task ribbon menu not updated after delivery task deleted
101520 [Document Templates] - UX - Publish button on Pack blade confusing
104909 [Multi Party] - template's default output folder does not pre-populate