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

버전
문서 링크
AEM as a Cloud Service
여기 클릭
AEM 6.5
이 문서

데이터 통합

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

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

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

NOTE
두 그룹의 멤버여야 합니다. fdm-authorforms-user 양식 데이터 모델을 만들고 작업할 수 있는 그룹입니다. 그룹의 구성원이 되려면 AEM 관리자에게 문의하십시오.

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

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

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

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

  1. AEM 작성자 인스턴스에 로그인하고 다음으로 이동합니다. Forms > 데이터 통합 ​을 클릭하고 데이터 모델 개체를 추가할 양식 데이터 모델을 엽니다.

  2. 데이터 소스 창에서 데이터 소스를 확장하여 사용 가능한 데이터 모델 개체 및 서비스를 봅니다.

  3. 양식 데이터 모델에 추가할 데이터 모델 개체 및 서비스를 선택하고 선택 항목 추가.

    selected-object

    선택한 데이터 모델 개체 및 서비스

    note note
    NOTE
    Forms 데이터 모델에 관계형 데이터베이스에 대해 예약된 키워드인 개체가 포함된 경우, 이로 인해 데이터 추가, 업데이트 또는 검색 문제가 발생할 수 있습니다. 따라서 양식 데이터 모델에서 이러한 개체를 사용하지 마십시오.

    모델 탭에는 양식 데이터 모델에 추가된 모든 데이터 모델 객체와 해당 등록 정보가 그래픽으로 표시됩니다. 각 데이터 모델 개체는 양식 데이터 모델의 상자에 표시됩니다.

    model-tab

    모델 탭에는 추가된 데이터 모델 객체가 표시됩니다

    note note
    NOTE
    데이터 모델 개체 상자를 누른 채로 드래그하여 컨텐츠 영역에 구성할 수 있습니다. 양식 데이터 모델에 추가된 모든 데이터 모델 개체는 데이터 소스 창에서 회색으로 표시됩니다.

    서비스 탭에 추가된 서비스가 나열됩니다.

    서비스 탭

    서비스 탭에는 데이터 모델 서비스가 표시됩니다

    note note
    NOTE
    데이터 모델 개체 및 서비스 외에도 OData 서비스 메타데이터 문서에는 두 데이터 모델 개체 간의 연결을 정의하는 탐색 속성이 포함됩니다. 자세한 내용은 OData 서비스의 탐색 속성 작업.
  4. 선택 저장 를 클릭하여 양식 모델 개체를 저장합니다.

    note note
    NOTE
    적응형 양식 규칙을 사용하여 양식 데이터 모델의 서비스 탭에서 구성한 서비스를 호출할 수 있습니다. 구성된 서비스는 규칙 편집기의 서비스 호출 작업에서 사용할 수 있습니다. 적응형 양식 규칙에서 이러한 서비스를 사용하는 방법에 대한 자세한 내용은 서비스 호출 및 규칙 값 설정 을 참조하십시오. 규칙 편집기.

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

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

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

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

  1. AEM 작성자 인스턴스에 로그인하고 다음으로 이동합니다. Forms > 데이터 통합 ​을 클릭하고 데이터 모델 개체 또는 엔터티를 만들 양식 데이터 모델을 엽니다.

  2. 선택 엔티티 만들기.

  3. 데이터 모델 만들기 대화 상자에서 데이터 모델 개체의 이름을 지정하고 을 선택합니다 추가. 양식 데이터 모델에 데이터 모델 개체가 추가됩니다. 새로 추가된 데이터 모델 개체는 데이터 소스에 바인딩되지 않으며 다음 이미지에 표시된 대로 어떤 속성도 가지고 있지 않습니다.

    새 엔티티

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

