데이터 사전

소개

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

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

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

Correspondence Management는 데이터 사전의 구조에 따라 저장된 백엔드, 고객 또는 수신자별 데이터를 사용하여 서로 다른 고객을 위한 메시지를 생성합니다. 예를 들어 "Addy {First Name}","Mr."과 같은 친숙한 이름으로 문서를 만들 수 있습니다. {성}".

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

데이터 사전 워크플로우

  1. 작성자는 스키마 를 업로드하거나 처음부터 데이터 사전을 생성합니다.
  2. 작성자는 데이터 사전을 기반으로 서신 및 인터랙티브 커뮤니케이션을 만들고 데이터 사전 요소를 필요한 경우 편지와 인터랙티브 커뮤니케이션에 연결합니다.
  3. 작성자는 데이터 사전의 스키마를 기반으로 하는 샘플 데이터 XML 파일을 다운로드할 수 있습니다. 작성자는 데이터 사전과 테스트 데이터로 연결할 수 있는 샘플 데이터 XML 파일을 수정할 수 있습니다. 문자 미리 보기 중에도 동일한 기능이 사용됩니다.
  4. 편지 를 미리 보는 동안작성자는 데이터가 있는 문자를 미리 보기(사용자 정의 미리 보기)로 선택합니다. 작성자가 제공한 데이터로 미리 채워진 편지가 열립니다. 통신 만들기 인터페이스에서 열립니다. 이 편지를 미리 보고 있는 에이전트는 이 서신의 컨텐트, 데이터 및 첨부 파일을 수정할 수 있으며 최종 편지를 제출할 수 있습니다. 문자 만들기에 대한 자세한 내용은 통신 만들기를 참조하십시오.

전제 조건

[ 양식 ] 페이지에서 데이터 사전 옵션을 보려면 호환성 패키지를설치합니다.

데이터 사전 만들기

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

노트

유사한 요소가 필요한 여러 글자의 경우 공통 데이터 사전을 만들 수 있습니다. 하지만 많은 수의 요소가 있는 큰 데이터 사전은 데이터 사전을 사용하고 문자 및 문서 조각과 같은 요소를 로드하는 동안 성능 문제를 초래할 수 있습니다. 성능 문제가 발생하는 경우 문자별로 별도의 데이터 사전을 만들어 보십시오.

  1. [ 양식 ] > [ 데이터 사전]을 선택합니다.

  2. 데이터 사전 만들기를 누릅니다.

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

    • 제목: (선택 사항) 데이터 사전의 제목을 입력합니다. 제목에는 고유하지 않고 특수 문자와 비영어 문자가 포함될 수 있습니다. 편지 및 기타 문서 조각은 축소판 및 자산 속성과 같이 해당 제목(사용 가능한 경우)으로 참조됩니다. 데이터 사전은 제목이 아니라 해당 이름으로 참조됩니다.

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

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

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

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

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

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

    계산된 DD 요소에 대한 자세한 내용은 계산된 데이터 사전 요소를 참조하십시오.

    노트

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

  5. 다음을 누릅니다.

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

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

    1_2_createandelement

    복합 요소, 수집 요소 또는 기본 요소를 선택합니다.

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

    데이터 사전을 만들기 위한 몇 가지 규칙은 다음과 같습니다.

    • 데이터 사전에는 복합 유형만 최상위 DDE로 사용할 수 있습니다.
    • 이름, 참조 이름 및 요소 유형은 데이터 사전 및 DDE에 대한 필수 필드입니다.
    • 참조 이름은 고유해야 합니다.
    • 부모 DDE(복합)에는 이름이 같은 두 개의 자식이 있을 수 없습니다.
    • 열거형에는 기본 문자열 유형만 포함됩니다.

    복합, 수집 및 기본 요소 및 데이터 사전 요소 작업에 대한 자세한 내용은 데이터 사전 요소를 XML 스키마에 매핑을 참조하십시오.

    데이터 사전의 유효성 검사에 대한 자세한 내용은 데이터 사전 편집기 유효성 검사를 참조하십시오.

    2_adddpropertiesbasic

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

    3_adddpropertiesadvanced

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

    4_deleteelement

    노트

    하위 노드가 있는 복합/컬렉션 요소를 삭제하면 해당 하위 노드도 삭제됩니다.

  9. (선택 사항) 데이터 사전 구조 창과 필드 및 변수 목록 패널에서 요소를 선택합니다. 요소에 연결된 필수 속성을 변경하거나 추가합니다.

  10. 저장을 누릅니다.

