Modifying Layouts

Layouts Explained

The Layout is what defines what elements appear and their position on the page. You are required to have an Object and Elements created before you can use the Layout.
Once you have the Object and Elements created, you simply drag the elements from the fields list onto the page and position them. Save the Layout and you are done.

Modifying Layouts

1. After logging into the Subscribe-HR portal, select the Development TAB.
2. Select the Objects folder.
3. Select the Object you wish to modify the Layout of.
   If you wish to create a new object please see the documentation Creating New Objects and Creating New Elements.
4. Select the Layout SubFolder.
   You should notice a General Tab box in the centre of the screen, an Actions box, Fields box and Custom Controls box. The General Tab box is your main page.
5. Select and drag one of the fields from the Fields box into the General Tab box.
   If you do not see any elements in the Fields box you have not create any new elements for this object, or the elements have been placed on another layout.
6. Select the Save layout option from the Actions box.

You can also add New Headings and Custom HTML into Layouts. This allows you to break the form up into sections (Headings) and also create custom sections using XML and HTML. The Custom HTML tool is used in combination with the existing Create and Drop facility.

The Actions Box

The Actions box provides 5 actions that can be used within these screens. New tab, New heading, Custom HTML, Save layout and Edit javascript.

New tab

By selecting the New tab option you are creating a new page off the General page under the same Object. This is accessible via a TAB that is present on the General page.
You should notice that an empty page appears below the General page on the Layout screen. The newly created TAB will not be saved unless the page contains at least one element.

1. Select the New tab option.
2. Select and drag one field from the Fields box to the TAB.
3. Next to the word Tab in the form enter a Name for the TAB.
4. Select the Save layout option.

New heading

To add a heading.

1. Select the New heading option.
2. Drag the heading to where you would like it in the form.
3. Insert Text into the heading.
4. Select the Save layout option.

Custom HTML

Custom HTML can be used to create totally custom section where you can change the layout the fields in the form. TO add fields, you will need to write the field name into the HTML. The field names can be found in the Developer Tool, by clicking on the element name and use the "Element Field Name". Please not that this tool is for more Technically Orientated users.

1. Select the Custom HTML option.
2. Move the Custom area around in the form to the desired location.
3. Type in the require HTML.
4. Select the Save layout option.

Save layout

The Save layout option is your Save button. Whenever you make a change and move a field to another screen, remove a field, add a field.
You must select the Save layout option or your changes will no be reflected anywhere.

Edit javascript

The Edit javascript option allows you to add some custom javascript to a form. This option loads a javascript editor in which you can write your custom javascript.

1. Select the Edit javascript option.
2. Enter your javascript into the editor.
3. Select the Save layout option.

The Fields Box

The Fields box contains new elements that have been created but not yet placed in a layout.
To place an element in a layout simply select the desired field and drag this to one of the TAB pages.
Removing an element from a TAB Page
To remove an element from a TAB page select the X next to the element. This will place the element back into the Fields box.
Moving an element to another TAB Page
To move an element from one TAB Page to another, simply select and drag the element to the other TAB Page, and select the Save layout option.

Changing the Sort Order of fields on the Search

1. After logging into the Subscribe-HR portal, navigate to the Development TAB.
2. Select the Objects Folder.
3. Select the object that you wish to modify.
   Example: If you are modifying the order of fields on the Employee Property screen then search for Employee Property in the objects search.
4. Select the Layout SubFolder

Elements that have been created and flagged with Display on Search Results will appear on the search form of the object. But when they appear they will appear in natural order.
The Search Fields Display Order section under the Layout SubFolder allows the user to customise the order / position that the field appears on the search form.
By selecting the Layout SubFolder we can see the Search Fields Display Order section.
The Search Fields Display Order section is automatically populated with any elements (fields) that are flagged with Display on Search Results.

1. To change the order that the elements appear in simply drag the desired element into position.
2. Select [Save Layout].

The first element in the list will appear as the first on the search form from the left.