Mapping rule built-ins work similarly to methods in object-oriented programming. Consider the following simple mapping:
let idautoPersonBirthdate = dobThis mapping works when the source format matches the target format. When the source
provides dob values such as 10/31/2002 (October 31,
2002) and RapidIdentity expects 2002-10-31, a built-in converts the
value:
let idautoPersonBirthdate = dob.convertDateFrom("MM/dd/yyyy")This rule populates
idautoPersonBirthdate by taking the source
dob field and reformatting it into RapidIdentity's standard date
format using the descriptor MM/dd/yyyy.| Built-in Name | Arguments | Outputs | Example |
|---|---|---|---|
calculateGradYear | (Optional) Cut-off month for school year rollover. The default is
6 for June. | Projected graduation year based on the input grade, in CEDS format | grade.calculateGradYear() |
containsText | The substring to look for | true if the field contains the substring,
false otherwise | if (@ou.containsText("OU=Students,")) "staff" |
convertDateFrom | Input date pattern (Java DateTimeFormatter) | Converts a date string to RapidIdentity standard format
(yyyy-MM-dd) | dob.convertDateFrom("MM/dd/yyyy") |
convertDateTimeFrom | Input date and time pattern (Java DateTimeFormatter) | Converts a date and time string to RapidIdentity standard format
(yyyyMMddhhmmssZ) | termTimestamp.convertDateTimeFrom("MM/dd/yyyy hh:mm") |
convertDateTo | Output date pattern (Java DateTimeFormatter) | Converts a RapidIdentity standardized date
(yyyy-MM-dd) to the specified format | idautoPersonBirthdate.convertDateTo("M/d/yyyy") |
convertDateTimeTo | Output date and time pattern (Java DateTimeFormatter) | Converts a RapidIdentity standardized date and time to the specified format | idautoPersonEndDate.convertDateTimeTo("MM/dd/yyyy") |
convertDate | Input date pattern, output date pattern | Date string in the output format specified | dob.convertDate("M/d/yyyy", "MMddyyyy") |
convertDateTime | Input date and time pattern, output date and time pattern | Date and time string in the output format specified | termTimestamp.convertDateTime("MM/dd/yyyy hh:mm", "MMddyyyy hh:mm") |
endsWith | The suffix to look for | true if the field ends with the suffix,
false otherwise | if (jobTitle.endsWith("Teacher")) "teacher" |
getWord | Index of word; (optional) delimiter string | Word at the index in the delimited input, or an empty string if out of bounds | firstNames.getWord(0);
mail.getWord(0, "@") |
isEmpty | None | true if the field is empty | givenName.isEmpty() |
isNotEmpty | None | true if the field is not empty | givenName.isNotEmpty() |
length | None | The length of the input | firstNames.length |
lowercase | None | Input with all characters lowercase | email.lowercase() |
replace | String to replace, replacement string; (optional)
true for case-insensitive | Input with the replacement applied | username.replace("@identityautomation.com", "") |
startsWith | The prefix to look for | true if the field starts with the prefix,
false otherwise | if (jobTitle.startsWith("IT")) "admin" |
stripDiacriticals | None | Input with no diacriticals | givenName.stripDiacriticals() |
stripQualifiers | None | Input with no generational qualifiers or titles after a comma | fullName.stripQualifiers() |
stripSpaces | None | Input with all negative space removed (spaces, tabs, and newlines) | lastName.stripSpaces() |
stripSpecialCharacters | None | Input with no special characters | givenName.stripSpecialCharacters() |
substring | startIndex (inclusive); (optional)
endIndex (exclusive) | Substring from startIndex to
endIndex. Use take or
takeLast if indices can be out of bounds. | studentId.substring(1) |
take | Length of prefix to extract | Prefix of the input. Safe even if the input is shorter than the specified length. | username.take(20) |
takeLast | Length of suffix to extract | Suffix of the input. Safe even if the input is shorter than the specified length. | studentId.takeLast(10) |
titleCase | None | Input with all words in title case | displayName.titleCase() |
uppercase | None | Input with all characters uppercase | username.uppercase() |