기본 메타 모델 확장

마지막 업데이트: 2025년 5월 5일

주제:
응용 양식

작성 대상:

초급
중간
관리자
개발자

AFCS(automated forms conversion 서비스)는 소스 양식에서 양식 개체를 식별하고 추출합니다. 시맨틱 매퍼는 추출된 객체가 적응형 양식으로 표현되는 방식을 서비스가 결정할 수 있도록 도와줍니다. 예를 들어 소스 양식에는 날짜에 대한 다양한 표현 유형이 있을 수 있습니다. 시맨틱 매퍼는 소스 양식의 모든 날짜 양식 개체 표현을 적응형 양식의 날짜 구성 요소와 매핑하는 데 도움이 됩니다. 또한 Semantic Mapper를 사용하여 변환 중에 서비스가 유효성 검사, 규칙, 데이터 패턴, 도움말 텍스트 및 접근성 속성을 미리 구성하고 적응형 양식 구성 요소에 적용할 수 있습니다.

메타 모델은 JSON 스키마입니다. 메타 모델을 시작하기 전에 JSON에 대해 잘 알고 있는지 확인하십시오. JSON 형식으로 저장된 데이터를 작성, 편집 및 읽은 경험이 있어야 합니다.

기본 메타 모델

AFCS(automated forms conversion 서비스)에는 기본 메타 모델이 있습니다. JSON 스키마이며 AFCS(Automated forms conversion 서비스)의 다른 구성 요소와 함께 Adobe 클라우드에 있습니다. 로컬 AEM 서버( http://<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metmodel/global.schema.json)에서 메타 모델의 복사본을 찾을 수 있습니다. 영어 스키마에 액세스하거나 다운로드하려면 여기를 클릭할 수도 있습니다. 프랑스어, 독일어 스페인어, 이탈리아어 및 포르투갈어 언어용 메타 모델도 다운로드할 수 있습니다.

메타 모델의 스키마는 https://schema.org/docs/schemas.html의 스키마 엔티티에서 파생됩니다. 여기에는 Person, PostalAddress, LocalBusiness 및 https://schema.org에 정의된 더 많은 엔티티가 있습니다. 메타 모델의 모든 엔티티는 JSON 스키마 오브젝트 유형을 준수합니다. 다음 코드는 샘플 메타 모델 구조를 나타냅니다.

   "Entity": {
      "id": "Entity",
      "properties": {
        "name": {
          "type": "string"
        },

        "description": {
          "type": "string",
          "description": "Description of the item"
        }
      }
    }

기본 메타 모델 다운로드

기본 메타 모델을 로컬 파일 시스템에 다운로드하려면 다음 단계를 수행하십시오.

AEM Forms 인스턴스에 로그인.
Forms > Forms & Documents > Meta Model 폴더로 이동합니다.
global.schema.json 파일을 선택하고 Download 을(를) 누릅니다. 다운로드 대화 상자가 나타납니다. Download asset(s) as binary files 옵션을 선택하십시오. Download 을 누릅니다. 아카이브가 다운로드됩니다.

메타 모델 이해

메타 모델은 엔티티가 포함된 JSON 스키마 파일을 참조합니다. JSON 스키마 파일의 모든 엔티티에는 이름과 ID가 포함됩니다. 각 엔티티는 여러 속성을 포함할 수 있습니다. 엔티티와 해당 속성은 도메인에 따라 다를 수 있습니다. 키워드 및 필드 구성으로 스키마 파일을 늘려 스키마 속성을 적응형 양식 구성 요소에 매핑할 수 있습니다.

"Event": {
      "id": "Eventid",
      "allOf": [
        {
          "$ref": "#Entity"
        },
        {
          "properties": {
            "startDate": {
              "type": "string",
              "format": "date",
              "description": "Specify the start date and time of the event in ISO 8601 date format."
            },
            "endDate": {
              "type": "string",
              "format": "date",
              "description": "Specify the end date and time of the event in ISO 8601 date format."
            },
            "location": {
              "$ref": "#PostalAddress",
              "description": "Specify the location of the event."
            }
          }
        }
      ]
    }

이 예제에서 Event 은 id 값이 Eventid 인 엔터티의 이름을 나타냅니다. 이벤트 엔티티에는 여러 속성이 포함됩니다.

startDate
endDate
위치

메타 모델의 allOf 구문을 사용하면 엔터티 간에 상속이 가능합니다.

각 속성에는 다음이 더 포함될 수 있습니다.

JSON 스키마 속성
생성된 적응형 양식 필드에 속성을 적용하는 키워드 기반 검색
추가 속성

메타 모델 속성

aem:affKeyword 을 사용하여 참조된 키워드를 기반으로 전환 서비스에서 원본 양식 필드에 대한 검색 작업을 수행합니다. 전환 서비스는 검색 기준을 충족하는 필드에 JSON 스키마 속성 및 추가 속성을 적용합니다.

이 예에서 전환 서비스는 소스 양식에서 전화, 전화, 휴대폰, 회사 전화, 집 전화, 전화 번호, 전화 번호 및 전화 번호 키워드를 검색합니다. 전환 서비스는 이러한 키워드를 포함하는 필드를 기반으로 전환 후 type, pattern 및 aem:afProperties를 적응형 양식 필드에 적용합니다.

생성된 적응형 양식 필드에 대한 JSON 스키마 속성

메타 모델은 Automated forms conversion 서비스(AFCS)를 사용하여 생성된 적응형 양식 필드에 대한 다음의 JSON 스키마 공통 속성을 지원합니다.

속성 이름

설명

제목

메타 모델의 제목 속성 내에 언급된 텍스트는 생성된 적응형 양식 필드에 작업을 수행하는 검색 키워드 역할을 합니다. 예를 들어 적응형 양식 필드의 레이블 수정 자세한 내용은 사용자 지정 메타 모델 예제에서 양식 필드의 레이블 수정 을 참조하십시오.

설명

description 속성은 생성된 적응형 양식 필드에 대한 도움말 텍스트를 설정합니다. 자세한 내용은 사용자 지정 메타 모델 예제의 양식 필드에 도움말 텍스트 추가 를 참조하십시오.

유형

type 속성은 생성된 적응형 양식 필드에 대한 데이터 유형을 정의합니다. 제목 속성에 사용할 수 있는 값은 다음과 같습니다.

string: 텍스트 데이터 유형의 적응형 양식 필드를 생성합니다.
number: 숫자 데이터 유형의 적응형 양식 필드를 생성합니다.
정수: 하위 유형이 정수로 설정된 숫자 데이터 유형의 적응형 양식 필드를 생성합니다.
부울: 스위치 적응형 양식 구성 요소를 생성합니다.

메타 모델에서 형식 속성을 사용하는 방법에 대한 자세한 내용은 사용자 지정 메타 모델 예제에서 양식 필드의 형식 수정 을 참조하십시오.

패턴

pattern 속성은 정규 표현식에 따라 생성된 적응형 양식 필드의 값을 제한합니다. 예를 들어 메타 모델의 다음 코드는 생성된 적응형 양식 필드의 값을 10자리로 제한합니다.
"pattern": "/\\d{10}/"
마찬가지로 메타 모델의 다음 코드는 필드의 값을 특정 날짜 형식으로 제한합니다.
"pattern": "date{DD MMMM, YYYY}"

형식

format 속성은 정규 표현식 대신 명명된 패턴을 기반으로 생성된 적응형 양식 필드의 값을 제한합니다. 형식 속성에 사용할 수 있는 값은 다음과 같습니다.

이메일: 이메일 적응형 양식 구성 요소를 생성합니다.
호스트 이름: 텍스트 상자 적응형 양식 구성 요소를 생성합니다.

메타 모델에서 format 속성을 사용하는 방법에 대한 자세한 내용은 사용자 지정 메타 모델 예제에서 양식 필드의 형식 수정 을 참조하십시오.

enum 및 enumNames

enum 및 enumNames 속성은 드롭다운, 확인란 또는 라디오 단추 필드의 값을 고정된 세트로 제한합니다. enumNames에 나열된 값은 사용자 인터페이스에 표시됩니다. 열거형 속성을 사용하여 나열된 값은 계산에 사용됩니다.
자세한 내용은 적응형 양식에서 다중 선택 확인란으로 양식 필드 변환, 적응형 양식에서 텍스트 필드를 드롭다운 목록으로 변환 및 사용자 지정 메타 모델 예제에서 드롭다운 목록에 추가 옵션 추가 를 참조하십시오.

생성된 적응형 양식 필드에 속성을 적용하는 키워드 기반 검색

Automated forms conversion 서비스(AFCS)는 변환 중에 소스 양식에서 키워드 검색을 수행합니다. 검색 기준을 충족하는 필드를 필터링한 후 전환 서비스는 메타 모델의 해당 필드에 대해 정의된 속성을 생성된 적응형 양식 필드에 적용합니다.

키워드는 aem:affKeyword 속성을 사용하여 참조됩니다.

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"]
 }
}

