UsedClass

XML Forms Guide

Version
R2024.1.1
UsedClass

The <UsedClass> tag loads an additional data source not associated with a form control. Can also be used to filter the records being loaded by a data source that is associated with a form control. See Load Additional Data Sources.

Possible values:

  • <Name> tag
  • <Mode> tag
  • <LoadCriteria> tag
  • <AddNewInstanceIfEmpty> tag

AddNewInstanceIfEmpty

The <AddNewInstanceIfEmpty> tag is used for including the Employment Agreement on custom forms.

Copy
<UsedClass>
    <Name>List_EmployeeEmploymentAgreement</Name>
    <Mode>Current</Mode>
    <AddNewInstanceIfEmpty>true</AddNewInstanceIfEmpty>
</UsedClass>

When <AddNewInstanceIfEmpty> is set to true, the form is loaded with a blank row populated on the form, if there is no existing row on the grid. This automatically populated row includes the current date in the Effective Start field, and the employee's pay group country in the Country field. If the employee does not have a pay group assigned to them, the Country code is blank and selectable. On a custom New Hire form, the Country field is not automatically populated. All other fields on the custom form are automatically populated as expected based on the values applicable to the default pay group country.