하위 속성 추가 child-properties

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

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

  1. 양식 데이터 모델에서 데이터 모델 개체를 선택하고 하위 속성 만들기.

  2. 다음에서 하위 속성 만들기 대화 상자에서 속성의 이름과 데이터 형식을 이름유형 각각 필드입니다. 속성에 대한 제목과 설명을 선택적으로 지정할 수 있습니다.

  3. 속성이 계산된 속성인 경우 [계산됨]을 활성화합니다. 계산된 속성의 값은 규칙 또는 표현식을 기반으로 평가됩니다. 자세한 내용은 속성 편집.

  4. 데이터 모델 개체가 데이터 소스에 바인딩되면 추가된 자식 속성은 동일한 이름 및 데이터 형식의 부모 데이터 모델 개체의 속성에 자동으로 바인딩됩니다.

    하위 속성을 데이터 모델 개체 속성과 수동으로 바인딩하려면 바인드 참조 필드. 다음 개체 선택 이 대화 상자에는 상위 데이터 모델 개체의 모든 속성이 나열됩니다. 바인딩할 속성을 선택하고 확인 표시 아이콘을 선택합니다. 하위 속성과 동일한 데이터 유형의 속성만 선택할 수 있습니다.

  5. 선택 완료 하위 속성을 저장하고 저장 양식 데이터 모델을 저장하려면… 이제 하위 속성이 데이터 모델 개체에 추가됩니다.

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

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

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

  1. 양식 데이터 모델에서 데이터 소스와 바인딩할 바인딩되지 않은 데이터 소스를 선택합니다.

  2. 속성 편집 ​을 선택하십시오.

  3. 다음에서 속성 편집 창에서 다음 옆에 있는 찾아보기 아이콘을 선택합니다 바인딩 필드. 열리면 개체 선택 양식 데이터 모델에 추가된 데이터 소스를 나열하는 대화 상자입니다.

    select-object

  4. 데이터 소스 트리를 확장하고 바인딩할 데이터 모델 개체를 선택하고 확인 표시 아이콘을 선택합니다.

  5. 선택 완료 속성을 저장한 다음 저장 을 클릭하여 양식 데이터 모델을 저장합니다. 이제 데이터 모델 개체가 데이터 소스로 바인딩됩니다. 데이터 모델 개체가 더 이상 바인딩되지 않음으로 표시되지 않습니다.

    바인딩된 모델-개체

서비스 구성 configure-services

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

  1. 데이터 모델 개체 상단의 확인란을 선택하여 선택하고 속성 편집.

    edit-properties

    속성을 편집하여 데이터 모델 개체에 대한 읽기 및 쓰기 서비스를 구성합니다.

    속성 편집 대화 상자가 열립니다.

    edit-properties-2

    속성 편집 대화 상자

    note note
    NOTE
    데이터 모델 개체 및 서비스 외에도 OData 서비스 메타데이터 문서에는 두 데이터 모델 개체 간의 연결을 정의하는 탐색 속성이 포함됩니다. 양식 데이터 모델에 OData 서비스 데이터 소스를 추가하면 데이터 모델 개체의 모든 탐색 속성에 대해 양식 데이터 모델에서 서비스를 사용할 수 있습니다. 이 서비스를 사용하여 해당 데이터 모델 개체의 탐색 속성을 읽을 수 있습니다.
    서비스 사용에 대한 자세한 내용은 OData 서비스의 탐색 속성 작업.
  2. 전환 최상위 개체 데이터 모델 개체가 최상위 수준 모델 개체인지 여부를 지정합니다.

    양식 데이터 모델에 구성된 데이터 모델 개체는 양식 데이터 모델을 기반으로 하는 적응형 양식의 콘텐츠 브라우저에 있는 데이터 모델 개체 탭에서 사용할 수 있습니다. 두 데이터 모델 객체 간에 연관을 추가하면 연관하려는 데이터 모델 객체가 데이터 모델 객체 탭의 연관하려는 데이터 모델 객체 아래에 중첩됩니다. 중첩된 데이터 모델이 최상위 수준 객체인 경우에는 데이터 모델 객체 탭에도 별도로 표시됩니다. 따라서 중첩된 계층 내부와 외부의 두 항목이 표시되고, 이로 인해 양식 작성자가 혼동할 수 있습니다. 연결된 데이터 모델 개체가 중첩된 계층에만 나타나도록 하려면 Top Level Object 속성을 비활성화합니다.

  3. 선택한 데이터 모델 개체에 대해 읽기 및 쓰기 서비스를 선택합니다. 서비스에 대한 인수가 나타납니다.

    읽기-쓰기-서비스

    직원 데이터 원본에 대해 구성된 읽기 및 쓰기 서비스

  4. 선택 aem_6_3_edit 에 대한 서비스 인수 읽기 인수를 사용자 프로필 속성, 요청 속성 또는 리터럴 값에 바인딩합니다. 바인딩 값을 지정합니다.

  5. 선택 완료 인수를 저장하려면 완료 속성을 저장한 다음 저장 을 클릭하여 양식 데이터 모델을 저장합니다.

바인딩 읽기 서비스 인수 bindargument

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

리터럴 값 literal-value

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

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

리터럴 값

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

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

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

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

