While a person record in Slate displays all Slate standard fields and prompts by default, Slate does not display any custom fields. Custom fields can be displayed on a record by adding them to custom tabs using Form Builder.
Do not add all of the custom fields to tabs. Only fields that will be updated or referenced often while in the person record view should be placed on a custom tab. While it is possible to add multiple custom tabs to the person record, accessibility of the data is diminished when it is difficult to navigate a labyrinth of custom tabs.
Follow these steps to most effectively group and order custom fields on a custom tab. Remember to make it concise and easy to view and edit the information.
Make a list of the fields needed on custom tabs. For example:
Decide the order and which fields should be grouped together. For example:
The first step to creating a custom tab for either person or application records is to create a form. To build the form, perform the following steps:
- Select Forms on the top navigation bar.
- Select New Form. Provide the proper form configurations, including:
- Page Title: Give the form a straightforward name, such as "Details Custom Tab."
- Folder: Create a folder called "Custom Tabs" to keep forms organized.
- Status: Set the status to Confirmed/Active.
- Select Save. With the form created, select Edit Form.
- Select Edit Properties.
- Change the scope. The default scope of a form is Person.
- For a custom tab form that will appear on person records, change this scope to Person Page.
- For an applications custom tab, change the scope to Application Page.
- For a dataset custom tab, change the scope to Dataset Page, and then select the correct dataset from the Dataset list.
- Remove all of the standard Slate fields that are included on the form by default (such as name and address fields).
- Add custom fields to the form. Custom tab forms must only contain fields that are mapped to custom fields.
Remember to select compatible field types from the Form Builder palette for mapped custom fields. For example, a custom field using prompts should be added using a form tool that supports prompts (such as a Select List).
To further enhance the look of a custom tab form, group fields together in sections by adding header rows.
ImportantWhen conditional logic filters are placed on custom tab form fields and the fields are not visible to the internal user, data in these fields may be overwritten with null values. To avoid this behavior, avoid using conditional logic on custom tab fields.
Creating the Tab
Now that a Person Page, Application Page, or Dataset Page form has been created, link this form to a tab by performing the following steps:
- Select Database on the top navigation bar and select Tabs.
- Select Insert.
- Enter the following configurations in the dialog box:
- Status: Keep this setting set to Active in order for the tab to appear on records.
- Name: Give the tab a name that will appear on the tab when viewing records.
- Scope: If this tab is being added to person records, keep the scope set to Person. If the tab should appear on application records, set the scope to Application. If the tab should appear on dataset records, select Dataset.
- Form: The form menu will contain all forms with the corresponding scope (such as Person Page-scoped forms for a person-scoped tab). Select the desired form.
- Order: Custom tabs are, by default, ordered alphabetically. To override the alphabetical order, enter an order value for the custom tab.
- Read Permission (Optional): Set a read permission for the tab by selecting a permission from the list. This will cause the tab to show only for users with the selected permission.
- Write Permission (Optional): Set a write permission for the tab by selecting a permission from the list. This will allow only users with this permission to edit data on this tab when viewing a record.
- Show for Records in Population (Optional): If the tab should only appear for records in a specific population, select the population here (this setting does not apply to dataset tabs).
- Notes (Optional): Include internal notes regarding the tab, if desired.
- Select Save.
The custom tab can now be viewed on records.
Custom Person Dataset Tabs
After configuration, person and dataset-scoped custom tabs will appear on the record to the right of the standard tabs. To add, remove, or reorder custom fields, edit the custom tab form.
Custom Application Tabs
Custom application tabs links appear in the right-side pane on a record's application tab.