이 예제에서 전환 서비스는 aem:affKeyword 내의 텍스트를 검색 키워드로 사용합니다. 양식에서 은행 계좌 번호 텍스트를 검색한 후 전환 서비스는 type 속성을 사용하여 필드를 number 형식으로 변환합니다.

생성된 적응형 양식 필드에 대한 추가 속성

메타 모델에서 aem:afProperties 속성을 사용하여 AFCS(Automated forms conversion 서비스)를 사용하여 생성된 적응형 양식 필드에 대해 다음과 같은 추가 속성을 정의할 수 있습니다.

속성 이름

설명

다중 라인

multiLine 속성은 변환 후 소스 양식 필드를 적응형 양식의 여러 줄 필드로 변환합니다. 자세한 내용은 사용자 지정 메타 모델 예제에서 문자열 필드를 여러 줄 필드로 변환 을 참조하십시오.

필수

필수 속성은 변환 후 적응형 양식 필드에 대한 입력을 필수로 설정합니다.
자세한 내용은 사용자 지정 메타 모델 예제의 적응형 양식 필드에 유효성 검사 추가 를 참조하십시오.

jcr:title

제목 JSON 스키마 속성이 있는 jcr:title 속성을 사용하면 전환 후 적응형 양식 필드의 레이블을 수정할 수 있습니다.
자세한 내용은 사용자 지정 메타 모델 예제에서 양식 필드의 레이블 수정 을 참조하십시오.
JSON 스키마를 사용하여 적응형 양식 만들기에서 JSON 스키마를 사용하여 적응형 양식 필드에 적용할 수 있는 추가 속성에 대한 정보를 참조하십시오.

