Tag filtering via UI, and mandatory and optional shift assignments for ESS (v0.29.0)

This new version of the Timefold Platform comes with the following improvements:

Tag filtering
: Finding the run you’re looking for has just become a lot easier. When you do a run that contains a tag, the UI will now display those tags on the model run details and overview pages. Use the “Add filter” button, or click an existing tag to filter on all runs with that tag.
Unified error responses (including Breaking Change for API)
: We have made sure error responses for all platform API endpoints now return the same format:
{ id: “string”, code: “string”, message: “string”, details: … }
. While doing so we changed the
/logs
endpoints (like
/v1/route-plans/{id}/logs
) to return a
{ details: “string” }
object. If you depended on this endpoint, this is a breaking change.
Better error reporting when uploading custom files via UI
: When you upload a custom JSON file via the Platform UI, validation errors and warnings will now be displayed in a cleaner way. We’ve moved all details to a separate dialog with the option to copy all errors and warnings as a JSON structure.
Improvements to trials
: We’re now allowing newly added Tenant admins to also extend trials of models, and we’ve improved the UX when doing so.
Displaying maximum values for resource settings
: When making configuration changes for a model, we’ll now display the maximum values for the resource settings (cpu’s, memory & threads), so it’s clear what range of options you have for the model’s configuration.
Several
bugfixes
(including a bug with the APIs to update environment variables for model configurations) and
improvements
(including loading states for models list and run details page, and opening a model’s documentation in a new tab so it’s more easily shareable and searchable).

The new version also comes with updates to these Timefold Models:

Employee Shift Scheduling (v1 | Stable)

Mandatory and optional shift assignment
: We have extended shift priorities to distinguish between
mandatory
(default) and
optional
shifts. Optional shifts are useful in scenarios when conformance with a soft constraint (e.g. a
PREFERRED
multi-day pattern rule) is more desired than having an extra shift assigned. Learn more.
Multi-day pattern rules updates
: We have added a custom move to facilitate matching of PREFERRED patterns. You may now also specify the weight of a multi-day shift pattern in the relation to the other multi-day patterns. See “Employee works preferred multi-day shift sequence pattern” rule for more information. The weight can be used to migrate from REQUIRED patterns to PREFERRED patterns with high weight, see Upgrading to the latest versions for details. Additionally we have implemented a custom move for multi-day patterns so you should see performance improvements.
Limit scope of “minutes between shift” rules
: In Employee Contracts, you can specify the minimum or maximum time between shifts with
minutesBetweenShiftsRules
. You can now provide a scope for these rules. The scope will limit which pairs of shifts the rule is applied to. The scope excludes shift pairs where the start of the later shift is after the end of the prior shift plus the scope duration. See the updated Employee Contracts guide for examples.

Field Service Routing (v1 | Stable)

Improved validation and error handling when datasets contain breaks with negative durations.
Real-time planning documentation
: We have added several guides explaining how to better handle day-to-day planning with scenarios that require the initial plan to change. The following scenarios are covered: a visit takes longer than expected, an urgent and unexpected visit must be added to the schedule, travel disruptions, the customer is unavailable, a technician is taken ill.

Launching a feature requests board

We’re launching a feature requests board to streamline the process of how we collect ideas and feature requests from customers like you. Please head to https://feedback.timefold.ai/feature-requests to see feature requests from others, upvote them, or add your own. When you upvote ideas, you’ll always be notified of changes to the status of the idea, including when it’s being worked on, and when ideas are implemented and made into a new version. Check “Feature requests” for a full overview of the process.

Please let us know if you have feedback.