양식 데이터 모델 작업 work-with-form-data-model

양식 데이터 모델 편집기는 양식 데이터 모델을 편집하고 구성하기 위한 직관적인 사용자 인터페이스와 도구를 제공합니다. 편집기를 사용하면 양식 데이터 모델의 연결된 데이터 소스에서 데이터 모델 개체, 속성 및 서비스를 추가하고 구성할 수 있습니다. 또한 데이터 소스 없이 데이터 모델 개체 및 속성을 만들고 나중에 해당 데이터 모델 개체 및 속성과 바인딩할 수 있습니다. 미리 보는 동안 적응형 양식 및 대화형 커뮤니케이션을 미리 채우는 데 사용할 수 있는 데이터 모델 개체 속성에 대한 샘플 데이터를 생성하고 편집할 수도 있습니다. 양식 데이터 모델에 구성된 데이터 모델 개체 및 서비스를 테스트하여 데이터 소스와 제대로 통합되었는지 확인할 수 있습니다.

Forms 데이터 통합을 처음 사용하지만 데이터 소스를 구성하거나 양식 데이터 모델을 만들지 않은 경우 다음 항목을 참조하십시오.

양식 데이터 모델 편집기를 사용하여 수행할 수 있는 다양한 작업 및 구성에 대한 자세한 내용은 을 참조하십시오.

데이터 모델 개체 및 서비스 추가 add-data-model-objects-and-services

데이터 소스로 양식 데이터 모델을 만든 경우 양식 데이터 모델 편집기를 사용하여 데이터 모델 개체 및 서비스를 추가하고, 속성을 구성하고, 데이터 모델 개체 간의 연결을 구축하고, 양식 데이터 모델 및 서비스를 테스트할 수 있습니다.

양식 데이터 모델에서 사용 가능한 데이터 소스의 데이터 모델 개체 및 서비스를 추가할 수 있습니다. 추가된 데이터 모델 개체는 모델 탭에 나타나는 반면 추가된 서비스는 서비스 탭에 나타납니다.

데이터 모델 개체 및 서비스를 추가하려면 다음을 수행합니다.

데이터 모델 개체 및 하위 속성 만들기 create-data-model-objects-and-child-properties

데이터 모델 개체 만들기 create-data-model-objects

구성된 데이터 소스에서 데이터 모델 개체를 추가할 수 있지만, 데이터 소스가 없는 데이터 모델 개체나 엔터티를 만들 수도 있습니다. 특히 양식 데이터 모델에서 데이터 소스를 구성하지 않은 경우 유용합니다.

데이터 소스 없이 데이터 모델 객체를 생성하려면 다음을 수행합니다.

그런 다음 바인딩되지 않은 데이터 모델 개체에 하위 속성을 추가할 수 있습니다.

하위 속성 추가 child-properties

양식 데이터 모델 편집기를 사용하면 데이터 모델 개체에 하위 속성을 만들 수 있습니다. 속성을 만들 때 이 속성은 데이터 소스의 어떤 속성에도 바인딩되어 있지 않습니다. 나중에 하위 속성을 포함된 데이터 모델 개체의 다른 속성과 바인딩할 수 있습니다.

하위 속성을 만들려면 다음 작업을 수행하십시오.

데이터 모델 개체 및 속성을 만든 후에도 양식 데이터 모델을 기반으로 하는 적응형 양식 및 대화형 커뮤니케이션을 계속 만들 수 있습니다. 나중에 데이터 소스를 사용 가능하고 구성했으면 양식 데이터 모델을 데이터 소스와 바인딩할 수 있습니다. 바인딩은 연결된 적응형 양식 및 대화형 통신에서 자동으로 업데이트됩니다. 양식 데이터 모델을 사용하여 적응형 양식 및 대화형 커뮤니케이션을 만드는 방법에 대한 자세한 내용은 양식 데이터 모델 사용을 참조하십시오.

데이터 모델 개체 및 속성 바인딩 bind-data-model-objects-and-properties