sling:resourceType 및 guideNodeClass

sling:resourceType 및 guideNodeClass 속성을 사용하면 양식 필드를 해당 적응형 양식 구성 요소에 매핑할 수 있습니다.
자세한 내용은 사용자 지정 메타 모델 예제에서 양식 필드를 적응형 양식의 다중 선택 확인란으로 변환 및 텍스트 필드를 적응형 양식의 드롭다운 목록으로 변환 을 참조하십시오.

validatePictureSection

validatePictureClause 속성은 변환 후 적응형 양식 필드에 허용되는 형식에 대한 유효성 검사를 설정합니다.
자세한 내용은 사용자 지정 메타 모델 예제의 적응형 양식 필드에 유효성 검사 추가 를 참조하십시오.

자국어로 사용자 지정 메타모델 만들기

언어별 메타 모델을 만들 수 있습니다. 이러한 메타 모델은 원하는 언어로 매핑 규칙을 만드는 데 도움이 됩니다. AFCS(automated forms conversion 서비스)를 사용하면 다음 언어로 메타 모델을 만들 수 있습니다.

영어(en)
프랑스어(fr)
독일어(de)
스페인어(es)
이탈리아어(it)
포르투갈어(pt-br)

상위 메타 모델에 aem:Language 메타 태그 태그를 추가하여 해당 언어를 지정합니다. 예:

