데이터 사전 data-dictionary

소개 introduction

데이터 사전을 사용하면 비즈니스 사용자가 기본 데이터 모델에 대한 기술적 세부 정보를 알지 않고도 백엔드 데이터 소스의 정보를 사용할 수 있습니다. 데이터 사전은 데이터 사전 요소(DDE)로 구성됩니다. 이러한 데이터 요소를 사용하여 고객 서신에 사용하기 위한 입력으로 백엔드 데이터를 문자에 통합합니다.

데이터 사전은 기본 데이터 구조 및 관련 속성을 설명하는 메타데이터의 독립적인 표현입니다. 비즈니스 어휘를 사용하여 데이터 사전을 만듭니다. 하나 이상의 기본 데이터 모델에 매핑할 수 있습니다.

데이터 사전은 단순, 복합 및 컬렉션 요소의 세 가지 유형 요소로 구성됩니다. 단순 DDE는 문자열, 숫자, 날짜 및 도시 이름과 같은 정보를 포함하는 부울 값과 같은 기본 요소입니다. 복합 DDE에는 기본, 복합 또는 컬렉션 유형의 다른 DDE가 포함되어 있습니다. 예를 들어, 주소(거리 주소, 시, 도, 국가 및 우편 번호)가 있습니다. 컬렉션은 유사한 단순 또는 복합 DDE 목록입니다. 예를 들어 여러 위치 또는 청구 및 배송 주소가 다른 고객의 경우.

서신 관리는 데이터 사전의 구조에 따라 저장된 백엔드, 고객 또는 수신자 특정 데이터를 사용하여 다른 고객을 위한 서신을 만듭니다. 예를 들어 "Dear {First Name}","Mr."과 같은 친숙한 이름으로 문서를 만들 수 있습니다. {Last Name}".

일반적으로 비즈니스 사용자는 XSD(XML 스키마) 및 Java 클래스와 같은 메타데이터 표현에 대한 지식이 필요하지 않습니다. 그러나 솔루션을 빌드하려면 일반적으로 이러한 데이터 구조 및 속성에 액세스해야 합니다.

데이터 사전 워크플로 data-dictionary-workflow

  1. 작성자 데이터 사전 만들기 스키마를 업로드하거나 처음부터 업로드하여.
  2. 작성자는 데이터 사전을 기반으로 편지 및 대화형 커뮤니케이션을 만들고 필요한 경우 편지 및 대화형 커뮤니케이션의 데이터 사전 요소를 연결합니다.
  3. 작성자는 데이터 사전의 스키마를 기반으로 하는 샘플 데이터 XML 파일을 다운로드할 수 있습니다. 작성자는 샘플 데이터 XML 파일을 수정할 수 있으며, 이 파일은 데이터 사전에 테스트 데이터로 연결될 수 있습니다. 편지 미리보기 중에도 동일한 용어가 사용됩니다.
  4. While 편지 미리 보기, 작성자는 데이터를 사용하여 편지 미리 보기를 선택합니다(사용자 지정 미리 보기). 편지는 작성자가 제공한 데이터로 미리 채워진 상태로 열립니다. 응답 만들기 인터페이스에서 열립니다. 이 편지를 미리 보고 있는 에이전트는 이 편지의 내용, 데이터 및 첨부 파일을 수정할 수 있으며 최종 편지를 제출할 수 있습니다. 편지 만들기에 대한 자세한 내용은 서신 만들기.

전제 조건 prerequisite

설치 호환성 패키지 을(를) 보려면 데이터 사전 옵션 Forms 페이지를 가리키도록 업데이트하는 중입니다.

데이터 사전 만들기 createdatadictionary

데이터 사전 편집기를 사용하여 데이터 사전을 만들거나 XSD 스키마 파일을 업로드하여 이를 기반으로 데이터 사전을 만들 수 있습니다. 그런 다음 필드를 포함하여 더 많은 필수 정보를 추가하여 데이터 사전을 확장할 수 있습니다. 데이터 사전의 작성 방식에 관계없이 비즈니스 프로세스 소유자는 백엔드 시스템에 대한 지식이 필요하지 않습니다. 비즈니스 프로세스 소유자는 해당 프로세스에 대한 도메인 객체와 해당 정의에 대한 지식만 있으면 됩니다.

