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

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

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

기본 메타 모델 default-meta-model

Automated forms conversion 서비스에는 기본 메타 모델이 있습니다. JSON 스키마이며 Automated forms conversion 서비스의 다른 구성 요소와 함께 Adobe 클라우드에 있습니다. 로컬 AEM 서버에서 http://으로 메타 모델의 복사본을 찾을 수 있습니다.<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metamodel/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."
            }
          }
        }
      ]
    }

이 예에서는 이벤트 값이 있는 엔티티의 이름을 나타냅니다. id 다음으로: Eventid. 이벤트 엔티티에는 여러 속성이 포함됩니다.

다음 allOf 메타 모델에서 를 만들면 엔티티 간에 상속이 가능합니다.

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

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

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

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

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

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

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

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

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

이 예제에서 전환 서비스는 다음 내에서 텍스트를 사용합니다 aem:affKeyword 를 검색 키워드로 사용하십시오. 검색 후 은행 계좌 번호 양식의 텍스트, 변환 서비스는 필드를 로 변환합니다. 숫자 을 사용하여 입력 유형 속성.

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

다음을 사용할 수 있습니다. aem:afProperties automated forms conversion 서비스를 사용하여 생성된 적응형 양식 필드에 대한 다음 추가 속성을 정의하는 메타 모델의 속성:

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

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

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

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

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

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

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

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

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

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

http://<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json

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

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

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

맞춤형 메타 모델 예제 custommetamodelexamples

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

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

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

이 사용자 지정 메타 모델에서 전환 서비스는 제목 속성을 검색 키워드로 사용합니다. 검색 후 은행 계좌 번호 양식의 텍스트 변환 서비스는 텍스트를 고객 계정 번호 이(가) 포함된 문자열 jcr:title 의 속성 aem:afProperties 섹션.

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

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

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

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

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

예: 변환 국가 변환 전 양식의 문자열 유형 필드를 변환 후 적응형 양식의 확인란

이 사용자 지정 메타 모델에서 전환 서비스는 다음 내에서 텍스트를 사용합니다. aem:affKeyword 를 검색 키워드로 사용하십시오. 검색 후 국가 양식의 텍스트에서 변환 서비스는 다음을 사용하여 필드를 다음 확인란으로 변환합니다. 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 를 검색 키워드로 사용하십시오. 검색 후 이메일 주소 양식의 텍스트 변환 서비스는 다음을 사용하여 필드를 이메일 형식으로 변환합니다. 형식 속성.

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

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

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

이 사용자 지정 메타 모델에서 전환 서비스는 다음 내에서 텍스트를 사용합니다. aem:affKeyword 를 검색 키워드로 사용하십시오. 검색 후 우편 번호 양식의 텍스트에서 전환 서비스는 다음을 사용하여 필드에 유효성 검사를 추가합니다. validatePictureSection 에 정의된 속성 aem:afProperties 섹션. 유효성 검사를 기반으로 우편 번호 변환 후 적응형 양식의 필드에는 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

예: 변환 국가 전환 전 양식의 문자열 유형 필드입니다. 전환 후 적응형 양식의 드롭다운 옵션입니다.

이 사용자 지정 메타 모델에서 전환 서비스는 다음 내에서 텍스트를 사용합니다. aem:affKeyword 를 검색 키워드로 사용하십시오. 검색 후 국가 양식의 텍스트에서 전환 서비스는 다음을 사용하여 필드를 다음과 같은 드롭다운 목록 옵션으로 전환합니다. 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

예: 변환 주소 변환 후 양식의 여러 줄 필드에 대한 문자열 유형의 필드입니다.

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

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