수식 참조 V2

Vault에서 다양한 작업을 수행하는 수식을 만들 수 있습니다. Vault는 날짜와 텍스트 문자열, 숫자를 계산할 수 있는 함수와 연산자를 포함하여 Excel™과 유사한 함수 언어를 사용합니다.

개념

다음 개념을 검토하여 Vault에서 수식이 작동하는 방식을 숙지하십시오.

• 함수란 무엇입니까?
• 함수는 어디에 사용됩니까?
• 함수의 요소
• 연산자 및 함수&
• 변수 및 참조&

함수란 무엇입니까?

함수는 원하는 결과를 만들기 위한 일련의 지침입니다. 화학식(2개의 H와 1개의 O가 H2O 구성)을 예로 들 수 있습니다. 수소와 산소가 물과 "동일"하지 않다는 의미에서 방정식은 아니지만, 물을 만드는 데 사용할 수 있습니다. 경우에 따라 함수는 서로 다른 변수 간의 관계를 보여 주는 특수한 유형의 방정식입니다. 이 경우 함수는 변수 값을 대체하여 평가(푸는 것이 아님)하게 됩니다.

함수를 평가한 후 Vault는 값 또는 True/False를 반환합니다.

함수는 어디에 사용됩니까?

함수는 Vault CDMS 내의 여러 위치에서 사용됩니다.

• 데이터 검증 룰
• 파생 아이템
• 단위 변환
• 보기의 파생 열
• 함수 필드
• 필드 기본값

함수의 요소

함수은 하나 이상의 표현식과 인수로 구성됩니다. 각 표현식에는 결과를 계산하기 위한 값, 함수, 연산자, 참조 및 변수가 포함되어 있습니다. 인수는 연산자 또는 함수가 표현식의 결과에 따라 작동하는 경우입니다.

연산자 및 함수&

연산자 및 함수는 함수 내의 행위자입니다. 함수 내의 표현식 및 값에 대해 작업을 수행하여 결과를 출력할 수 있습니다.

"연산자"와 "함수"의 차이점은 무엇입니까?

