Placeholders
The placeholders below are supported and available in the Attribute Mapping areas in the ADMS Admin Console and can be mapped to any available single valued attribute in Active Directory.
For a complete list of Active Directory attributes available see https://docs.microsoft.com/en-us/windows/win32/adschema/c-user#windows-server-2012
| Common | Students | Staff |
|---|---|---|
| <role> | <yearlevel> | <title> |
| <id> | <whanau> | <position> |
| <uniqueid> | <genderpreferred> | <classification> |
| <firstname> | <enrolmentdate> | <moenumber> |
| <lastname> | <althomedrive> | <registrationnumber> |
| <username> | <altdescription> | <extension> |
| <email> | <byodinfo> | <departments> |
| <datebirth> | <caregivernames> | |
| <gender> | <caregiveremails> | |
| <startingdate> | <nsn> | |
| <leavingdate | ||
| <photocopierid> | ||
| <mobile> | ||
| <tutor> | ||
| <house> | ||
| <passwordhash> |
A complete list of fields sent from KAMAR is available at https://directoryservices.kamar.nz/?listening-service/check-fields. If you find there is data available from KAMAR that you would like to use in ADMS, please let us know.
Warning
The following Active Directory attributes are needed by ADMS. Do not configure an Attribute Mapping to override them.
flags
sAMAccountName employeeID
Placeholder Customisation
Note: Placeholders are represented in angle brackets (< and >) and separated by a semi-colon (;) when trimming or a custom date format is specified.
Trimming Placeholders
ADMS provides the ability to trim placeholders to a specific length. This is particularly useful when you want to extract only a portion of the data. Here's an example:
Single-letter Trimming
To extract the first letter of a placeholder, use the format <placeholder;1>. For example, if the placeholder is <firstname>, <firstname;1> will output the first letter of the firstname.
Given the user named John Smith and the placeholder <firstname>:
<firstname;1>, the output will be "J,<firstname;2>will output "Jo", and so on.
Combining Trimming
Combine multiple placeholders to build your own strings.To do this, concatenate the desired placeholders. For instance, using <firstname;2><lastname;1> will generate the output "JoS" by combining the second letter of the first name with the first letter of the last name.
Formatting Date Placeholders
ADMS also allows you to format dates supplied by KAMAR using placeholders. This is useful for standardising the date representation.
Given a date placeholder of <startingdate;format_string> and the starting date data as "12 Jul 2023", you can specify the desired date format using C# date and time format strings.
For example, <startingdate;yyyy-MM-dd> will output "2023-07-12" by representing the year, month, and day in that specific order.
Various format options using C# date and time format strings to customise the output according to your needs.
Here are a few more examples of C# date and time format strings:
<startingdate;dd-MMM-yyyy>will output "12-Jul-2023".<startingdate;MMM dd, yyyy>will output "Jul 12, 2023".<startingdate;dddd>will output the full weekday name, such as "Monday".