Add documentation on related collections in repositories for Umbraco UI Builder

[jemayn]

What type of issue is it? (Choose one - delete the others)

Missing documentation

What article/section is this about?

https://docs.umbraco.com/umbraco-ui-builder/13.ui-builder.latest-lts/advanced/repositories
https://docs.umbraco.com/umbraco-ui-builder/13.ui-builder.latest-lts/collections/related-collections

Describe the issue

In Umbraco UI Builder version 13.1.0 a new feature was added for related collections: https://docs.umbraco.com/umbraco-ui-builder/13.ui-builder.latest-lts/collections/related-collections

It explains pretty well how to use these related collections in the configurator, however if you use your own repository two new methods are added to the inherited class:

protected override TJunctionEntity SaveRelationImpl<TJunctionEntity>(TJunctionEntity entity)
{
    throw new NotImplementedException();
}

protected override IEnumerable<TJunctionEntity> GetRelationsByParentIdImpl<TJunctionEntity>(int parentId, string relationAlias)
{
    throw new NotImplementedException();
}

Those methods are not mentioned at all in the repository section: https://docs.umbraco.com/umbraco-ui-builder/13.ui-builder.latest-lts/advanced/repositories

I would love an example of how you should set those up, as it is not really clear to me 🙂

[sofietoft]

Thanks for reporting this @jemayn ! 💪

I'll forward it to the right people, to see if we could get some more details added about this.

[acoumb]

Hi @jemayn ,
Thank you for your input, I have updated the docs and they will be soon live.

[sofietoft]

Changes related to this has been merged: #6634

The changes will be added to version 14 and 15 as well.

With that, I'll close this issue.
Feel free to get back in touch should something come up!