양식 데이터 모델과 통합할 데이터 소스를 사용할 수 있으면 데이터 소스 업데이트에 설명된 대로 양식 데이터 모델에 추가할 수 있습니다. 그런 다음 바인딩되지 않은 데이터 모델 개체와 속성을 바인딩하려면 다음을 수행합니다.

서비스 구성 configure-services

데이터 모델 개체에 대한 데이터를 읽고 쓰려면 다음을 수행하여 읽기 및 쓰기 서비스를 구성합니다.

바인딩 읽기 서비스 인수 bindargument

바인딩 값을 기반으로 Read 서비스 인수를 사용자 프로필 속성, 요청 속성 또는 리터럴 값에 바인딩합니다. 이 값은 데이터 소스에서 지정된 값과 연결된 세부 정보를 가져오는 인수로 서비스에 전달됩니다.

리터럴 값 literal-value

바인딩 대상 드롭다운 메뉴에서 리터럴 ​을(를) 선택하고 바인딩 값 필드에 값을 입력하십시오. 값과 연관된 세부 정보는 데이터 소스에서 검색됩니다. 정적 값과 연관된 세부 정보를 검색하려면 이 옵션을 사용합니다.

이 예제에서는 mobilenum 인수에 대한 값으로 4367655678 ​과(와) 관련된 세부 정보를 데이터 원본에서 검색합니다. 모바일 번호 인수에 대한 값을 전달하는 경우 관련된 세부 정보에는 고객 이름, 고객 주소 및 구/군/시 등의 속성이 포함될 수 있습니다.

사용자 프로필 속성 user-profile-attribute

바인딩 대상 드롭다운 메뉴에서 사용자 프로필 특성 ​을(를) 선택하고 바인딩 값 필드에 특성 이름을 입력합니다. AEM 인스턴스에 로그인한 사용자의 세부 정보는 속성 이름을 기반으로 데이터 소스에서 검색됩니다.

바인딩 값 필드에 지정된 특성 이름에는 사용자의 특성 이름까지 전체 바인딩 경로가 포함되어야 합니다. CRXDE의 사용자 세부 정보에 액세스하려면 다음 URL을 엽니다.

https://[server-name]:[port]/crx/de/index.jsp#/home/users/

이 예제에서는 grios 사용자에 대한 바인딩 값 필드에 profile.empid을(를) 지정합니다.

id 인수는 사용자 프로필의 empid 특성 값을 사용하여 Read 서비스에 인수로 전달합니다. 로그인한 사용자와 연결된 empid에 대한 직원 데이터 모델 개체에서 연결된 속성의 값을 읽고 반환합니다.

요청 속성 request-attribute

요청 속성을 사용하여 데이터 소스에서 연결된 속성을 검색합니다.

세부 정보는 요청에 지정된 특성 이름을 기반으로 데이터 소스에서 검색됩니다.

예를 들어, 요청에 특성을 petid=100(으)로 지정하면 데이터 소스에서 특성 값과 연결된 속성을 검색합니다.

연결 추가 add-associations

일반적으로 데이터 소스의 데이터 모델 개체 간에 구축된 연결이 있습니다. 연결은 일대일 또는 일대다일 수 있습니다. 예를 들어 한 직원에 여러 개의 종속 항목이 연결되어 있을 수 있습니다. 일대다 연결이라고 하며 연결된 데이터 모델 개체를 연결하는 줄에 1:n이(가) 표시됩니다. 그러나 연관이 지정된 직원 ID에 대해 고유한 직원 이름을 반환하는 경우 이를 일대일 연관이라고 합니다.

데이터 소스의 연관된 데이터 모델 객체를 양식 데이터 모델에 추가하면 해당 연관이 유지되어 화살표 선으로 연결된 상태로 표시됩니다. 양식 데이터 모델의 개별 데이터 소스 간에 데이터 모델 개체 간의 연결을 추가할 수 있습니다.

연결을 추가하려면:

속성 편집 properties

