Added release and upgrade notes for Forms 15.0.0-rc1

Author: AndyButland

15/umbraco-forms/developer/configuration/README.md

@@ -115,7 +115,7 @@ For illustration purposes, the following structure represents the full set of op
         "PrivateKey": "",
         "Domain": "Google",
         "VerificationUrl": "https://www.google.com/recaptcha/api/siteverify",
-        "ShowFieldValidation": false
+        "ShowFieldValidation": true
       },
       "RichText": {
         "DataTypeId": "ca90c950-0aff-4e72-b976-a30b1ac57dad"
@@ -511,11 +511,9 @@ Some customers with a locked-down production environment cannot configure the fi
 
 #### ShowFieldValidation
 
-By default the validation message returned from a failed reCAPTCHA 3 request will be displayed only in the form level validation summary.
+The validation message returned from a failed reCAPTCHA 3 request will be displayed in the form level validation summary and alongside the field.
 
-To render also at a field level, set this value to `true`.
-
-We expect to make the default value for this option `true` in Umbraco Forms 15.
+To remove rendering at the field level, set this value to `false`.
 
 ### Rich text field type configuration
 

15/umbraco-forms/release-notes.md

@@ -18,75 +18,16 @@ If you are upgrading to a new major version, you can find information about the
 
 This section contains the release notes for Umbraco Forms 14 including all changes for this version.
 
-#### [**14.1.1**](https://github.com/umbraco/Umbraco.Forms.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.1.1) **(August 6th 2024)**
+#### [**15.0.0-rc1**](https://github.com/umbraco/Umbraco.Forms.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.0) **(Tuesday 8th 2024)**
 
-* Fixed issues with entries export for Windows installations without access to a component necessary for auto-fit of Excel columns [#1259](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1259).
-* Resolved intermittent issues with display of entries list [#1256](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1256).
-* Restored access to setting option for sensitive data handling in workflows [#1262](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1262).
-* Fixed validation on saving a form without a name [#1263](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1263).
-* Fixed fallback of the localized user interface for English (GB) to English (US) [#1267](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1267).
-* Fixed issue with form block rendering from rich text content [#1268](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1268).
-* Restored the `ValueAsString` extension method on `Record`.
-
-#### [**14.1.0**](https://github.com/umbraco/Umbraco.Forms.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.1.0) **(July 23rd 2024)**
-
-{% hint style="warning" %}
-The 14.1.0 release contains minor changes to the mark-up in the following Razor files shipped with the product: `Form.cshtml`, `FieldType.RadioButtonList.cshtml`, and `FieldType.CheckBoxList.cshtml`. These changes were made to resolve issues [#1220](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1220) and [#1218](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1218).
-
-Please ensure to check the rendering of these features on website forms after the upgrade. If you need to view the files to compare changes, you can download and view the [latest](https://our.umbraco.com/FileDownload?id=24343) and [previous](https://our.umbraco.com/FileDownload?id=24339) versions.
-{% endhint %}
-
-* All issues from earlier 14.1 release candidates.
-* Ensured prevalues can be retrieved outside of an HTTP request context when they depend on a static root node [#1258](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1258).
-
-#### [**14.1.0-rc2**](https://github.com/umbraco/Umbraco.Forms.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.1.0) **(July 18th 2024)**
-
-* Added configuration option `AllowedFileUploadExtensions` to provide an "allow list" of extensions that will be accepted in file uploads via forms [#1252](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1252).
-  * Read more about this and related settings [here](developer/configuration/#allowedfileuploadextensions).
-* Allowed users without sensitive data permissions to set, but not remove, the sensitive flag on a form field [#1233](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1233).
-* Ordered select list of prevalue sources when defining prevalues for a form field.
-* Limited the field preview for a field containing prevalues.
-* Improved support for editing large, multi-page forms by retaining scroll position between views and adding a "jump to page" option [#1243](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1243).
-
-#### [**14.1.0-rc1**](https://github.com/umbraco/Umbraco.Forms.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.1.0) **(July 9th 2024)**
-
-* Added setting option for single and multiple choice fields to allow for vertical or horizontal display [#1218](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1218)
-* Updated themes such that accessibility is improved by having hidden labels remain in markup but be visually hidden [#1220](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1220).
-* Added new setting type for multiple text strings [#1217](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1217)
-* Added validation to prevent users defining an email workflow that allows the form's sender email to be defined as that entered by the user [#1210](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1210)
-* Allowed for the provision of additional data when rendering and submitting forms. When provided it will be used as a source for ["magic string" replacements](magic-strings.md). The data will be associated with the created record and made available for custom logic and update within workflows. [#578](https://github.com/umbraco/Umbraco.Forms.Issues/issues/578)
-* Added details of workflow type to edit workflow dialog [#1183](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1183)
-* Allowed for use of prevalue sources that customize based on the current form or field in backoffice editing and preview [#1221](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1221)
-* Ensured links to Umbraco pages within rich text fields used for emails are correctly parsed [#1208](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1208).
-* Added body rich text field for send email with Razor template workflow [#1198](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1198).
-* Fixed console error with blank values in the date picker field [#1241](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1241).
-* Ensured placeholders are parsed for accepted entry response from the delivery API [#1238](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1238).
-* Resolved issues with intermittent failures of the form entries table display [#1239](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1239).
-
-#### [**14.0.2**](https://github.com/umbraco/Umbraco.Forms.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.0.2) **(June 11th 2024)**
-
-* Fixed issue with upload of text file for the prevalue source based on file contents.
-
-#### [**14.0.1**](https://github.com/umbraco/Umbraco.Forms.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.0.1) **(June 6th 2024)**
-
-* Ensured local links are parsed when HTML fields are returned in the delivery API results for form definitions [#1227](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1227).
-* Restored target used to generate local configuration schema information [#1226](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1226).
-* Resolved duplicate approval occurring when the record is approved via a workflow [#1223](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1223).
-* Added some missing localization keys and translations.
-* Fixed description of management API on Swagger UI.
-* Fixed display of specific form access list for user and group security.
-
-#### [**14.0.0**](https://github.com/umbraco/Umbraco.Forms.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.0.0) **(May 30th 2024)**
-
-* Compatibility with Umbraco 14
+* Compatibility with Umbraco 15
   * See full details of breaking changes under the [Version-specific Upgrade Guide](upgrading/version-specific/).
-
-## Umbraco.Forms.Deploy
-
-#### **14.0.0** **(May 30th 2024)**
-
-* Compatibility with Umbraco 14, Forms 14 and Deploy 14.
+* Made retrieval of prevalue source values and execution of record exports asynchronous [#1285](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1285).
+* Preview of features due in 13.3 and 14.1:
+    * Option to display paging details for multi-page forms.
+    * Form picker with allowed forms managed via folders.
+    * New "form details picker" providing a single property editor for selection of form, theme and redirect.
 
 ## Legacy release notes
 
-You can find the release notes for versions out of support in the [Legacy documentation on Github](https://github.com/umbraco/UmbracoDocs/blob/umbraco-eol-versions/11/umbraco-forms/release-notes.md) and [Umbraco Forms Package page](https://our.umbraco.com/packages/developer-tools/umbraco-forms/).
+You can find the release notes for versions out of support in the [Legacy documentation on Github](https://github.com/umbraco/UmbracoDocs/blob/umbraco-eol-versions/12/umbraco-forms/release-notes.md) and [Umbraco Forms Package page](https://our.umbraco.com/packages/developer-tools/umbraco-forms/).

15/umbraco-forms/upgrading/version-specific/README.md

@@ -6,46 +6,50 @@ description: >-
 
 # Version Specific Upgrade Notes
 
-This article provides specific upgrade documentation for migrating to Umbraco Forms version 14.
+This article provides specific upgrade documentation for migrating to Umbraco Forms version 15.
 
 {% hint style="info" %}
 If you are upgrading to a minor or patch version, you can find the details about the changes in the [Release Notes](../../release-notes.md) article.
 {% endhint %}
 
 ## Version Specific Upgrade Notes History
 
-Version 14 of Umbraco Forms has a minimum dependency on Umbraco CMS core of `14.0.0`. It runs on .NET 8.
+Version 15 of Umbraco Forms has a minimum dependency on Umbraco CMS core of `15.0.0`. It runs on .NET 9.
 
 #### **Breaking changes**
 
-Version 14 contains a number of breaking changes, primarily due to the new backoffice introduced in Umbraco 14. The details are listed here:
+Version 15 contains a number of breaking changes. If you do run into any, they should be straightforward to adjust and recompile.
 
-#### **Behavior**
-
-* A new management API has been introduced at `umbraco/forms/management/api`.
-* The root of the existing delivery API used for headless/AJAX solutions has moved to `umbraco/forms/delivery/api`.
-* The HTML helper `RenderUmbracoFormDependencies` no longer renders the promises polyfill, which is not needed in modern browsers.
-* Server-side registration of content apps has been removed as this is now a client-side concern.
-* Creation of custom fields, workflow, and other provider types remains primarily a server-side task. However, they no longer require the provision of AngularJS views and controllers. Instead, these reference registered client-side manifests. For more information, see the [extending Umbraco Forms](../../developer/extending/) article.
-* With the removal of node selection by XPath support in Umbraco 14, the "Save as Umbraco node" workflow now uses [dynamic root](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/multinode-treepicker).
+For reference, the full details are listed here:
 
 #### **Configuration**
 
-* The setting `FieldSettings:TitleAndDescription:AllowUnsafeHtmlRendering` has a new default of `false`.
-* The setting `PageOptions:TrackRenderedFormsStorageMethod` has a new default of `HttpContextItems`.
+* The setting `FieldSettings:Recaptcha3:ShowFieldValidation` has a new default of `true`.
+* The setting `Options:EnableMultiPageFormSettings` has a new default of `true`.
 
-#### **Dependencies**
+#### **Asynchronous Methods**
 
-* Umbraco CMS dependency was updated to `14.0.0`.
+* `IFieldPreValueSourceType.GetPrevalues` (and the abstract method of the same name in `FieldPreValueSourceType`) is now an asynchronous method. It has an `Async` suffix.
+* `IExportType.ExportRecords` and `ExportToFile` are now asynchronous methods and have `Async` suffixes.
 
 #### **Code**
 
-The following updates describe the more significant changes to the codebase and public API:
-
-* All controllers relating to backoffice trees and editors have been removed and their functionality replaced by the management API.
-* The serialization library has been changed from `Newtonsoft.Json` to `System.Text.Json`. Among other updates this involved removing the public class `FormsJsonSerializerSettings` and replacing it with `FormsJsonSerializerOptions`.
-* The obsolete methods `GetFieldsNotDisplayed` and `Build` on `FormViewModel` have been removed.
-* The unused `RetryWorkflow` class has been removed.
+* Parameters in the `FileUpload` constructor were renamed.
+* Obsolete constructors in the classes `SendRazorEmail`, `EntryAcceptedDtoFactory`, `FormDtoFactory`, `RenderFormViewComponent`, `GetValuesByKeyPrevalueSourceController` and `UmbracoFormsController` were removed.
+* The obsolete overload on `FormFileExtensions.IsFileTypeAllowed` was removed.
+* The purposes defined for uses of `IDataProtector` were renamed to have a common prefix.
+* Unused fields `Field.Placeholder` and `FormFieldDto.Placeholder` were removed.
+* Unused `ServerVariablesParsingHandler` was removed.
+* Default implementations on the interfaces `IWorkflowFactory`, `IWorkflowRepository`, `IWorkflowService` were removed.
+* Obsolete methods on `PlaceholderParsingService` were removed.
+* Method overloads without optional parameters on `FormDtoFactory`, `EntryAcceptedDtoFactory`, `IFormRenderingService`, `IPlaceholderParsingService`, `WorkflowType`, `DictionaryExtensions` and `StringExtensions` were removed.
+* Base64 encoding was removed when storing and retrieving form state.
+* The obsolete overload of `FormViewModel.Build` was removed.
+* `UmbracoPreValuesReadOnly` constructor now has an additional parameter.
+* Due to the introduction of asynchronous behavior to `IFieldPreValueSourceType.GetPrevalues`, `FormViewModel.Build` is now also asynchronous.
+* `FormsTreeRequirement` and related classes were removed.
+* `FormRenderingService` was made internal.
+* Default implementations on `IFormThemeResolver` were removed.
 
 ## Legacy version specific upgrade notes