[DOCU-2036] ItemProvider: Explain 'For any data source' better Created: 22/Jul/20  Updated: 22/Jul/20

Status: Open
Project: Documentation
Component/s: documentation-examples
Affects Version/s: None
Fix Version/s: None

Type: Improvement Priority: Neutral
Reporter: Christian Ringele Assignee: Unassigned
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

On this page are the itemProviders explained:
https://documentation.magnolia-cms.com/display/DOCS62/Item+providers

 

I don't understand this:

For any data source

$type class and description
currentItemProvider info.magnolia.ui.editor.CurrentItemProviderDefinition
Returns the parent node. Suitable for sub-forms only since it relies on a parent.

The explanation text "Returns the parent node." implies that it operates on (JCR?) nodes. What is meant with this, "sub-forms only since it relies on a parent." also I don't understand, which paren is meant?

 

Cause the title says: "For any datasource" which implies it will work for everything, which can't be meant.

 

Is something meant like ??:

  • you have form and sub form
  • subform needs parent data -> use this item provider as it can grab any parent data => title comes from this? "For any subSet of data" and not "ant data source".


 Comments   
Comment by Richard Gange [ 22/Jul/20 ]

In the Overview of the page it tries to clarify that a bit I think. The relation ship is the same like it was for composites in UI5

Item providers allow you to bind form views to complex nested data structures and to fine tune such bindings. For example, if a form binds a contact address as a separate sub-form (a composite field in the Magnolia 5 UI context), a Magnolia user might want to:

So, I think the answer is yes, now you can have sub forms that group similar fields or fields with a relationship, such as, an address.

HTH

Generated at Mon Feb 12 01:23:29 CET 2024 using Jira 9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b.