데이터 사전

소개

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

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

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

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

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

데이터 사전 워크플로우

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

전제 조건

호환성 패키지를 설치하여 Forms 페이지에서 데이터 사전 옵션을 봅니다.

데이터 사전 만들기

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

노트

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

  1. Forms > 데이터 사전​을 선택합니다.

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

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

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

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

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

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

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

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

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

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

    노트

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

  5. 다음​을 누릅니다.

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

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

    1_2_createanelement

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

    • 복합 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의 이름입니다. 고유해야 합니다.
참조
이름
문자열 필수. 데이터 사전의 계층 또는 구조 변경과 독립적인 DDE에 대한 참조를 허용하는 DDE의 고유 참조 이름입니다. 텍스트 모듈은 이 이름을 사용하여 매핑됩니다
displayname 문자열 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 값 또는 리터럴의 함수입니다. 기본적으로 EL(JSP 표현식 언어) 표현식이 지원됩니다. EL 표현식은 ${ } 문자를 사용하고 유효한 표현식은 리터럴, 연산자, 변수(데이터 사전 요소 참조) 및 함수 호출을 포함할 수 있습니다. 표현식에서 데이터 사전 요소를 참조하는 동안 DDE의 참조 이름이 사용됩니다. 참조 이름은 데이터 사전 내의 모든 데이터 사전 요소에 대해 고유합니다.

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

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

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

XSD

데이터 사전

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

xs:element of type - Composite Type

유형의 DDE - COMPOSITE

java.util.Map

xs:element where maxOccurs > 1

DDE of type - COLLECTION-
상위 COLLECTION 노드의 정보를 캡처하는 COLLECTION DDE 옆에 DDE 노드가 만들어집니다. 단순/복합 데이터 유형의 두 컬렉션에 대해 동일한 항목이 만들어집니다. 유형 조합의 COLLECTION이 있을 때마다 데이터 사전 트리에서는 유형 정보를 캡처하기 위해 만든 DDE의 1차 하위 구성요소의 필드를 캡처합니다.
- DDE(수집)
- DDE(유형 정보에 대한 복합)
- DDE(문자열) 필드1
- DDE(문자열) 필드2

java.util.List

유형의 속성 - xs:id

유형의 DDE - 문자열
java.lang.String

xs:attribute /xs:element of type - xs:string

유형의 DDE - STRING
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 형식 - xs:long 유형 DDE - 숫자 java.lang.Double
xs:attribute /xs:element 형식 - xs:double 유형 DDE - 숫자 java.lang.Double
열거형 유형 및 baseType 요소 - xs:string DDE of
type - STRING
하위 유형 - ENUM
valueSet - ENUM
에 대해 허용되는 값
java.lang.String

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

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

  1. 데이터 사전 페이지에서 선택​을 누른 다음 데이터 사전을 탭하여 선택합니다.

  2. 샘플 XML 데이터 다운로드​를 선택합니다.

  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가 계산되지 않은 경우에만 필수 항목으로 표시되도록 합니다. 또한 Collection의 유형(컬렉션 요소의 유일한 자식)을 나타내는 "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 스키마에 매핑

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

컬렉션 요소 매핑

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

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

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

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

  • 컬렉션 요소의 모든 하위 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)
TokenID TokenID
토큰 텍스트 empty(null)
토큰 제목 TokenText/TextHeading
TokenBody TokenText/TextBody

이 페이지에서는