"metaTags": {
        "aem:Language": "fr"
    }

언어가 지정되지 않은 경우 서비스는 메타 모델이 영어로 된 것으로 간주합니다.

언어별 메타 모델 만들기 고려 사항

모든 키의 이름이 영어로 되어 있는지 확인합니다. 예를 들어 emailAddress입니다.
모든 엔티티 참조와 모든 ID 키의 사전 정의된 값이 ASCII 문자로만 구성되는지 확인합니다. 예를 들어 "id": "ContactPoint" / "$ref": "#ContactPoint"입니다.
다음 키에 해당하는 모든 값이 지정된 메타 모델 언어로 되어 있는지 확인합니다.
- aem:affKeyword
- 제목
- 설명
- enumNames
- 간단한 설명
- validatePictureSectionMessage
예를 들어 메타 모델의 언어가 프랑스어("aem:Language": "fr")인 경우 모든 설명 및 메시지가 프랑스어로 되어 있는지 확인합니다.
모든 JSON 스키마 속성에서 지원되는 값만 사용하도록 하십시오. 예를 들어, 유형 속성은 String, Number, Integer 및 Boolean의 선택된 값만 포괄할 수 있습니다.

다음 이미지에는 영어 메타 모델 및 해당 프랑스어 메타 모델의 예가 표시됩니다.

사용자 지정 메타 모델을 사용하여 적응형 양식 필드 수정

조직에는 기본 메타 모델에 나열된 패턴 및 유효성 검사 외에도 패턴 및 유효성 검사가 있을 수 있습니다. 기본 메타 모델을 확장하여 조직 고유의 패턴, 검증 및 엔티티를 추가할 수 있습니다. AFCS(automated forms conversion 서비스)는 변환하는 동안 사용자 지정 메타 모델을 양식 필드에 적용합니다. 조직에 관련된 새 패턴, 유효성 검사 및 엔티티가 검색되면 메타 모델을 계속 업데이트할 수 있습니다.

AFCS(automated forms conversion 서비스)는 전환 중에 다음 위치에 저장된 기본 메타 모델을 사용하여 소스 양식 필드를 적응형 양식 필드에 매핑합니다.

http://<서버>:<포트>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json

하지만 폴더에 사용자 지정 메타 모델을 저장하고 전환 중에 사용자 지정 메타 모델을 사용하도록 전환 서비스 속성을 수정할 수 있습니다.

전환 중 사용자 지정 메타 모델 사용

전환 중에 사용자 지정 메타 모델을 사용하려면 다음 단계를 수행하십시오.

Forms > Forms & Documents 에서 폴더를 만들고 사용자 지정 메타 모델 JSON 스키마 파일을 폴더에 업로드합니다.
다음을 사용하여 전환 서비스 속성을 엽니다.

Tools > Cloud Services > Automated Forms Conversion Configuration > <선택한 구성의 속성>
Basic 탭에서 Custom Meta-model 필드에 사용자 지정 메타 모델의 위치를 지정하고 Save & Close 을(를) 누릅니다.
변환을 실행하여 변환 프로세스에 사용자 지정 메타 모델을 적용합니다.

맞춤형 메타 모델 예제

사용자 지정 메타 모델을 사용하여 적응형 양식 필드 속성을 수정하는 몇 가지 일반적인 예는 다음과 같습니다.

양식 필드의 레이블 수정
양식 필드 유형 수정
양식 필드에 도움말 텍스트 추가
양식 필드를 적응형 양식의 다중 선택 라디오 단추로 변환
양식 필드 형식 수정
적응형 양식 필드에 유효성 검사 추가
적응형 양식의 양식 필드를 드롭다운 목록 옵션으로 변환
드롭다운 목록에 추가 옵션 추가
문자열 필드를 여러 줄 필드로 변환

