Relatedlisting (value of type)

From JRapid

relatedlisting is a value of type attribute of action.

Contents 1 Description 2 Usage 3 Example 4 See also

Description

The relatedlisting attribute associates the action to an entity list.

Usage

<action type="relatedentity" entity=ENTITY name=NAME label=LABEL 
        Optionals:{subset=SUBSET_NAME, subsetparams=PARAMS,defaulset=DEFAULSET_NAME,defaulsetparams=PARAMS,listing=LISTING_NAME}
/>

• entity: the name of the associated entity.
• subset: the subset which will load the associated listing.
• subsetparams: the subset parameters.
• defaultset: the defaultset which will load an entity property values when opened from the associated listing.
• defaultsetparams: the defaulset parameters.
• listing: the name of the associated list.

Example

 <property name="country" label="Country" entity="Country">
   <action label="Show provinces list" type="relatedlisting" entity="Province" subset="forCountry" subsetparams="country" />
 </property>

 <entity name="Province" label="Province">
   <subset name="forCountry">
     <param name="country" entity="Country" />
     <condition field="country" value="country" />
   </subset>
   <property name="name" label="Name" display="primary" />
   <property name="country" label="Country" entity="Country" />   
 </entity>

A country property has a relatedlisting action, which refers to a province entity. Then, all the provinces associated with the country are shown in a list.

See also

• action