Lists contain pre-defined options for a field, so users are limited to specified data entry.
Managing Lists requires Full Admin permissions.
You have a few options for accessing lists.
- Click on the list field and access the Field Properties Screen. Click on the link for the List the field is using.
- Click on the "edit" link located to the right of some drop down lists. A pop-up of the list management will open.
- Settings > Lists
From this screen, you are presented with a list of lists used in SAM. The lists shown are enabled and presented in alphabetical order.
List Management Screen
Sometimes, lists are used on multiple fields. At the top of the list, SAM will show all fields referencing the list.
Edit List Item
Click the "Edit" link next to the list item that you would like to modify. You can rename, or modify list attributes (if shown), then press Save. Editing a list item will update all the records referencing the list item.
List Attributes are a characteristic of the list item which affects the configuration the records with that list item as its value. Some attributes do not affect configurations, but are rather a tool for categorizing lengthy lists.
Add List Item
Name the list item, then Press Save. There is a limit on the number of characters that can be input on lists, but it's lengthy enough for short sentences.
Edit List Item Order
Use the numbered drop-down box next to the item you wish to reorder. Select the position's number and SAM will reorder the list items.
Enable/Disable List Item
Access under Advanced Options. Disabled items will not display when a user interacts with a list. Once you are past setup/implementation, we recommend using this function over Delete List Item.
Delete List Item
Click Advanced Options, then "Delete Items" link. The page will refresh and there will be "Remove" links instead of the "Edit" links next to each list item. SAM will prevent you from deleting List Items that are used in records.
Set Default List Item
Lists allow you to set a "default list item", so that list item will be selected by default when adding new records. The default List Item can be changed once set. Default List Items only work for Drop-Down Lists.
Merge List Items
Convert two list items into one. This action will replace all records that have the Merge From value with the Merged To value. This action cannot be undone, so use with caution.
1. Click Advanced Options in the side bar. Select Merge List Items.
2. Choose the Merge From and Merge To list items from the dropdown boxes.
3. Click Save. Read the pop-up Warning and click Confirm.
Edit List Name
Rename the title of the list.
Multiple list items can be added at once. This may be helpful during implementation or for new programs to SAM. Click Advanced Options > Select Bulk Insert. Select CSL (Comma Separated List) or Line-Separated as the format method for entering multiple list items. Copy/paste the items in the box. Click Save.
Disables the list from being used with any fields. Once disabled, you can re-enable using the same action.
Big Search Lists & Filters
Fields that link to lengthy lists or Big-Search-Lists that link to other Records can have a filter applied to present only specific values to the user.
For example, on the child, the Case Worker field will only list Persons that have Person type = Case Worker. If a Record is not listed in the list, open the entity’s form and add that function type to the entity.
Beneath the field entry, a hint will be shown to show users the filters applied.
Divide list into multiple columns
Open Field Properties for the list and click Number of Columns to divide List Items into. Enter the number of columns. Press Save.