데이터 모델 개체의 속성과 해당 속성 및 양식 데이터 모델에 추가된 서비스를 편집할 수 있습니다.

속성을 편집하려면:

계산된 속성 만들기 computed

계산된 등록 정보는 규칙이나 표현식을 기반으로 값이 계산되는 등록 정보입니다. 규칙을 사용하여 계산된 속성의 값을 리터럴 문자열, 숫자, 수학 표현식의 결과 또는 양식 데이터 모델의 다른 속성 값으로 설정할 수 있습니다.

예를 들어 기존 FirstName ​과(와) LastName 속성을 연결한 결과로 값을 갖는 계산 속성 FullName ​을(를) 만들 수 있습니다. 방법은 다음과 같습니다.

OData 서비스의 탐색 속성을 사용하여 작업 work-with-navigation-properties-of-odata-services

OData 서비스에서는 탐색 속성을 사용하여 두 데이터 모델 개체 간의 연결을 정의합니다. 이러한 속성은 엔터티 형식 또는 복합 형식으로 정의됩니다. 예를 들어, 샘플 TripPin OData 샘플 서비스의 메타데이터 파일에서 다음 추출에서 개인 엔터티에는 Friends, BestFriend 및 Trip의 세 가지 탐색 속성이 포함됩니다.

탐색 속성에 대한 자세한 내용은 OData 설명서를 참조하십시오.

<edmx:Edmx xmlns:edmx="https://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
<script/>
<edmx:DataServices>
<Schema xmlns="https://docs.oasis-open.org/odata/ns/edm" Namespace="Microsoft.OData.Service.Sample.TrippinInMemory.Models">
<EntityType Name="Person">
<Key>
<PropertyRef Name="UserName"/>
</Key>
<Property Name="UserName" Type="Edm.String" Nullable="false"/>
<Property Name="FirstName" Type="Edm.String" Nullable="false"/>
<Property Name="LastName" Type="Edm.String"/>
<Property Name="MiddleName" Type="Edm.String"/>
<Property Name="Gender" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonGender" Nullable="false"/>
<Property Name="Age" Type="Edm.Int64"/>
<Property Name="Emails" Type="Collection(Edm.String)"/>
<Property Name="AddressInfo" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location)"/>
<Property Name="HomeAddress" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location"/>
<Property Name="FavoriteFeature" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" Nullable="false"/>
<Property Name="Features" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature)" Nullable="false"/>
<NavigationProperty Name="Friends" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person)"/>
<NavigationProperty Name="BestFriend" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person"/>
<NavigationProperty Name="Trips" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip)"/>
</EntityType>

양식 데이터 모델에서 OData 서비스를 구성할 경우 엔티티 컨테이너의 모든 탐색 속성을 양식 데이터 모델의 서비스를 통해 사용할 수 있습니다. 이 TripPin OData 서비스 예제에서 양식 데이터 모델에서 GET LINK 서비스 하나를 사용하여 Person 엔터티 컨테이너의 세 가지 탐색 속성을 읽을 수 있습니다.

다음은 TripPin OData 서비스의 Person 엔터티에 있는 세 개의 탐색 속성에 대해 결합된 서비스인 양식 데이터 모델의 GET LINK of Person /People 서비스를 강조 표시합니다.

양식 데이터 모델의 서비스 탭에 GET LINK 서비스를 추가하면 속성을 편집하여 서비스에 사용할 출력 모델 개체와 탐색 속성을 선택할 수 있습니다. 예를들어 다음 예제에서 GET LINK of Person /People 서비스는 Trip을 출력 모델 개체로 사용하고 탐색 속성을 Trip으로 사용합니다.

이 예제에서는 출력 모델 개체를 Person으로 선택하고 탐색 속성 인수를 Friends 또는 BestFriend로 선택할 수도 있습니다(배열을 반환하는지 여부에 따라 다름). ​이(가) 사용 또는 사용 안 함으로 설정되어 있습니다.

