필드 참조, 리터럴, 연산자 및 함수를 사용하여 Adobe Acrobat Sign의 계산 필드용 수식을 작성합니다.
값 유형 > 계산됨으로 구성된 필드의 수식 속성에 수식을 입력합니다. 이 참조는 수식 작성에 사용할 수 있는 표현식 구문을 설명합니다.
필드 자체를 구성하려면 계산 필드 만들기를 참조하세요.
수식 작성
수식에는 다음 요소 중 하나 이상이 포함될 수 있습니다:
| 요소 | 사용 목적 | 예 |
|---|---|---|
| 필드 참조 | 다른 필드의 값 사용 | price * quantity |
| 리터럴 | 고정된 숫자, 텍스트 값 또는 날짜 포함 | total * 0.10 |
| 연산자 | 산술, 비교 또는 텍스트 연산 수행 | 소계 + 세금 |
| 함수 | 미리 정의된 계산 또는 논리 연산 수행 | max(value1, value2) |
수식은 다른 계산 필드도 참조할 수 있습니다.
이름으로 필드 참조
수식에서 필드 이름을 사용하여 해당 값을 참조합니다.
예:
price * quantity
price 및 quantity라는 이름의 필드 값을 사용합니다.
필드 이름에 공백이 포함된 경우 전체 이름을 대괄호로 묶으세요:
[Unit price] * quantity
양식이 변경되어도 수식을 이해할 수 있도록 의미 있고 고유한 필드 이름을 사용하세요.
필드 이름 요구 사항에 대해서는 양식 필드 속성을 참조하세요.
리터럴 값 사용
리터럴은 수식에 직접 포함된 고정 값입니다.
예는 다음과 같습니다.
- 번호: 10
- 텍스트: "승인됨"
- 지원되는 날짜 함수에서 사용하는 날짜
텍스트 문자열을 작은따옴표나 큰따옴표로 둘러싸세요.
예:
"승인됨"
리터럴 값은 필드, 연산자, 함수와 결합할 수 있습니다.
지원되는 연산자
연산자를 사용해 계산을 수행하거나 텍스트를 결합하거나 값을 비교하세요.
| 연산자 | 연산 |
|---|---|
| + | 추가 |
| - | 빼기 |
| / | 분할 |
| * | 곱하기 |
| & | 텍스트 문자열 결합 |
| = | 같음 |
| != | 같지 않음 |
| < | 미만 |
| <= | 다음보다 작거나 같음 |
| > | 보다 큼 |
| >= | 다음보다 크거나 같음 |
| % | 나눗셈 후 나머지 반환 |
| ^ | 값을 거듭제곱으로 올림 |
비교 연산자는 참 또는 거짓 결과를 반환하며 논리 함수 내에서 사용할 수 있습니다.
예:
total >= 1000
total 값이 최소 1000인지 평가합니다.
수학 함수
| 함수 | 결과 |
|---|---|
| abs(number1) | 숫자의 절대값을 반환합니다. |
| roundUp(number1) | 숫자를 올림합니다. |
| roundDown(number1) | 숫자를 내림합니다. |
| round(number1) | 숫자를 가장 가까운 정수로 반올림합니다. |
| min(number1, number2) | 두 숫자 중 작은 쪽을 반환합니다. |
| max(number1, number2) | 두 숫자 중 큰 쪽을 반환합니다. |
예
max(Amount1, Amount2)
두 필드 값 중 더 큰 값을 반환합니다.
날짜 함수
| 함수 | 결과 |
|---|---|
| datePart(part, date) | 날짜의 지정된 부분을 정수로 반환합니다. |
| dateAdd(part, date, addition) | 날짜에 지정된 숫자의 날짜 부분을 추가합니다. 음수 값을 사용하여 빼기를 수행합니다. |
| dateDiff(part, date1, date2) | 지정된 날짜 부분을 사용하여 두 날짜 간의 차이를 반환합니다. |
| daysIn(part, date) | 지정된 날짜 부분의 일수를 반환합니다. |
| date(string) | 날짜를 나타내는 텍스트 값을 다른 함수에서 사용할 수 있는 날짜 값으로 변환합니다. |
| now() | 공식을 연산한 날짜와 시간을 반환합니다. |
날짜 부분 값
지원되는 날짜 함수의 part 인수에 다음 값을 사용하세요.
| 값 | 날짜 또는 시간 부분 |
|---|---|
| y | 연도 |
| q | 분기 |
| m | 월 |
| d | 일 |
| h | 시간 |
| n | 분 |
| s | 초 |
예
dateAdd("d", StartDate, 30)
StartDate 필드 값에 30일을 추가합니다.
이전 날짜를 계산하려면 음수를 사용하세요:
dateAdd("d", StartDate, -7)
논리 함수
계산된 값이 하나 이상의 조건에 따라 달라지는 경우 논리 함수를 사용하세요.
| 함수 | 결과 |
|---|---|
| if(logical_test, value_if_true, value_if_false) | 테스트가 참일 때 한 값을 반환하고 거짓일 때 다른 값을 반환합니다. |
| and(logical1, logical2, …) | 지정된 모든 조건이 참일 때만 참을 반환합니다. |
| or(logical1, logical2, …) | 지정된 조건 중 하나 이상이 참일 때 참을 반환합니다. |
| not(logical) | 참 또는 거짓 결과를 뒤바꿉니다. |
| lookup(sourceField, values, default_value) | 소스 필드와 연결된 값을 반환하거나 일치하는 항목을 찾을 수 없는 경우 기본값을 반환합니다. |
if를 사용하여 결과 선택
예:
if(Total >= 1000, "Approval required", "Approved")
Total 이 1000 이상일 때 한 텍스트 값을 반환하고 그렇지 않을 때 다른 값을 반환합니다.
참 및 거짓 결과 자체에 표현식이 포함될 수 있습니다.
논리 테스트 결합하기(and, or, not)
모든 조건이 참이어야 하는 경우 and 를 사용하세요:
and(Age >= 18, Consent = "Yes")
어떤 조건이든 참일 수 있을 때 또는 을 사용하세요:
or(State = "CA", State = "OR")
조건의 반대가 필요할 때는 not을 사용합니다.
not(Status = "Closed")
조회로 한 값을 다른 값에 매핑
lookup 은 소스 값이 해당 값을 반환해야 할 때 사용합니다.
예:
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
일치하는 항목이 있을 때 매핑된 주 이름을 반환하고 없을 때 기타를 반환합니다.
이는 소스 값이 드롭다운이나 라디오 버튼 필드와 같은 정의된 선택 항목 세트에서 나올 때 유용합니다.
공식 예제
금액 계산하기
quantity * [Unit price]
수량에 단가를 곱합니다.
여러 값 더하기
subtotal + tax + shipping
세 필드의 값을 더합니다.
백분율 계산하기
subtotal * taxRate
한 필드에 다른 필드에 저장된 요율을 곱합니다.
조건부로 값 반환하기
if(quantity >= 10, [Unit price] * 0.9, [Unit price])
수량이 정의된 임계값에 도달했을 때 할인된 값을 반환합니다.
미래 날짜 계산하기
dateAdd("m", StartDate, 12)
StartDate 이후 12개월 후의 날짜를 반환합니다.
텍스트 결합
RecipientName & " - " & Company
필드 값과 리터럴 텍스트를 하나의 결과로 결합합니다.
유지 관리하기 쉬운 수식 작성
설명적인 필드 이름을 사용하고 관련 계산을 양식에서 허용하는 만큼 간단하게 유지하세요.
수식을 검토할 때 다음을 확인하세요:
- 참조된 모든 필드가 존재하는지 확인하세요.
- 필드 이름이 수식에서 사용된 이름과 일치하는지 확인하세요.
- 공백이 포함된 필드는 대괄호로 묶여 있는지 확인하세요.
- 텍스트 리터럴은 따옴표로 묶여 있는지 확인하세요.
- 함수에 필수 인수가 포함되어 있는지 확인하세요.
- 계산된 필드가 예상된 수신자 입력에 대해 의도된 값을 생성하는지 확인하세요.
계산된 필드 구성 및 숫자 결과 서식 지정에 대해서는 계산된 필드 만들기를 참조하세요.
