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.