양식 필드의 레이블 수정

예: 변환 후 양식의 은행 계좌 번호 레이블을 적응형 양식의 사용자 지정 계좌 번호로 수정합니다.

이 사용자 지정 메타 모델에서 전환 서비스는 title 속성을 검색 키워드로 사용합니다. 양식에서 은행 계좌 번호 텍스트를 검색한 후 전환 서비스는 해당 텍스트를 aem:afProperties 섹션의 jcr:title 속성으로 언급된 고객 계좌 번호 문자열로 대체합니다.

{
  "numberfields": {
      "type": "number",
   "title": "Bank account number",
   "aem:afProperties" : {
    "jcr:title" : "Customer account number"
   }
   }
}

양식 필드 유형 수정

예: 전환 후 적응형 양식의 숫자 유형 필드로 전환하기 전에 양식에서 텍스트 유형의 은행 계좌 번호 필드를 수정합니다.

이 사용자 지정 메타 모델에서 전환 서비스는 aem:affKeyword 내의 텍스트를 검색 키워드로 사용합니다. 양식에서 은행 계좌 번호 텍스트를 검색한 후 전환 서비스는 type 속성을 사용하여 필드를 번호 형식으로 변환합니다.

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"]
 }
}

양식 필드에 도움말 텍스트 추가

예: 적응형 양식의 은행 계좌 번호 필드에 도움말 텍스트를 추가하십시오.

이 사용자 지정 메타 모델에서 전환 서비스는 aem:affKeyword 내의 텍스트를 검색 키워드로 사용합니다. 양식에서 은행 계좌 번호 텍스트를 검색한 후 전환 서비스는 설명 속성을 사용하여 적응형 양식 필드에 도움말 텍스트를 추가합니다.

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"],
   "description": "Specify your bank account number."
 }
}

적응형 양식에서 양식 필드를 다중 선택 확인란으로 변환

예: 변환 전 양식의 문자열 유형 Country 필드를 변환 후 적응형 양식의 확인란으로 변환합니다.

이 사용자 지정 메타 모델에서 전환 서비스는 aem:affKeyword 내의 텍스트를 검색 키워드로 사용합니다. 양식에서 Country 텍스트를 검색한 후 변환 서비스는 enum 속성을 사용하여 필드를 다음 확인란으로 변환합니다.

인도
잉글랜드
오스트레일리아
뉴질랜드

sling:resourceType 및 guideNodeClass 속성은 양식 필드를 확인란 적응형 양식 구성 요소에 매핑합니다.

{
"title": {
    "aem:affKeyword": [
      "country"
    ],
    "type" : "string",
    "enum": [
      "India",
      "England",
      "Australia",
      "New Zealand"
    ],
    "aem:afProperties": {
      "sling:resourceType": "fd/af/components/guidecheckbox",
      "guideNodeClass": "guidecheckbox"
    }
  }
}

양식 필드 형식 수정

예: 전자 메일 주소 필드의 형식을 전자 메일 형식으로 수정합니다.

이 사용자 지정 메타 모델에서 전환 서비스는 aem:affKeyword 내의 텍스트를 검색 키워드로 사용합니다. 양식에서 전자 메일 주소 텍스트를 검색한 후 변환 서비스는 format 속성을 사용하여 필드를 전자 메일 형식으로 변환합니다.

{
   "additionalDetails" : {
      "aem:affKeyword": ["E-mail Address"],
       "type" : "string",
       "format" : "email"
  }
}

적응형 양식 필드에 유효성 검사 추가

예 1: 적응형 양식의 우편 번호 필드에 유효성 검사를 추가합니다.