하나 이상의 데이터 사전의 사본 만들기

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

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

데이터 사전 요소를 참조하는 문서 조각 또는 문서 보기

데이터 사전을 편집하거나 보는 동안 데이터 사전에서 텍스트, 조건, 문자 및 인터랙티브 커뮤니케이션을 참조하는 요소를 확인할 수 있습니다.

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

    • 데이터 사전 위로 마우스를 가져간 다음 편집을 누릅니다.
    • 데이터 사전을 선택한 다음 헤더에서 편집을 누릅니다.
    • 데이터 사전 위로 마우스를 가져간 다음 선택을 누릅니다. 그런 다음 헤더에서 편집을 누릅니다.

    또는 데이터 사전을 탭하여 볼 수 있습니다.

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

    요소의 [기본] 및 [고급] 속성과 함께 [대여 콘텐트]도 나타납니다.

  3. 대여 콘텐츠를 누릅니다.

    대여 내용 탭이 다음과 같이 나타납니다. 문자, 조건, 문자 및 인터랙티브한 커뮤니케이션 이러한 각 머리글에는 선택한 요소에 대한 참조 수도 표시됩니다.

  4. 요소를 참조하는 자산의 이름을 보려면 머리글을 누릅니다.

    lentcontent

  5. 다른 요소에 대한 대여된 내용을 보려면 요소를 누릅니다.

  6. 요소를 참조하는 자산을 표시하려면 해당 이름을 누릅니다. 브라우저에는 자산, 문자 또는 대화형 통신이 표시됩니다.

테스트 데이터 작업

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

  2. 테스트 데이터를 다운로드할 데이터 사전을 누른 다음 샘플 XML 데이터 다운로드를 누릅니다.

  3. 경고 메시지 에서 확인을 누릅니다. XML 파일이 다운로드됩니다.

  4. 메모장 또는 다른 XML 편집기를 사용하여 XML 파일을 엽니다. 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>
    
    노트

    이 예에서 XML은 컬렉션 요소에 세 개의 값 공간을 만들지만 요구 사항에 따라 값 수를 늘리거나 줄일 수 있습니다.

  5. 데이터 항목을 만든 후 테스트 데이터가 포함된 문자를 미리 볼 때 이 XML 파일을 사용할 수 있습니다.

    DD를 사용하여 이 테스트 데이터를 추가할 수 있습니다(DD를 선택하고 테스트 데이터 업로드를 탭하고 이 xml 파일 업로드). 이렇게 하면 보통(사용자 지정 아님) 문자를 미리 볼 때 이 XML 데이터가 문자로 사용됩니다. 사용자 지정을 누른 다음 이 XML을 업로드할 수도 있습니다.

샘플

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

데이터 사전에 업로드할 수 있는 샘플 스키마

<?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와 연결된 공통 속성

다음 표에서는 DDE와 연관된 공통 속성에 대해 자세히 설명합니다.

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

계산된 데이터 사전 요소

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

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

XSD와 데이터 사전 간의 데이터 형식 매핑

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

XSD

데이터 사전

DDI(인스턴스 값 데이터 유형)

xs:유형의 요소 - 합성 유형

DDE of type - COMPOSITE

java.util.Map

xs:element where maxOccurs > 1

