List Fields
List fields are the pieces of information about a person that you can store in ARCOS. There are three types of fields:
- System Fields: Basic fields that come standard in ARCOS, such as First Name, Last Name, Address Line 1, and Employer.
- Derived Fields: Fields that are automatically calculated by ARCOS based on other information in a person's record. For example, based on a person's contribution history, ARCOS derives the date, amount, and URL of the person's highest contribution and stores them in three fields: Maximum contribution date, Maximum contribution amount, and Maximum contribution link.
- Custom Fields: Fields specific to your organization. Custom fields might include Birthday (a date), Household Income (a number), or Parent? (a yes/no value).
System Fields
System fields are those fields that come standard in ARCOS. The data in these fields can be edited, but the name and type can not be altered.
There are 21 system fields:
- Prefix
- First Name
- Middle Name
- Last Name
- Address Line 1
- Address Line 2
- City
- State
- Country Code
- ZIP Code
- Employer
- Occupation
- Phone
- Phone 2
- Fax
- Confirmed Registration
- Record Created
- Person ID
- Username
- County
Derived Fields
Derived fields are those fields that are automatically calculated by ARCOS based on other information in a person's record. Derived fields' name and type can not be changed. You can not edit the data stored in these fields.
There are 17 derived fields:
- Maximum contribution amount
- Maximum contribution link
- Maximum contribution date
- First contribution amount
- First contribution link
- First contribution date
- Last contribution amount
- Last contribution link
- Last contribution date
- Contributions made in current year
- Contributions made in previous year
- Petitions signed in current year
- Petitions signed in previous year
- Volunteered in current year
- Volunteered in previous year
- Email Domain
- Opt-Out
Custom Fields
Custom fields are those fields that your organization has added to ARCOS. You can add, edit, and delete custom fields, upload data into those fields, or use them on forms.
All custom fields have the following properties:
- ID
-
This is the system generated id number that identifies that field. It's also used to reorder fields.
- Name
-
This is the name of the field as used in the back-end code.
- Display Name
-
This is the name of the field as displayed to the end user.
- Type
-
This is the specific input element e.g. text field, pull-down etc.
- Length
-
This is the maximum number of characters allowed in each text field.
To Add a Custom List Field
To create a new custom field, click the Add List Field button at the top of the List Fields page. This takes you to the New List Field page.
The input types are:
- Alphanumeric
-
A single-line text input field of up to 255 characters. This is a good field type to use for text data you expect to be short, such as "Nickname" or "Spouse's Employer."
- Alphanumeric (Large)
-
A multi-line text input field for 256 characters or more. This is a good field type to use for open-ended or essay responses on surveys or other forms.
- Currency
-
A dollar amount
- Date
-
A date
- Enumerated
-
Values you input for an enumerated field get displayed as a dropdown on your web forms. This is a good field type to use when you know all possible responses and want to let people pick just one, e.g. "What type of meal would you like?" where the dropdown options might be Beef, Chicken, Fish, and Vegetarian.
- File Upload
-
Gives your site visitors the ability to upload files tied to their record (e.g., their resume). You select the maximum size and file types allowed.
- Number (Any)
-
A number that may have a decimal
- Number (Whole)
-
A number with no decimal (a whole number)
- True/False
-
A true/false checkbox. Note: If you are uploading True/False data using List Upload, these values will be treated as false: 0, 0.0, F, FALSE, N, NO, and "" (i.e., no value) will be treated as false. Anything else will be treated as true.
To Edit a Custom List Field
- Click the Edit button next to the custom field.
- Make any changes you wish to the field's Name, Display Name, or Description. The Type can not be changed.
- Click the Save button.
To Delete a Custom List Field
WARNING: Deleting a custom field will permanently remove from ARCOS any data stored in that field. For example, if you have members' birthdays stored in a field named "Birthday", deleting this field will delete the members' birthdays from ARCOS.
- Place a check in the checkbox next to the custom field you wish to permanently remove.
- Click the Delete button.