Include Union Information

XML Forms Guide

Version
R2025.2.1
ft:lastEdition
2025-12-01
Include Union Information

You can create a custom form that includes fields that save an employee's union membership details. These fields are often required on custom New Hire or Candidate Hire forms. The information populates the Employment > Unions screen of People.

Start by adding the following UsedClass to the top of the custom form:

Copy
<!-- Used Class for Union -->
  <UsedClass>
    <Name>List_EmployeeUnion</Name>
    <Mode>Current</Mode>
    <AddNewInstanceIfEmpty>true</AddNewInstanceIfEmpty>
    <DefaultStatus>Insert</DefaultStatus>
  </UsedClass>

Next, use the following code sample to add union-specific fields to the form:

Copy
<!-- Union  -->
    <Panel>
      <Style>IVPanel</Style>
      <Caption>Union</Caption>
      <Row>XX</Row>
      <Column>XX</Column>
      <ColumnSpan>4</ColumnSpan>
    </Panel>
    <Grid>
      <Style />
      <Block>1</Block>
      <Row>XX</Row>
      <Column>XX</Column>
      <ColumnSpan>4</ColumnSpan>
      <RowSpan>3</RowSpan>
      <ItemSource>List_EmployeeUnion</ItemSource>
      <AuthorizationKey>All</AuthorizationKey>
      <GridColumn>
        <BindingProperty>DFUnionId</BindingProperty>
        <HeaderCaption>lblDFUnion</HeaderCaption>
        <DataProvider>Unions</DataProvider>
        <DisplayMemberPath>ShortName</DisplayMemberPath>
        <SelectedValuePath>DFUnionId</SelectedValuePath>
        <IsRequired>true</IsRequired>
      </GridColumn>
      <GridColumn>
        <BindingProperty>UnionMembershipDate</BindingProperty>
        <HeaderCaption>lblUnionMembershipDate</HeaderCaption>
        <SelectedValuePath>UnionMembershipDate</SelectedValuePath>
        <IsRequired>true</IsRequired>
      </GridColumn>
      <GridColumn>
        <BindingProperty>EffectiveStart</BindingProperty>
        <HeaderCaption>lblEffectiveStart</HeaderCaption>
        <IsRequired>true</IsRequired>
      </GridColumn>
      <GridColumn>
        <BindingProperty>EffectiveEnd</BindingProperty>
        <HeaderCaption>lblEffectiveEnd</HeaderCaption>
      </GridColumn>
    </Grid>