사용자 프로필

이 예에서 profile.empid 다음에서 바인딩 값 필드 grios 사용자.

인수 편집

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

요청 속성 request-attribute

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

  1. 선택 요청 속성 다음에서 바인딩 대상 드롭다운 메뉴를 사용하여 바인딩 값 필드.

  2. 만들기 오버레이 head.jsp용 오버레이를 생성하려면 CRX DE 를 열고 를 복사합니다. https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp 파일 위치: https://<server-name>:<port number>/crx/de/index.jsp#/apps/fd/af/components/page2/afStaticTemplatePage/head.jsp

    note note
    NOTE
    • 정적 템플릿을 사용하는 경우 다음 위치에 head.jsp를 오버레이합니다.
      /libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
    • 편집 가능한 템플릿을 사용하는 경우 다음 위치에 aftemplatedpage.jsp를 오버레이합니다.
      /libs/fd/af/components/page2/aftemplatedpage/aftemplatedpage.jsp
  3. 설정 paramMap 요청 속성에 대해 설명합니다. 예를 들어 apps 폴더의 .jsp 파일에 다음 코드를 포함합니다.

    code language-javascript
    <%Map paraMap = new HashMap();
     paraMap.put("<request_attribute>",request.getParameter("<request_attribute>"));
     request.setAttribute("paramMap",paraMap);
    

    예를 들어 아래 코드를 사용하여 데이터 소스에서 petid 값을 검색합니다.

    code language-javascript
    <%Map paraMap = new HashMap();
    paraMap.put("petId",request.getParameter("petId"));
    request.setAttribute("paramMap",paraMap);%>
    

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

예를 들어 속성을 다음으로 지정 petid=100 요청에서 데이터 소스의 속성 값과 연관된 속성을 검색합니다.

연결 추가 add-associations

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

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

NOTE
JDBC 데이터 소스의 사전 정의된 연결은 양식 데이터 모델에 유지되지 않습니다. 수동으로 만듭니다.

연결을 추가하려면:

  1. 데이터 모델 개체 상단의 확인란을 선택하여 선택하고 연결 추가. 연결 추가 대화 상자가 열립니다.

    연결 추가

    note note
    NOTE
    데이터 모델 개체 및 서비스 외에도 OData 서비스 메타데이터 문서에는 두 데이터 모델 개체 간의 연결을 정의하는 탐색 속성이 포함됩니다. 양식 데이터 모델에서 연결을 추가할 때 이러한 탐색 속성을 사용할 수 있습니다. 자세한 내용은 OData 서비스의 탐색 속성 작업.

    연결 추가 대화 상자가 열립니다.

    add-association-2

    연결 추가 대화 상자

  2. 연결 추가 창에서 다음을 수행합니다.

    • 연결의 제목을 지정합니다.
    • 연결 유형(일대일 또는 일대다)을 선택합니다.
    • 연결할 데이터 모델 개체를 선택합니다.
    • 선택한 모델 개체에서 데이터를 읽을 읽기 서비스를 선택합니다. 서비스 읽기 인수가 나타납니다. 를 편집하여 필요한 경우 인수를 변경하고 연결할 데이터 모델 개체의 속성에 바인딩합니다.

    다음 예제에서 종속 데이터 모델 개체의 읽기 서비스에 대한 기본 인수는 입니다. dependentid.

    add-association-example

    종속 항목 읽기 서비스의 기본 인수가 종속 항목입니다.

    그러나 인수는 연결된 데이터 모델 객체 간의 공통 속성이어야 합니다. 이 예에서는 다음과 같습니다. Employeeid. 따라서 Employeeid 인수는 다음에 바인딩되어야 합니다. id Employee 데이터 모델 개체의 속성을 사용하여 Dependents 데이터 모델 개체에서 연결된 종속 세부 정보를 가져옵니다.

    add-association-example-2

    인수 및 바인딩이 업데이트되었습니다.

    선택 완료 를 클릭하여 인수를 저장합니다.

  3. 선택 완료 연결을 저장한 다음 저장 을 클릭하여 양식 데이터 모델을 저장합니다.

  4. 필요에 따라 더 많은 연관을 생성하려면 단계를 반복합니다.

NOTE
추가된 연결은 지정된 제목과 연결된 데이터 모델 개체를 연결하는 선이 있는 데이터 모델 개체 상자에 나타납니다.
연결에 대한 확인란을 선택하고 을 선택하여 연결을 편집할 수 있습니다 연결 편집.

