JDistil

Fragment Relationship

The Fragment Relationship wizard is used to establish a many-to-many or many-to-one relationship between two application fragments. Many-to-many relationships support the option of managing the relationship from both entity user interfaces.

Relationship Creation

Select the new resource wizard and choose the Fragment Relationship wizard.

Wizard Selection


Populate all required fields on the Definition wizard page. Definitions of each field are listed below the screen shot.

Fragment Relationship

Field Description
Project Workspace project where application resources will be generated.
Source Fragment: Data Object Data object associated with the source fragment.
Source Fragment: UI Attribute Attribute associated with the source fragment data object. Only valid in a many-to-many relationship and specifies the value to display when managing the relationship from the target fragment user interface.
Source Fragment: Include in View Indicates the source fragment will be included in the target fragment's view.
Configuration: Association Type of relationship to establish. Many-to-many or many-to-one relationships are available for selection.
Configuration: Bidirectional Indicates the relationship can be managed from both the source and target fragment user interfaces.
Target Fragment: Data Object Data object associated with the target fragment.
Target Fragment: UI Attribute Attribute associated with the target fragment data object. Specifies the value to display when managing the relationship from the target fragment user interface.
Target Fragment: Required Indicates the target fragment is a required field when editing a source fragment.
Target Fragment: Include in View Indicates the target fragment will be included in the source fragment's view.

Relationship Resources

The following table documents the project specific resources modified by the Fragment Relationship wizard.

Directory Resource Description
src <base-package>.configuration.FieldIds Adds relationship specific field ID constants.
src <base-package>.configuration.fragment.<fragment-name>Configuration Add fields, actions, and data object bindings supporting the fragment relationship.
src <base-package>.<fragment-name>.<fragment-name>.java Adds property supporting the fragment relationship.
src <base-package>.<fragment-name>.<fragment-name>Manager.java Adds a column binding (many-to-one) or associate binding (many-to-many) the fragment relationship.
sql app-category.txt Adds fragment specific SQL statements supporting any new code lookup categories.
sql app-entity.txt Adds SQL statements used to create a column (many-to-one) or associative table (many-to-many) supporting the fragment relationship.
sql app-security.txt Adds SQL statements used to populate security entitlements supporting the fragment relationship.
WebContent/<fragment-name> <fragment-name>.jsp/td> Adds selection component to the edit entity page supporting the fragment relationship.