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

Create a user attribute

User attributes can be managed at the system, super enterprise, 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
 Plan and Manage Enterprise Organizations
 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
    • Geo-aware Single-select Picklist
    • Geolocation
    • Memo
    • Multi-select Picklist
    • Number
    • Single-select Picklist
    • Status
    • Text
    The New Attribute screen displays 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 user profiles.
  10. Optionally, select
    Use as a Response Option
    .
    Only Checkbox, Geo-aware Single-select Picklist, Single-select Picklist, and Status 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 selected, the following fields appears:
    Attribute type
    Values fields
    Checkbox
    Select the
    Selected by Default
     option for the attribute to be selected by default when it appears.
    • Date
    • Date Time
    Select the
    Earliest Allowed Date Time
     and
    Latest Allowed Date Time
     from the calendar pickers. Set the date-range and time-range for the fields by entering the first and last dates and times it covers.
    Geo-aware Single-select Picklist
    1. In the
      Value
       field, enter a value that a user can select from a pull-down list.
    2. In the
      Geo location
       field, specify a real physical address or location coordinates in the POINT(longitude/latitude) or latitude,longitude format.
      Due to validation of individual geolocation entries in the CSV import file, importing many values will take time.
    3. Optionally, click
      Import Values
       to import the attribute values from a CSV file.
    4. Specify the order the values appear in the list. The sort order is the same anywhere the attribute is displayed.
    5. Click
      Save
      .
    Geolocation
    1. Click
      Change
       beside
      Map Icon
       to select the icon to display on maps to represent the attribute.
    2. Optionally, select the
      Save Location History
       option to track where the icon is located on the map over time.
    Memo
    —
    • Multi-select Picklist
    • Single-select Picklist
    1. In the
      Value
       field, enter a value that a user can select in the attribute field.
    2. Optionally, select a default value.
    3. Optionally, click
      Import Values
       to import the attribute values from a CSV file.
    4. Specify the order the values appear in the list. The sort order is the same anywhere the attribute is displayed. This is also the order users will be sorted in when sending an alert that contains escalation rules.
    5. Click
      Save
      .
    • Number
    • Text
    In the
    Minimum Value
     and
    Maximum Value
     fields, enter the minimum and maximum number of characters that end users must enter in the attribute field.
    Status
    1. In the
      Value
       field, enter a value that a user can select in the attribute field.
    2. Specify the order the values appear in the list. The sort order is the same anywhere the attribute is displayed.
    3. Optionally, click
      Import Values
       to import the attribute values from a CSV file.
    4. Click
      Save
      .
  12. Optionally, in the
    Page Layout
     section, select the pages and sections where the user attribute appears. 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, for multi-select, single-select, and geo-aware single-select picklist attributes, complete the
    Personnel Reports
     section to create a personnel report based on the attribute and its values:
    1. Select the
      Enabled
       option.
    2. Enter a report name and description.
    You can view this report from
    Reports
     >
    Personnel
    .
  14. Click
    Save
    .