추가된 연결

속성 편집 properties

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

속성을 편집하려면:

  1. 양식 데이터 모델에서 데이터 모델 개체, 속성 또는 서비스 옆에 있는 확인란을 선택합니다.

  2. 선택 속성 편집. 다음 속성 편집 선택한 모델 개체, 속성 또는 서비스에 대한 창이 열립니다.

    • 데이터 모델 개체: 읽기 및 쓰기 서비스를 지정하고 인수를 편집합니다.
    • 속성: 속성의 유형, 하위 유형 및 형식을 지정합니다. 선택한 속성이 데이터 모델 개체의 기본 키인지 여부를 지정할 수도 있습니다.
    • 서비스: 서비스의 입력 모델 개체, 출력 유형 및 인수를 지정합니다. Get 서비스의 경우 배열을 반환할지 여부를 지정할 수 있습니다.

    edit-properties-service

    get 서비스의 속성 편집 대화 상자

  3. 선택 완료 속성을 저장한 다음 저장 을 클릭하여 양식 데이터 모델을 저장합니다.

계산된 속성 만들기 computed

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

예를 들어 계산된 속성을 만들 수 있습니다 전체 이름 기존 값의 연결 결과 값 이름 속성. 방법은 다음과 같습니다.

  1. 이름으로 속성 만들기 FullName 데이터 유형이 문자열인 경우

  2. 사용 계산됨 및 선택 완료 속성을 만듭니다.

    계산됨

    FullName 계산 속성을 만듭니다. 계산된 속성을 나타내려면 속성 옆에 있는 아이콘을 확인합니다.

    계산된 prop

  3. FullName 속성을 선택하고 규칙 편집. 규칙 편집기 창이 열립니다.

  4. 규칙 편집기 창에서 다음을 선택합니다 만들기. A 값 설정 규칙 창이 열립니다.

    Select Option 드롭다운에서 수학 표현식. 사용 가능한 기타 옵션은 다음과 같습니다 양식 데이터 모델 개체문자열.

  5. 수학 표현식에서 을 선택합니다. 이름 첫 번째 및 두 번째 객체에서 각각. 선택 플러스 를 연산자로 사용하십시오.

    선택 완료 다음을 선택합니다. 닫기 을 눌러 규칙 편집기 창을 닫습니다. 이 규칙은 다음과 유사합니다.

    규칙

  6. 양식 데이터 모델에서 저장. 계산된 속성이 구성되었습니다.

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

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

탐색 속성에 대한 자세한 내용은 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 서비스의 이 예에서는 Person 엔티티 컨테이너는 1개를 사용하여 읽을 수 있습니다. GET LINK 양식 데이터 모델의 서비스.

다음에서는 GET LINK of Person /People 양식 데이터 모델의 서비스: 의 세 가지 탐색 속성에 대한 결합 서비스 Person tripPin OData 서비스의 엔터티입니다.

nav-prop-service

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

edit-prop-nav-prop

NOTE
에서 사용할 수 있는 값 기본값 필드 탐색 속성 이름 인수는 의 상태에 따라 다릅니다 배열을 반환하시겠습니까? 토글 단추. 활성화되면 컬렉션 유형의 탐색 속성이 표시됩니다.

이 예제에서는 출력 모델 개체를 Person으로 선택하고 탐색 속성 인수를 Friends 또는 BestFriend로 선택할 수도 있습니다(선택 여부에 따라 다름) 배열을 반환하시겠습니까? 이(가) 활성화되거나 비활성화됩니다.

edit-prop-nav-prop2

마찬가지로 다음을 선택할 수 있습니다 GET LINK 양식 데이터 모델에서 연결을 추가할 때 해당 탐색 속성을 서비스하고 구성합니다. 단, 탐색 속성을 선택하려면 필드에 바인딩 이(가) (으)로 설정됨 리터럴.

add-association-nav-prop