모든 연산자는 함수이지만 모든 함수가 연산자는 아닙니다. 연산자는 입력한 것과 동일한 데이터 형식을 배타적으로 반환하지만 함수는 다른 데이터 형식을 반환할 수 있습니다. 예를 들어 연산자 Add()와 함수 Value()를 생각해 보십시오. 둘 다 수학 함수로 간주됩니다. 두 숫자를 더하면 함수는 숫자를 반환합니다. Add(2, 2)는 4를 반환합니다. Value() 함수를 사용할 때 텍스트를 입력하면 함수는 숫자를 출력합니다. Value(Right("Veeofen 20", 2)는 텍스트 문자열 대신 숫자 20을 반환합니다.

이 참조에는 현재 Vault에서 지원되는 모든 연산자 및 함수 목록이 포함되어 있습니다.

변수 및 참조&

함수 내에서 변수와 참조를 사용하여 실행 데이터의 자리 표시자 역할을 하도록 할 수 있습니다. Vault는 시스템이 함수를 평가할 때 변수와 참조를 실제 실행 값으로 바꿉니다. Studio에서 데이터 검증 룰을 작성하는 경우, 식별자를 사용하여 데이터 수집 아이템을 호출할 때마다 변수를 사용하게 됩니다. Vault 수식의 컨텍스트에서 참조는 오브젝트의 값 대신 관련 오브젝트의 값을 가리키는 변수입니다. 예를 들어 $site__vr.status__v를 사용하는 경우 Vault는 해당 참조를 사이트 오브젝트의 상태 값으로 바꿉니다.

연산자

함수를 작성할 때 아래 연산자를 사용하십시오. 모든 연산자는 달리 지정하지 않는 한 함수를 포함할 수 있는 모든 위치에서 사용할 수 있습니다.

수학 연산자

수학 연산자는 표현식 내에서 수학 연산을 수행합니다.

Add

두 값의 합계를 계산합니다.

구문

+

사용

value1 + value2

데이터 유형

Add 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

• 숫자가 있는 날짜 시간(숫자를 일수로 해석)

• 숫자가 있는 날짜(숫자를 일수로 해석)

• 시간이 있는 날짜 시간

• 간격이 있는 날짜

• 간격이 있는 날짜 시간

예시

Subtract

두 값의 차이를 계산합니다.

구문

-

사용

value1 - value2

데이터 유형

Subtract 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

• 날짜

• 날짜 시간

• 숫자가 있는 날짜 시간(숫자를 일수로 해석)

• 숫자가 있는 날짜(숫자를 일수로 해석)

• 날짜 시간이 있는 날짜(날짜 시간을 날짜로 변환)

• 간격이 있는 날짜

• 간격이 있는 날짜 시간

• 시간이 있는 시간(시간차를 분 단위로 반환)

예시

Multiply

두 값을 곱합니다.

구문

*

사용

value1 * value2

데이터 유형

Multiply 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

예시

Divide

두 값을 곱합니다.

구문

/

사용

value1 / value2

데이터 유형

Divide 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

예시

Remainder

한 값을 다른 값으로 나눈 나머지입니다.

구문

%

사용

value1 % value2

데이터 유형

Remainder 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

예시

Parenthesis

먼저 괄호 안의 표현식을 평가합니다.

구문

()

사용

(expression1)expression2

데이터 유형

Parenthesis 연산자는 다음과 같은 데이터 형식을 허용합니다.

예시

논리 연산자

논리 연산자는 표현식 내에서 논리 연산을 수행합니다.

Equal

두 값이 같은지 평가합니다.

구문

=

사용

value1 = value2

데이터 유형

Equal 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

• 텍스트

• 날짜

• 날짜 시간

• 날짜가 있는 날짜 시간(날짜 시간을 날짜로 변환)

• 예/아니요

• 선택 목록(두 선택 목록 모두 단일 값이어야 함)

• 텍스트가 있는 선택 목록

예시

메모

• 날짜를 날짜 시간과 비교할 때 Vault는 Vault의 시간대를 사용하여 날짜 시간을 날짜로 변환합니다.

• 선택 목록 함수 및 연산자는 값 레이블 대신 값 이름을 평가합니다. 예를 들어 선택 목록인 레벨(level__v)에는 study_level__v, country_level__v, site_level__v라는 3개의 값이 있으며 각각은 스터디, 국가 및 사이트라는 레이블이 있습니다. 선택 목록의 값을 평가하려면 레이블 대신 이름(예: level__v = "country_level__v")을 사용하여 함수를 정의합니다.

Not Equal

두 값이 같지 않은지 평가합니다.

구문

!=

사용

value1 != value2

데이터 유형

Not Equal 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

• 텍스트

• 날짜

• 날짜 시간

• 날짜가 있는 날짜 시간(날짜 시간을 날짜로 변환)

• 예/아니요

• 선택 목록(두 선택 목록 모두 단일 값이어야 함)

• 텍스트가 있는 선택 목록

예시

메모

• 날짜를 날짜 시간과 비교할 때 Vault는 Vault의 시간대를 사용하여 날짜 시간을 날짜로 변환합니다.

• 선택 목록 함수 및 연산자는 값 레이블 대신 값 이름을 평가합니다. 예를 들어 선택 목록인 레벨(level__v)에는 study_level__v, country_level__v, site_level__v라는 3개의 값이 있으며 각각은 스터디, 국가 및 사이트라는 레이블이 있습니다. 선택 목록의 값을 평가하려면 레이블 대신 이름(예: level__v = "country_level__v")을 사용하여 함수를 정의합니다.

Less Than

한 값이 다른 값보다 작은지 평가합니다.

구문

<

사용

value1 < value2

데이터 유형

미만 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

• 날짜

• 날짜 시간

• 날짜 시간이 있는 날짜(날짜 시간을 날짜로 변환)

예시

메모

• 날짜를 날짜 시간과 비교할 때 Vault는 날짜 시간을 날짜로 변환합니다.

Less Than or Equal To

한 값이 다른 값 이하인지 평가합니다.

구문

<=

사용

value1 <= value2

데이터 유형

Less Than or Equal To 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

• 날짜

• 날짜 시간

• 날짜 시간이 있는 날짜(날짜 시간을 날짜로 변환)

예시

메모

• 날짜를 날짜 시간과 비교할 때 Vault는 날짜 시간을 날짜로 변환합니다.

Greater Than

한 값이 다른 값보다 큰지 평가합니다.

구문

>

사용

value1 > value2

데이터 유형

Greater Than 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

• 날짜

• 날짜 시간

• 날짜 시간이 있는 날짜(날짜 시간을 날짜로 변환)

예시

메모

• 날짜를 날짜 시간과 비교할 때 Vault는 날짜 시간을 날짜로 변환합니다.

Greater Than or Equal To

한 값이 다른 값 이상인지 평가합니다.

구문

>=

사용

value1 >= value2

데이터 유형

Greater Than or Equal To 연산자는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

• 날짜

• 날짜 시간

• 날짜 시간이 있는 날짜(날짜 시간을 날짜로 변환)

예시

메모

• 날짜를 날짜 시간과 비교할 때 Vault는 날짜 시간을 날짜로 변환합니다.

And

두 값 또는 표현식이 모두 true인지 평가합니다.

구문

&&

&& 대신 And()를 사용할 수도 있습니다.

사용

(expression) && (expression)

데이터 유형

And 연산자는 다음과 같은 데이터 형식을 허용합니다.

예시

Or

두 값 또는 표현식 중 하나 이상이 true인지 평가합니다.

구문

||

|| 대신 Or()를 사용할 수도 있습니다.

사용

(expression) || (expression)

데이터 유형

Or 연산자는 다음과 같은 데이터 형식을 허용합니다.

예시

텍스트 연산자

텍스트 연산자는 표현식 내에서 텍스트 연산을 수행합니다.

Concatenate

둘 이상의 텍스트 문자열을 연결합니다.

구문

&

& 대신 Concat()를 사용할 수도 있습니다.

사용

텍스트 & 텍스트

데이터 유형

Concatenate 연산자는 다음과 같은 데이터 형식을 허용합니다.

예시

함수

함수를 작성할 때 아래 함수를 사용하십시오. 모든 함수는 달리 지정하지 않는 한 함수를 포함할 수 있는 모든 위치에서 사용할 수 있습니다.

수학 함수

수학 함수는 표현식 내에서 수학 함수를 수행합니다.

Abs

숫자의 절대값을 계산합니다.

구문

Abs()

사용

Abs(number)

예시

Average

해당 숫자의 평균을 계산합니다.

구문

Average()

사용

Average(number, number, number...)

예시

Ceiling

해당 값에서 다음으로 큰 정수를 반환합니다.

구문

Ceiling()

사용

Ceiling(number)

예시

Floor

해당 값에서 다음으로 작은 정수를 반환합니다.

구문

Floor()

사용

Floor(number)

예시

Max

설정값에서 가장 큰 수를 반환합니다.

구문

Max()

사용

Max(number, number...)

예시

메모

• 이 함수는 숫자, 날짜 및 날짜 시간 데이터 형식과 함께 사용할 수 있습니다. 단일 Max() 요청에서 데이터 유형을 혼합할 수 없습니다. 날짜와 날짜 시간을 혼합해야 하는 경우 DateValue를 사용하여 날짜 시간을 날짜로 변환하십시오.

Median

인수의 중앙값을 계산합니다. 이 함수는 숫자 데이터 형식의 인수를 허용합니다.

구문

Median()

사용

Median(number, number...)

예시

Min

세트에서 가장 작은 숫자를 반환합니다.

구문

Min()

사용

Min(number, number...)

예시

메모

• 이 함수는 숫자, 날짜 및 날짜 시간 데이터 형식과 함께 사용할 수 있습니다. 단일 Min() 요청에서 데이터 유형을 혼합할 수 없습니다. 날짜와 날짜 시간을 혼합해야 하는 경우 DateValue를 사용하여 날짜 시간을 날짜로 변환하십시오.

Power

숫자의 값을 다른 숫자(지수)의 거듭제곱으로 올립니다.

구문

Power()

사용

Power(number, number)

예시

Round

값을 정의된 소수 자릿수로 반올림합니다.

구문

Round()

사용

Round(number, number of decimal places)

예시

메모

• Vault는 소수점 오른쪽에 있는 숫자를 기준으로 숫자를 반올림합니다. 이 숫자가 5보다 크면 Vault에서 반올림되거나 0에서 멀어집니다. 이 숫자가 5보다 작으면 Vault에서 내림되거나 0에 가까워집니다.

Sqrt

수의 제곱근을 반환합니다.

구문

Sqrt()

사용

Sqrt(number)

예시

메모

• 숫자는 양수여야 합니다.

Sum

해당 숫자의 평균을 계산합니다.

구문

Sum()

사용

Sum(number, number, number...)

예시

Value

텍스트 문자열을 숫자로 반환합니다.

구문

Value()

사용

Value(text)

예시

메모

• 숫자로 확인되지 않는 Value 함수에 텍스트를 입력하면 오류가 발생합니다.

논리 함수

논리 함수는 표현식 내에서 논리 함수를 수행합니다.

And

모든 표현식이 true일 때 true를 반환합니다.

구문

And()

And() 대신 &&를 사용할 수도 있습니다.

사용

And(expression, expression)

예시

Case

표현식의 값을 각 사례별 값과 비교하여 결과 쌍을 반환합니다. 일치하는 값이 없으면 마지막 인수를 반환합니다.

구문

Case()

사용

Case(expression1, value1, result1, value2, result2, else_result)

데이터 유형

Case 함수는 다음과 같은 데이터 형식을 허용합니다.

• 숫자

• 텍스트

• 예/아니요

• 선택 목록

예시

메모

• 선택 목록 필드(예: picklist__c)로 작업할 때 필드는 값 레이블(스터디) 대신 값 이름(study__v)을 반환합니다.

If

표현식이 true인지 false인지 결정합니다. true이면 주어진 값을 반환하고 false이면 다른 값을 반환합니다.

구문

If()

사용

If(expression1, value1, value2)

예시

Includes

선택 목록에 정의된 문자열 또는 단일 값 선택 목록과 일치하는 이름이 포함된 경우 true를 반환합니다.

구문

Includes()

사용

Includes(문자열/선택 목록 값)

예시

메모

• 다중 값 선택 목록은 Vault Platform에서 사용할 수 있습니다. CDMS의 경우 FindValue() 함수를 사용하여 선택 목록에서 선택한 값을 찾습니다.

IsBlank

값이 비어 있는 경우 true를 반환합니다.

구문

IsBlank()

사용

IsBlank(expression)

예시

IsNumber

값이 숫자인 경우 true를 반환합니다.

구문

IsNumber()

사용

IsNumber(text)

예시

Not

표현식이 false인 경우 true를 반환하고 표현식이 true인 경우 false를 반환합니다.

구문

Not()

사용

Not(expression)

예시

Or

어느 한 조건이든 true인 경우 true를 반환합니다.

구문

Or()

사용

Or(expression, expression)

예시

텍스트 함수

논리 함수는 표현식 내에서 논리 함수를 수행합니다.

Concat

둘 이상의 텍스트 문자열을 연결합니다.

구문

Concat()

Concat() 대신 &를 사용할 수도 있습니다.

사용

Concat(text, text...)

예시

Find

텍스트 문자열 내의 문자열 위치를 반환합니다.

구문

Find()

사용

찾기(find_text, within_text)

예시

Left

텍스트 문자열의 시작에서 지정된 수만큼의 문자를 반환합니다.

구문

Left()

사용

Left(text, number)

예시

Length

지정된 텍스트 문자열에 포함된 문자 수를 반환합니다.

구문

Length()

사용

Length(text)

Lower

지정된 문자열의 모든 글자를 소문자로 변환합니다.

구문

Lower()

사용

Lower(text)

예시

Middle

지정된 두 위치 사이에 있는 텍스트 문자 수를 반환합니다.

구문

Middle()

사용

Middle(text, start_position, count)

예시

Right

텍스트 문자열의 끝에서 지정된 수만큼의 문자를 반환합니다.

구문

Right()

사용

Right(text, number)

예시

Substitute

문자열의 이전 텍스트를 새 텍스트로 대체합니다.

구문

Substitute()

사용

Substitute(text, old_text, new_text)

예시

Text

지정된 형식에 따라 값을 텍스트로 변환합니다.

구문

Text()

사용

Text(value, "format")

예시

메모

• d 1(1자리 숫자로 표시된 일)

• dd 01(2자리 숫자로 표시된 일)

• ddd Thu(3자리 문자로 표시된 요일)

• dddd Thursday(요일의 전체 명칭)

• mm 03(2자리 문자로 표시된 월)

• mmm Mar(3자리 문자로 표시된 월)

• mmmm March(월의 전체 명칭)

• yy 17(2자리 숫자로 표시된 연도)

• yyyy 2017(연도의 전체 숫자)

• dd-mm-yyyy 31-03-2017

• yyyymmdd 20170331

• dd.mmm.yyyy 30.Mar.2017

• yyyy-mm-dd 2017-03-30

• mmmm yyyy March 2017

• dddd dd/mm/yy Thursday 31/03/17

Trim

텍스트 문자열의 시작과 끝에서 공백과 탭을 제거합니다.

구문

Trim()

사용

Trim(text)

예시

Upper

지정된 텍스트 문자열의 모든 글자를 대문자로 변환합니다.

구문

Upper()

사용

Upper(text)

예시

집계 함수

집계 함수는 표현식 내의 집계 식별자의 값에 대해 함수를 수행합니다. 이러한 집계 함수 중 일부는 모든 식별자 유형과 함께 사용할 수도 있는데, 집계 식별자에 사용할 수 있는 함수의 전체 목록을 제공하기 위해 아래에 나열되어 있습니다.

AllEqual

집계 식별자의 모든 값이 같은지 확인합니다. 값이 같은 경우 true를 반환하고 값이 같지 않은 경우 false를 반환합니다.

구문

AllEqual()

사용

AllEqual(Identifier, Identifier, ...)

예시

Average

집계 식별자에서 모든 값의 평균을 반환합니다.

구문

Average()

사용

Average(Identifier), Average(Identifier, Identifier)

예시

Count

집계 식별자의 인스턴스 수(예: 식별된 반복 폼의 인스턴스 수)를 반환합니다.

구문

Count()

사용

Count(Identifier, Identifier, ...)

예시

메모

• 이 함수에는 빈(또는 null) 값이 포함됩니다. 아이템이 비어 있거나 의도적으로 비워 둔 것으로 표시된 경우 개수에 포함됩니다. NoBlank 함수를 사용하여 null 값을 제거합니다.

CountIf

지정된 모든 식별자에서 지정된 값을 찾을 수 있는 횟수를 반환합니다.

구문

CountIf()

사용

CountIf(Value, Identifier, Identifier)

예시

FindValue

지정된 값이 표현식의 식별자에 대한 값 중 하나 이상에 있는지 확인합니다.

구문

FindValue()

사용

FindValue(value, identifier)

예시

First

집계 식별자의 첫 번째(가장 낮은 시퀀스 번호) 값을 반환합니다.

구문

First()

사용

First(Identifier)

예시

GetAllMatches

두 번째 파라미터에서 값(첫 번째 파라미터)을 찾을 수 있는 동일한 인스턴스에서 발견되는 세 번째 파라미터의 값 어레이를 반환합니다. 전달된 두 식별자는 모두 동일한 수의 값을 가져야 합니다. 따라서 두 식별자 모두 동일한 집계 경로를 사용해야 합니다.

구문

GetAllMatches()

사용

GetAllMatches(Value, Identifier, Identifier)

예시

메모

• 집계 경로:
  • 첫 번째 식별자가 $EG[*].EV.F.IG.IT인 경우 두 번째 식별자는 $EG[*]로 시작해야 합니다.
  • 첫 번째 식별자가 $EG.EV.F[*].IG.IT인 경우 두 번째 식별자는 $EG.EV.F[*]로 시작해야 합니다.
  • 첫 번째 식별자가 $EG.EV.F.IG[*].IT인 경우 두 번째 식별자는 $EG.EV.F.IG[*]로 시작해야 합니다.
  • 첫 번째 식별자가 $EG[*].EV.F[*].IG[*].IT인 경우 두 번째 식별자는 $EG[*].EV.F[*].IG[*]로 시작해야 합니다.
  • 첫 번째 식별자가 $EG[*].EV.F[*].IG.IT인 경우 두 번째 식별자는 $EG[*].EV.F[*]로 시작해야 합니다.
  • 첫 번째 식별자가 $EG[*].EV.F.IG[*].IT인 경우 두 번째 식별자는 $EG[*].EV.F.IG[*]로 시작해야 합니다.
  • 첫 번째 식별자가 $EG.EV.F[*].IG[*].IT인 경우 두 번째 식별자는 $EG.EV.F[*].IG[*]로 시작해야 합니다.

HasDuplicates

2+ 어레이가 내부의 모든 식별자에 대해 동일한 값을 가지는 경우 true를 반환합니다. 중복 항목이 null 또는 빈 값인 경우 true를 반환하지 않습니다. null 또는 빈 값은 기본적으로 무시됩니다.

구문

HasDuplicates()

사용

HasDuplicates(Identifier1, Identifier2, Identifier3)

예시

IsBlank

어레이가 비어 있는 경우 true를 반환합니다. 어레이에 값이 하나 이상 있는 경우 해당 값이 null이라도 false를 반환합니다.

구문

IsAnyBlank()

사용

IsBlank(expression)

예시

IsAnyBlank

식별자의 값이 비어 있는지 확인합니다. 공백이 있는 경우 true를 반환합니다.

구문

IsAnyBlank()

사용

IsAnyBlank(Identifier, Identifier, ...)

예시

Last

집계 식별자의 마지막(가장 높은 시퀀스 번호) 값을 반환합니다.

구문

Last()

사용

Last(Identifier)

예시

Max

집계 식별자 값의 최대 값(가장 높은 값, 가장 큰 값)을 반환합니다.

구문

Max()

사용

Max(Identifier), Max(Identifier, Identifier)

예시

Median

인수의 중앙값을 계산합니다. 이 함수는 숫자 데이터 형식의 인수를 허용합니다.

구문

Median()

사용

Median(number, number...)

예시

Min

집계 식별자 값의 최소 값(가장 낮은 값, 가장 작은 값)을 반환합니다.

구문

Min()

사용

Min(Identifier), Min(Identifier, Identifier)

예시

NoBlanks

값 어레이를 null 값이 제거된 상태로 반환합니다. 이 함수는 전달된 값의 원래 순서를 유지합니다.

구문

NoBlanks()

사용

NoBlanks(Identifier, Identifier, ....)

예시

Sum

집계 식별자에서 값의 평균을 반환합니다.

구문

Sum()

사용

Sum(Identifier)

예시

날짜 및 날짜 시간 함수&

날짜 및 날짜 시간 함수는 표현식 내에서 날짜 및 날짜 시간 함수를 수행합니다.

Date

연도, 월 및 일 값에서 날짜 값을 반환합니다.

구문

Date()

사용

Date(year, month, day)

예시

DateValue

날짜 시간의 날짜 부분을 반환합니다.

구문

DateValue()

사용

DateValue(datetime)

예시

Day

일을 반환합니다.

구문

Day()

사용

Day(date)

예시

Days

지정된 일 수를 간격으로 반환합니다.

구문

Days()

사용

Days(number)

예시

Hour

0에서 23 사이의 현재 시간을 반환합니다.

구문

Hour()

사용

Hour()

예시

Hours

지정된 시간 수를 간격으로 반환합니다.

구문

Hours()

사용

Hours(number)

예시

메모

• 현재 릴리스에서 이 함수는 InInWindow() 함수 내에서 시간 간격을 정의하는 데만 사용할 수 있습니다.

• 이 함수는 날짜 시간 또는 시간 아이템에서 시를 반환하지 않습니다.

• 이 함수는 소수 자릿수와 함께 사용하지 마십시오. 대신 동일한 분 수와 함께 Minutes() 함수를 사용하십시오(예: Hours(0.5) 대신 Minutes(30)).

Minute

0에서 59 사이의 현재 분을 반환합니다.

구문

Minute()

사용

Minute()

예시

Minutes

지정된 분 수를 간격으로 반환합니다.

구문

Minutes()

사용

Minutes(number)

예시

메모

• 현재 릴리스에서 이 함수는 InInWindow() 함수 내에서 시간 간격을 정의하는 데만 사용할 수 있습니다.

Month

날짜에서 월을 반환합니다.

구문

Month()

사용

Month(date), Month(datetime)

예시

Months

지정된 개월 수를 간격으로 반환합니다.

구문

Months()

사용

Months(number)

예시

NetWorkdays

두 날짜 또는 날짜 시간 간의 영업일 수를 반환합니다. 이 함수는 날짜와 날짜 시간의 혼합을 지원합니다. 날짜 시간을 사용할 때는 시간대에 유의해야 합니다. 이 함수는 주말 및 공휴일 일정에 대한 선택적 파라미터도 허용합니다. 어드민은 비즈니스 어드민(Business Admin) > 공휴일 일정(Holiday Schedules)에서 공휴일을 구성할 수 있습니다.

구문

NetWorkdays()

사용

NetWorkdays(start_date/datetime, number_of_days, weekend_number, holiday_schedule)

예시

Now

현재 날짜 및 시간을 반환합니다.

구문

Now()

사용

Now(), Now(Timezone)

예시

메모

• timezone 파라미터가 없는 Now()는 현재 날짜 시간을 UTC로 반환합니다.

• timezone 파라미터를 사용하여 현재 날짜 시간을 반환할 표준 시간대를 지정하십시오. 이 항목 형식 목록을 참조하십시오.

• 사이트의 시간대로 현재 날짜를 반환하려면 DateValue(Now(), @Site.timezone__v)를 사용할수 있습니다.

Second

0에서 59 사이의 현재 초를 반환합니다.

구문

Second()

사용

Second()

예시

StartOfDay

지정된 시간대에서 하루의 시작에 해당하는 날짜 시간을 UTC로 반환합니다.

구문

StartOfDay()

사용

StartOfDay(day, "Timezone")

예시

Time

지정된 시, 분, 초를 기준으로 시간을 반환합니다.

구문

Time()

사용

Time(hour, minute, second)

예시

Today

사용자의 현재 날짜를 반환합니다. 선택적 "timezone" 파라미터를 포함하여 특정 시간대의 현재 날짜를 반환합니다.

구문

Today()

사용

Today(), Today("timezone")

예시

Weekday

날짜 또는 날짜 시간의 요일을 1~7의 숫자로 반환합니다.

구문

Weekday()

사용

Weekday(date), Weekday(datetime)

예시

Workday

주말 및 공휴일(선택 사항)을 제외하고 지정된 일수 후의 미래 날짜를 반환합니다. 이 함수는 주말 및 공휴일 일정에 대한 선택적 파라미터도 허용합니다. 어드민은 비즈니스 어드민(Business Admin) > 공휴일 일정(Holiday Schedules)에서 공휴일을 구성할 수 있습니다.

구문

Workday()

사용

Workday(start_date/datetime, number_of_days, weekend_number, holiday_schedule)

예시

Year

지정된 날짜 또는 날짜 시간에서 연도를 반환합니다. 날짜 또는 날짜 시간가 제공되지 않은 경우 현재 연도를 반환합니다.

구문

Year()

사용

Year(date)

예시

Years

지정된 연 수를 간격으로 반환합니다.

구문

Years()

사용

Years(number)

예시

MaxDate

날짜의 알 수 없는 부분을 가능한 최대 값으로 바꿉니다.

구문

MaxDate()

사용

MaxDate(unknown date), MaxDate(unknown date, timezone)

예시

메모

• MaxDate()를 사용해 알 수 없는 항목이 있는 날짜를 래핑하여 표현식에 사용할 수 있습니다.

• 알 수 없는 항목이 없는 날짜에 MaxDate()를 사용하면 원래 날짜만 반환됩니다.

• timezone 파라미터를 사용하여 현재 날짜를 반환할 표준 시간대를 지정하십시오. 이 항목 형식 목록을 참조하십시오.

MinDate

날짜의 알 수 없는 부분을 가능한 최소 값으로 바꿉니다.

구문

MinDate()

사용

MinDate(unknown date), , MinDate(unknown date, timezone)

예시

메모

• MinDate()를 사용해 알 수 없는 항목이 있는 날짜를 래핑하여 표현식에 사용할 수 있습니다.

• 알 수 없는 항목이 없는 날짜에 MinDate()를 사용하면 원래 날짜만 반환됩니다.

• timezone 파라미터를 사용하여 현재 날짜를 반환할 표준 시간대를 지정하십시오. 이 항목 형식 목록을 참조하십시오.

MaxDateTime

날짜 시간의 알 수 없는 부분을 가능한 최대 값으로 바꿉니다.

구문

MaxDateTime()

사용

MaxDateTime(unknown date), MaxDateTime(unknown date, timezone)

예시

메모

• 알 수 없는 항목이 없는 날짜 시간에 MaxDateTime()을 사용하면 원래 날짜 시간만 반환됩니다.

• 알 수 없는 시간의 경우 Vault는 시로 23, 분으로 59를 반환합니다(즉, 23:59).

• MaxDateTime()은 정규화된 값을 얻기 위해 적용되는 UTC 시간으로의 변환에 영향을 받기 때문에, 아이템의 값을 설정하는 독립 실행형 함수로 사용해서는 안 됩니다. 대신 알려진 날짜 시간을 평가해야 하는 계산 및 비교를 수행하는 데 이 함수를 사용하십시오.

• timezone 파라미터를 사용하여 현재 날짜 시간을 반환할 표준 시간대를 지정하십시오. 이 항목 형식 목록을 참조하십시오.

MinDateTime

날짜 시간의 알 수 없는 부분을 가능한 최소 값으로 바꿉니다.

구문

MinDateTime()

사용

MinDateTime(unknown date), MinDateTime(unknown date, timezone)

예시

메모

• 알 수 없는 항목이 없는 날짜 시간에 MinDateTime()을 사용하면 원래 날짜 시간만 반환됩니다.

• 알 수 없는 시간의 경우 Vault는 시와 분 모두 00을 반환합니다(즉, 00:).

• MinDateTime()은 정규화된 값을 얻기 위해 적용되는 UTC 시간으로의 변환에 영향을 받기 때문에, 아이템의 값을 설정하는 독립 실행형 함수로 사용해서는 안 됩니다. 대신 알려진 날짜 시간을 평가해야 하는 계산 및 비교를 수행하는 데 이 함수를 사용하십시오.

• timezone 파라미터를 사용하여 현재 날짜 시간을 반환할 표준 시간대를 지정하십시오. 이 항목 형식 목록을 참조하십시오.

InWindow

날짜가 참조 날짜를 기준으로 지정된 기간 내에 있는 경우 true를 반환합니다.

구문

InWindow()

사용

InWindow(date, date, interval, interval, boolean, boolean)

데이터 유형

InWindow 함수는 다음과 같은 데이터 형식을 허용합니다.

• 날짜

• 날짜 시간

• 시간

예시

메모

• 데이터 형식이 같은 오브젝트만 비교할 수 있습니다(날짜와 날짜, 날짜 시간과 날짜 시간, 시간과 시간).

• 시간 간격은 Minutes(), Hours(), Days(), Months(), Years() 함수를 사용하여 정의할 수 있습니다.

• 2개의 불린(Boolean) 인수는 하한(첫 번째 인수)과 상한(두 번째 인수)이 전체 창에 포함되는지 여부를 나타냅니다. true는 경계가 제외됨을 의미하고 false는 경계가 포함됨을 의미합니다.

SiteDateTime

사이트 시간대의 날짜 아이템 및 시간 아이템에서 날짜 시간을 자동으로 생성합니다.

구문

SiteDateTime()

사용

SiteDateTime(date, time)

데이터 유형

SiteDateTime 함수는 다음과 같은 데이터 형식을 허용합니다.

• 날짜

• 시간

예시

SiteDateValue

날짜 시간 아이템에서 날짜를 반환하고 자동으로 사이트 시간대에 넣습니다.

구문

SiteDateValue()

사용

SiteDateValue(datetime)

데이터 유형

SiteDateValue 함수는 다음과 같은 데이터 형식을 허용합니다.

• Datetime

예시

메모

• MinDateTime 및 MaxDateTime은 날짜 부분을 알 수 없는 경우 이 함수에 대해 지원되지 않습니다.

사용되지 않는 함수

다음 함수는 새 표현식 문법에서 더 이상 사용할 수 없습니다.

Concatenate

둘 이상의 텍스트 문자열을 연결합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

Concatenate(text, text)

대신 사용

Concat()&

DateAdd

시작 날짜(date)로부터의 오프셋(interval)을 기준으로 날짜를 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

DateAdd(date, interval)

대신 사용

date + number and date + interval

DateDiff

두 날짜의 차이를 일수로 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

DateDiff(end, start)

대신 사용

date - date

DateTimeAdd

시작 날짜 시간(datetime)으로부터의 오프셋(interval)을 기준으로 날짜 시간 값을 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

DateTimeAdd(datetime, interval)

대신 사용

dateTime + number and dateTime + interval

DateTimeDiff

두 날짜 시간 값의 차이를 일, 시간 및 분 단위 수로 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

DateTimeDiff(end, start)

대신 사용

dateTime - dateTime

IfBlank

이 함수는 첫 번째 인수가 비어 있는 경우 두 번째 인수를 반환합니다. 비어 있지 않은 경우 첫 번째 인수를 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

IfBlank(expression, expression)

대신 사용

If(IsBlank())

IfNull

이 함수는 첫 번째 인수가 null인 경우 두 번째 인수를 반환합니다. null이 아닌 경우 첫 번째 인수를 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

IfNull(expression, expression)

대신 사용

If(IsBlank())

IsNull

값이 null이면 true를 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

IsNull(expression, expression)

대신 사용

If(IsBlank())

NumberEquals

두 숫자 인수가 모두 같은 경우 true를 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

NumberEquals(number, number)

대신 사용

=

PicklistEquals

선택 목록 값의 기본 레이블을 기존 전역 선택 목록 값의 기본 레이블과 비교하고 true 또는 false를 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

PicklistEquals(<picklist_field>, picklist_value__v)

대신 사용

=

TextEquals

두 텍스트 문자열이 모두 같은 경우 true를 반환합니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

TextEquals(text, text)

대신 사용

=

TimeDiff

두 시간의 차이를 분 수로 반환합니다. 이 함수는 종료 시간(end)에서 시작 시간(start)을 뺍니다. 이 함수는 표현식 엔진 V1을 사용하는 스터디에서만 사용할 수 있습니다. V2에서 사용할 함수에 대해서는 '대신 사용'을 참조하십시오.

구문

TimeDiff(end, start)

대신 사용

Time - Time

날짜 형식

아래 표에는 사용 가능한 날짜 형식이 나열되어 있습니다.

숫자 형식

아래 표에는 사용 가능한 숫자 형식이 나열되어 있습니다.

시스템 변수

시스템 변수는 하나 이상의 Vault 애플리케이션에서 참조할 수 있는 값을 저장하는 시스템 정의 동적 오브젝트입니다. 사용되는 컨텍스트에 따라 값이 변경된다는 점에서 동적입니다. 예를 들어 @User는 현재 로그인한 사용자의 프로필을 가리키며, 사용자의 상태 또는 이메일과 같은 여러 속성에 대한 접속을 허용하는 시스템 변수입니다.

Vault Platform 시스템 변수

현재 릴리스에서는 Vault EDC에서 @User라는 하나의 Vault Platform 시스템 변수가 지원됩니다. 룰을 작성할 때 이 변수를 참조할 수 있습니다.

@User

현재 로그인한 사용자를 참조합니다.

속성 예시

• @User.name__v: 현재 사용자의 이름을 반환합니다.

• @User.status__v: 현재 사용자의 상태를 반환합니다.

• @User.email__v: 현재 사용자의 이메일을 반환합니다.

• @User.securityProfile__v: 현재 사용자의 보안 프로필을 반환합니다.

• @User.language__v: 현재 사용자의 언어를 반환합니다.

• @User.timezone__v: 현재 사용자의 시간대를 반환합니다.

사용 예시

Vault EDC 시스템 변수

EDC에는 룰을 작성할 때 사용할 수 있는 몇 가지 특정 시스템 변수가 있습니다. 이러한 변수를 사용하면 스터디 또는 사례집 계층의 오브젝트에 빠르게 접속할 수 있습니다.

시스템 변수에 사용하기 위해 Vault EDC에서 사용할 수 있는 오브젝트 및 필드는 다음과 같습니다.

스터디

시스템 참조 및 변수에 사용할 수 있는 스터디(study__v) 오브젝트의 필드는 다음과 같습니다.

스터디 국가

시스템 참조 및 변수에 사용할 수 있는 스터디 국가(study_country__v) 오브젝트의 필드는 다음과 같습니다.

사이트

시스템 참조 및 변수에 사용할 수 있는 사이트(site__v) 오브젝트의 필드는 다음과 같습니다.

메모

• 사이트의 경우 name__v는 해당 사이트 레코드에 대한 스터디 사이트 번호 필드 값을 반환합니다. 스터디 사이트 번호는 name__v 필드의 레이블입니다.

사례집

시스템 참조 및 변수에 사용할 수 있는 사례집(casebook__v) 오브젝트의 필드는 다음과 같습니다.

이벤트 그룹

시스템 참조 및 변수에 사용할 수 있는 이벤트 그룹(event_group__v) 오브젝트의 필드는 다음과 같습니다.

이벤트

시스템 참조 및 변수에 사용할 수 있는 이벤트(event__v) 오브젝트의 필드는 다음과 같습니다.

메모

• 이벤트 날짜를 참조할 때는 항상 이벤트를 정의하십시오. @Event.event_date__v를 사용하지 마십시오. 정규화된 식별자의 경우 $EG.EVENT.event_date__v를 사용하십시오.

폼

시스템 참조 및 변수에 사용할 수 있는 폼(form__v) 오브젝트의 필드는 다음과 같습니다.

메모

• 정규화된 식별자에 대한 예시 형식으로 $EG.EVENT.FORM.intentionally_left_blank를 사용하십시오.

• 24R2 릴리스에서는 in_progress_post_submit__v 폼 상태의 레이블이 '진행 중인 게시물 제출'에서 '편집 중'으로 변경되었습니다. 변수는 변경되지 않았으며 in_progress_post_submit__v 상태로 유지됩니다.

아이템

시스템 참조 및 변수에 사용할 수 있는 아이템(item__v) 오브젝트의 필드는 다음과 같습니다.

메모

• 날짜 데이터 형식의 아이템에 대해 value___v를 사용하지 마십시오. 기본적으로 날짜 유형 아이템은 모든 계산에 value_normalized__v를 사용하며, value__v를 강제로 사용하면 실행 오류가 발생합니다.

• 정규화된 식별자에 대한 예시 형식으로 $EG.EVENT.FORM.IG.ITEM.change_reason__v를 사용하십시오.

• 수학 함수는 단위 아이템 유형에 사용할 수 있습니다.

• Vault는 단위 아이템인 식별자의 값을 표준 단위로 자동으로 변환합니다. 예를 들면 @Form.IG.UNITITEM.value_translated__v와 같습니다. {{@Form.IG.UNITITEM.value__v }}를 사용하여 단위 없이 입력된 숫자 값을 반환할 수 있습니다.

부분적으로 정의된 경로도 룰 표현식에서 지원됩니다. 예를 들면 @EventGroup.EVENT.field__v, @EventGroup.EVENT.FORM.field__v, @EventGroup.EVENT.FORM.IG.ITEM.field__v, @Event.FORM.field__v, @Event.FORM.IG.ITEM.field__v와 같습니다.

시스템 참조

Vault 수식의 컨텍스트에서 참조는 오브젝트의 값 대신 관련 오브젝트의 값을 가리키는 변수입니다. 예를 들어 $study__vr.phase__v를 사용하면 Vault는 해당 참조를 현재 사이트와 연결된 스터디 오브젝트의 단계 값으로 바꿉니다.

Vault Platform 시스템 참조

다음 시스템 참조는 Vault Platform의 일부로 사용할 수 있으므로 함수를 사용할 수 있는 애플리케이션의 모든 영역에서 사용할 수 있습니다.

관련된 오브젝트에 대한 오브젝트

함수가 컨텍스트에서 현재 오브젝트와 관련된 오브젝트의 속성에 접속할 수 있도록 합니다.

사용

relationship__vr.name__vr

예시

principal_investigator__vr.research_and_focus_areas__v = "Macular Degeneration"

현재 사이트(오브젝트)의 책임 연구자가 황반 변성에 연구 초점을 두고 있는 경우 True를 반환합니다.

Vault EDC 시스템 참조

다음 시스템 참조는 Vault EDC의 일부로 사용할 수 있으므로 함수가 EDC의 일부로 허용되는 애플리케이션 영역(데이터 검증 룰, 단위 변환 등)에서만 사용할 수 있습니다.

EDC 스터디 계층의 오브젝트는 다음 순서를 따릅니다.

스터디 → 사이트 → 사례집 → 이벤트 그룹 → 이벤트 → 폼 → 아이템 그룹 → 아이템

EDC 표현식은 스터디 계층 내에서 여러 오브젝트와 해당 속성을 참조할 수 있습니다. 이러한 오브젝트를 참조하려면 스터디 계층 구조의 접속 경로를 특정 구문을 사용하여 작성해야 합니다.

모든 참조는 $ 기호 또는 @ 기호로 시작해야 하며, 오브젝트와 속성은 마침표(.)로 구분해야 합니다.

시스템 참조 및 변수에 사용하기 위해 Vault EDC에서 사용할 수 있는 오브젝트 및 필드는 다음과 같습니다.&

스터디

시스템 참조 및 변수에 사용할 수 있는 스터디(study__v) 오브젝트의 필드는 다음과 같습니다.

Study Country

시스템 참조 및 변수에 사용할 수 있는 스터디 국가(study_country__v) 오브젝트의 필드는 다음과 같습니다.

사이트

시스템 참조 및 변수에 사용할 수 있는 사이트(site__v) 오브젝트의 필드는 다음과 같습니다.

메모

• 사이트의 경우 name__v는 해당 사이트 레코드에 대한 스터디 사이트 번호 필드 값을 반환합니다. 스터디 사이트 번호는 name__v 필드의 레이블입니다.

사례집

시스템 참조 및 변수에 사용할 수 있는 사례집(casebook__v) 오브젝트의 필드는 다음과 같습니다.

이벤트 그룹

시스템 참조 및 변수에 사용할 수 있는 이벤트 그룹(event_group__v) 오브젝트의 필드는 다음과 같습니다.

이벤트

시스템 참조 및 변수에 사용할 수 있는 이벤트(event__v) 오브젝트의 필드는 다음과 같습니다.

메모

• 이벤트 날짜를 참조할 때는 항상 이벤트를 정의하십시오. @Event.event_date__v를 사용하지 마십시오. 정규화된 식별자의 경우 $EG.EVENT.event_date__v를 사용하십시오.

폼

시스템 참조 및 변수에 사용할 수 있는 폼(form__v) 오브젝트의 필드는 다음과 같습니다.

메모

• 정규화된 식별자에 대한 예시 형식으로 $EG.EVENT.FORM.intentionally_left_blank를 사용하십시오.

• 24R2 릴리스에서는 in_progress_post_submit__v 폼 상태의 레이블이 '진행 중인 게시물 제출'에서 '편집 중'으로 변경되었습니다. 변수는 변경되지 않았으며 in_progress_post_submit__v 상태로 유지됩니다.

아이템

시스템 참조 및 변수에 사용할 수 있는 아이템(item__v) 오브젝트의 필드는 다음과 같습니다.

메모

• 날짜 데이터 형식의 아이템에 대해 value___v를 사용하지 마십시오. 기본적으로 날짜 유형 아이템은 모든 계산에 value_normalized__v를 사용하며, value__v를 강제로 사용하면 실행 오류가 발생합니다.

• 정규화된 식별자에 대한 예시 형식으로 $EG.EVENT.FORM.IG.ITEM.change_reason__v를 사용하십시오.

• 수학 함수는 단위 아이템 유형에 사용할 수 있습니다.

• Vault는 단위 아이템인 식별자의 값을 표준 단위로 자동으로 변환합니다. 예를 들면 @Form.IG.UNITITEM.value_translated__v와 같습니다. {{@Form.IG.UNITITEM.value__v }}를 사용하여 단위 없이 입력된 숫자 값을 반환할 수 있습니다.

예시

예를 들어 스터디의 끝에서 활력징후 수집 날짜에 접속하려면 다음을 사용하십시오(EDC Studio에서 스터디가 구축된 방식 및 오브젝트 이름에 따라 다름).

$End_of_Study.End_of_Study_Visit.Vital_Signs.General_Information.Date.value__v

이 참조는 스터디의 마지막에서 활력징후 수집 날짜(일반 정보 아이템 그룹의 활력징후 폼, 스터디 방문 종료 이벤트, 스터디 종료 이벤트의 날짜 아이템)에 접속합니다.

이벤트 또는 폼과 같은 다른 레벨에서도 속성에 접속할 수 있습니다.

$Cohort_A.Visit_1.event_date__v

이 참조는 코호트 A 이벤트 그룹의 첫 번째 방문(방문 1 이벤트)에 대한 이벤트 날짜에 접속합니다.

짧은 경로 정의

표현식의 모든 오브젝트에 접속하기 위해 전체 경로를 지정하는 작업은 길고 번거로울 수 있습니다. 따라서 #define 문을 사용하여 표현식(또는 다른 오브젝트)에서 자주 사용되는 폼 또는 아이템 그룹을 참조하는 짧은 경로를 정의하는 것이 유용할 수 있습니다.

시스템 참조와 시스템 변수를 모두 #define 문의 일부로 사용할 수 있습니다.

짧은 경로를 정의하는 구문은 다음과 같습니다.

#define vitals_info “$End_of_Study.Vital_Signs.General_Information”

그런 다음 오브젝트 vitals_info를 사용하여 관련 오브젝트 및 속성에 접속할 수 있습니다.

이전 섹션의 예시를 들면 다음과 같습니다.

$End_of_Study.End_of_Study_Visit.Vital_Signs.General_Information.Date.value__v

이는 다음으로 바꿀 수 있습니다.

vitals_info.Date.value__v

함수 작성

사용할 수 있는 함수 에디터 기능은 Vault에서 함수를 사용하는 위치에 따라 다릅니다. 함수 영역별 수식에 대한 자세한 내용은 다음을 참조하십시오.

• Studio에서 룰 생성
• 기본 단위 및 변환 정의&
• 보기 생성

유효한 필드 및 데이터 유형&

함수를 정의할 때는 함수의 연산자, 함수, 필드 및 값이 필드의 데이터 형식과 일치하는지 확인하십시오. 예를 들어 함수의 날짜 필드를 사용하여 텍스트 필드를 업데이트하려면 반드시 텍스트 함수를 사용하여 변환해야 합니다.

Vault는 함수에 사용되는 다음 데이터 형식을 자동으로 변환합니다.

• 오브젝트 참조 → 텍스트
• 선택 목록 → 텍스트(오브젝트의 함수 필드 또는 필드 기본값 제외)
• 날짜 시간 → 날짜(오브젝트의 함수 필드 또는 필드 기본값 제외)

Vault는 데이터 형식을 변환하는 데 사용할 수 있는 함수를 제공합니다.

• 날짜 → 텍스트: Text(date, format)
• 숫자 → 간격: Days(number), Months(number), Years(number), Hours(number), Minutes(number)
• 텍스트 → 숫자: Value(text)

식별자

룰 또는 보기에서 사용할 함수를 작성할 때 식별자를 사용하여 스터디 데이터(예: 폼의 특정 아이템)를 참조할 수 있습니다.

고유해질 때까지 식별자를 계층적으로 정의하고, 마침표(.)로 식별자를 구분합니다.

$Event_group.Event.Form.Item_group.Item

그런 다음 아이템 오브젝트의 필드를 사용하여 수집된 값을 참조할 수 있습니다.

$Event_group.Event.Form.Item_group.Item.value__v

Studio 룰 에디터에서 Vault는 식별자, 변수, 연산자 및 함수를 입력할 때 자동 완성을 시도할 수 있습니다. Ctrl + Space를 눌러 자동 완성 옵션의 드롭다운 목록을 확인합니다. 식별자 입력을 시작하기 전에 Ctrl + Space를 누르면 Vault의 드롭다운에 모든 유효한 식별자가 나열됩니다.

디자인 정의를 두 곳 이상에서 사용하는 경우(예: 여러 폼에서 아이템을 사용하는 경우) @을 사용하여 해당 정의의 모든 인스턴스를 포함하도록 지정할 수 있습니다.

예를 들어 여러 폼에서 아이템을 평가하려면 @Form.Item_group.Item과 같이 작성하면 됩니다. 이벤트 그룹, 이벤트 및 폼 레벨에서 사용할 수 있습니다.

아이템 값 비활성화 및 아이템 값 설정 룰의 경우 @Form 식별자만 사용할 수 있습니다(@EventGroup, @Event 또는 @ItemGroup을 사용할 수 없음).

#define 문

#define 문을 사용하여 식별자에 대한 변수를 정의할 수 있으므로 함수에서 식별자를 참조할 때마다 변수를 다시 작성할 필요가 없습니다.

예를 들어 확장기 혈압 아이템의 축약된 이름을 정의하려면 다음과 같이 하면 됩니다.

#define diastolic @Form.Vitals.Diastolic_blood_pressure.value__v

이제 함수에서 diastolic을 사용할 때마다 Vault에서 자동으로 #define 문의 식별자로 읽습니다.

• #define 문장을 함수의 맨 위에 한 줄에 하나씩 넣으십시오.
• 각 개별 함수에 #define 문을 포함해야 합니다. 이러한 변수는 룰의 컨텍스트에서 정의되므로 여러 룰에서 단일 #define 문을 사용할 수 없습니다.

주석

주석을 사용하여 함수 내에 메모를 작성할 수 있습니다. 예를 들어 특정 표현식에 대한 간략한 설명을 추가하여 나중에 어떻게 작동하는지 상기시킬 수 있습니다.

함수에 주석을 추가하려면 함수 맨 위(첫 번째 줄)에 주석 텍스트를 입력하고 이 텍스트를 /* 및 */로 둘러쌉니다.

/* 이것은 주석입니다. */

함수에 대한 지침

함수를 작성할 때 다음 지침을 사용하십시오.

• 소수점은 Vault의 로캘에 관계없이 마침표입니다.
• 최대 표현식 길이는 1,500자입니다.
• 함수에 표현식이 여러 개 포함된 경우 표현식을 괄호()로 묶습니다.
• Vault CDMS는 숫자를 부동 소수점으로 처리하여 함수 평가가 끝날 때 확인합니다.

함수

함수 표현식에 함수를 추가하려면 다음 지침을 사용하십시오.

• 함수 이름은 대소문자를 구분합니다.
• 함수에는 하나 이상의 인수가 있을 수 있습니다. 함수마다 허용되는 인수의 수가 다릅니다.
• Vault는 함수를 왼쪽에서 오른쪽으로 처리합니다. 중첩 함수의 경우 Vault는 상위 함수를 처리하기 직전에 왼쪽에서 바로 하위 함수를 처리합니다.

연산자

함수 표현식에 연산자를 추가하려면 다음 지침을 사용하십시오.

• 표준 작업 순서가 적용됩니다. 즉, 덧셈과 뺄셈 전에 곱셈과 나눗셈을 먼저 하되, 괄호를 사용해 그룹화하는 경우에는 이 순서가 재정의됩니다.
• 수학 연산을 사용하여 숫자와 숫자 유형 필드를 모두 추가할 수 있습니다.
• 수학 연산에서는 날짜 유형 필드를 사용할 수 없습니다. 위에서 설명한 다양한 날짜 함수를 사용합니다.

불린(Boolean) 필드

예/아니요 유형의 오브젝트 필드 또는 불린(Boolean) 유형의 아이템(확인란)을 참조하는 함수를 작성할 때 예는 true를, 아니요(선택되지 않은 확인란)는 false를 사용합니다.

공백 값 처리

이는 Vault가 함수 내의 공백 필드 값을 처리하는 방법을 나타냅니다.

• 0으로 처리: Vault에서 공백 값을 0으로 대체하여 함수 계산을 완료할 수 있도록 합니다.
• null로 처리: Vault에서 공백 값을 null로 처리하여 전체 표현식이 null/빈 값을 반환하도록 합니다.

예시

이 예시에서는 다양한 공백 처리 옵션이 이 함수의 결과에 어떤 영향을 미치는지 보여 줍니다.

함수:

NUM1 + NUM2 

오류 처리

룰을 생성하거나 업데이트하기 전에 모든 구문 오류를 해결해야 합니다. 조건 필드 바깥쪽을 클릭하면 함수 구문이 올바르지 않은 경우 '표현식이 유효하지 않습니다' 메시지가 표시됩니다. 다음은 일반적인 구문 오류입니다.

• 반환 데이터 형식이 일치하지 않습니다. 예를 들어 반환 형식이 날짜이지만 표현식이 숫자를 반환하는 경우 오류가 발생합니다.
• 함수에 닫는 괄호가 없거나 괄호가 일치하지 않습니다.
• 함수에 잘못된 수의 인수가 있습니다. 예를 들어 if(expression, value 1, value 2) 함수에 3개의 인수가 있습니다.
• 함수에 잘못된 파라미터 값이 있습니다.

마이그레이션(V1에서 V2로)

향상된 Vault 수식은 수식을 사용하는 플랫폼 애플리케이션 영역에서 자동으로 사용할 수 있으며, 즉시 사용 가능합니다.

EDC 관련 함수 사용(룰 및 보기)의 경우 스터디별로 향상된 Vault 함수를 활성화해야 합니다.

19R1(2019년 4월 릴리스) 이전에 생성된 스터디는 향상된 함수 언어로 업그레이드할 수 없습니다. 이러한 스터디는 룰 및 파생된 열 매핑에 대해 V1 함수 언어(여기에서 참조 확인)를 계속 사용해야 합니다.

스터디에 대해 향상된 Vault 함수를 활성화하는 방법

스터디에서 향상된 Vault 함수를 활성화하는 방법은 다음과 같습니다.

1. 스터디에 함수 언어 V1을 사용하는 함수가 포함되어 있지 않은지 확인합니다.
2. 어드민(Admin) > 비즈니스 어드민(Business Admin)에서 스터디 구성 오브젝트로 이동합니다.
3. 스터디를 찾아 클릭하여 엽니다.
4. 편집(Edit)을 클릭합니다.
5. 표현식 엔진 버전(Expression Engine Version) 필드에 2를 입력합니다.
6. 저장을 클릭합니다.

이제 스터디에서 향상된 함수 언어를 사용합니다.

향상된 Vault 함수를 사용하여 기존 디자인을 새 스터디로 이동

새 스터디를 생성하고(새 스터디에는 기본적으로 향상된 Vault 함수가 활성화되어 있음) 기존 디자인을 새 스터디로 가져올 수도 있습니다. Vault는 시스템 관리 룰(필수, 범위 및 미래 날짜 검증 확인) 및 단위 변환(value__v를 $value__v로 자동 대체)을 가져오지만 사용자 지정(custom) 룰 또는 파생 열 수식은 가져오지 않습니다.

1. 스터디 디자인을 내보냅니다. 여기에서 세부 사항을 참조하십시오.
2. 새 스터디를 생성합니다.
3. 스터디 디자인을 새 스터디로 가져옵니다. 여기에서 세부 사항을 참조하십시오.
4. Vault에서 모든 사용자 지정(custom) 룰 및 파생 열 수식을 제거한 다음 스터디를 가져옵니다.

이제 룰, 파생 유형 열 및 단위 변환에 대해 향상된 Vault 함수를 사용하여 새 함수 표현식을 생성할 수 있습니다.

추가 자료

함수 사용 방법에 대한 사용 사례별 정보가 포함된 추가 도움말 항목이 있습니다.

• Studio에서 룰 생성
• 기본 단위 및 변환 정의&
• 보기 생성