Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. 7.15
  4. Manage Users
  5. Manage user attributes
  6. Create a user attribute

Create a user attribute

User attributes can be managed at the system, enterprise, or organization level. Inheritance rules can have an impact on who can use them, so verify that you are creating them at the correct organization level. For more information, see “Manage common content with inheritance” in the
BlackBerry AtHoc
 Enterprise Planning and Management Guide
.
  1. In the navigation bar, click The Settings icon.
  2. In the
    Users
     section, click
    User Attributes
    .
  3. On the
    User Attributes
     screen, click
    New
     and select one of the following attribute types:
    • Checkbox
    • Date
    • Date Time
    • Geolocation
    • Memo
    • Multi-select Picklist
    • Number
    • Single-select Picklist
    • Status
    • Text
    The New Attribute screen displays all of the fields required to create a user attribute.
  4. In the
    Name
     field, enter the name that will be displayed when the attribute appears in lists or fields in the
    BlackBerry AtHoc
     system. The attribute name has a 128 character limit.
    If the user attribute will be used for preset response options, enter “RO” before the name. Operators can identify it as a response option when publishing an alert.
  5. Optionally, in the
    Tooltip
     field, enter a hint that displays when users hover their cursor over the attribute field.
    Pop-up help text in a tooltip field
  6. Optionally, in the
    Help Text
     field, enter text that will appear under the field.
    The Help Text field
  7. Optionally, modify the
    Common Name
     value.
    The value of the Common Name field is the same as the Attribute Name value by default. You can modify the Common Name, but it is not typically changed. The common name has a 128 character limit.
  8. Select
    Users Can Update
     if users need to modify the value.
  9. Select
    Mandatory
     if the attribute is a required field in the user profile.
  10. Optionally, select
    Use as a Response Option
    .
    Only Single-select Picklist, Status, and Checkbox attribute types can be used as a response option. Attributes used as response options can have up to 9 values.
  11. In the
    Values
     section, click
    Add value
    .
    Depending on the attribute type that you selected, one of the following fields appears:
    • Length
      : For text attribute types, enter the minimum and maximum number of characters that end users must enter in the attribute field.
    • Minimum Value
       (number)/
      Maximum Value
       (number): Set the range for the field by entering the minimum and maximum number a user can enter.
    • Minimum Value
       (date)/
      Maximum Value
       (date): Set the date range for the field by entering the first and last dates it covers.
    • Minimum Value
       (date/time)/
      Maximum Value
       (date/time): Set the date-range and time-range for the field by entering the first and last dates and times it covers.
    • Picklist values
      : For single and multi-select picklist types, enter each of the values that a user can select in the attribute field. Specify the order the values appear in the list in.
      The sort order is the same anywhere the attribute is displayed. This is also the order users will be sorted when sending an alert that contains escalation rules.
      User attributes that have a data type of single-select picklist appear in the Response Options list in the alert's Content section.
    • Selected by Default
      : For Checkbox type attributes, select Yes in this field if you want the attribute to be selected by default whenever it appears.
    • Map Icon
      : For Geolocation type attributes, you can select the icon that you want to display on maps to represent the attribute. Select the
      Save Location History
       option to track where the icon is located on the map over time.
  12. Optionally, complete the
    Page Layout
     section:
    1. Select the pages and sections where you want the user attribute to appear.
    2. For each page listed in the section, click the drop-down list and select the location where you want the user attribute to appear or select
      Do not show
       to avoid having it appear anywhere on the corresponding page.
  13. Optionally, complete the
    Personnel Reports
     section:
    1. For the following attribute types, select
      Available for reporting
      .
      • Single and multi-select picklist
      • Checkbox (Yes/No)
      You can create a personnel report based on the attribute and its values.
    2. Enter a report name and description. You can view this report from
      Reports
       >
      Personnel
      .
  14. Click
    Save
    .