샘플 데이터 생성 및 편집 sample

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

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

  1. 양식 데이터 모델을 열고 다음을 선택합니다. 샘플 데이터 편집. 샘플 데이터 편집 창에서 샘플 데이터를 생성하고 표시합니다.

    샘플 데이터 생성

  2. 위치 샘플 데이터 편집 창, 필요에 따라 데이터 편집 및 선택 저장.

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

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

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

  1. 양식 데이터 모델에서 데이터 모델 개체 또는 서비스를 선택하고 테스트 모델 개체 또는 테스트 서비스, 각각

    테스트 양식 데이터 모델 창이 열립니다.

    test-data-model

  2. 양식 데이터 모델 테스트 창의 입력 창에서 테스트할 데이터 모델 개체 또는 서비스를 선택합니다.

  3. 테스트 코드에서 인수 값을 지정하고 다음을 선택합니다. 테스트. 테스트가 성공하면 [출력] 창의 출력이 반환됩니다.

    테스트 결과

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

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

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

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

  • 전체: FDM은 모든 제약 조건을 기반으로 유효성 검사를 수행합니다
  • : 유효성 검사 없음
  • 기본: FDM은 '필수' 및 'nullable' 제약 조건을 기반으로 유효성 검사를 수행합니다

값을 설정하지 않은 경우 ValidationOptions플래그, 기본 입력 데이터에 대한 유효성 검사가 수행됩니다.

다음은 유효성 검사 플래그를 다음으로 설정하는 예제입니다. 전체:

operationOptions.setValidationOptions(ValidationOptions.FULL);
NOTE
입력 데이터의 속성에 대해 제공하는 값은 메타데이터 문서의 속성에 대해 정의된 데이터 유형과 일치해야 합니다.
값이 속성에 대해 정의된 데이터 유형과 일치하지 않으면 DermisBridge API는 의 값에 관계없이 예외를 표시합니다 ValidationOptions 플래그. 로그 수준이 디버그로 설정되면 오류가 error.log 파일.

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

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

제한
설명
입력 데이터 소스
required
true인 경우 매개 변수는 입력 데이터에 포함되어야 합니다.
Swagger, WSDL 및 데이터베이스
null 허용
true인 경우 입력 데이터에서 매개 변수의 값을 Null로 설정할 수 있습니다.
WSDL, Odata 및 데이터베이스
최대
숫자 값의 상한을 지정합니다. 상한으로 지정된 최대값도 입력 데이터의 매개 변수에 할당할 수 있습니다.
Swagger 및 WSDL
최소값
숫자 값의 하한을 지정합니다. 하한으로 지정된 최소값도 입력 데이터의 매개 변수에 할당할 수 있습니다.
Swagger 및 WSDL
exclusiveMaximum
숫자 값의 상한을 지정합니다. 상한으로 지정된 최대값은 입력 데이터의 매개 변수에 할당할 수 없습니다.
Swagger 및 WSDL
exclusiveMinimum
숫자 값의 하한을 지정합니다. 하한으로 지정된 최소값은 입력 데이터의 매개 변수에 할당할 수 없습니다.
Swagger 및 WSDL
minLength
문자열에 포함된 문자 수의 하한을 지정합니다. 하한으로 지정된 최소값도 입력 데이터의 매개 변수에 할당할 수 있습니다.
Swagger 및 WSDL
maxLength
문자열에 포함된 문자 수의 상한을 지정합니다. 상한으로 지정된 최대값도 입력 데이터의 매개 변수에 할당할 수 있습니다.
Swagger, WSDL, Odata 및 데이터베이스
패턴
고정된 문자 시퀀스를 지정합니다. 문자가 지정된 패턴을 따르는 경우에만 입력 문자열의 유효성을 검사합니다.
Swagger
최소 항목
배열의 최소 항목 수를 지정합니다. 하한으로 지정된 최소값도 입력 데이터의 매개 변수에 할당할 수 있습니다.
Swagger 및 WSDL
최대 항목 수
배열의 최대 항목 수를 지정합니다. 상한으로 지정된 최대값도 입력 데이터의 매개 변수에 할당할 수 있습니다.
Swagger 및 WSDL
고유 항목
true인 경우 배열의 모든 요소는 입력 데이터에서 고유해야 합니다.
Swagger
enum(문자열)
입력 데이터의 매개 변수 값을 고정된 문자열 값 집합으로 제한합니다. 하나 이상의 요소가 있는 배열이어야 합니다. 여기서 각 요소는 고유합니다.
Swagger, WSDL 및 Odata
enum(숫자)
입력 데이터의 매개 변수 값을 고정된 숫자 값 집합으로 제한합니다. 하나 이상의 요소가 있는 배열이어야 합니다. 여기서 각 요소는 고유합니다.
WSDL

이 예제에서 입력 데이터는 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"
   }
   ]

입력 데이터가 검증 기준을 충족하지 않는 경우 예외가 표시됩니다. 로그 수준이 로 설정된 경우 디버그 ​에 오류가 기록됩니다. 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

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2