다음을 통해 공유


Microsoft Entra ID에서 특성 매핑에 대한 식 작성

클라우드 동기화를 구성할 때 지정할 수 있는 특성 매핑 유형 중 하나는 식 매핑입니다.

식 매핑을 사용하면 스크립트와 유사한 식을 사용하여 특성을 사용자 지정할 수 있습니다. 이를 통해 온-프레미스 데이터를 새 값 또는 다른 값으로 변환할 수 있습니다. 예를 들어 이 단일 특성은 클라우드 애플리케이션 중 하나에서 사용되므로 두 특성을 단일 특성으로 결합할 수 있습니다.

다음 문서에서는 데이터를 변환하는 데 사용되는 스크립트와 유사한 식을 다룹니다. 이는 프로세스의 일부일 뿐입니다. 다음으로 이 식을 사용하여 테넌트에 대한 웹 요청에 배치해야 합니다. 자세한 내용은 변환 참조하세요.

구문 개요

특성 매핑에 대한 식 구문은 VBA(Visual Basic for Applications) 함수를 연상시킵니다.

  • 전체 식은 이름 뒤에 괄호로 된 인수로 구성된 함수 측면에서 정의되어야 합니다.
    FunctionName(<<argument 1>>,<<argument N>>)

  • 함수를 서로 중첩할 수 있습니다. 예를 들어:
    FunctionOne(FunctionTwo(<<argument1>>))

  • 세 가지 유형의 인수를 함수에 전달할 수 있습니다.

    1. 대괄호로 묶어야 하는 특성입니다. 예: [attributeName]
    2. 큰따옴표로 묶어야 하는 문자열 상수입니다. 예: "미국"
    3. 기타 함수. 예: 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 - value1value2 해당 비트 중 하나 또는 둘 다 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"

다음 단계