diff --git a/10/umbraco-workflow/release-notes.md b/10/umbraco-workflow/release-notes.md index a8fe850e59f..fba44ba70a2 100644 --- a/10/umbraco-workflow/release-notes.md +++ b/10/umbraco-workflow/release-notes.md @@ -17,6 +17,10 @@ If you are migrating from Plumber to Umbraco Workflow, see the [Migrate from Plu This section contains the release notes for Umbraco Workflow 10 including all changes for this version. +### [10.3.10](https://github.com/umbraco/Umbraco.Workflow.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.3.10) (May 10 2024) + +* Fixes an issue where Content Review notification emails failed to send due to attempting to access UmbracoContext in a hosted service [#57](https://github.com/umbraco/Umbraco.Workflow.Issues/issues/57) + ### [10.3.9] (April 23rd 2024) * Fixes an issue where SQL query generation exposed a potential injection vector. This fix was also released as a patch for Plumber v2 and v10. diff --git a/12/umbraco-workflow/release-notes.md b/12/umbraco-workflow/release-notes.md index 3d10d6c0c29..17096d88ac8 100644 --- a/12/umbraco-workflow/release-notes.md +++ b/12/umbraco-workflow/release-notes.md @@ -17,6 +17,10 @@ Check the [Version Specific Upgrade Notes](./upgrading/version-specific.md) arti This section contains the release notes for Umbraco Workflow 12 including all changes for this version. +### [12.2.7](https://github.com/umbraco/Umbraco.Workflow.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.2.7) (May 10 2024) + +* Fixes an issue where Content Review notification emails failed to send due to attempting to access UmbracoContext in a hosted service [#57](https://github.com/umbraco/Umbraco.Workflow.Issues/issues/57) + ### [12.2.6] (April 23rd 2024) * Fixes an issue where SQL query generation exposed a potential injection vector. diff --git a/13/umbraco-workflow/release-notes.md b/13/umbraco-workflow/release-notes.md index 8ef8bf16ed1..4403c1352d8 100644 --- a/13/umbraco-workflow/release-notes.md +++ b/13/umbraco-workflow/release-notes.md @@ -17,6 +17,10 @@ Check the [Version Specific Upgrade Notes](upgrading/version-specific.md) articl This section contains the release notes for Umbraco Workflow 13 including all changes for this version. +### [13.0.7](https://github.com/umbraco/Umbraco.Workflow.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.7) (May 10 2024) + +* Fixes an issue where Content Review notification emails failed to send due to attempting to access UmbracoContext in a hosted service [#57](https://github.com/umbraco/Umbraco.Workflow.Issues/issues/57) + ### [13.0.6] (April 23rd 2024) * Fixes an issue where SQL query generation exposed a potential injection vector. diff --git a/14/umbraco-workflow/SUMMARY.md b/14/umbraco-workflow/SUMMARY.md index 43192989a06..2144d4c4278 100644 --- a/14/umbraco-workflow/SUMMARY.md +++ b/14/umbraco-workflow/SUMMARY.md @@ -18,7 +18,6 @@ ## Getting Started * [Dashboards and Buttons](getting-started/dashboards-and-buttons.md) -* [Content App](getting-started/workflow-content-app.md) * [Submitting Content for Approval](getting-started/submitting-changes.md) * [Notifications](getting-started/notifications.md) * [Configuration](getting-started/configuration.md) diff --git a/14/umbraco-workflow/getting-started/images/content-app.png b/14/umbraco-workflow/getting-started/images/content-app.png deleted file mode 100644 index 312a09792dd..00000000000 Binary files a/14/umbraco-workflow/getting-started/images/content-app.png and /dev/null differ diff --git a/14/umbraco-workflow/getting-started/workflow-content-app.md b/14/umbraco-workflow/getting-started/workflow-content-app.md deleted file mode 100644 index 2355e8ed772..00000000000 --- a/14/umbraco-workflow/getting-started/workflow-content-app.md +++ /dev/null @@ -1,101 +0,0 @@ -# Content App - -Umbraco Workflow adds a [Content App](https://docs.umbraco.com/umbraco-cms/extending/content-apps) to all content nodes in the **Content** section where a workflow is enabled. The Workflow content app includes three sub-sections: - -* [Active Workflow](workflow-content-app.md#active-workflow) -* [Configuration](workflow-content-app.md#configuration) -* [History](workflow-content-app.md#history) - -![Workflow content app](../../../10/umbraco-workflow/getting-started/images/content-app.png) - -## Active Workflow - -The Active workflow sub-section provides an interface for managing workflows for the current content node. - -When the current node is pending workflow approval, the **Active workflow** sub-section displays detailed information such as: - -* Option to [approve, reject, or cancel pending workflow tasks](workflow-content-app.md#approve-reject-or-cancel-pending-workflow-tasks). -* View change description and track differences across pending and completed workflows. -* View the group responsible for approving the pending workflow. -* View pending language variant(s) workflow. -* View the workflow activity (eg. pending approval/task approvals/rejects) for the current workflow process. - -![Active Workflow sub-section](../../../10/umbraco-workflow/getting-started/images/Active-Workflow-detailed-info.png) - -You can access Active Workflows from two places - the **Content** section and the **Workflow** section (depending on your user permission). Workflow Administrators (those users with access to the Workflow section) can access workflows assigned to a different group. In the **Workflow History**, these are noted as being performed by the admin. - -### Approve, Reject, or Cancel pending workflow tasks - -#### Approve Workflow Tasks - -To approve a Workflow task, click on the **Approve** button in the Action section. - -#### Reject Workflow Tasks - -To reject a Workflow task, click on the **Reject** button in the Action section. Depending on the approval stage, the reviewer can decide where to send the rejected task. - -For first-stage approvals, the rejected task is sent back to the original editor/author. For second-stage approvals and above, the reviewer can send the rejected task either to the original editor or any other previous workflow group. - -![Reject Workflow Tasks](../../../10/umbraco-workflow/getting-started/images/assign-rejected-task.png) - -#### Cancel pending Workflow Tasks - -To cancel a pending Workflow task, click on the **Cancel** button in the Action section. - -## Configuration - -The Configuration sub-section provides an interface for configuring the content approval flow for the current node. It also displays any Inherited or Document type approval flows applied to the current content node. - -In multi-lingual sites, each variant can have its own approval flow. By default, new variants inherit the configuration set on the default language. - -For example, German variants can be approved by the German speakers group, while English variants are approved by the English speakers group. - -![Configuration sub-section](../../../10/umbraco-workflow/getting-started/images/Configuration-sub-section.png) - -### Content Approval Flow - -You can add different groups for different stages of content approval flow. Content Approval flow groups can be reordered via drag and drop. You can also apply the approval flow either for publish and unpublish workflow or only publish workflow. - -![Content approval flow](../../../10/umbraco-workflow/getting-started/images/content-approval-flow.gif) - -#### Approval Flow Types - -Approval Flows are available in three types: Content approval flow, Inherited approval flow, and Document type approval flow. - -A given content node may have all three approval flow types applied but only one will be applied as per the following order of priority: - -* **Content approval flow:** set directly on a content node via the **Configuration** section in the **Workflow** tab . This type will take priority over all others. -* **Document type approval flow:** set in the **Settings** section. This approval flow will apply to all content nodes of the selected Document Type unless the node has a Content approval flow set. This feature requires a license. -* **Inherited approval flow:** if a node has no Content approval flow set, nor a flow applied to its Document Type, Umbraco Workflow will traverse the content tree until it finds a node with a Content approval flow and will use this flow for the current change. - -![Approval Flow Types](../../../10/umbraco-workflow/getting-started/images/approval-flow-types.png) - -Review the current responsibilities for Approval Groups in the **Roles** tab of the **Approval Groups** section for **Node-based approvals** and **Document type approvals** only. For more information see the [Roles](../workflow-section/approval-groups.md#roles) section in the [Approval Groups](../workflow-section/approval-groups.md) article. - -![Approval Groups Roles](../../../10/umbraco-workflow/getting-started/images/approval-groups-roles.png) - -Document type approval flows can also include conditional stages i.e., only include **Translators** in the workflow when the **Description** property has changed. For more information on settings conditions in Document type approval flows, see the [Document type approval flows](../workflow-section/workflow-settings.md#document-type-approval-flows) section in the [Workflow Settings](../workflow-section/workflow-settings.md) article. - -Configuration cannot be modified when a content node is in a workflow process. - -#### Content reviews - -Content reviews is a tool that allows content editors to keep their content up-to-date. For more information, see the [Content reviews](../workflow-section/content-reviews.md) section. - -## History - -The History sub-section provides a chronological audit trail of workflow activity for the current node. It displays a table containing the following information: - -* Type of Publish. -* Who the workflow is requested by. -* The date the workflow was requested. -* Comments. -* Status of the workflow. - -![History sub-section](../../../10/umbraco-workflow/getting-started/images/History-sub-section.png) - -You can also **Filter** the records based on the information listed above. Additionally, you can adjust the total number of records displayed on a page. - -The **Detail** button at the end of the record displays an overlay with content similar to the Active workflow sub-section. - -![Details overlay](../../../10/umbraco-workflow/getting-started/images/Workflow-Content-app-Details-overlay.png) diff --git a/14/umbraco-workflow/release-notes.md b/14/umbraco-workflow/release-notes.md index 8ef8bf16ed1..30c37854c3f 100644 --- a/14/umbraco-workflow/release-notes.md +++ b/14/umbraco-workflow/release-notes.md @@ -15,45 +15,12 @@ Check the [Version Specific Upgrade Notes](upgrading/version-specific.md) articl ## Release History -This section contains the release notes for Umbraco Workflow 13 including all changes for this version. +This section contains the release notes for Umbraco Workflow 14 including all changes for this version. -### [13.0.6] (April 23rd 2024) +### [14.0.0](https://github.com/umbraco/Umbraco.Workflow.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.0.0) (May 30 2024) -* Fixes an issue where SQL query generation exposed a potential injection vector. - -### [13.0.5](https://github.com/umbraco/Umbraco.Workflow.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.4) (March 13th 2024) - -* Make dashboard, content app, and section registration classes public [#56](https://github.com/umbraco/Umbraco.Workflow.Issues/issues/56) -* Fixes discrepancy between a JSON property attribute value and property name in WorkflowTaskCollectionViewModel, which resulted in unexpected JSON values. - -### [13.0.4] - -* Incorrectly tagged and released as 13.0.5 🤦 - -### [13.0.3](https://github.com/umbraco/Umbraco.Workflow.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.3) (February 28th 2024) - -* Fixes issue where invariant workflows on variant content would publish previously published, but currently unpublished, variants [#52](https://github.com/umbraco/Umbraco.Workflow.Issues/issues/52). -* Fixes issue where split-view allowed publishing content without using Workflow [#53](https://github.com/umbraco/Umbraco.Workflow.Issues/issues/53). - -The above fixes introduce an updated UI for requesting workflow approvals. For more information, see the [Submitting Content for Approval](./getting-started/submitting-changes.md) article. - -### [13.0.2](https://github.com/umbraco/Umbraco.Workflow.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.2) (January 17th 2024) - -* Fixes bug where workflow submission was not respecting user's language access permissions -* Fixes bug where approval groups were not populated for new nodes using the new-node approval workflow [#51](https://github.com/umbraco/Umbraco.Workflow.Issues/issues/51) - -### [13.0.1](https://github.com/umbraco/Umbraco.Workflow.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.1) (December 20th 2023) - -* Updates internal license validation to handle licenses registered with 'UmbracoWorkflow' or 'Umbraco.Workflow' - -### [13.0.0](https://github.com/umbraco/Umbraco.Workflow.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.0) (December 14th 2023) - -* Compatibility with Umbraco 13 +* Compatibility with Umbraco 14 * For full details of breaking changes refer to the [Version Specific Upgrade Notes](upgrading/version-specific.md) -* **FEATURE** => Advanced Search dashboard. Refer to [Advanced Search dashboard](advanced-search/advanced-search-dashboard.md) for more details. -* Update to use package migrations to avoid startup exception when Workflow is installed as part of a new Umbraco installation [#48](https://github.com/umbraco/Umbraco.Workflow.Issues/issues/48) -* Fixed issue with scheduled workflows on invariant content [#49](https://github.com/umbraco/Umbraco.Workflow.Issues/issues/49) -* Introduces lazy constructor parameters to prevent database access when Workflow is installed as part of a new Umbraco install ## Legacy release notes diff --git a/14/umbraco-workflow/upgrading/version-specific.md b/14/umbraco-workflow/upgrading/version-specific.md index b2ef5bff3bb..be78b77f125 100644 --- a/14/umbraco-workflow/upgrading/version-specific.md +++ b/14/umbraco-workflow/upgrading/version-specific.md @@ -5,7 +5,7 @@ description: >- # Version Specific Upgrade Notes -This page covers specific upgrade documentation for when migrating to major 13 of Umbraco Workflow. +This page covers specific upgrade documentation for when migrating to Umbraco Workflow version 14. {% hint style="info" %} If you are upgrading to a new minor or patch version, you can find information about the breaking changes in the [Release Notes](../release-notes.md) article. @@ -13,21 +13,29 @@ If you are upgrading to a new minor or patch version, you can find information a ## Version Specific Upgrade Notes History -Version 13 of Umbraco Workflow has a minimum dependency on Umbraco CMS core of `13.0.0`. It runs on .NET 8. +Version 14 of Umbraco Workflow has a minimum dependency on Umbraco CMS core of `14.0.0`. It runs on .NET 8. #### **Breaking changes** -Version 13 is primarily a dependency update, but does remove some properties previously marked obsolete. These are not typical extension or integration points, and are listed below for reference. +Version 14 contains a number of breaking changes, primarily due to the new backoffice introduced in Umbraco 14. The details are listed here: + +#### **Behaviour** + +* A new management API has been introduced at `umbraco/workflow/management/api` + +#### **Dependencies + +* Umbraco CMS dependency was updated to `14.0.0` #### **Code** -* Removed the `Type` property from `ConfigModel` -* Removed the `Type` property from `UserGroupPermissionsPoco` -* Removed the `ScheduledDate` property from `HtmlEmailModel`. `ReleaseDate` or `ExpireDate` properties should be used instead. -* Removed the `ScheduledDate` property from `InstanceDetailViewModel`. `ReleaseDate` or `ExpireDate` properties should be used instead. -* Removed the `ScheduledDate` property from `WorkflowInstanceViewModel`. `ReleaseDate` or `ExpireDate` properties should be used instead. -* Removed the `ScheduledDate` property from `WorkflowTaskViewModel`. `ReleaseDate` or `ExpireDate` properties should be used instead. -* Removed the `SetDueDate()` method from `ContentReviewConfigPoco`. The implementation accepting the `ContentSettingsReviewModel` parameter should be used instead. +Workflow 14 includes a non-trivial number of breaking code changes, primarily related to namespace changes. The majority of these related to removing the `Implement` namespace for services, and moving appropriate models to `Umbraco.Workflow.Core.ViewModels` or `Umbraco.Workflow.Core.Interfaces`. + +* The serialization library has been changed from `Newtonsoft.Json` to `System.Text.Json`. +* Approval group identifiers changes from int to Guid. +* Workflow instance author identifier changes from int to Guid. +* Workflow task indentifiers for approving user, assigned user and actioning user change from int to Guid. +* Services return `Attempt` or `Attempt`, in line with similar changes in the CMS. ## Legacy version specific upgrade notes