HR Form Builder

The HR Form Builder allows you to create and edit the form definition, including fields, role type, authorisation levels and filters

The web part must be placed on a web part page called HRFormBuilder.aspx. If you’re creating the HRFormBuilder.aspx page you may get a message such asAn unexpected error has occurred
This is because HRFormBuilder.aspx is designed to be called from another page which passes the forms Reference Code as a parameter, e.g HRFormBuilder.aspx?REFERENCE=HOLS, allowing HR Form Builder to idenify the form to be created or amended.

Reference Code

The Reference Code is passed by the HR Form Editor web part and cannot be changed.

Form Name

The Form Name is passed by the HR Form Editor web part and can be amended.

User Role

Self Service

The employees own record is shown. The employee is identified from the Windows ID field in the HR Record.

Authorised User

Authorised Users can see records for other employees. The records and fields that they are able to view and change are dictated by the permission levels assigned in the software. The form would be used in conjunction with the Employee Search web part to select the required employee record.

Label width

The width of the form labels will be set to a proportion of the width of the resulting web part.

Form Type

Display

Users can view, but not change the information that they are presented with.

Update

Users can change the details that they are presented with. Whether the changes are immediately authorised or require further authorisation depends on the authorisation level selected.

 2 Authorisations

The default two levels of authorisation are required. The amendments are entered into the database as ‘Propose’. Users must have Propose level permissions to perform the first level of authorisation, which enters the changes into the database as ‘Authorise’. Users must have Authorise level permissions to carry out the final authorisation, which enters the changes into the database as ‘Live’.

1 Authorisations

Only one level of authorisation is required and the amendments are entered into the database as ‘Authorise’. Users must have Authorise level permissions to authorise the changes which then enters the changes into the database as ‘Live’.

0 Authorisations

The changes require no further authorisation and the amendments are immediately entered into the database as ‘Live’.

User Defined Level

The Administrator can define their own number of authorisation levels here – up to 100 levels – for each bespoke form.

Select the number of authorisation levels required from the Authorisation Level field.

If you haven’t already set up you authorisation chain, you can do it by clicking on Authorisation.

Authorisation Levels

If you’ve chosen ‘User Defined Level’ from the Form Type pulldown list you can define the number of authorisation levels required.

Authorisation

If you’ve chosen ‘User Defined Level’ from the Form Type pulldown list click Authorisation to be taken to a new page, HRFormAuthor.aspx, to define the authorisation channels.

Group Name

Groups are used to group related fields visually. Groups can be contracted or expanded (shown or hidden).

Add

Type a name for the group and click Add.

Delete

Select a group from the Order of Display list and click Delete to remove a group.

Order of Display

Use the Move Up/Move Down buttons to reorder the groups.

Include

The left hand side of the screen shows a list of available fields. If the fields should be within a Group, select the Group first. Check the fields that should be included in the form. Clicking Include will move the fields to the right hand side of the screen, in the order that they were selected. The fields on the right hand side of the screen are the fields that will be included in the form.

Exclude

Uncheck the Include field for fields no longer required on the form and click Exclude. The fields will be moved from the right hand side of the screen to the left hand side and will not be included within the form.

Move Field Up/Move Field Down

By default, fields are listed on the form in the order that they were checked. Use the Move Field Up and Move Field Down buttons to rearrange the order of the fields within their Group.

Add Header

A header is used to display text. Click Add Header, change the Field Name to something descriptive and use the Move Fields buttons to place the header above the first related field.

Edit Filter

Filters can be used to force the form to save certain data, without the need for the user to complete that field. For example, a Holiday Request form can be filtered to save the Absence Type as Holiday, negating the need for the user to select Holiday from a list of Absence Types.

Select the field to be filtered and click Edit Filter. You will be taken to HRFormFilters.aspx to create the filter.  Select the required data from the list of options and click Save. An icon will appear to show that this field is filtered. This data will be saved with the form submission.

Group Fields

Field names (labels) shown on the form can be changed. Click on the Field Name, type a new name and press Enter or Return.

Fields Included on the Form

Group

The group, if any, that this field belongs to.

Custom Field Name

The field label can be changed or deleted.

Include?

Whether the field will be include in the form.

Clear on Submit?

The user may be entering recurring information, for example mileage claims.  In this case the expense type will be constant and would benefit from not being cleared on submission, in preparation for entering the next record.

Editable?

A field can be shown on a submission form, but not be changed.  This may be relevant when using the form to edit an existing record, for example you way want the system to calculate the duration of a holiday, rather than allow the user to enter the duration, but you may want to display the duration when editing the record.

View

Clicking View will open a new window, showing you how your form will look to the users.

Save

Click Save periodically to save your work in progress and also when you’ve finished creating the form.

Close

Close will take you back to the Form Editor page, showing a list of available forms.

Ensure that you Save your work before Closing.

Make a note of the Form Reference as you’ll need this to create a web part to display your newly created form.