NOTE
유사한 요소를 필요로 하는 여러 편지의 경우 공통 데이터 사전을 만들 수 있습니다. 그러나 요소가 많은 큰 데이터 사전이 있으면 데이터 사전을 사용하고 편지 및 문서 조각과 같은 요소를 로드하는 동안 성능 문제가 발생할 수 있습니다. 성능 문제가 발생하면 다른 문자에 대해 별도의 데이터 사전을 만들어 보십시오.
  1. 선택 Forms > 데이터 사전.

  2. 선택 데이터 사전 만들기.

  3. Properties 화면에서 다음을 추가합니다.

    • 제목: (선택 사항) 데이터 사전의 제목을 입력합니다. 제목은 고유할 필요가 없으며 특수 문자와 영어가 아닌 문자를 포함할 수 있습니다. 편지 및 기타 문서 조각은 썸네일 및 에셋 속성에서와 같이 제목과 함께 참조됩니다(사용 가능한 경우). 데이터 사전은 제목이 아닌 이름으로 참조됩니다.

    • 이름: 데이터 사전에 대한 고유한 이름. 이름 필드에는 영어 문자, 숫자 및 하이픈만 입력할 수 있습니다. 이름 필드는 제목 필드를 기준으로 자동으로 채워지며 제목 필드에 입력된 특수 문자, 공백, 숫자 및 비영어 문자는 하이픈으로 대체됩니다. 제목 필드의 값이 이름에 자동으로 복사되지만 값을 편집할 수 있습니다.

    • 설명: (선택 사항) 데이터 사전에 대한 설명입니다.

    • 태그: (선택 사항) 사용자 지정 태그를 만들려면 텍스트 필드에 값을 입력하고 Enter 키를 누릅니다. 태그의 텍스트 필드 아래에 태그가 표시됩니다. 이 텍스트를 저장하면 새로 추가된 태그도 만들어집니다.

    • 확장된 속성: (선택 사항) 선택 필드 추가 데이터 사전에 대한 메타데이터 속성을 지정합니다. 속성 이름 열에 고유한 속성 이름을 입력합니다. 값 열에서 속성과 연결할 값을 입력합니다.

    독일어로 지정된 데이터 사전 속성

  4. (선택 사항) 데이터 사전에 대한 XSD 스키마 정의를 업로드하려면 데이터 사전 구조 창에서 다음을 선택합니다 XML 스키마 업로드. XSD 파일을 찾아 선택한 다음 선택합니다. 열기. 업로드된 XML 스키마를 기반으로 데이터 사전을 만듭니다. 데이터 사전에 있는 요소의 표시 이름과 설명을 수정해야 합니다. 이렇게 하려면 요소를 탭하여 요소의 이름을 선택하고 오른쪽 창의 필드에서 설명, 표시 이름 및 기타 세부 사항을 편집합니다.

    계산된 DD 요소에 대한 자세한 내용은 계산된 데이터 사전 요소.

    note note
    NOTE
    사용자 인터페이스를 사용하여 스키마 파일 업로드를 건너뛰고 데이터 사전을 처음부터 빌드할 수 있습니다. 이렇게 하려면 이 단계를 건너뛰고 다음 단계를 계속 진행하십시오.
  5. 다음 ​을 선택합니다.

  6. 속성 추가 화면에서 요소를 데이터 사전에 추가합니다. 데이터 사전의 기본 구조를 가져오기 위해 스키마를 업로드한 경우 요소를 추가/삭제하고 해당 세부 정보를 편집할 수도 있습니다.

    요소의 오른쪽에 있는 세 점을 선택하고 데이터 사전 구조에 요소를 추가할 수 있습니다.

    1_2_createanelement

    복합 요소, 수집 요소 또는 원시 요소를 선택합니다.

    • 복합 DDE에는 기본, 복합 또는 컬렉션 유형의 다른 DDE가 포함되어 있습니다. 예를 들어, 주소(거리 주소, 시, 도, 국가 및 우편 번호)가 있습니다.
    • 원시 DDE는 문자열, 숫자, 날짜 및 도시 이름과 같은 정보를 포함하는 부울 값과 같은 요소입니다.
    • 컬렉션은 유사한 단순 또는 복합 DDE 목록입니다. 예를 들어 여러 위치 또는 청구 및 배송 주소가 다른 고객의 경우.

    다음은 데이터 사전을 만드는 데 사용할 수 있는 몇 가지 규칙입니다.

    • 데이터 사전에서는 합성 유형만 최상위 수준 DDE로 허용됩니다.
    • 이름, 참조 이름 및 요소 유형은 데이터 사전 및 DDE의 필수 필드입니다.
    • 참조 이름은 고유해야 합니다.
    • 상위 DDE(합성)에는 이름이 같은 하위 항목이 두 개 있을 수 없습니다.
    • 열거형에는 기본 문자열 유형만 포함됩니다.

    합성, 컬렉션 및 프리미티브 요소와 데이터 사전 요소 작업에 대한 자세한 내용은 XML 스키마에 데이터 사전 요소 매핑.

    데이터 사전의 유효성 검사에 대한 자세한 내용은 데이터 사전 편집기 유효성 검사.

    2_addddpropertiesbasic

  7. (선택 사항) 요소를 선택한 후 고급 탭에서 속성(속성)을 추가할 수 있습니다. 다음을 선택할 수도 있습니다. 필드 추가 DD 요소의 속성을 확장합니다.

    3_addddpropertiesadvanced

  8. (선택 사항) 요소의 오른쪽에 있는 세 점을 탭하고 을 선택하여 요소를 제거할 수 있습니다 삭제.

    4_deleteelement

    note note
    NOTE
    하위 노드가 있는 복합/컬렉션 요소를 삭제하면 하위 노드도 삭제됩니다.
  9. (선택 사항) 데이터 사전 구조 창과 필드 및 변수 목록 패널에서 요소를 선택합니다. 요소와 연관된 필수 속성을 변경하거나 추가합니다.

  10. 저장 ​을 선택합니다.

