SubObjects are used to create multiple lines of grouped data to capture data of the property that may change in number of occurrences, depending on the property. They provide functionality to add or link a table of information with the Job card. This allows a many to one relationship between the table of information and the Job card as well as keeping all the data in the one place for easy access.
For instance, some properties may have more than one building on the land, or, you would like to capture data on every room in the building.
Fields within a Subobject work exactly the same as regular fields, and can be configured to use any of the field types and formats.
Sub Object Views
The subObject function allows the user to toggle between two different views:
Card View - Where the user can expand a subObject record from the list to view and edit the information in a Card format and collapse the Card format back to the List view.
List View - Where the fields for the subObject appear in a table grid format and the user can immediately view and edit the information for all the records at once.
Users can toggle between Card view or List view by changing the view select list at the top of the sub object, next to the label.
Card View
When a subObject is in Card View, the user will be presented with each subObject record collapsed into a single grayed out field displaying the title of the record with an arrow down button (1) beside it. This allows the user to view the title of all the subObject records in a quick glance.
The user can then edit a subObject record by clicking the arrow down button beside a field to display the editable fields of the sub object, edit the subObject record data and press the Save button to save the data or press the Save and Close button to save the data and collapse the Sub Object record view.
More subObject records can be added using the Add button.
List View
When a subObject is in List view, the user will be presented with a table grid format of editable Sub Object fields. All the fields visible on the subObject are displayed for the user to edit immediately on the screen without having to press any additional buttons.
The user can then edit one or more of the fields, then press the Save button to save the data.
More subObject records can be added using the Add button, while subObject records can be deleted using the [ X ] button.
Buttons
This section explains the functions for the buttons available for subObject views:
Expand
The Expand button is only visible when the subObject is in Card view. Clicking this button will automatically expand all subObject records to show all fields for a user to edit.
Save
When in List view, the Save button (1) appears in the bottom row of the subObject. Clicking this button will save any changes made to any of the fields for any subObject record in the table grid.
When in Card view, the Save button (3) appears in the bottom row of the subObject view and each expanded SubObject record will also have a Save button (2) available. Clicking on the Save button in the bottom row of the SubObject view will save any changes made to any of the expanded SubObject record views.
Clicking on the Save button within each SubObject record view will only save any changes made to fields within that particular SubObject record view only.
Save and Close
The Save and Close button is only visible when the SubObject is in Card view. The Save and Close button (1) appears in the bottom row of the SubObject view and each expanded SubObject record will also have a Save and Close button (2) available.
Clicking on the Save and Close button (1) in the bottom row of the SubObject view will save any changes made to any of the expanded Sub Object record views, then will immediately collapse all the record views back to the single grayed out field.
Clicking on the Save and Close button (2) within each SubObject record view will only save any changes made to fields within that particular SubObject record view only and immediately collapse that record view only back to the single grayed out field.
Add
The Add button appears in the bottom row of the SubObject regardless of the SubObject view. The Number to Add select list beside the Add button is used to allow the user to control the number of Sub Object records added with the button click.
Clicking the Add button will add the number of blank SubObject records selected in the Number to Add select list. This is generally 1 by default. If the user changes the Number to Add select list to 2, then clicks the add button, ValuePRO will add 2 new blank SubObject records.
[ X ]
The [ X ] button is only visible when the SubObject is in List view. The [ X ] button appears next to each SubObject record that is attached to the job. Clicking this button will prompt the user with the message:
Are you sure you want to delete this record? This action cannot be undone.
To confirm and delete the SubObject record and all it's data, click the OK button (2), otherwise click the Cancel button (3) to stop the deletion process.