계산된 필드는 고급 양식의 일부이며 따라서 Business 및 Enterprise 수준의 서비스에만 포함됩니다.

개요

Adobe Sign에서는 계약서에 서명할 때 서명자가 입력한 데이터를 기반으로 문서(계약서)에 있는 필드를 동적으로 업데이트하는 기능을 제공합니다. 이 작업은 계산된 필드를 사용하여 수행할 수 있습니다. 서명을 위해 발송하기 전에 계산된 필드를 사용하여 문서(또는 문서 템플릿) 내의 규칙을 설정할 수 있습니다. 이러한 규칙은 서명자가 문서와 상호 작용할 때 처리되며, 필드/값에 따라 문서를 동적으로 업데이트합니다.

계산된 필드는 다음 메커니즘 중 하나를 사용하여 문서 내에서 정의할 수 있습니다.

계산된 필드 사용 사례

계산된 필드는 서명 시 문서를 동적으로 업데이트해야 하는 모든 상황에 사용할 수 있습니다. 다음은 계산된 필드를 사용할 수 있는 몇 가지 샘플 사용 사례입니다. 이 사용 사례는 예시용입니다.

1. 주문 양식 설정 - 계산된 필드는 서명자가 사용 가능한 항목 목록에서 선택하고 수량을 지정할 수 있는 주문 양식을 설정하는 데 사용할 수 있습니다. 목록에서 항목을 선택하면 선택된 항목의 가격을 이용하여 양식이 자동으로 업데이트됩니다. 서명자가 선택한 수량에 따라 항목의 총 비용도 자동으로 계산됩니다. 이 양식은 주문 시 총 세금을 결정하거나 고객에게 할인을 제공하는 Business 규칙에 따라 할인 볼륨을 계산하기 위한 추가적인 계산을 통합할 수도 있습니다.

2. 계약 기간 만료 날짜 자동 입력 - 고객이 서명 시 계약 기간(6개월, 12개월, 24개월 등)을 선택할 수 있도록 허용하는 계약의 경우, 계약 서명 시 고객이 수행한 선택 내용을 기반으로 계약 종료 날짜를 자동으로 입력하는 데 계산된 필드를 사용할 수 있습니다.

3. 여러 선택 사항이 있는 양식 서명 - 양식에 서명하는 사용자가 사용 가능한 옵션 집합에서 선택할 수 있는 서명 양식(예: 멤버십 양식)을 설정하는 데 계산된 필드를 사용할 수 있습니다. 서명자가 선택한 사항은 서명자가 동의하는 조건, 계약 기간 및 총 비용과 같은 양식의 다른 동적 측면을 활성화할 수 있습니다.

계산된 필드 기본 사항

Adobe Sign 양식의 모든 양식 필드, 확인란 또는 라디오 단추 필드는 계산된 필드로 표시할 수 있습니다. 서명 시, 서명자는 계산된 필드로 지정된 필드에 값을 직접 입력할 수 없으며, 필드의 값은 양식에 정의된 규칙에 따라 자동으로 계산됩니다.

계산된 필드 정의는 표현식과 형식, 이렇게 두 가지 부분으로 구성되어 있습니다.

표현식

필수

지정된 필드의 값이 계산되는 방식에 대한 공식/규칙을 정의합니다. 서명 시 Adobe Sign에서 표현식을 평가하고 결과 값은 필드에 표시됩니다.

형식

선택 사항

계산된 필드의 결과 값의 형식은 형식을 지정하여 날짜, 숫자 또는 통화로 지정할 수도 있습니다.

계산된 필드는 Adobe Sign 텍스트 태그를 사용하거나, Adobe Sign 웹 응용 프로그램을 사용하거나 PDF 양식 필드를 사용하여 정의할 수 있습니다. Adobe Sign 텍스트 태그나 PDF 양식 필드를 사용하여 계산된 필드를 정의할 때, "calc"라는 지시문을 사용하여 계산용 표현식이 정의됩니다. 계산된 필드의 형식은 "format"이라는 지시문을 사용하여 지정할 수 있습니다.