하나 이상의 데이터 사전의 복사본 만들기 create-copies-of-one-or-more-data-dictionary

기존 데이터 사전과 유사한 속성 및 요소를 사용하여 데이터 사전을 한 개 이상 빠르게 만들려면 해당 데이터 사전을 복사하여 붙여 넣을 수 있습니다.

  1. 데이터 사전 목록에서 적절한 데이터 사전을 선택합니다. UI에 복사 아이콘이 표시됩니다.
  2. 복사를 선택합니다. UI에 붙여넣기 아이콘이 표시됩니다.
  3. 붙여넣기를 선택합니다. 붙여넣기 대화 상자가 나타납니다. 시스템이 새 데이터 사전에 이름과 제목을 자동으로 할당합니다.
  4. 필요한 경우 데이터 사전의 복사본을 저장할 제목 및 이름 을 편집합니다.
  5. 붙여넣기를 선택합니다. 데이터 사전의 복사본이 만들어집니다. 이제 새로 만든 데이터 사전에서 필요한 사항을 변경할 수 있습니다.

데이터 사전 요소를 참조하는 문서 단편 또는 문서를 참조하십시오 see-the-document-fragments-or-documents-that-refer-to-a-data-dictionary-element

데이터 사전을 편집하거나 보는 동안 텍스트, 조건, 편지 및 대화형 커뮤니케이션에서 데이터 사전의 어떤 요소를 참조하는지 확인할 수 있습니다.

  1. 데이터 사전을 편집하려면 다음 중 하나를 수행하십시오.

    • 데이터 사전을 마우스로 가리킨 다음 편집을 선택합니다.
    • 데이터 사전을 선택한 다음 헤더에서 편집 을 선택합니다.
    • 데이터 사전을 마우스로 가리킨 다음 선택을 선택합니다. 그런 다음 헤더에서 편집 을 선택합니다.

    또는 데이터 사전에서 을(를) 선택하여 확인합니다.

  2. 데이터 사전에서 간단한 요소를 선택하여 선택합니다. 복합 및 컬렉션 요소에 참조가 없습니다.

    요소의 기본 및 고급 속성과 함께 빌려 온 콘텐츠도 표시됩니다.

  3. 빌려 온 컨텐츠를 선택합니다.

    텍스트, 조건, 편지 및 대화형 커뮤니케이션과 함께 빌려 온 컨텐츠 탭이 표시됩니다. 이러한 각 머리글에는 선택한 요소에 대한 참조 횟수도 표시됩니다.

  4. 제목을 선택하여 요소를 참조하는 에셋의 이름을 확인합니다.

    컨텐트

  5. 다른 요소에 대해 빌려준 콘텐츠를 보려면 해당 요소를 선택합니다.

  6. 요소를 참조하는 에셋을 표시하려면 해당 이름에서 를 선택합니다. 브라우저가 에셋, 편지 또는 대화형 통신을 표시합니다.

