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.

For detailed instructions on creating a Geo-aware Single-select Picklist attribute, see Create a Geo-aware Single-select Picklist attribute.

For detailed instructions on creating a dynamic hierarchy attribute, see Create a dynamic hierarchy attribute.

  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
    • Dynamic Hierarchy
    • 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.
    Note: 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.
    Note: 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.
    Note: 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. Attribute values used as response options must be less than 64 characters.
  11. In the Values section, click Add value. Depending on the attribute type selected, the value fields in the following table appear.

    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.
      Note: 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. Up to 2000 values can be imported.
    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 dynamic hierarchy, 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.