{{someCalculatedField_es_:signer1:calc(someExpn):format(formatType, someFormat)}}

이 예는 "someCalculatedField"라는 문서 내에서 필드를 정의하는 데 사용되는 텍스트 태그를 보여 줍니다. 이 필드는 signer1으로 식별되는 수신자에게 지정되어 있습니다. 이 필드의 값은 "someExpn"에 지정된 공식을 기반으로 계산됩니다. 결과 값의 유형은 매개 변수 "formatType"으로 지정되며 "someFormat"으로 정의된 형식을 기반으로 형식이 지정됩니다.

Adobe Sign 웹 응용 프로그램의 제작 환경에서는 계산된 필드용의 공식을 정의하기 위해 제대로 작동하는 표현식 작성기를 제공합니다. 표현식 작성에 대한 자세한 내용은 계산된 필드 지정용 표현식 작성기 사용을 참조하십시오.


계산된 필드 표현식

표현식에서는 계산된 필드의 값을 결정하기 위한 공식/규칙을 정의합니다. 표현식은 다음 요소 중 하나 이상으로 구성할 수 있습니다.

리터럴

표현식의 일부로 사용되는 실제 값을 지정합니다. 표현식은 문자열 값, 숫자 또는 날짜일 수 있습니다. 예:

• {{helloField_es_:signer1:calc(“Hello”)}} – 이 리터럴은 "helloField"라는 필드의 값을 Hello로 설정합니다.

• {{numField_es_:signer1:calc(10)}} – 이 리터럴은 "numField"라는 필드의 값을 10으로 설정합니다.