테스트 데이터 작업 working-with-test-data

  1. 데이터 사전 페이지에서 을 선택합니다 선택.

  2. 테스트 데이터를 다운로드할 데이터 사전을 선택한 다음 를 선택합니다 샘플 XML 데이터 다운로드.

  3. 선택 확인 경고 메시지. XML 파일을 다운로드합니다.

  4. 메모장 또는 다른 XML 편집기를 사용하여 XML 파일을 엽니다. XML 파일의 구조는 요소의 데이터 사전 및 자리 표시자 문자열과 동일합니다. 자리 표시자 문자열을 문자를 테스트할 데이터로 바꿉니다.

    code language-xml
    <?xml version="1.0" encoding="UTF-8" standalone="no"?>
    <Company>
    <Name>string</Name>
    <Type>string</Type>
    <HeadOfficeAddress>
    <Street>string</Street>
    <City>string</City>
    <State>string</State>
    <Zip>string</Zip>
    </HeadOfficeAddress>
    <SalesOfficeAddress>
    <Street>string</Street>
    <City>string</City>
    <State>string</State>
    <Zip>string</Zip>
    </SalesOfficeAddress>
    <HeadCount>1.0</HeadCount>
    <CEO>
    <PersonName>
    <FirstName>string</FirstName>
    <MiddleName>string</MiddleName>
    <LastName>string</LastName>
    </PersonName>
    <DOB>string</DOB>
    <CurrAddress>
    <Street>string</Street>
    <City>string</City>
    <State>string</State>
    <Zip>string</Zip>
    </CurrAddress>
    <DOJ>14-04-1973</DOJ>
    <Phone>1.0</Phone>
    </CEO>
    </Company>
    
    note note
    NOTE
    이 예에서 XML은 수집 요소에 세 개의 값을 위한 공간을 만들지만 요구 사항에 따라 값의 수를 늘리거나 줄일 수 있습니다.
  5. 데이터 항목을 만든 후 테스트 데이터가 있는 문자를 미리 볼 때 이 XML 파일을 사용할 수 있습니다.

    DD를 사용하여 이 테스트 데이터를 추가할 수 있습니다(DD 선택 및 테스트 데이터 업로드 선택 및 이 xml 파일 업로드). 따라서 이 작업 후 편지를 일반적으로 미리 볼 때(사용자 지정 아님) 이 XML 데이터가 편지에 사용됩니다. 사용자 지정을 선택한 다음 이 XML을 업로드할 수도 있습니다.

샘플 samples

다음 코드 샘플은 데이터 사전에 대한 구현 세부 사항을 보여 줍니다.

데이터 사전에 업로드할 수 있는 샘플 스키마 sample-schema-that-can-be-uploaded-to-the-data-dictionary

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns="DCT" targetNamespace="DCT" xmlns:xs="https://www.w3.org/2001/XMLSchema"
  elementFormDefault="qualified" attributeFormDefault="unqualified">
  <xs:element name="Company">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="Name" type="xs:string"/>
        <xs:element name="Type" type="xs:anySimpleType"/>
        <xs:element name="HeadOfficeAddress" type="Address"/>
        <xs:element name="SalesOfficeAddress" type="Address" minOccurs="0"/>
        <xs:element name="HeadCount" type="xs:integer"/>
        <xs:element name="CEO" type="Employee"/>
        <xs:element name="Workers" type="Employee" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:complexType name="Employee">
    <xs:complexContent>
      <xs:extension  base="Person">
        <xs:sequence>
          <xs:element name="CurrAddress" type="Address"/>
          <xs:element name="DOJ" type="xs:date"/>
          <xs:element name="Phone" type="xs:integer"/>
        </xs:sequence>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>
  <xs:complexType name="Person">
    <xs:sequence>
      <xs:element name="PersonName" type="Name"/>
      <xs:element name="DOB" type="xs:dateTime"/>
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="Name">
    <xs:sequence>
      <xs:element name="FirstName" type="xs:string"/>
      <xs:element name="MiddleName" type="xs:string"/>
      <xs:element name="LastName" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="Address">
    <xs:sequence>
      <xs:element name="Street" type="xs:string"/>
      <xs:element name="City" type="xs:string"/>
      <xs:element name="State" type="xs:string"/>
      <xs:element name="Zip" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

DDE와 연결된 일반 속성 common-attributes-associated-with-a-dde

다음 표에서는 DDE와 관련된 일반적인 속성에 대해 자세히 설명합니다.

