Position type custom field settings
  • 28 Mar 2024
  • 3 minutes to read

Position type custom field settings


Article Summary

When adding or editing a custom field in a position type, you can configure the following options. 

Common settings

SettingDescriptionNotes
Full nameThe complete title of the custom field.-
Short name (must be unique)

The abbreviated name of the custom field, which can be used for display purposes.

Custom fields will appear as options on the Edit item screen for position items.

-
Is this field required?When set to Yes, the field is compulsory.Note that this setting cannot be changed for Decimal input and Integer input custom fields, as it’s important that empty strings are not stored for these field types.
Is this field locked?When set to Yes, the field only displays the information set when the field was set up.-
Should the data be unique?When set to Yes, the field only accepts unique values.-
Hidden on the settings page?When set to Yes, the field is not displayed on the competency framework overview page.-

Checkbox

SettingDescriptionNotes
Checked by default

When set to Yes, the checkbox will be checked by default.

When set to No, the checkbox will not be checked by default.

-

Date/time

SettingDescriptionNotes
Start yearThe earliest year you can use. -
End yearThe most recent (future) year you can use. -
Include time?Tick to include a time. -

Decimal input

SettingDescriptionNotes
Default valueThe number that will appear in the field by default.-
Minimum valueThe lowest value that will be accepted.-
Maximum valueThe highest value that will be accepted.-
StepThe accepted increments for values in this field. For example, if this is set to 0.5 then the field will accept values such as -1.0, -0.5, 0, 0.5, 1.0, 1.5, etc.-
Decimal pointsThe number of decimal points that the field will accept.-

File

Choosing this custom field creates a file upload field. There are no specific settings for this field type. 

Integer input

SettingDescriptionNotes
Default valueThe number that will appear in the field by default.-
Minimum valueThe lowest value that will be accepted.-
Maximum valueThe highest value that will be accepted.-
StepThe accepted increments for values in this field. For example, if this is set to 5 then the field will accept values such as -5, 0, 5, 10, 15, etc.-

Location

SettingDescriptionNotes
Default addressOptionally enter a default address to be displayed. -
Default map sizeChoose from:
  • Small
  • Medium
  • Large
-
Default map viewChoose from:
  • Map
  • Satellite
  • Map & satellite (hybrid)
-
Default displayChoose from:
  • Map & address
  • Map
  • Address
-
Set map location

You can set the map location using the address above (if provided), or search for an address, town or city.

If you want to refine the location of the pin, you can do so by dragging and dropping it.

Please check that your site adheres to the Google Maps JavaScript API Terms Of Service before changing the view to include a map. We strongly recommend you get a Google Maps JavaScript API Key or a Client ID and set it within Totara.
SettingDescriptionNotes
Menu option (one per line)

Enter the menu options that will appear in the dropdown box.

Only enter one option per line.

-
Default value

Set the default value that will appear in the dropdown box. The default value must appear in the menu options above.

Leave blank if there is no default entry required.

-

Multi-select

SettingDescriptionNotes
Menu option (and icons)Enter the multi-select options (and icons) that will appear in the dropdown box.-

Text input

SettingDescriptionNotes
Default value

The text that will appear in the text area by default.

Leave this field blank if no default text is required.

-
Columns

This setting sets the width of the text area.

If a text editor plugin is applied to the text area, the width will be determined by the plugin, and changing this value may have no effect.

-
Rows

This setting sets the height of the text area custom field (the number of lines).

If a text editor plugin is applied to the text area, the height will be determined by the plugin, and changing this value may have no effect.

-

Text area

SettingDescriptionNotes
Default value

The text that will appear in the text field by default.

Leave this field blank if no default text is required.

-
Display sizeSets the number of characters that will be displayed in the text field.-
Maximum lengthSets the maximum number of characters the text field will accept.-
Regular expression validation

A regular expression that will be used to ensure entered text is in the expected format. For example, /^[0-9]{3}$/ will ensure the text consists of exactly three numbers.

This validation is performed only when submitting forms with custom fields. Current data is not affected after validation is changed.

For more information on regular expressions please refer to the PHP PCRE regular expression documentation.

-
Description of regular expression validation formatAdd a description message explaining the required format to users.-

URL

SettingDescriptionNotes
Default URL
Enter a default website address. -
Default text
Default link text to be displayed. If empty, the URL will be used.
-
Open in a new window
Enable this setting to open the link in a new window. -

C006 - Hierarchies and job assignments(1)The Totara Academy has a whole course dedicated to using Positions, organisations and job assignments in Totara. Here you can learn more on how to use hierarchies and job assignments, see best practice, and give it a go yourself.


© Copyright 2024 Totara Learning Solutions. All rights reserved.


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.