표현식에 포함해야 하는 문자열은 따옴표(큰 따옴표(") 또는 작은 따옴표(')) 안에 있어야 합니다. 결과 값에 따옴표(큰 따옴표나 작은 따옴표)를 포함해야 하는 경우, 따옴표를 닫는 백슬래시(\)를 사용하여 포함할 수 있습니다.

중요 참고: 앞으로의 모든 예에서는 표현식만 표시되며, 텍스트 태그에 대한 전체 구문은 표시되지 않습니다.

연산자

연산자는 표현식의 일부로서 하나 이상의 연산을 수행하는 데 사용됩니다. 예:

• 6 + 4 – 이 연산자를 사용하면 계산된 필드에 10이라는 값이 입력됩니다.

• 5/22/2016 - 3 – 이 연산자를 사용하면 계산된 필드에 5/19/2016이라는 값이 입력됩니다.

표현식 내에서 지원되는 연산자 목록이 필요하면 지원되는 연산자를 참조하십시오.

필드

문서 내의 기존 필드는 이름으로 필드를 참조하여 표현식을 정의하는 데 사용할 수 있습니다. 필드는 Adobe Sign 필드(예: 서명, 날짜 필드, 서명자 이름, 서명자 회사 등) 또는 문서 내에 정의된 필드나 다른 계산된 필드일 수 있습니다. 예:

• price * quantity – 이 표현식에서는 문서 내의 "price"와 "quantity"라는 두 개의 다른 필드를 참조합니다. 이 두 필드의 값들을 곱한 결과는 계산된 필드에 입력됩니다.

• signerName & “employee of “ & signerCompany – 이 표현식은 문서 내에 있는 두 필드 "signerName"과 "signerCompany"를 참조하는데, 이 필드들은 Adobe Sign을 사용할 수 있고, 함께 연결하는 경우 Adobe Sign에 의해 사전에 입력됩니다. 서명자의 이름이 "Casey Jones"이고, 서명자의 회사가 "Acme Corp"일 경우, 이 표현식을 사용하면 계산된 필드에 "Casey Jones employee of Acme Corp"이 입력됩니다.

필드 이름에 공백이 있으면, 필드 이름을 대괄호([]) 내에 배치하여 표현식에서 참조할 수 있도록 해야 합니다. 예를 들어 [공백이 있는 필드 이름]은 "공백이 있는 필드 이름"이라는 문서 내 필드를 참조합니다.

함수

표현식은 Adobe Sign의 지원되는 함수 목록의 함수를 하나 이상 포함할 수도 있습니다. 지정된 함수는 계약서 서명 프로세스 동안 평가되며 결과 값은 계산된 필드에 표시됩니다. 예:

• dateAdd(d, signedDate, 3)– 이 표현식에서는 "dateAdd" 함수를 사용하고 이 계약서가 서명되는 날짜에 3일을 추가하도록 지정합니다. 따라서 문서가 5/22/2016에 서명되는 경우, 표현식의 결과 값은 5/25/2016이 됩니다.

표현식 내에서 지원되는 함수 목록이 필요하면 지원되는 함수를 참조하십시오.


지원되는 연산자

계산된 필드에서 다음 연산자가 지원됩니다.

+

두 수를 더합니다.

-

두 수 간에 빼기 연산을 수행합니다.

/

두 수 간에 나누기 연산을 수행합니다.

*

두 수를 함께 곱합니다.

&

두 문자열을 서로 연결합니다.

=

같음. 두 수를 비교하고 두 수가 같으면 true를 반환하고 같지 않으면 false를 반환합니다.

!=

같지 않음. 두 수를 비교하고 두 수가 같지 않으면 true를 반환하고 같으면 false를 반환합니다.

보다 작음. 두 값을 비교하고 첫 번째 값이 두 번째 값보다 작으면 부울 값(true 또는 false)을 반환합니다.

>=

보다 크거나 같음. 두 값을 비교하고 첫 번째 값이 두 번째 값보다 크거나 같으면 부울 값(true 또는 false)을 반환합니다.

<=

보다 작거나 같음. 두 값을 비교하고 첫 번째 값이 두 번째 값보다 작거나 같으면 부울 값(true 또는 false)을 반환합니다.

보다 큼. 두 값을 비교하고 첫 번째 값이 두 번째 값보다 크면 부울 값(true 또는 false)을 반환합니다.

%

나머지 연산자. 두 수 간의 나눗셈 나머지를 반환합니다.

^

지수 연산자. 지정된 숫자들의 지수 값을 반환합니다.


지원되는 함수

계산된 필드 내에서 표현식을 지정할 때 다음 함수가 지원됩니다.

함수

카테고리

설명

abs(number1)

수학

숫자 "number1"의 절대값을 반환합니다.

roundUp(number1)

수학

숫자 "number1"을 올림합니다.

roundDown(number1)

수학

숫자 "number1"을 내림합니다.

round(number1)

수학

숫자 "number1"을 가장 가까운 정수로 반올림합니다.

min(number1,number2)

수학

두 숫자 "number1"과 "number2" 중 작은 숫자를 반환합니다.

max(number1,number2)

수학

두 숫자 "number1"과 "number2" 중 큰 숫자를 반환합니다.

datePart(part, date)

날짜

첫 번째 인수로 지정한 날짜의 일부를 정수로 반환합니다. 예를 들어, datePart(m, 5/22/2016)은 날짜의 월 부분인 5를 반환합니다.

부분 속성에 대한 허용 가능한 값에 대한 정보가 필요하면 아래의 "날짜의 부분들에 대해 허용된 값"을 참조하십시오.

dateAdd(part, date, addition)

날짜

날짜에 지정한 단위(예: 일은 "d", 월은 "m" 또는 년은 "y")의 수를 더하여 미래 날짜를 계산합니다. 숫자 및 필드 이름을 사용할 수 있습니다.

예를 들어, dateAdd("m", "Jan 1, 2016", 3)은 Apr 1, 2016이라는 날짜를 반환합니다. 이 예에서는 지정된 날짜에 3개월이 더해집니다.

dateDiff(part, date1, date2)

날짜

두 날짜 사이의 단위(예: 일은 "d", 시간은 "h" 또는 분은 "n") 수를 반환합니다. 숫자 및 필드 이름을 사용할 수 있습니다.

예를 들어 dateDiff("d", "Jan 1, 2016", "Jan 2, 2016")는 1월 1일과 1월 2일 간에 1일 차이를 나타내는 값 1을 반환합니다.

daysIn(part, date)

날짜

지정한 날짜의 단위(예: 일은 "d", 월은 "m" 또는 년은 "y")에 포함된 일 수를 반환합니다. 숫자 및 필드 이름을 사용할 수 있습니다.

예를 들어 daysIn("m", "Feb 1, 2016")은 2016년 2월의 일수인 값 29가 반환되고 daysIn("y", "02/01/2015")은 2015년의 일수인 365가 반환됩니다.

date(string)

날짜

"1/1/2016"과 같은 문자열 값을 다른 함수에서 사용할 수 있는 날짜 개체로 변환합니다.

now()

날짜

공식을 평가한 날짜와 시간(종종 eSign 페이지를 로드할 때)을 반환합니다.

if(logical_test, value_if_true, value_if_false)

논리

"logical_test"를 평가합니다. "logical_test"는 다른 표현식일 수 있습니다. TRUE일 경우, "value_if_true"에 지정된 값이 반환됩니다. FALSE일 경우, "value_if_false"의 값이 반환됩니다. "value_if_true"와 "value_if_false" 속성이 모두 표현식일 수도 있습니다.

예를 들어, (1>0, "Correct", "Incorrect")은 "Correct"를 반환합니다.

and(logical1, logical2, ...)

논리

모든 논리적 인수가 TRUE로 평가될 경우에만 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다.

예를 들어, and(1>0, 2>1)은 "true"를 반환하고 and(1>0, 2=1)은 "false"를 반환합니다.

or(logical1, logical2, ...)

논리

논리적 인수들(logical1, logical2,...) 중 하나라도 TRUE로 평가될 경우 true를 반환합니다. 모든 논리적 인수가 FALSE로 평가될 경우에는 false를 반환합니다.

예를 들어, or(1>0, 2>1)은 "true"를 반환합니다. or(1>0, 2=1)은 "false"를 반환합니다.

not(logical)

논리

"logical"의 반대쪽 값을 반환합니다. 따라서 "logical"이 FALSE로 평가되는 경우, true가 반환됩니다. TRUE로 평가되는 경우에는 false가 반환됩니다. 예를 들어 not(1>0)은 "false"를 반환합니다.
lookup(sourceField,("value1=return1,value2=return2", "default_value") 논리

가능한 값의 목록을 기반으로, 계산된 필드에 기본값을 채우기 위해 소스 필드 "반환 값"(드롭박스와 라디오 단추에 사용됨)을 평가합니다.

예: lookup(stateField, “CA=California,UT=Utah,MA=Massachusetts,WA=Washington”,”None”)

stateField가 CA이면 California가 반환되고, stateField가 UT이면 Utah가 반환되는 방식입니다.일치하는 항목이 없으면 없음을 반환합니다.


날짜의 부분들에 대해 허용된 값

다음 값은 함수가 작동해야 하는 날짜의 부분을 지정할 때 날짜 관련 함수에서 사용할 수 있습니다.

부분

함수가 적용되는 날짜의 부분

y

연도

q

분기

m

d

h

시간

n

s


계산된 필드 형식 지정

계산된 필드에 대한 표현식을 지정하는 것 이외에 출력 값의 형식을 지정할 수도 있습니다. 출력의 형식은 텍스트(기본값)로 지정하거나, 숫자나 날짜로 지정할 수 있습니다.

텍스트 태그와 함께 사용할 때 형식 지시문은 FormatType과 Format, 이 두 개의 인수를 취합니다.

FormatType

계산된 필드가 나타내는 값의 유형을 지정합니다. 이 매개 변수에 대해 허용된 값은 숫자와 날짜입니다.

형식

계산된 필드에 배치할 출력 값의 구조를 지정합니다.


계산된 필드의 형식을 숫자로 지정

다음 문자는 출력의 형식을 숫자 형태로 지정하는 데 사용할 수 있습니다.

문자 형식 지정

설명

_

(밑줄.) 숫자 자리 표시자를 나타냅니다.

9

숫자 자리 표시자를 나타냅니다.

.

필수 소수점(또는 로케일에 적합한 기호)의 위치.

0

필수 소수점의 왼쪽 또는 오른쪽에 배치됩니다. 0으로 채웁니다.

( )

숫자가 0보다 작을 경우, 마스크 둘레에 괄호를 넣습니다.

+

양수 앞에는 더하기(+) 기호를, 음수 앞에는 빼기(-) 기호를 사용합니다.

-

양수 앞에는 공백을, 음수 앞에는 빼기(-) 기호를 사용합니다.

,

셋째 십진법 자리마다 쉼표(또는 로케일에 적합한 구분 문자)로 구분합니다.

$

형식이 지정된 숫자 앞에 달러 기호(또는 로케일에 적합한 기호)를 사용합니다. 지정하는 경우 형식 문자열의 첫 번째 문자가 되어야 합니다.

%

필드에 있는 숫자 값을 백분율로 변환합니다. 100을 곱하고 끝에

% 기호를 넣습니다. 지정하는 경우 형식 문자열의 마지막 문자가 되어야 합니다.


계산된 필드의 형식을 날짜로 지정

다음 문자는 출력의 형식을 날짜 형태로 지정하는 데 사용할 수 있습니다.

형식

설명

s

해당 분의 0-59 범위 초입니다.

"0" ~ "59"

ss

해당 분의 초로서, 필요할 경우 0으로 시작합니다.

"00" ~ "59"

n

해당 시간의 0-59 범위 분입니다.

"0" ~ "59"

nn

해당 시간의 분으로서, 필요할 경우 0으로 시작합니다.

"00" ~ "59"

h

해당 일의 1-12 범위 시간입니다.

"1" ~ "12"

hh

해당 일의 시간으로서, 필요할 경우 0으로 시작합니다.

"01" ~ "12"

H

해당 일의 0-23 범위 시간입니다.

"0" ~ "23"

HH

해당 일의 시간으로서, 필요할 경우 0으로 시작합니다.

"00" ~ "23"

d

해당 월의 1~31 범위 일입니다.

"1" ~ "31"

dd

해당 월의 일로서, 필요할 경우 0으로 시작합니다.

"01" ~ "31"

ddd

단축 요일 이름입니다.

"월" ~ "일"

dddd

전체 요일 이름입니다.

"월요일" ~ "일요일"

m

해당 연도의 1-12 범위 월입니다.

"1" ~ "12"

mm

해당 연도의 월로서, 필요할 경우 0으로 시작합니다.

"01" ~ "12"

mmm

단축 월 이름입니다.

"1월" ~ "12월"

mmmm

전체 월 이름입니다.

"1월" ~ "12월"

yy

2자리 숫자 연도입니다.

"99" ~ "15"

yyyy

4자리 전체 연도입니다.

"1999" ~ "2015"

t

A.M.(오전)/P.M.(오후) 지정자의 첫 번째 문자를 표시합니다.

"A" 또는 "P"

tt

A.M.(오전)/P.M.(오후) 지정자를 표시합니다.

"오전" 또는 "오후"


형식 지정 예

다음 예는 날짜 및 숫자 계산된 필드의 형식을 지정하는 방법을 보여 줍니다.

  • 날짜로 형식이 지정된 계산된 필드:

{{myField_es_:calc(otherDateField + 3):format(date, "mmm dd, yyyy")}}

"5월 22, 2016"과 같이 출력됩니다.

  • 숫자로 형식이 지정된 계산된 필드:

{{myTax_es_:calc(total * taxrate):format(number, "$,.00") }}

"$1,987.65"과 같이 출력됩니다.


표현식 작성기를 사용하여 계산된 필드 지정

계산된 필드는 Adobe Sign 제작 환경을 통해 지정할 수 있습니다. 아래 단계에서는 제작 환경을 사용할 때 계산된 필드를 정의하는 단계를 안내합니다.

1. 문서에서 필드를 드래그하여 놓습니다. 추가한 필드를 두 번 클릭하여 필드 속성 대화 상자를 표시하십시오. 필드에 적절한 이름을 지정합니다. 계산된 값 유형이 되도록 드롭다운 목록에서 값 유형 특성을 변경하십시오. 이 유형은 필드 값이 서명 시 계산을 기반으로 결정됨을 나타냅니다.

값 유형 필드

 

2. 공식이라는 텍스트 필드에서 계산 표현식을 입력하거나 함수 단추( fx )를 클릭하여 표현식 작성기를 표시합니다.

공식 작성기

 

3. 표현식 작성기를 사용하여 계산된 필드에 사용할 표현식을 정의합니다(아래 그림 참조). 맨 위의 표현식 영역에는 필드의 값을 계산하는 데 사용할 공식이 표시됩니다. 표현식 영역에 공식을 입력하거나, 제작 환경을 사용하여 공식을 구성할 수 있습니다. 표현식 작성기에서는 사용할 수 있는 모든 함수 목록, 문서에 있는 기존 양식 필드 목록, 표현식 구성에 도움이 되는 지원되는 연산자 목록을 제공합니다. 표현식 작성기의 [목록 영역]에서 항목을 두 번 클릭하여 필드함수를 공식에 추가할 수 있습니다. [연산자 목록]에서 특정 연산자를 클릭하여 연산자를 표현식에 추가할 수도 있습니다.

4. 표현식 정의를 완료하면 구문 검사 단추를 클릭한 다음 변경 사항을 저장하여 표현식의 구문을 검사할 수 있습니다.

5. 다른 형식으로 표시 드롭다운 목록을 사용하여 계산된 필드의 유형을 설정합니다.

다른 형식으로 표시 필드

 

6. 다른 형식으로 표시 값이 [날짜]나 [숫자]인 경우, 드롭다운 목록을 사용하여 필드 값 날짜/숫자 형식을 설정합니다. [사용자 지정] 형식을 선택하여 필드에 사용자 지정 형식을 정의할 수도 있습니다.

숫자 형식 필드

계산된 필드 예

 

  • {{shipState_es_:signer1:calc([billingState]):showif(sameAs=unchecked)}}
    • "sameAs"라는 다른 필드(확인란) 선택을 해제할 경우에만 표시되는 첫 번째 서명자에게 지정된 문서에 있는 필드입니다. 필드의 값은 서명자가 문서에 입력한 "billingState" 필드의 값으로 자동으로 채워집니다.
  • {{total_es_:signer1:calc(q1*pr1):format(Number,”$,0.00”):align(right)}}
    • 첫 번째 서명자에게 지정된 문서의 필드입니다. 이 값은 "q1" 및 "pr1" 필드 값의 곱으로 자동 계산됩니다. 결과 값은 통화 형식으로 지정되며, 결과 값의 앞에 달러 기호($)를 사용하고 두 개의 소수점 자리를 포함하여 표시됩니다. 결과 값은 필드 내에서 오른쪽에 정렬됩니다.
  • price_es_:signer1:calc(if(pn1=”W1”,9.99,if(pn1=”W2”,5.99,if(pn1=”W3”,24.99,0))))}
    • 문서의 다른 필드 "pn1"에서 서명자가 선택한 값을 기반으로 계산되는 "price"라는 문서의 필드입니다. 이 예에서 "pn1" 필드가 W1이라면 "price" 필드에 표시되는 값은 9.99이고, "pn1" 필드가 W2라면 "price" 필드에 표시되는 값은 5.99, 이런 식으로 계속됩니다. 값들 중 어느 것도 "pn1" 필드의 값과 일치하지 않는다면 "price"에 표시되는 값은 0입니다. 이 메커니즘을 사용하면 서명자가 서명하는 동안 선택한 사항을 기반으로 항목의 가격을 자동으로 채우는 데 계산된 필드를 사용할 수 있습니다.

 


다운로드할 수 있는 버전

다운로드

이 작업에는 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License의 라이센스가 부여되었습니다.  Twitter™ 및 Facebook 게시물은 Creative Commons 약관을 적용받지 않습니다.

법적 고지 사항   |   온라인 개인 정보 보호 정책