Merge pull request #7006 from acoumb/uibuilder-release

Umbraco UI Builder release notes and details on entity identifier type converters

Author: eshanrnh

13/umbraco-ui-builder/SUMMARY.md

@@ -46,6 +46,7 @@
   * [Child Collection Groups](collections/child-collection-groups.md)
   * [Retrieve Child Collections](collections/retrieve-child-collections.md)
 * [Related Collections](collections/related-collections.md)
+* [Entity Identifier Converters](collections/entity-identifier-converters.md)
 
 ## Searching
 

13/umbraco-ui-builder/collections/entity-identifier-converters.md

@@ -0,0 +1,36 @@
+---
+description: Using Umbraco entities as reference with an UI Builder collection
+---
+
+# Entity Identifier Converters
+
+Umbraco stores identifiers in UDI format for most Umbraco object types.
+
+You can read more about them in the [UDI Identifiers](../../umbraco-cms/reference/querying/udi-identifiers.md) section of the documentation.
+
+If you want to reference an Umbraco object in your model and retrieve its `Integer` or `Guid` value, you must convert the `UDI` value.
+
+Use one of UI Builder's converters - `EntityIdentifierToIntTypeConverter` or `EntityIdentifierToGuidTypeConverter`. Add it as a `[TypeConverterAttribute]` to your model's foreign key property.
+
+An entity that references an Umbraco object would look like this:
+
+```csharp
+    [TableName(TableName)]
+    [PrimaryKey("Id")]
+    public class MemberReview
+    {
+        public const string TableName = "MemberReview";
+
+        [PrimaryKeyColumn]
+        public int Id { get; set; }
+
+        public string Title { get; set; }
+
+        public string Content { get; set; }
+
+        [TypeConverter(typeof(EntityIdentifierToIntTypeConverter))]
+        public int MemberId { get; set; }
+    }
+```
+
+You can also create a custom type converter. UI Builder will handle data persistence automatically.

13/umbraco-ui-builder/release-notes.md

@@ -18,6 +18,10 @@ If you are upgrading to a new major version, check the breaking changes in the [
 
 This section contains the release notes for Umbraco UI Builder 13 including all changes for this version.
 
+#### [**13.2.3**](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.2.3) **(April 4th 2025)**
+
+* Removed global registration of `UDI` converters [#144](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/144) and introduced new [Entity Identifier Converters](./collections/entity-identifier-converters.md).
+
 #### [**13.2.2**](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.2.2) **(March 21st 2025)**
 
 * Fixed an issue for bulk actions that disabled the actions row on cancel [#130](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/130)

15/umbraco-ui-builder/SUMMARY.md

@@ -43,6 +43,7 @@
   * [Child Collection Groups](collections/child-collection-groups.md)
   * [Retrieve Child Collections](collections/retrieve-child-collections.md)
 * [Related Collections](collections/related-collections.md)
+* [Entity Identifier Converters](collections/entity-identifier-converters.md)
 
 ## Searching
 

15/umbraco-ui-builder/collections/entity-identifier-converters.md

@@ -0,0 +1,36 @@
+---
+description: Using Umbraco entities as reference with an UI Builder collection
+---
+
+# Entity Identifier Converters
+
+Umbraco stores identifiers in UDI format for most Umbraco object types.
+
+You can read more about them in the [UDI Identifiers](../../umbraco-cms/reference/querying/udi-identifiers.md) section of the documentation.
+
+If you want to reference an Umbraco object in your model and retrieve its `Integer` or `Guid` value, you must convert the `UDI` value.
+
+Use one of UI Builder's converters - `EntityIdentifierToIntTypeConverter` or `EntityIdentifierToGuidTypeConverter`. Add it as a `[TypeConverterAttribute]` to your model's foreign key property.
+
+An entity that references an Umbraco object would look like this:
+
+```csharp
+    [TableName(TableName)]
+    [PrimaryKey("Id")]
+    public class MemberReview
+    {
+        public const string TableName = "MemberReview";
+
+        [PrimaryKeyColumn]
+        public int Id { get; set; }
+
+        public string Title { get; set; }
+
+        public string Content { get; set; }
+
+        [TypeConverter(typeof(EntityIdentifierToIntTypeConverter))]
+        public int MemberId { get; set; }
+    }
+```
+
+You can also create a custom type converter. UI Builder will handle data persistence automatically.

15/umbraco-ui-builder/release-notes.md

@@ -18,6 +18,15 @@ If you are upgrading to a new major version, check the breaking changes in the [
 
 Below are the release notes for Umbraco UI Builder 15, detailing all changes in this version.
 
+#### [**15.1.2**](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.1.2) **(April 4th 2025)**
+
+* Removed global registration of `UDI` converters [#144](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/144), [#136](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/136), and introduced new [Entity Identifier Converters](./collections/entity-identifier-converters.md).
+* Fixed `Create` action button [#137](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/137).
+* Added collection list view refresh feature following an entity action [#139](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/139).
+* Fixed collection visibility [#134](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/134).
+* Enabled rendering of sidebar properties.
+* Fixed an issue that prevented the creation of multiple sections.
+
 #### [**15.1.1**](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.1.1) **(March 21st 2025)**
 
 * Extended `UdiConverter` with options to convert to `GUID` [#108](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/108)