속성
유형
설명
이름
문자열
필수.
DDE 이름. 고유해야 합니다.
참조
이름
문자열
필수. 데이터 사전의 계층 구조 또는 구조에 대한 변경 사항과 독립적인 DDE에 대한 참조를 허용하는 DDE에 대한 고유 참조 이름입니다. 텍스트 모듈은 이 이름을 사용하여 매핑됩니다.
displayname
문자열
사용자에게 친숙한 DDE의 선택적 이름입니다.
설명
문자열
DDE에 대한 설명.
elementType
문자열
필수. DDE 유형: STRING, NUMBER, DATE, Boolean, COMPOSITE, COLLECTION.
elementSubtype
문자열
DDE의 하위 유형: 열거형. STRING 및 NUMBER elementType에만 허용됩니다.
부울
DDE가 키 요소인지 여부를 나타내는 부울 필드입니다.
계산됨
부울
DDE가 계산되는지 여부를 나타내는 부울 필드입니다. 계산된 DDE 값은 다른 DDE 값의 함수입니다. 기본적으로 jsp 표현식이 지원됩니다.
표현식
문자열
"계산된" DDE에 대한 표현식입니다. 기본적으로 제공되는 표현식 평가 서비스는 JSP EL 표현식을 지원합니다. 표현식 서비스를 사용자 지정 구현으로 바꿀 수 있습니다.
valueSet
목록
열거형 유형 DDE에 대해 허용되는 값 집합입니다. 예를 들어 계정 유형은 (저장, 현재) 값만 가질 수 있습니다.
extendedProperties
오브젝트
DDE(사용자 인터페이스별 또는 기타 정보)에 추가된 사용자 지정 속성 맵입니다.
필수
부울
이 플래그는 데이터 사전에 해당하는 인스턴스 데이터의 원본이 이 특정 DDE의 값을 포함해야 함을 나타냅니다.
바인딩
BindingElement
요소의 XML 또는 Java 바인딩입니다.

계산된 데이터 사전 요소 computedddelements

데이터 사전에는 계산된 요소도 포함될 수 있습니다. 계산된 데이터 사전 요소는 항상 표현식과 연결됩니다. 이 표현식은 런타임 시 데이터 사전 요소의 값을 얻기 위해 평가됩니다. 계산된 DDE 값은 다른 DDE 값 또는 리터럴의 함수입니다. 기본적으로 JSP 표현식 언어(EL) 표현식이 지원됩니다. EL 표현식은 ${ } 문자를 사용하며 유효한 표현식은 리터럴, 연산자, 변수(데이터 사전 요소 참조) 및 함수 호출을 포함할 수 있습니다. 표현식에서 데이터 사전 요소를 참조하는 동안 DDE의 참조 이름이 사용됩니다. 참조 이름은 데이터 사전 내의 모든 데이터 사전 요소에 대해 고유합니다.

계산된 DDE PersonFullName을 $와 같은 EL 연결 표현식과 연결할 수 있습니다{PersonFirstName} ${PersonLastName}.

XSD와 데이터 사전 간의 데이터 유형 매핑 data-type-mapping-between-xsd-and-data-dictionary-br

XSD를 내보내려면 다음 표에 자세히 설명되어 있는 특정 데이터 매핑이 필요합니다. DDI 열은 DDI에서 사용할 수 있는 DDE 값의 유형을 나타냅니다.

XSD
데이터 사전
DDI(인스턴스 값 데이터 형식)
xs:element of type - 합성 유형
유형의 DDE - 합성
java.util.Map
xs:element 여기서 maxOccurs > 1
유형의 DDE - 컬렉션-
상위 COLLECTION 노드의 정보를 캡처하는 COLLECTION DDE 옆에 DDE 노드가 만들어집니다. 단순/복합 데이터 유형의 컬렉션에도 동일하게 만들어집니다. 유형 복합 컬렉션이 있을 때마다 데이터 사전 트리는 유형 정보를 캡처하기 위해 만든 DDE의 하위 항목에 있는 구성 필드를 캡처합니다.
- DDE(콜렉션)
- DDE(유형 정보에 대한 합성)
- DDE(문자열) 필드1
- DDE(문자열) 필드2
java.util.List
유형의 속성 - xs:id
유형의 DDE - 문자열
java.lang.String
xs:attribute /xs:element of type - xs:string
유형의 DDE - 문자열
java.lang.String
xs:attribute /xs:element of type - xs: 부울
유형의 DDE - 부울
java.lang.Boolean
xs:attribute /xs:element of type - xs:date
유형의 DDE - 날짜
java.lang.String
xs:attribute /xs:element of type - xs:integer
유형의 DDE - 숫자
java.lang.Double
xs:attribute /xs:element of type - xs:long
유형의 DDE - 숫자
java.lang.Double
xs:attribute /xs:element of type - xs:double
유형의 DDE - 숫자
java.lang.Double
열거형 유형 및 baseType의 요소 - xs:string
의 DDE
유형 - 문자열
하위 유형 - 열거형
valueSet - ENUM에 대해 허용되는 값
java.lang.String

데이터 사전에서 샘플 데이터 파일 다운로드 download-a-sample-data-file-from-a-data-dictionary