마찬가지로 양식 데이터 모델에서 연결을 추가할 때 GET LINK 서비스를 선택하고 해당 탐색 속성을 구성할 수 있습니다. 그러나 탐색 속성을 선택하려면 필드에 대한 바인딩 ​이 리터럴(으)로 설정되어 있는지 확인하십시오.

샘플 데이터 생성 및 편집 sample

양식 데이터 모델 편집기를 사용하면 양식 데이터 모델에서 계산된 속성을 포함한 모든 데이터 모델 개체 속성에 대한 샘플 데이터를 생성할 수 있습니다. 각 속성에 대해 구성된 데이터 유형을 준수하는 무작위 값 세트입니다. 또한 샘플 데이터를 재생성하더라도 보존되는 데이터를 편집하고 저장할 수 있습니다.

샘플 데이터를 생성하고 편집하려면 다음을 수행하십시오.

그런 다음 샘플 데이터를 사용하여 양식 데이터 모델을 기반으로 대화형 커뮤니케이션을 미리 채우고 테스트할 수 있습니다. 자세한 내용은 양식 데이터 모델 사용을 참조하세요.

데이터 모델 개체 및 서비스 테스트 test-data-model-objects-and-services

양식 데이터 모델이 구성되어 있지만 사용하기 전에 구성된 데이터 모델 개체 및 서비스가 예상대로 작동하는지 테스트할 수 있습니다. 데이터 모델 개체 및 서비스를 테스트하려면 다음을 수행합니다.

마찬가지로 양식 데이터 모델에서 다른 데이터 모델 개체 및 서비스를 테스트할 수 있습니다.

입력 데이터의 자동 유효성 검사 automated-validation-of-input-data

양식 데이터 모델은 DermisBridge API를 호출하는 동안 입력으로 받은 데이터의 유효성을 검사합니다(양식 데이터 모델에서 사용할 수 있는 유효성 검사 기준에 기반). 유효성 검사는 API를 호출하는 데 사용되는 쿼리 개체에 설정된 ValidationOptions 플래그를 기반으로 합니다.

플래그는 다음 값 중 하나로 설정할 수 있습니다.

ValidationOptions플래그에 대해 설정된 값이 없으면 입력 데이터에 대해 BASIC 유효성 검사가 수행됩니다.

다음은 유효성 검사 플래그를 FULL(으)로 설정하는 예입니다.

operationOptions.setValidationOptions(ValidationOptions.FULL);

양식 데이터 모델은 데이터 유형 제약 조건 목록을 기반으로 입력 데이터의 유효성을 검사합니다. 입력 데이터에 대한 제약 조건 목록은 데이터 소스에 따라 달라질 수 있습니다.

다음 표에는 데이터 소스를 기반으로 하는 입력 데이터의 제약 조건이 나열되어 있습니다.

이 예제에서 입력 데이터는 Swagger 파일에 정의된 최대, 최소 및 필수 제약 조건을 기준으로 검증됩니다. 입력 데이터는 주문 ID가 있고 해당 값이 1과 10 사이인 경우에만 유효성 검사 기준을 충족합니다.

   parameters: [
   {
   name: "orderId",
   in: "path",
   description: "ID of pet that needs to be fetched",
   required: true,
   type: "integer",
   maximum: 10,
   minimum: 1,
   format: "int64"
   }
   ]

입력 데이터가 검증 기준을 충족하지 않는 경우 예외가 표시됩니다. 로그 수준이 Debug(으)로 설정되어 있으면 오류가 error.log 파일에 기록됩니다. 예:

21.01.2019 17:26:37.411 *ERROR* com.adobe.aem.dermis.core.validation.JsonSchemaValidator {"errorCode":"AEM-FDM-001-044","errorMessage":"Input validations failed during operation execution.","violations":{"/orderId":["numeric instance is greater than the required maximum (maximum: 10, found: 16)"]}}

다음 단계 next-steps

이제 적응형 양식 및 대화형 통신 워크플로우에서 사용할 준비가 된 작업 양식 데이터 모델이 있습니다. 자세한 내용은 양식 데이터 모델 사용을 참조하세요.