이 사용자 지정 메타 모델에서 전환 서비스는 aem:affKeyword 내의 텍스트를 검색 키워드로 사용합니다. 양식에서 우편 번호 텍스트를 검색한 후 전환 서비스는 aem:afProperties 섹션에 정의된 validatePictureClause 속성을 사용하여 필드에 유효성 검사를 추가합니다. 유효성 검사에 따라 변환 후 적응형 양식의 우편 번호 필드에 지정하는 입력에는 6자가 포함되어야 합니다.

{
   "postalCode" : {
      "aem:affKeyword": ["Postal Code"],
      "type" : "string",
      "aem:afProperties" : {
        "validatePictureClause" : "\\d{6}"
      }
   }
}

예 2: 적응형 양식의 은행 계좌 번호 필드에 유효성 검사를 추가합니다.

이 사용자 지정 메타 모델에서 전환 서비스는 aem:affKeyword 내의 텍스트를 검색 키워드로 사용합니다. 양식에서 은행 계좌 번호 텍스트를 검색한 후 전환 서비스는 aem:afProperties 섹션에 정의된 필수 속성을 사용하여 필드에 유효성 검사를 추가합니다. 전환 후 양식을 제출하기 전에 유효성 검사에 따라 은행 계좌 번호 필드에 값을 지정해야 합니다.

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"],
   "aem:afProperties" : {
        "mandatory": "true"
      }
   }
}

텍스트 필드를 적응형 양식의 드롭다운 목록으로 변환

예: 변환 전 양식의 문자열 유형 Country 필드를 변환 후 적응형 양식의 드롭다운 옵션으로 변환합니다.

이 사용자 지정 메타 모델에서 전환 서비스는 aem:affKeyword 내의 텍스트를 검색 키워드로 사용합니다. 양식에서 Country 텍스트를 검색한 후 변환 서비스는 enum 속성을 사용하여 필드를 다음과 같은 드롭다운 목록 옵션으로 변환합니다.

인도
잉글랜드
오스트레일리아
뉴질랜드

sling:resourceType 및 guideNodeClass 속성은 양식 필드를 드롭다운 적응형 양식 구성 요소에 매핑합니다.

{
"title": {
    "aem:affKeyword": [
      "country"
    ],
    "type" : "string",
    "enum": [
      "India",
      "England",
      "Australia",
      "New Zealand"
    ],
    "aem:afProperties": {
      "sling:resourceType": "fd/af/components/guidedropdownlist",
      "guideNodeClass": "guideDropDownlist"
    }
  }
}

드롭다운 목록에 추가 옵션 추가

예: 사용자 지정 메타 모델을 사용하여 기존 드롭다운 목록에 스리랑카 을(를) 추가 옵션으로 추가합니다.

추가 옵션을 추가하려면 enum 속성을 새 옵션으로 업데이트하십시오. 이 예제에서는 추가 옵션으로 스리랑카 을(를) 사용하여 enum 속성을 업데이트합니다. enum 속성에 나열된 값이 드롭다운 목록에 표시됩니다.

{
"title": {
    "aem:affKeyword": [
      "country"
    ],
    "type" : "string",
    "enum": [
      "India",
      "England",
      "Australia",
      "New Zealand",
   "Sri Lanka"
    ],
    "aem:afProperties": {
      "sling:resourceType": "fd/af/components/guidecheckbox",
      "guideNodeClass": "guidecheckbox"
    }
  }
}

문자열 필드를 여러 줄 필드로 변환

예: 문자열 형식의 Address 필드를 변환 후 양식의 여러 줄 필드로 변환합니다.

이 사용자 지정 메타 모델에서 전환 서비스는 aem:affKeyword 내의 텍스트를 검색 키워드로 사용합니다. 양식에서 Address 텍스트를 검색한 후 서비스는 aem:afProperties 섹션에 정의된 multiLine 속성을 사용하여 텍스트 필드를 여러 줄 필드로 변환합니다.

{
 "multiLine" : {
   "aem:affKeyword": [
      "Address"
    ],
    "type" : "string",
    "aem:afProperties": {
      "multiLine": "true"
    }
  }
}

recommendation-more-help