데이터 사전을 만든 후에는 XML 샘플 데이터 파일로 다운로드하여 데이터 사전의 텍스트 항목을 만들 수 있습니다.

  1. 데이터 사전 페이지에서 다음을 선택합니다. 선택 그런 다음 데이터 사전을 선택하여 선택합니다.

  2. 선택 샘플 XML 데이터 다운로드.

  3. 선택 확인 경고 메시지.

    서신 관리에서는 선택한 데이터 사전의 구조를 기반으로 XML 파일을 만들고 해당 이름으로 컴퓨터에 다운로드합니다 <data-dictionary-name>-SampleData. 이제 XML 또는 텍스트 편집기에서 이 파일을 편집하여 다음 기간 동안 데이터 항목을 만들 수 있습니다. 편지 만들기.

메타 데이터의 국제화 internationalization-of-meta-data

동일한 문자를 다른 언어로 고객에게 보내려면 데이터 사전 및 데이터 사전 요소의 표시 이름, 설명 및 열거형 값 세트를 현지화할 수 있습니다.

데이터 사전 현지화 localize-data-dictionary

  1. 데이터 사전 페이지에서 을 선택합니다 선택 그런 다음 데이터 사전을 선택하여 선택합니다.

  2. 선택 로컬라이제이션 데이터 다운로드.

  3. 선택 확인 경고. 서신 관리에서 DataDictionary 라는 이름의 zip 파일을 컴퓨터에 다운로드합니다.<ddname>.zip.

  4. Zip 파일에는 .properties 파일이 포함되어 있습니다. 이 파일은 다운로드한 데이터 사전을 정의합니다. 속성 파일의 내용은 다음과 유사합니다.

    code language-ini
    #Wed May 20 16:06:23 BST 2015
    DataDictionary.EmployeeDD.description=
    DataDictionary.EmployeeDD.displayName=EmployeeDataDictionary
    DataDictionaryElement.name.description=
    DataDictionaryElement.name.displayName=name
    DataDictionaryElement.person.description=
    DataDictionaryElement.person.displayName=person
    

    등록 정보 파일의 구조는 설명과 표시 이름에 대해 각각 한 줄을 정의하며 데이터 사전의 각 데이터 사전 요소와 데이터 사전의 각 데이터 사전 요소를 정의합니다. 또한 속성 파일은 각 데이터 사전 요소에 대해 설정된 열거형 값에 대해 한 줄을 정의합니다. 데이터 사전과 마찬가지로 해당 속성 파일에 여러 데이터 사전 요소 정의가 있을 수 있습니다. 또한 파일에는 하나 이상의 열거형 값 집합에 대한 정의가 포함될 수 있습니다.

  5. 다른 로케일에서 .properties 파일을 업데이트하려면 파일의 표시 이름 및 설명 값을 업데이트합니다. 현지화할 각 언어에 대해 파일의 인스턴스를 더 만듭니다. 프랑스어, 독일어, 일본어 및 영어 언어만 지원됩니다.

  6. 다음과 같은 이름으로 업데이트된 다른 등록 정보 파일을 저장합니다.

    _fr_FR.properties 프랑스어

    _de_DE.properties 독일어

    _ja_JA.properties 일본어

    _en_EN.properties 영어

  7. .properties 파일(또는 여러 로케일용 파일)을 단일 .zip 파일에 보관합니다.

  8. 데이터 사전 페이지에서 다음을 선택합니다. 자세히 > 로컬라이제이션 데이터 업로드 현지화된 속성 파일이 있는 zip 파일을 선택합니다.

  9. 현지화 변경 사항을 보려면 브라우저 로케일을 변경하십시오.

데이터 사전 유효성 검사 ddvalidations

