기본 메타 모델 확장 extend-the-default-meta-model

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

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

기본 메타 모델 default-meta-model

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"
        }
      }
    }

기본 메타 모델 다운로드 download-the-default-meta-model

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

메타 모델 이해 understanding-the-meta-model

메타 모델은 엔티티가 포함된 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 ​인 엔터티의 이름을 나타냅니다. 이벤트 엔티티에는 여러 속성이 포함됩니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

자국어로 사용자 지정 메타모델 만들기 language-specific-meta-model

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

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

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

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

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

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

사용자 지정 메타 모델을 사용하여 적응형 양식 필드 수정 modify-adaptive-form-fields-using-custom-meta-model

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

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

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

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

전환 중 사용자 지정 메타 모델 사용 use-custom-meta-model-during-conversion

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

맞춤형 메타 모델 예제 custommetamodelexamples

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

양식 필드의 레이블 수정 modify-the-label-of-a-form-field

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

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

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

양식 필드 유형 수정 modify-the-type-of-a-form-field

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

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

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

양식 필드에 도움말 텍스트 추가 add-help-text-to-a-form-field

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

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

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

적응형 양식에서 양식 필드를 다중 선택 확인란으로 변환 convert-a-form-field-to-multiple-choice-check-boxes-in-the-adaptive-form

예: 변환 전 양식의 문자열 유형 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"
    }
  }
}

양식 필드 형식 수정 modify-the-format-of-a-form-field

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

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

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

적응형 양식 필드에 유효성 검사 추가 add-validations-to-adaptive-form-fields

예 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"
      }
   }
}

텍스트 필드를 적응형 양식의 드롭다운 목록으로 변환 convert-a-text-field-to-drop-down-list-in-the-adaptive-form

예: 변환 전 양식의 문자열 유형 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"
    }
  }
}

드롭다운 목록에 추가 옵션 추가 add-additional-options-to-the-drop-down-list

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

추가 옵션을 추가하려면 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"
    }
  }
}

문자열 필드를 여러 줄 필드로 변환 convert-a-string-field-to-a-multi-line-field

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

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

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