텍스트 태그 - 기본 사항 및 구문

텍스트 태그가 필요로 하는 정확한 구조를 이해하여 필드가 올바르게 인식되고 예상대로 작동하도록 하세요.

텍스트 태그를 사용하면 구조화된 자리 표시자를 문서에 직접 입력하여 양식 필드를 만들 수 있습니다. 빠르고 강력하지만 구문이 정확할 때만 작동합니다.

이 페이지에서는 텍스트 태그의 필수 구조, 각 부분의 기능, 태그가 올바르게 인식되기 위해 따라야 하는 규칙을 설명합니다.

필수 태그 묶음(중괄호)

모든 텍스트 태그는 이중 중괄호로 묶어야 합니다.

{field-name_es_:signer-role:field-type:directive1:directive2}}

중괄호는 필수이며 두 가지 목적을 제공합니다.

• Acrobat Sign에 텍스트 태그가 시작되고 끝나는 위치를 알려줍니다.
• 생성된 필드의 초기 너비와 높이를 정의합니다.
  • 첫 번째 중괄호의 크기(글꼴)가 필드 높이를 결정합니다. 
    • 첫 번째 중괄호의 글꼴 크기가 클수록 필드가 더 높아집니다.
    • 태그의 나머지 부분은 다른 글꼴 크기일 수 있지만 2pt 이상이어야 합니다.
  • 중괄호 사이의 공간(중괄호 자체 포함)이 필드의 전체 너비를 결정합니다. 
    • 중괄호 사이의 간격이 넓을수록 필드가 더 넓어집니다.
    • 공백도 계산됩니다.

중괄호가 누락되거나 잘못된 형식인 경우, 텍스트는 일반 텍스트로 처리되고 필드가 생성되지 않으며, 양식이 업로드된 후 태그의 텍스트가 양식에 인쇄된 것을 볼 수 있습니다.

텍스트 태그와 사용 시기에 대한 전반적인 개요는 텍스트 태그 개요를 참조하세요.

텍스트 태그의 필수 구조

중괄호 안에서 모든 텍스트 태그는 다음 구조를 따라야 합니다.

field-name_es_:signer-role:field-type:directive1:directive2

이 구조는 엄격합니다. 요소를 재정렬하거나 필수 부분을 생략하면 자동 실패 또는 의도하지 않은 동작이 발생할 수 있습니다.

필수 요소(순서대로)

필드 이름

필드 이름은 Acrobat Sign에서 양식 필드를 식별합니다.

• 문서 내에서 고유해야 합니다.
• 공백을 포함하지 않아야 합니다.
• 보고 및 데이터 추출에 사용됩니다.

_es_ 식별자

_es_ 식별자는 텍스트가 텍스트 태그를 나타낸다는 것을 Acrobat Sign에 알려줍니다.

• _es_는 필수입니다.
• 이것이 없으면 태그는 일반 텍스트로 처리됩니다.

서명자 역할

서명자 역할은 필드가 속한 수신자를 정의합니다.

• 항상 서명자 역할을 포함하세요.
• 서명자 역할은 필드가 의도된 수신자를 나타내는 번호를 포함해야 합니다. 

지원되는 서명자 역할

텍스트 태그는 위치 서명자 역할을 사용하여 수신자에게 필드를 할당합니다.

지원되는 서명자 역할 형식은 다음과 같습니다.

:signerN

여기서 N은 서명 순서에서 수신자의 위치에 해당하는 1부터 시작하는 숫자입니다.

예:

• :signer1 — 첫 번째 수신자
• :signer2 — 두 번째 수신자
• :signer3 — 세 번째 수신자

텍스트 태그 자체에는 상한 제한이 없습니다. 서명자 역할은 필드가 할당되려면 계약의 실제 수신자와 일치해야 합니다.

텍스트 태그는 명명된 역할이나 의미적 역할을 지원하지 않습니다. 위치 기반 서명자 역할만 인식됩니다.

이 규칙의 예외는 :prefill 역할입니다.

• :prefill — 계약 발신자에게 할당되는 필드로, 계약이 전송된 후 첫 번째 서명자에게 알림이 전송되기 전에 입력해야 합니다.
  • 이 위치는 실제 서명 주기 이전에 발생하므로 숫자를 사용하지 않습니다.

필드 유형

필드 유형은 생성되는 양식 필드의 유형을 결정합니다.

일반적인 예는 다음과 같습니다.

• :text
• :signature
• :date
• :checkbox

지원되는 필드 유형만 인식됩니다. 지원되지 않는 필드 유형은 무시됩니다.

전체 목록과 필드별 동작에 대해서는 텍스트 태그 지원되는 필드 유형을 참조하세요.

지시문(선택 사항)

지시문은 필드의 동작 방식을 수정합니다.

예는 다음과 같습니다.

• :required
• :tooltip()
• :readOnly
• :calc()
• :format()

지시문은 필드 유형 다음에 나타나야 하며 올바른 구문을 따라야 합니다.

복잡한 지시문 상호 작용에 대해서는 텍스트 태그 고급 동작을 참조하세요.

예: 완전하고 유효한 텍스트 태그

{full_name_es_:signer1:text:required:tooltip(Enter your full legal name)}}

이 태그는:

• 중괄호를 사용하여 필드 경계와 크기를 정의합니다.
• 텍스트 필드를 생성합니다.
• 첫 번째 서명자에게 할당합니다.
• 필수 항목으로 만듭니다.
• 서명자에게 툴팁을 표시합니다.

추가적인 간단하고 복합적인 예제는 텍스트 태그 예시를 참조하세요.

초기에 이해해야 할 중요한 규칙

텍스트 태그는 의도적으로 엄격하게 설계되었습니다. 다음 규칙을 명심하세요.

• 태그는 문서가 업로드될 때 처리됩니다.
• 작성 시간 유효성 검사가 없습니다.
• 오류는 경고를 생성하지 않습니다.
• 잘못된 형식의 태그는 일반 텍스트로 처리됩니다.

무언가 작동하지 않으면 먼저 구문 문제를 가정하고 텍스트 태그 문제 해결을 확인하세요.