Microsoft Entra ID에서 특성 매핑에 대한 식 작성
클라우드 동기화를 구성할 때 지정할 수 있는 특성 매핑 유형 중 하나는 식 매핑입니다.
식 매핑을 사용하면 스크립트와 유사한 식을 사용하여 특성을 사용자 지정할 수 있습니다. 이를 통해 온-프레미스 데이터를 새 값 또는 다른 값으로 변환할 수 있습니다. 예를 들어 이 단일 특성은 클라우드 애플리케이션 중 하나에서 사용되므로 두 특성을 단일 특성으로 결합할 수 있습니다.
다음 문서에서는 데이터를 변환하는 데 사용되는 스크립트와 유사한 식을 다룹니다. 이는 프로세스의 일부일 뿐입니다. 다음으로 이 식을 사용하여 테넌트에 대한 웹 요청에 배치해야 합니다. 자세한 내용은 변환 참조하세요.
구문 개요
특성 매핑에 대한 식 구문은 VBA(Visual Basic for Applications) 함수를 연상시킵니다.
전체 식은 이름 뒤에 괄호로 된 인수로 구성된 함수 측면에서 정의되어야 합니다.
FunctionName(<<argument 1>>
,<<argument N>>
)함수를 서로 중첩할 수 있습니다. 예를 들어:
FunctionOne(FunctionTwo(<<argument1>>
))세 가지 유형의 인수를 함수에 전달할 수 있습니다.
- 대괄호로 묶어야 하는 특성입니다. 예: [attributeName]
- 큰따옴표로 묶어야 하는 문자열 상수입니다. 예: "미국"
- 기타 함수. 예: FunctionOne(
<<argument1>>
, FunctionTwo(<<argument2>>
))
문자열 상수의 경우 문자열에 백슬래시(\) 또는 따옴표(" )가 필요한 경우 백슬래시(\ ) 기호를 사용하여 이스케이프해야 합니다. 예: "회사 이름: \"Contoso\""
함수 목록
함수 목록 | 묘사 |
---|---|
추가 | 원본 문자열 값을 가져와 접미사를 끝에 추가합니다. |
BitAnd | BitAnd 함수는 값에 지정된 비트를 설정합니다. |
CBool | CBool 함수는 계산된 식에 따라 부울을 반환합니다. |
convertFromBase64 | ConvertFromBase64 함수는 지정된 base64로 인코딩된 값을 일반 문자열로 변환합니다. |
ConvertToBase64 | ConvertToBase64 함수는 문자열을 유니코드 base64 문자열로 변환합니다. |
convertToUTF8Hex | ConvertToUTF8Hex 함수는 문자열을 UTF8 16진수로 인코딩된 값으로 변환합니다. |
개수 | Count 함수는 다중값 특성의 요소 수를 반환합니다. |
Cstr | CStr 함수는 문자열 데이터 형식으로 변환됩니다. |
dateFromNum | DateFromNum 함수는 AD의 날짜 형식 값을 DateTime 형식으로 변환합니다. |
DNComponent | DNComponent 함수는 왼쪽에서 진행하는 지정된 DN 구성 요소의 값을 반환합니다. |
오류 | 오류 함수는 사용자 지정 오류를 반환하는 데 사용됩니다. |
FormatDateTime | 한 형식에서 날짜 문자열을 가져와서 다른 형식으로 변환합니다. |
GUID | 함수 Guid는 새 임의 GUID를 생성합니다. |
IIF | IIF 함수는 지정된 조건에 따라 가능한 값 집합 중 하나를 반환합니다. |
InStr | InStr 함수는 문자열에서 첫 번째 부분 문자열을 찾습니다. |
IsNull | 식이 Null로 계산되면 IsNull 함수는 true를 반환합니다. |
IsNullOrEmpty | 식이 null이거나 빈 문자열인 경우 IsNullOrEmpty 함수는 true를 반환합니다. |
IsPresent | 식이 Null이 아니고 비어 있지 않은 문자열로 계산되면 IsPresent 함수는 true를 반환합니다. |
IsString | 식을 문자열 형식으로 평가할 수 있는 경우 IsString 함수는 True로 평가됩니다. |
항목 | Item 함수는 다중값 문자열/특성에서 하나의 항목을 반환합니다. |
조인 | Join()은 여러 원본 문자열 값을 단일 문자열로 결합할 수 있으며 각 값은 구분 기호 문자열로 구분된다는 점을 제외하면 Append()와 비슷합니다. |
왼쪽 | Left 함수는 문자열 왼쪽에서 지정된 수의 문자를 반환합니다. |
중간 | 원본 값의 부분 문자열을 반환합니다. 부분 문자열은 원본 문자열의 일부 문자만 포함하는 문자열입니다. |
NormalizeDiacritics | 하나의 문자열 인수가 필요합니다. 문자열을 반환하지만, 모든 음의 문자가 해당하는 비진음성 문자로 바뀝니다. |
않음 | 원본부울 값을 대칭 이동합니다. 원본 값이 "True"이면 "False"를 반환합니다. 그렇지 않으면 "True"를 반환합니다. |
RemoveDuplicates | RemoveDuplicates 함수는 다중값 문자열을 사용하고 각 값이 고유한지 확인합니다. |
바꾸기 | 문자열 내의 값을 대체합니다. |
selectUniqueValue | 식을 사용하여 정의된 고유한 값 생성 규칙인 최소 두 개의 인수가 필요합니다. 함수는 각 규칙을 평가한 다음 생성된 값에서 대상 앱/디렉터리에서 고유성을 확인합니다. |
SingleAppRoleAssignment | 지정된 애플리케이션에 대해 사용자에게 할당된 모든 appRoleAssignments 목록에서 단일 appRoleAssignment를 반환합니다. |
분할 | 지정된 구분 기호 문자를 사용하여 문자열을 다중값 배열로 분할합니다. |
StringFromSID | StringFromSid 함수는 보안 식별자를 포함하는 바이트 배열을 문자열로 변환합니다. |
StripSpaces | 소스 문자열에서 모든 공백(" ") 문자를 제거합니다. |
스위치 | 원본 값이 키일치하면 해당 키대한 값 반환합니다. |
ToLower | 원본 문자열 값을 사용하여 지정된 문화권 규칙을 사용하여 소문자로 변환합니다. |
ToUpper | 원본 문자열 값을 사용하여 지정된 문화권 규칙을 사용하여 대문자로 변환합니다. |
트리밍 | Trim 함수는 문자열에서 선행 공백과 후행 공백을 제거합니다. |
word | Word 함수는 사용할 구분 기호와 반환할 단어 번호를 설명하는 매개 변수를 기반으로 문자열 내에 포함된 단어를 반환합니다. |
덧붙이다
함수:
부록(원본, 접미사)
설명:
원본 문자열 값을 가져와 접미사를 끝에 추가합니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 일반적으로 원본 개체의 특성 이름입니다. |
접미사 | 필수 | 문자열 | 원본 값의 끝에 추가할 문자열입니다. |
BitAnd
설명:
BitAnd 함수는 값에 지정된 비트를 설정합니다.
구문:
num BitAnd(num value1, num value2)
- value1, value2: AND'ed를 함께 사용해야 하는 숫자 값
설명:
이 함수는 두 매개 변수를 이진 표현으로 변환하고 비트를 다음으로 설정합니다.
- 0 - value1 및 value2 해당 비트 중 하나 또는 둘 다 0인 경우
- 1 - 해당 비트가 모두 1인 경우
즉, 두 매개 변수의 해당 비트가 1인 경우를 제외하고 모든 경우에 0을 반환합니다.
예제:
BitAnd(&HF, &HF7)
16진수 "F" 및 "F7"이 이 값으로 계산되므로 7을 반환합니다.
CBool
설명:
CBool 함수는 계산된 식에 따라 부울을 반환합니다.
구문:
bool CBool(exp Expression)
설명:
식이 0이 아닌 값으로 계산되면 CBool은 True를 반환하고 그렇지 않으면 False를 반환합니다.
예제:
CBool([attrib1] = [attrib2])
두 특성의 값이 같으면 True를 반환합니다.
ConvertFromBase64
설명:
ConvertFromBase64 함수는 지정된 base64로 인코딩된 값을 일반 문자열로 변환합니다.
구문:
str ConvertFromBase64(str source)
- 인코딩을 위해 유니코드를 가정합니다.
str ConvertFromBase64(str source, enum Encoding)
- 원본: Base64로 인코딩된 문자열
- 인코딩: 유니코드, ASCII, UTF8
예제
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA")
ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8)
두 예제 모두 "Hello world!"
ConvertToBase64
설명:
ConvertToBase64 함수는 문자열을 유니코드 base64 문자열로 변환합니다.
정수 배열의 값을 base-64 숫자로 인코딩된 해당 문자열 표현으로 변환합니다.
구문:
str ConvertToBase64(str source)
예제:
ConvertToBase64("Hello world!")
"SABlAGwAbABvACAAdwBvAHIAbABkACEA"를 반환합니다.
ConvertToUTF8Hex
설명:
ConvertToUTF8Hex 함수는 문자열을 UTF8 16진수로 인코딩된 값으로 변환합니다.
구문:
str ConvertToUTF8Hex(str source)
설명:
이 함수의 출력 형식은 Microsoft Entra ID에서 DN 특성 형식으로 사용됩니다.
예제:
ConvertToUTF8Hex("Hello world!")
48656C6C6F20776F726C6421을 반환합니다.
세다
설명:
Count 함수는 다중값 특성의 요소 수를 반환합니다.
구문:
num Count(mvstr attribute)
CStr
설명:
CStr 함수는 문자열 데이터 형식으로 변환됩니다.
구문:
str CStr(num value)
str CStr(ref value)
str CStr(bool value)
- value: 숫자 값, 참조 특성 또는 부울일 수 있습니다.
예제:
CStr([dn])
"cn=Joe,dc=contoso,dc=com"을 반환할 수 있습니다.
DateFromNum
설명:
DateFromNum 함수는 AD의 날짜 형식 값을 DateTime 형식으로 변환합니다.
구문:
dt DateFromNum(num value)
예제:
DateFromNum([lastLogonTimestamp])
DateFromNum(129699324000000000)
2012-01-01 23:00:00을 나타내는 DateTime을 반환합니다.
DNComponent
설명:
DNComponent 함수는 왼쪽에서 진행하는 지정된 DN 구성 요소의 값을 반환합니다.
구문:
str DNComponent(ref dn, num ComponentNumber)
- dn: 해석할 참조 특성
- ComponentNumber: 반환할 DN의 구성 요소
예제:
DNComponent(CRef([dn]),1)
dn이 "cn=Joe,ou=..."이면 Joe가 반환됩니다.
오류
설명:
오류 함수는 사용자 지정 오류를 반환하는 데 사용됩니다.
구문:
void Error(str ErrorMessage)
예제:
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required"))
attribute accountName이 없으면 개체에 오류를 throw합니다.
FormatDateTime
함수:
FormatDateTime(source, inputFormat, outputFormat)
설명:
한 형식에서 날짜 문자열을 가져와서 다른 형식으로 변환합니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 일반적으로 원본 개체의 특성 이름입니다. |
inputFormat | 필수 | 문자열 | 원본 값의 예상 형식입니다. 지원되는 형식은 /dotnet/standard/base-types/custom-date-and-time-format-strings참조하세요. |
outputFormat | 필수 | 문자열 | 출력 날짜의 형식입니다. |
Guid(Guid)
설명:
함수 Guid는 새 임의 GUID를 생성합니다.
구문:
str Guid()
IIF
설명:
IIF 함수는 지정된 조건에 따라 가능한 값 집합 중 하나를 반환합니다.
구문:
var IIF(exp condition, var valueIfTrue, var valueIfFalse)
- condition: true 또는 false로 평가할 수 있는 모든 값 또는 식입니다.
- valueIfTrue: 조건이 true로 평가되면 반환된 값입니다.
- valueIfFalse: 조건이 false로 평가되면 반환된 값입니다.
예제:
IIF([employeeType]="Intern","t-" & [alias],[alias])
사용자가 인턴인 경우 시작 부분에 "t-"가 추가된 사용자의 별칭을 반환하고, 그렇지 않으면 사용자의 별칭을 있는 그대로 반환합니다.
InStr
설명:
InStr 함수는 문자열에서 첫 번째 부분 문자열을 찾습니다.
구문:
num InStr(str stringcheck, str stringmatch)
num InStr(str stringcheck, str stringmatch, num start)
num InStr(str stringcheck, str stringmatch, num start, enum compare)
- stringcheck: 검색할 문자열
- stringmatch: 찾을 문자열
- start: 부분 문자열을 찾기 위한 시작 위치
- compare: vbTextCompare 또는 vbBinaryCompare
설명:
부분 문자열이 발견된 위치 또는 0을 찾을 수 없는 경우 반환합니다.
예제:
InStr("The quick brown fox","quick")
5로 평가
InStr("repEated","e",3,vbBinaryCompare)
7로 평가
IsNull
설명:
식이 Null로 계산되면 IsNull 함수는 true를 반환합니다.
구문:
bool IsNull(var Expression)
설명:
특성의 경우 특성이 없으므로 Null이 표현됩니다.
예제:
IsNull([displayName])
CS 또는 MV에 특성이 없으면 True를 반환합니다.
IsNullOrEmpty
설명:
식이 null이거나 빈 문자열인 경우 IsNullOrEmpty 함수는 true를 반환합니다.
구문:
bool IsNullOrEmpty(var Expression)
설명:
특성의 경우 특성이 없거나 존재하지만 빈 문자열인 경우 True로 평가됩니다.
이 함수의 역방향 이름은 IsPresent입니다.
예제:
IsNullOrEmpty([displayName])
특성이 없거나 CS 또는 MV에 빈 문자열이면 True를 반환합니다.
IsPresent
설명:
식이 Null이 아니고 비어 있지 않은 문자열로 계산되면 IsPresent 함수는 true를 반환합니다.
구문:
bool IsPresent(var expression)
설명:
이 함수의 역 이름은 IsNullOrEmpty입니다.
예제:
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])
항목
설명:
Item 함수는 다중값 문자열/특성에서 하나의 항목을 반환합니다.
구문:
var Item(mvstr attribute, num index)
- 특성: 다중값 특성
- index: 다중값 문자열의 항목에 대한 인덱스입니다.
설명:
Item 함수는 후자의 함수가 다중값 특성의 항목에 인덱스를 반환하기 때문에 Contains 함수와 함께 유용합니다.
인덱스가 범위를 벗어나면 오류를 throw합니다.
예제:
Mid(Item([proxyAddresses],Contains([proxyAddresses], "SMTP:")),6)
기본 전자 메일 주소를 반환합니다.
IsString
설명:
식을 문자열 형식으로 평가할 수 있는 경우 IsString 함수는 True로 평가됩니다.
구문:
bool IsString(var expression)
설명:
CStr()이 식을 구문 분석하는 데 성공할 수 있는지 확인하는 데 사용됩니다.
잇다
함수:
Join(separator, source1, source2, ...)
설명:
Join()은 여러 원본 문자열 값을 단일 문자열로 결합할 수 있으며 각 값은 구분 기호 문자열로 구분된다는 점을 제외하면 Append()와 비슷합니다.
원본 값 중 하나가 다중 값 특성인 경우 해당 특성의 모든 값이 구분 기호 값으로 구분되어 함께 조인됩니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
구분 기호 | 필수 | 문자열 | 원본 값이 하나의 문자열로 연결될 때 소스 값을 구분하는 데 사용되는 문자열입니다. 구분 기호가 필요하지 않은 경우 ""일 수 있습니다. |
source1 ... sourceN | 필수, 가변 횟수 | 문자열 | 함께 조인할 문자열 값입니다. |
왼쪽
설명:
Left 함수는 문자열 왼쪽에서 지정된 수의 문자를 반환합니다.
구문:
str Left(str string, num NumChars)
- string: 문자를 반환할 문자열입니다.
- NumChars: 문자열의 시작 부분(왼쪽)에서 반환할 문자 수를 식별하는 숫자입니다.
설명:
문자열의 첫 번째 numChars 문자를 포함하는 문자열입니다.
- numChars = 0이면 빈 문자열을 반환합니다.
- numChars < 0이면 입력 문자열을 반환합니다.
- 문자열이 null이면 빈 문자열을 반환합니다.
문자열에 numChars에 지정된 숫자보다 적은 문자가 포함된 경우 문자열과 동일한 문자열(즉, 매개 변수 1의 모든 문자 포함)이 반환됩니다.
예제:
Left("John Doe", 3)
Joh
반환합니다.
중간
함수:
Mid(source, start, length)
설명:
원본 값의 부분 문자열을 반환합니다. 부분 문자열은 원본 문자열의 일부 문자만 포함하는 문자열입니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 일반적으로 특성의 이름입니다. |
시작 | 필수 | 정수 | 부분 문자열을 시작해야 하는 원본 문자열의 인덱스입니다. 문자열의 첫 번째 문자는 인덱스가 1이고 두 번째 문자는 인덱스 2를 갖습니다. |
길이 | 필수 | 정수 | 부분 문자열의 길이입니다. 길이가 원본 문자열 외부에서 끝나는 경우 함수는 시작 인덱스에서 원본 문자열의 끝까지 부분 문자열을 반환합니다. |
NormalizeDiacritics
함수:
NormalizeDiacritics(source)
설명:
하나의 문자열 인수가 필요합니다. 문자열을 반환하지만, 모든 음의 문자가 해당하는 비진음성 문자로 바뀝니다. 일반적으로 이름 및 성(악센트 표시)이 포함된 이름과 성을 사용자 계정 이름, SAM 계정 이름 및 전자 메일 주소와 같은 다양한 사용자 식별자에서 사용할 수 있는 법적 값으로 변환하는 데 사용됩니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 일반적으로 이름 또는 성 특성입니다. |
안
함수:
Not(source)
설명:
원본부울 값을 대칭 이동합니다.
원본 값이 "True"이면 "False"를 반환합니다. 그렇지 않으면 "True"를 반환합니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 부울 문자열 | 예상 원본 값은 "True" 또는 "False"입니다. |
RemoveDuplicates
설명:
RemoveDuplicates 함수는 다중값 문자열을 사용하고 각 값이 고유한지 확인합니다.
구문:
mvstr RemoveDuplicates(mvstr attribute)
예제:
RemoveDuplicates([proxyAddresses])
모든 중복 값이 제거된 삭제된 proxyAddress 특성을 반환합니다.
갈다
함수:
Replace(source, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, template)
설명:
문자열 내의 값을 대체합니다. 제공된 매개 변수에 따라 다르게 작동합니다.
oldValue 및 replacementValue 경우:
- 원본oldValue 모든 항목을 replacementValue 바꿉니다.
oldValue 및 템플릿 경우:
- 템플릿oldValue 모든 항목을 원본 값으로 바꿉니다.
regexPattern 및 replacementValue 경우:
- 이 함수는 원본 문자열에 regexPattern 적용하고 regex 그룹 이름을 사용하여 replacementValue 문자열을 생성할 수 있습니다.
regexPattern regexGroupName replacementValue 제공됩니다.
- 이 함수는 regexPattern원본 문자열에 적용하고 regexGroupName 일치하는 모든 값을 replacementValue
regexPattern 경우 regexGroupName replacementAttributeName 제공됩니다.
- 원본 값이 없으면 원본 반환됩니다.
- 원본 값이 있는 경우 함수는 원본 문자열에 regexPattern 적용하고 regexGroupName 일치하는 모든 값을 replacementAttributeName
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 일반적으로 원본 개체의 특성 이름입니다. |
oldValue | 선택적 | 문자열 | 원본 또는 템플릿바꿀 값입니다. |
regexPattern | 선택적 | 문자열 | 원본바꿀 값의 정규식 패턴입니다. 또는 replacementPropertyName 사용하는 경우 replacementPropertyName에서 값을 추출하는 패턴이. |
regexGroupName | 선택적 | 문자열 | regexPattern내 그룹의 이름입니다. replacementPropertyName 사용하는 경우에만 이 그룹의 값을 replacementPropertyNamereplacementValue 추출합니다. |
replacementValue | 선택적 | 문자열 | 이전 값을 바꿀 새 값입니다. |
replacementAttributeName | 선택적 | 문자열 | 대체 값에 사용할 특성의 이름 |
템플릿 | 선택적 | 문자열 | 템플릿 값이 제공되면 템플릿 내에서 oldValue 찾아서 원본 값으로 바꿉 있습니다. |
SelectUniqueValue
함수:
SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, ...)
설명:
식을 사용하여 정의된 고유한 값 생성 규칙인 최소 두 개의 인수가 필요합니다. 함수는 각 규칙을 평가한 다음 생성된 값에서 대상 앱/디렉터리에서 고유성을 확인합니다. 발견된 첫 번째 고유 값은 반환되는 값입니다. 모든 값이 대상에 이미 있는 경우 항목이 에스크로깅되고 그 이유가 감사 로그에 기록됩니다. 제공할 수 있는 인수 수에 상한이 없습니다.
메모
- 최상위 함수이며 중첩할 수 없습니다.
- 일치하는 우선 순위가 있는 특성에는 이 함수를 적용할 수 없습니다.
- 이 함수는 항목 만들기에만 사용됩니다. 특성과 함께 사용하는 경우 개체를 만드는 동안 매핑 속성을 Only로설정합니다.
- 이 함수는 현재 "Workday 및 SuccessFactors to Active Directory User Provisioning"에 대해서만 지원됩니다. 다른 프로비저닝 애플리케이션에는 사용할 수 없습니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
uniqueValueRule1 ... uniqueValueRuleN | 2개 이상 필요, 상한 없음 | 문자열 | 평가할 고유 값 생성 규칙 목록입니다. |
SingleAppRoleAssignment
함수:
SingleAppRoleAssignment([appRoleAssignments])
설명:
지정된 애플리케이션에 대해 사용자에게 할당된 모든 appRoleAssignments 목록에서 단일 appRoleAssignment를 반환합니다. 이 함수는 appRoleAssignments 개체를 단일 역할 이름 문자열로 변환하는 데 필요합니다. 모범 사례는 한 번에 하나의 appRoleAssignment만 한 사용자에게 할당되도록 하는 것이며, 여러 역할이 할당된 경우 반환된 역할 문자열을 예측할 수 없습니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
[appRoleAssignments] | 필수 | 문자열 | [appRoleAssignments] 개체입니다. |
쪼개다
함수:
Split(source, delimiter)
설명:
지정된 구분 기호 문자를 사용하여 문자열을 다중값 배열로 분할합니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 업데이트할 원본 값을. |
구분 기호 | 필수 | 문자열 | 문자열을 분할하는 데 사용할 문자를 지정합니다(예: ","). |
StringFromSid
설명:
StringFromSid 함수는 보안 식별자를 포함하는 바이트 배열을 문자열로 변환합니다.
구문:
str StringFromSid(bin ObjectSID)
StripSpaces
함수:
StripSpaces(source)
설명:
소스 문자열에서 모든 공백(" ") 문자를 제거합니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 업데이트할 원본 값을. |
스위치
함수:
Switch(source, defaultValue, key1, value1, key2, value2, ...)
설명:
원본 값이 키일치하면 해당 키대한 값 반환합니다.
원본 값이 키와 일치하지 않으면 defaultValue 반환합니다.
키 및 값 매개 변수는 항상 쌍으로 제공되어야 합니다. 함수는 항상 짝수의 매개 변수를 예상합니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 확인할 원본 값을. |
defaultValue | 선택적 | 문자열 | 원본이 키와 일치하지 않을 때 사용할 기본값입니다. 빈 문자열("")일 수 있습니다. |
키 | 필수 | 문자열 | 원본 값을 비교할 키 . |
값 | 필수 | 문자열 | 키와 일치하는 원본 대한 대체 값입니다. |
ToLower
함수:
ToLower(source, culture)
설명:
원본 문자열 값을 사용하여 지정된 문화권 규칙을 사용하여 소문자로 변환합니다. 지정된 문화권 정보가 없으면 고정 문화권을 사용합니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 일반적으로 원본 개체의 특성 이름 |
문화권 | 선택적 | 문자열 | RFC 4646을 기반으로 하는 문화권 이름의 형식은 languagecode2-country/regioncode2 , 여기서 languagecode2 두 글자 언어 코드이고 country/regioncode2 두 글자 하위 문화권 코드입니다. 예를 들어 일본어(일본)의 ja-JP 영어(미국)의 en-US 있습니다. 두 글자 언어 코드를 사용할 수 없는 경우 ISO 639-2에서 파생된 3자 코드가 사용됩니다. |
ToUpper
함수:
ToUpper(source, culture)
설명:
원본 문자열 값을 사용하여 지정된 문화권 규칙을 사용하여 대문자로 변환합니다. 지정된 문화권 정보가 없으면 고정 문화권을 사용합니다.
매개 변수:
이름 | 필수/반복 | 형 | 노트 |
---|---|---|---|
원본 | 필수 | 문자열 | 일반적으로 원본 개체의 특성 이름입니다. |
문화권 | 선택적 | 문자열 | RFC 4646을 기반으로 하는 문화권 이름의 형식은 languagecode2-country/regioncode2 , 여기서 languagecode2 두 글자 언어 코드이고 country/regioncode2 두 글자 하위 문화권 코드입니다. 예를 들어 일본어(일본)의 ja-JP 영어(미국)의 en-US 있습니다. 두 글자 언어 코드를 사용할 수 없는 경우 ISO 639-2에서 파생된 3자 코드가 사용됩니다. |
다듬다
설명:
Trim 함수는 문자열에서 선행 공백과 후행 공백을 제거합니다.
구문:
str Trim(str value)
예제:
Trim(" Test ")
"Test"를 반환합니다.
Trim([proxyAddresses])
proxyAddress 특성의 각 값에 대한 선행 및 후행 공백을 제거합니다.
단어
설명:
Word 함수는 사용할 구분 기호와 반환할 단어 번호를 설명하는 매개 변수를 기반으로 문자열 내에 포함된 단어를 반환합니다.
구문:
str Word(str string, num WordNumber, str delimiters)
- string: 단어를 반환할 문자열입니다.
- WordNumber: 반환해야 하는 단어 번호를 식별하는 숫자입니다.
- 구분 기호: 단어를 식별하는 데 사용해야 하는 구분 기호를 나타내는 문자열입니다.
설명:
구분 기호의 문자 중 하나로 구분된 문자열의 각 문자열은 단어로 식별됩니다.
- number < 1이면 빈 문자열을 반환합니다.
- 문자열이 null이면 빈 문자열을 반환합니다.
문자열에 숫자보다 작은 단어가 포함되거나 문자열에 구분 기호로 식별되는 단어가 없는 경우 빈 문자열이 반환됩니다.
예제:
Word("The quick brown fox",3," ")
"brown"을 반환합니다.
Word("This,string!has&many separators",3,",!&#")
"has"를 반환합니다.
예제
알려진 도메인 이름 제거
사용자 이름을 얻으려면 사용자의 전자 메일에서 알려진 도메인 이름을 제거해야 합니다.
예를 들어 도메인이 "contoso.com"인 경우 다음 식을 사용할 수 있습니다.
식:
Replace([mail], "@contoso.com", , ,"", ,)
샘플 입력/출력:
- INPUT(메일): "john.doe@contoso.com"
- 출력 : "john.doe"
사용자 이름에 상수 접미사 추가
Salesforce Sandbox를 사용하는 경우 동기화하기 전에 모든 사용자 이름에 추가 접미사를 추가해야 할 수 있습니다.
식:
Append([userPrincipalName], ".test")
샘플 입력/출력:
- INPUT: (userPrincipalName): "John.Doe@contoso.com"
- 출력 : "John.Doe@contoso.com.test"
이름과 성의 일부를 연결하여 사용자 별칭 생성
사용자 이름의 처음 3개 문자와 사용자 성의 처음 5자를 사용하여 사용자 별칭을 생성해야 합니다.
식:
Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))
샘플 입력/출력:
- INPUT(givenName): "John"
- INPUT(성): "Doe"
- OUTPUT: "JohDoe"
문자열에서 발음 제거
강조 표시가 포함된 문자를 악센트 기호를 포함하지 않는 동등한 문자로 바꾸어야 합니다.
식:
NormalizeDiacritics([givenName])
샘플 입력/출력:
- INPUT(givenName): "Zoë"
- 출력 : "Zoe"
문자열을 다중값 배열로 분할
쉼표로 구분된 문자열 목록을 가져와 Salesforce의 PermissionSets 특성과 같은 다중 값 특성에 연결할 수 있는 배열로 분할해야 합니다. 이 예제에서는 Microsoft Entra ID의 extensionAttribute5에 사용 권한 집합 목록이 채워졌습니다.
식:
Split([extensionAttribute5], ",")
샘플 입력/출력:
- INPUT(extensionAttribute5): "PermissionSetOne, PermissionSetTwo"
- OUTPUT: ["PermissionSetOne", "PermissionSetTwo"]
특정 형식의 문자열로 출력 날짜
특정 형식으로 SaaS 애플리케이션에 날짜를 보내려고 합니다.
예를 들어 ServiceNow의 날짜 서식을 지정하려고 합니다.
식:
FormatDateTime([extensionAttribute1], "yyyyMMddHHmmss.fZ", "yyyy-MM-dd")
샘플 입력/출력:
- INPUT(extensionAttribute1): "20150123105347.1Z"
- OUTPUT: "2015-01-23"
미리 정의된 옵션 집합에 따라 값 바꾸기
Microsoft Entra ID에 저장된 상태 코드를 기반으로 사용자의 표준 시간대를 정의해야 합니다.
주 코드가 미리 정의된 옵션과 일치하지 않는 경우 기본값인 "Australia/Sydney"를 사용합니다.
식:
Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")
샘플 입력/출력:
- INPUT(상태): "QLD"
- 출력: "오스트레일리아/브리즈번"
정규식을 사용하여 문자 바꾸기
정규식 값과 일치하는 문자를 찾아 제거해야 합니다.
식:
Replace([mailNickname], , "[a-zA-Z_]*", , "", , )
샘플 입력/출력:
- INPUT(mailNickname: "john_doe72"
- 출력 : "72"
생성된 USERPrincipalName(UPN) 값을 소문자로 변환
아래 예제에서 UPN 값은 PreferredFirstName 및 PreferredLastName 원본 필드를 연결하여 생성되며 ToLower 함수는 생성된 문자열에서 작동하여 모든 문자를 소문자로 변환합니다.
ToLower(Join("@", NormalizeDiacritics(StripSpaces(Join(".", [PreferredFirstName], [PreferredLastName]))), "contoso.com"))
샘플 입력/출력:
- INPUT(PreferredFirstName): "John"
- INPUT(PreferredLastName): "Smith"
- 출력 : "john.smith@contoso.com"
USERPrincipalName(UPN) 특성에 대한 고유 값 생성
UPN 특성에 값을 할당하기 전에 사용자의 이름, 중간 이름 및 성에 따라 UPN 특성에 대한 값을 생성하고 대상 AD 디렉터리에서 고유성을 확인해야 합니다.
식:
SelectUniqueValue(
Join("@", NormalizeDiacritics(StripSpaces(Join(".", [PreferredFirstName], [PreferredLastName]))), "contoso.com"),
Join("@", NormalizeDiacritics(StripSpaces(Join(".", Mid([PreferredFirstName], 1, 1), [PreferredLastName]))), "contoso.com"),
Join("@", NormalizeDiacritics(StripSpaces(Join(".", Mid([PreferredFirstName], 1, 2), [PreferredLastName]))), "contoso.com")
)
샘플 입력/출력:
- INPUT(PreferredFirstName): "John"
- INPUT(PreferredLastName): "Smith"
- OUTPUT: "John.Smith@contoso.com" John.Smith@contoso.com UPN 값이 디렉터리에 아직 없는 경우
- OUTPUT: "J.Smith@contoso.com" John.Smith@contoso.com UPN 값이 디렉터리에 이미 있는 경우
- OUTPUT: 위의 두 UPN 값이 디렉터리에 이미 있는 경우 "Jo.Smith@contoso.com"