데이터 사전 편집기는 데이터 사전을 만들거나 업데이트할 때 다음 유효성 검사를 시행합니다.

  • 데이터 사전에서는 복합 유형만 최상위 수준 요소로 허용됩니다.
  • 리프 수준에서 복합 및 컬렉션 요소를 사용할 수 없습니다. 리프 수준에서는 기본(문자열, 날짜, 숫자, 부울) 요소만 허용됩니다. 이 유효성 검사는 하위 DDE가 없는 합성 및 컬렉션 요소가 없는지 확인합니다.
  • 데이터 사전을 만들기 위해 XSD 파일을 업로드하는 동안 데이터 사전 편집기는 데이터 사전을 만들기 위해 최상위 수준 요소(여러 개가 있는 경우)에 대해 프롬프트를 표시합니다.
  • 이 이름은 데이터 사전에 유일한 필수 매개 변수입니다.
  • 상위 DDE(합성)에는 이름이 같은 하위 항목이 두 개 있을 수 없습니다
  • 필수 매개 변수가 아닌 경우에만 DDE가 계산됨으로 표시되는지 확인합니다. 필수 요소는 계산할 수 없으며 계산된 요소는 필수 요소가 될 수 없습니다. 또한 컬렉션 및 복합 요소는 계산된 요소가 될 수 없습니다.
  • DDE가 계산되지 않은 경우에만 필수로 표시되는지 확인합니다. 또한 컬렉션 유형(컬렉션 요소의 유일한 자식)을 나타내는 "collectionElement"가 아닙니다.
  • 데이터 사전 또는 DDE에 대한 extendedProperties에서는 빈 키 또는 중복 키를 사용할 수 없습니다.
  • 확장 속성의 키 또는 값 내에 콜론(:) 또는 세로 막대(|) 문자를 사용하지 마십시오. 이러한 금지된 문자를 사용할 수 있는지 확인할 수 없습니다.

데이터 사전 수준에서 적용되는 유효성 검사

  • 데이터 사전 이름은 null이 아니어야 합니다.
  • 데이터 사전 이름에는 영숫자만 사용할 수 있습니다.
  • 데이터 사전의 하위 요소 목록은 null이거나 비워 둘 수 없습니다.
  • 데이터 사전에는 둘 이상의 최상위 수준 데이터 사전 요소가 포함될 수 없습니다.
  • 데이터 사전에서는 합성 유형만 최상위 수준 요소로 허용됩니다.

데이터 사전 요소 수준에서 적용되는 유효성 검사입니다.

  • 모든 DDE 이름은 null이 아니어야 하며 공백을 포함해서는 안 됩니다.
  • 모든 DDE에는 "null 아님/null 아님" 요소 유형이 있어야 합니다.
  • 모든 DDE 참조 이름은 null이 아니어야 합니다.
  • 모든 DDE 참조 이름은 고유해야 합니다.
  • 모든 DDE 참조에는 영숫자와 "_"만 포함되어야 합니다.
  • 모든 DDE 표시 이름에는 영숫자와 "_"만 포함되어야 합니다.
  • 리프 수준에서 복합 및 컬렉션 요소를 사용할 수 없습니다. 리프 수준에서는 기본(문자열, 날짜, 숫자, 부울) 요소만 허용됩니다. 이 유효성 검사는 하위 DDE가 없는 합성 및 컬렉션 요소가 없는지 확인합니다.
  • 복합 상위 DDE에는 이름이 같은 두 개의 하위 요소가 없어야 합니다.
  • ENUM 하위 유형은 String 및 Number 요소에만 사용됩니다.
  • 컬렉션 및 복합 요소를 계산할 수 없습니다.
  • DDE는 계산 및 필수 둘 다일 수 없습니다.
  • 계산된 DDE에는 유효한 표현식이 있어야 합니다.
  • 계산된 DDE에는 XML 바인딩이 없어야 합니다.
  • 컬렉션 DDE의 유형을 나타내는 DDE는 계산하거나 요구할 수 없습니다.
  • 하위 유형 ENUM의 DDE에는 null 또는 빈 값 집합이 포함될 수 없습니다.
  • 컬렉션 DDE의 XML 바인딩은 특성에 매핑할 수 없습니다.
  • XML 바인딩 구문은 유효해야 합니다. 예를 들어 한 개의 @만 나타나고 다음에 특성 이름이 올 때만 @이 허용됩니다.

XML 스키마에 데이터 사전 요소 매핑 mappingddetoschema

XML 스키마에서 데이터 사전을 만들거나 데이터 사전 사용자 인터페이스를 사용하여 만들 수 있습니다. 데이터 사전 내의 모든 DDE(데이터 사전 요소)에는 XML 스키마의 요소에 대한 DDE의 바인딩을 저장하는 XML 바인딩 필드가 있습니다. 각 DDE의 바인딩은 상위 DDE에 상대적입니다.

다음은 데이터 사전에 대한 구현 세부 사항을 보여 주는 샘플 모델 및 코드 샘플에 대해 자세히 설명합니다.

단순(기본) 요소 매핑 mapping-simple-primitive-elements

기본 DDE는 자연에서 원자적인 필드 또는 속성을 나타냅니다. 복합 유형(복합 DDE) 또는 반복 요소(컬렉션 DDE)의 범위 밖에 정의된 기본 DDE는 XML 스키마 내의 모든 위치에 저장할 수 있습니다. 기본 DDE에 해당하는 데이터의 위치는 상위 DDE의 매핑에 종속되지 않습니다. 기본 DDE는 XML 바인딩 필드의 매핑 정보를 사용하여 해당 값을 결정하며 매핑은 다음 중 하나로 변환됩니다.

  • 속성
  • 요소
  • 텍스트 컨텍스트
  • nothing(무시된 DDE)