DDE of type - COLLECTION-
A DDE 노드는 부모 COLLECTION 노드의 정보를 캡처하는 COLLECTION DDE 옆에 생성됩니다. 단순/복합 데이터 유형의 두 컬렉션 모두에 대해 동일한 항목이 생성됩니다. 복합 유형의 COLLECTION이 있을 때마다 데이터 사전 트리는 유형 정보를 캡처하기 위해 만든 DDE의 자식의 구성 요소 필드를 캡처합니다.
- DDE(컬렉션)
- DDE(유형 정보에 대한 합성)
- DDE(문자열) field1
- DDE(문자열) 필드2

java.util.List
유형 속성 - xs:id

DDE of type - STRING
java.lang.String
xs:attribute /xs:type - xs:string

DDE of type - STRING
java.lang.String
xs:attribute /xs:type - xs: boolean
DDE 유형 - 부울
java.lang.Boolean
xs:attribute /xs:type - xs:date DDE of type - DATE java.lang.String
xs:attribute /xs:type - xs:integer DDE of type - NUMBER java.lang.Double
xs:attribute /xs:type - xs:long DDE of type - NUMBER java.lang.Double
xs:attribute /xs:type - xs:double DDE of type - NUMBER java.lang.Double
열거형 유형 및 baseType 요소 - xs:string DDE of
type - STRING
하위 유형 - ENUM
valueSet - ENUM에 대해 허용되는 값
java.lang.String

데이터 사전에서 샘플 데이터 파일 다운로드

데이터 사전을 만들고 나면 XML 샘플 데이터 파일로 다운로드하여 텍스트 항목을 만들 수 있습니다.

  1. 데이터 사전 페이지에서 선택을 누른 다음 데이터 사전을 눌러 선택합니다.

  2. Select Download Sample XML Data.

  3. 경고 메시지 에서 확인을 누릅니다.

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

메타 데이터의 국제화

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

데이터 사전 현지화

  1. 데이터 사전 페이지에서 선택을 누른 다음 데이터 사전을 눌러 선택합니다.

  2. 현지화 데이터 다운로드를 누릅니다.

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

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

    #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. 현지화 변경 사항을 보려면 브라우저 로케일을 변경하십시오.

데이터 사전 유효성 검사

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

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

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

  • 데이터 사전 이름은 null일 수 없습니다.
  • 데이터 사전 이름에는 영숫자만 포함되어야 합니다.
  • 데이터 사전의 하위 요소 목록은 null이거나 비워 둘 수 없습니다.
  • 데이터 사전에는 최상위 데이터 사전 요소를 두 개 이상 포함할 수 없습니다.
  • 데이터 사전의 최상위 요소로 복합 유형만 허용됩니다.

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

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

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

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

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

단순(기본) 요소 매핑

원시 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 바인딩
나이 /나이
가격 /가격

복합 요소 매핑

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

다음 예는 참조의 스키마를 보여줍니다.

<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 바인딩
note empty(null)
/note/to
변환 전: /note/from
제목 /note/heading
/note/body

컬렉션 요소 매핑

컬렉션 요소는 카디널리티 > 1이 있는 다른 컬렉션 요소에만 매핑됩니다. DDE 컬렉션의 자식 DDE에는 부모 XML 바인딩과 관련하여 상대(로컬) XML 바인딩이 있습니다. 컬렉션 요소의 자식 DDE는 부모 DDE와 같은 카디널리티를 가져야 하므로 자식 DDE가 반복되지 않는 XML 스키마 요소를 가리키지 않도록 카디널리티 제약 조건을 확실히 하기 위해서는 상대 바인딩이 필수적입니다. 아래 예에서, "TokenID"의 카디널리티는 부모 컬렉션 DDE인 "토큰"과 같아야 합니다.

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

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

  • 컬렉션 요소의 유형을 나타내는 DDE에 대한 바인딩을 제공하지 않습니다. 제공된 경우 바인딩은 무시됩니다.

  • 컬렉션 요소의 모든 하위 DDE에 대한 바인딩은 상위 컬렉션 요소에 상대적이어야 합니다.

아래의 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)
토큰 /루트/토큰
합성 empty(null)
TokenID TokenID
TokenText empty(null)
TokenHeading TokenText/TextHeading
TokenBody TokenText/TextBody

이 페이지에서는