Primary and Secondary Collection Specifications dialog box
For each collection specified for the form, you can specify these properties and options.
Definition properties
| Collection Property | Applies to Collection | Description and Comments |
|---|---|---|
| Collection | Primary Secondary | The name of the collection-source IDO. |
| Collection Name | Primary Secondary | A string name or literal value that is used to identify the collection in error messages and menu options. This should be a name that is appropriate for end user. |
| Custom Load Method | Primary Secondary | An IDO method for loading data into the collection. This attribute should be specified only if the standard default method of loading the collection is inadequate. This specification is usually required only in very advanced applications. |
| Method Parameters | Primary Secondary | The parameters passed to the custom load method. These may include literal values, properties, variables, or components. |
| Read Mode | Primary Secondary | The isolation level for transactions when loading the collection. This setting overrides the default value for Collection Read Mode set in the core form Process Defaults. The override applies only to the collection for which it is specified. |
Standard operations
| Collection Property | Applies to Collection | Description and Comments |
|---|---|---|
| Navigate | Secondary | The user may navigate to the first, next, previous, and last IDO item in the queried secondary collection. Primary collections use the form's standard Navigate operation. |
| Refresh | Secondary | The user may requery data into the secondary collection. Primary collections use the form's standard Refresh operation. |
| Filter | Secondary | The user may specify filter criteria for the data queried into the secondary collection. Primary collections use the form's standard Filter operation. |
| New/Copy | Secondary | The user may create a new IDO item in the secondary collection. Primary collections use the form's standard New/Copy operation. |
| Save | Secondary | The user may save changes made to IDO items in the secondary collection. Primary collections use the form's standard Save operation. |
| Delete | Secondary | The user may delete IDO items in the secondary collection. Primary collections use the form's standard Delete operation. |
| Notes | Secondary | Notes may be attached to IDO items in the secondary collection. Primary collections use the form's standard Notes operation. |
| Graph | Secondary | The user may generate an ad hoc graph of the data in the secondary collection. Primary collections use the form's standard Graph operation. |
Advanced options
| Collection Property | Applies to Collection | Description and Comments |
|---|---|---|
| Operate as Primary | Secondary | Unbound or variable-bound components are usually associated with the form's primary collection. For instance, variable-bound components are reinitialized when the user inserts a new IDO item into the primary collection. This option allows you to designate another collection to be associated with these components. |
| Reload After Save | Primary Secondary | Causes the whole collection to be refreshed after a save. |
| Reload After Child Save | Primary Secondary | Causes the parent collection to be refreshed after the child subcollection is saved. |
| Defer Refresh Until Visible | Primary Secondary | Defers querying of the collection or subcollection until components become visible to the user. This is useful for cases where subcollections or secondary collections are displayed on notebook tabs. If this property is is set to True, the collection is not queried until the user selects the tab that contains it. |
| Save One Row Per Transaction | Primary Secondary | Allows each modified row to be saved in a separate transaction, overriding the default behavior, in which all modified rows are sent to the middle tier to be processed within a single transaction. |
| Load/Save Overrides | Primary Secondary | Custom procedures for update, insert, delete, and post-query processing. |
| Record Cap Override | Primary and Secondary | Specifies a record cap for the selected collection. This number cannot exceed the WinStudio maximum record cap, if it has been specified on the Process Defaults form. |
Selection options
| Collection Property | Applies to Collection | Description and Comments |
|---|---|---|
| Filter Form | Secondary | The name of the form used to define ad hoc filter criteria. Primary collections use the form's filter form. |
| Distinct | Primary Secondary | Remove duplicate records from the returned data. If the property is set to True, the data cannot be reliably updated. It should only be used for read-only data. |
| Filter | Primary Secondary | A permanent filter that is applied to a collection. Ad hoc filter specifications set by filter forms or Filter-in-Place are added to this filter when querying the collection. |
| OrderBy | Primary Secondary | A comma-delimited list of properties that are used to sort the collection. The default order is ascending. You can specify the order of any of the properties by supplying either desc (descending) or asc (ascending) following the property name. |
| GroupBy | Primary Secondary | A comma-delimited list of properties that are passed to the IDO, which converts them to a SQL GROUP BY clause and passes them to the application database. |