다음 예제에서는 간단한 스키마를 보여 줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema">
  <xs:element name='age' type='integer'/>
  <xs:element name='price' type='decimal'/>
</xs:schema>
데이터 사전 요소
기본 XML 바인딩
나이
/age
가격
/price

복합 요소 매핑 mapping-composite-elements

복합 요소에 대해서는 바인딩이 지원되지 않습니다. 바인딩이 제공되면 무시됩니다. 기본 유형의 모든 구성 하위 DDE에 대한 바인딩은 절대적이어야 합니다. 복합 DDE의 하위 요소에 대한 절대 매핑을 허용하면 XPath 바인딩 측면에서 보다 유연하게 작업할 수 있습니다. XML 스키마의 복합 유형 요소에 복합 DDE를 매핑하면 해당 하위 요소에 대한 바인딩 범위가 제한됩니다.

다음 예제는 메모에 대한 스키마를 보여줍니다.

<xs:element name="note">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="to" type="xs:string"/>
            <xs:element name="from" type="xs:string"/>
            <xs:element name="heading" type="xs:string"/>
            <xs:element name="body" type="xs:string"/>
        </xs:sequence>
    </xs:complexType>
</xs:element>
데이터 사전 요소
기본 XML 바인딩
참고
empty(null)
대상
/note/to
시작 시간:
/note/from
제목
/note/heading
본문
/note/body

컬렉션 요소 매핑 mapping-collection-elements

컬렉션 요소는 카디널리티가 1보다 큰 다른 컬렉션 요소에만 매핑됩니다. 컬렉션 DDE의 자식 DDE에는 해당 부모의 XML 바인딩에 대한 상대(로컬) XML 바인딩이 있습니다. 컬렉션 요소의 자식 DDE는 부모 요소의 카디널리티와 동일해야 하므로, 자식 DDE가 반복되지 않는 XML 스키마 요소를 가리키지 않도록 카디널리티 제약 조건을 보장하기 위해 상대 바인딩이 필요합니다. 아래 예에서 "TokenID"의 카디널리티는 상위 컬렉션 DDE인 "Tokens"와 동일해야 합니다.

컬렉션 DDE를 XML 스키마 요소에 매핑하는 경우:

  • 컬렉션 요소에 해당하는 DDE에 대한 바인딩은 절대 XPath여야 합니다.

  • Collection 요소의 유형을 나타내는 DDE에 바인딩을 제공하지 않습니다. 제공되면 바인딩이 무시됩니다.

  • Collection 요소의 모든 자식 DDE에 대한 바인딩은 부모 Collection 요소에 상대적이어야 합니다.

아래 XML 스키마는 이름이 Tokens이고 maxOccurs 특성이 "unbounded"인 요소를 선언합니다. 따라서 토큰은 수집 요소입니다.

<?xml version="1.0" encoding="utf-8"?>
<Root>
  <Tokens>
    <TokenID>string</TokenID>
    <TokenText>
      <TextHeading>string</TextHeading>
      <TextBody>string</TextBody>
    </TokenText>
  </Tokens>
  <Tokens>
    <TokenID>string</TokenID>
    <TokenText>
      <TextHeading>string</TextHeading>
      <TextBody>string</TextBody>
    </TokenText>
  </Tokens>
  <Tokens>
    <TokenID>string</TokenID>
    <TokenText>
      <TextHeading>string</TextHeading>
      <TextBody>string</TextBody>
    </TokenText>
  </Tokens>
</Root>

이 샘플과 연결된 Token.xsd는 다음과 같습니다.

<xs:element name="Root">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="Tokens" type="TokenType" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>
</xs:element>

<xs:complexType name="TokenType">
  <xs:sequence>
    <xs:element name="TokenID" type="xs:string"/>
    <xs:element name="TokenText">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="TextHeading" type="xs:string"/>
          <xs:element name="TextBody" type="xs:string"/>
        </xs:sequence>
      </xs:complexType>
    </xs:element>
  </xs:sequence>
</xs:complexType>
데이터 사전 요소
기본 XML 바인딩
루트
empty(null)
토큰
/Root/Tokens
합성
empty(null)
토큰 ID
토큰 ID
토큰 텍스트
empty(null)
TokenHeading
토큰 텍스트/텍스트 제목
토큰 본문
TokenText/텍스트 본문
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2