Example (value of attribute)

From JRapid

First line contains the category link and the parent element or property links. It also links to sibling values.

inline is a value of embedded.

Other values are:

• detail
• grid

Contents 1 Description 2 Usage 3 Examples 4 See also

Description

1st phrase: Minimum sufficient description that identifies the result of using this value. The summary in the first row. After that, in each row, the other necessary ideas that provide the whole description. If you use bullets, remember to enter the dot at the end of each sentence.

When a property is declared as embedded inline (it must be a collection), the properties of the child entity are displayed as columns.

• The property of the child specified as childproperty will not appear as a column.
• Remove-line button will appear at the end of each line.
• Depending of the type of collection (Attribute of property) used, ordering buttons may appear next to the remove-line button.
• Displayed properties can be overridden with displayproperties (attribute of property).

(Avoid repeating concepts that belong to the parent attribute. Link to the attribute instead.)

• Embedded collections need to specify a childproperty attribute, which connects to the parent entity and plays as the "linking property" in this 1-N relation.
• Embedded collections represent weak relations, so they map to cascade="all" hibernate relations, and ondelete="cascade" at the database.

Usage

Taking the closest ancestor template (Do not use {{Property spec}}, enter Template:Property spec instead, and copy-paste here, leaving only required attributes + those attributes related to the parent attribute

<property
         name = NAME
         label = LABEL
         ...
         entity = ENTITY
         collection = COLLECTION
         embedded = (inline|detail|grid)
         childproperty = PROPERTY
         maxrows = ROWS
         minrows = ROWS
         listindex = LIST_INDEX
         listunique = LIST_UNIQUE
         setorder = SETORDER
         sort = SORT
         sortexpr = EXPR
         where = WHERE
         extendable = "extendable"
         sortable = "sortable"
         gridheader = "gridheader"
         gridvalue = "gridvalue" 
         displayproperties = PROPERTIES
         (foreach?, dynamicforeach?, ...)
</property>

Examples

Examples have an structure and need to be unique for the value. As we say for the description, they should not include nor explain concepts from the parent attribute.

• Business Rules
  • Data Model (Screenshot)
  • Data Model (XML Source)
• Screenshot of result
• Conclusion text

Business rules

• Main Company entity and a child Contact entity.
• Contacts belong only to one Company (n-1).

    <entity label="Company" menu="Main" name="Company">
        <property display="primary" label="Name" name="name"/>
        <property display="secondary" label="Contacts" name="contacts" entity="Contact" collection="set" embedded="inline" childproperty="company" extendable="extendable"/>
    </entity>

    <entity label="Contact" name="Contact">
        <property entity="Company" label="Company" name="company"/>
        <property label="First Name" name="firstName"/>
        <property label="Last Name" name="lastName"/>
        <property label="Phone" name="phone"/>
    </entity>

• We have few fields, so a column-disposition is a good way of presenting (for more columns see detail.
• We will never have many rows (for many rows consider embeddedlisting).

Here we get the child entity with its properties displayed as columns. Additionally, we get a remove-line button at the end.

See also

Most important wikiwords that appear in the article, and how they link, when needed

• embedded
• displayproperties
• extendable

Include corresponding category

[[Category:Value]]