이전 항목: 명시적 전역 사용자 특성 규칙다음 항목: 프로비져닝 역할 성능


기본 제공 규칙 함수

값에서 여러 변환을 수행하기 위해 규칙 식에서 기본 제공 규칙 함수를 사용할 수 있습니다. 기본 제공 함수 호출의 일반 형식은 다음과 같습니다.

%[*]$$function(arg[,…])[:offset,length]%

다중 값 표시기 별표(*), offset, length 하위 문자열 사양은 선택 사항입니다.

식별된 기본 제공 함수는 다음과 같습니다.

기본 제공 규칙 함수

설명

ALLOF

모든 매개 변수를 다중 값 특성으로 병합합니다. 순가가 유지되며 중복 항목은 제거됩니다. 예를 들어, 사용자 특성이 다음과 같이 설정되는 경우:

eTCustomField01: { A, B }
eTCustomField02: { A, C }

다음 규칙은:

%*ALLOF(%*UCU01%,%*UCU02%)%

3개의 값{ A, B, C }으로 평가됩니다.

DATE

dd/mm/yyyy 형식의 현재 날짜로 평가됩니다. 규칙 식 %D%는 다음 중 하나와 동일합니다.

%$$DATE()%
%$$DATE%

FIRSTOF

매개 변수의 첫 번째 값을 반환합니다. 특성이 설정되지 않은 경우 기본값을 삽입하기 위해 사용됩니다.

%$$FIRSTOF(%UCU01%,'unknown')%
%$$FIRSTOF(%LN%,%UCU01%,%U%)%

어떠한 값도 설정되지 않은 경우 결과는 값 없음입니다. 인수에 상수 문자열을 입력하려면 작은따옴표로 묶으십시오.

INDEX

다중 값이 있는 특성의 값 하나를 반환합니다. 색인 1은 첫 번째 값입니다. 색인이 값의 개수보다 많으면 결과는 설정되지 않은(빈) 값입니다. 다음 규칙은 다음과 동일합니다.

%$$INDEX(%*UCU01%,1)%

%$$FIRSTOF(%*UCU01%)%

NOTEMPTY

인수 하나의 단일 값을 반환하지만 이 특성 값이 설정되지 않은 경우 오류를 보고합니다.

예 1:

사용자에게 할당된 UID 특성이 없는 경우 계정 생성 또는 업데이트가 실패합니다.

%$$NOTEMPTY(%UID%)%

예 2:

설정된 경우 이름을 사용하고 설정되지 않은 경우 성을 사용합니다. 둘 다 설정되지 않은 경우 계정 생성 또는 업데이트가 실패합니다.

%$$NOTEMPTY(

%$$FIRSTOF(

%UF%,

%UL%

)%

)%

PRIMARYEMAIL

여러 전자 메일 주소에서 추출한 기본 전자 메일 주소를 반환합니다. 식 %UE%는 다음과 동일합니다.

%$$PRIMARYEMAIL(%UEP%)%

RDNVALUE

특성 값을 LDAP 고유 이름처럼 다루고 해당 DN에서 개체의 일반 이름을 추출합니다.

%*$$RDNVALUE(%#eTRoleDN%)%

이 함수는 할당된 모든 프로비져닝 역할의 일반 이름을 반환합니다. 사용자가 동일한 일반 이름을 사용하는 프로비져닝 역할에 속하는 경우 해당 역할 이름은 한 번만 나열됩니다.

TOLOWER

대문자 텍스트를 소문자로 변환합니다.

%$$TOLOWER(%AC%)%

TOUPPER

소문자 텍스트를 대문자로 변환합니다.

%$$TOUPPER(%U%)%

TRIM

특성 값에서 맨 앞 및 맨 뒤의 공백 문자를 제거합니다.

예를 들어, "%UF %UL%"는 일반적으로 이름과 성이 공백 문자로 구분된 값을 만듭니다. 하지만 사용자의 이름 특성이 비어 있으면 이 규칙은 끝에 공백을 넣는 값을 생성합니다. 하지만 다음을 사용하면

“%$$TRIM(%UF% %UL%)%

이름 또는 성 중 하나가 설정되지 않은 경우라도 계정 특성 값의 앞 또는 뒤에서 공백이 제거됩니다.