스키마 정의 페이지

이 페이지 정보

이 양식 페이지에서는 편집된 스키마의 문법을 구성하는 스키마 오브젝트의 구조 및 특성을 편집할 수 있습니다.

스키마 오브젝트의 구조는 확장점 요소 섹션에서 편집됩니다. 이 섹션은 편집기 영역의 왼쪽 상단에 있습니다.

스키마 오브젝트의 특성은 <schema-object> 세부사항 섹션에서 편집됩니다. 이러한 섹션은 확장점 요소 섹션에서 선택한 스키마 요소 유형에 따라 편집기 영역의 오른쪽 상단 부분에 활성화됩니다.

페이지 섹션

이 페이지는 다음 섹션으로 구성됩니다.

확장점 요소 섹션

이 섹션에서 다음을 수행할 수 있습니다.

이 섹션은 스키마 정의 양식 페이지를 통해 직접 액세스할 수 있습니다.

확장점 요소 섹션 필드

확장점 요소 뷰어 필드를 사용하여 다음을 수행할 수 있습니다.

이 뷰어에는 다음 노드가 포함되어 있습니다.

요소:

컴포지터:

속성:

예제: extension 요소는 하나 이상의 shortcut 요소가 합법적 하위로 허용되는 시퀀스를 지정합니다. 요소 참조는 shortcut 요소를 나타냅니다. Sequence 컴포지터는 요소의 시퀀스를 나타냅니다.

확장점 요소 섹션 2

예제: shortcut 요소는 합법적 하위로 사용 가능한 description 또는 category 요소를 지정합니다. 요소 참조는 description 및 category 요소를 나타냅니다. Choice 컴포지터는 요소의 선택사항을 나타냅니다.

확장점 요소 섹션 1

확장점 요소 섹션 조치

새 글로벌 요소 선언을 확장점 스키마 문법에 추가하려면 요소 추가 단추를 클릭하십시오. 이 조치는 노드를 선택할 때 사용 가능합니다. 참고: 요소 선언 순서는 중요하지 않습니다.

새 로컬 속성 선언을 확장점 스키마 문법에서 선택한 요소에 추가하려면 속성 추가 단추를 클릭하십시오. 이 조치는 선택한 요소 노드 중 extension 요소 노드를 제외한 모든 노드에 대해 사용 가능합니다. extension 요소 노드의 속성은 항상 동일합니다(id, name, point). 참고: 속성 선언 순서는 중요하지 않습니다.

확장점 스키마 문법에서 스키마 오브젝트를 삭제하려면 선택한 노드를 마우스 오른쪽 단추로 클릭하고 삭제를 선택하십시오. 이 조치는 선택한 노드 중 extension 요소 노드를 제외한 모든 노드에 대해 사용 가능합니다. 비공유 스키마의 경우 extension 요소 노드는 편집된 스키마 문법의 시작점을 정의하는 특수한 루트 요소입니다. 플러그인 Manifest 편집기에서 정의된 확장은 모두 extension 상위 요소를 사용하여 XML 관련 마크업을 지정해야 합니다.

요소의 하위가 확장점 스키마 문법에서 기타 요소의 선택사항 또는 시퀀스로 작성되도록 지정하려면 다음을 수행하십시오.

  1. 상위 요소로 지정할 요소 노드를 선택하고 마우스 오른쪽 단추로 클릭하십시오.
  2. 요소의 시퀀스를 정의하려면 새로 작성 > 컴포지터 > 시퀀스를 선택하십시오. 요소의 선택사항을 정의하려면 새로 작성 > 컴포지터 > 선택사항을 선택하십시오.
  3. 새 컴포지터 노드를 선택하고 마우스 오른쪽 단추로 클릭하십시오.
  4. 새로 작성 > 참조 서브메뉴에서 상위 요소의 하위로 지정할 요소를 선택하십시오. 참조 서브메뉴는 확장점 스키마 문법에서 글로벌로 선언된 모든 요소로 채워집니다.
  5. (3)단계와 (4)단계를 반복하여 추가 하위 요소를 지정하십시오. 시퀀스 컴포지터가 지정된 경우에는 시퀀스에 추가 요소를 지정하는 것과 마찬가지입니다. 선택사항 컴포지터가 지정된 경우에는 추가 요소 선택사항을 지정하는 것과 마찬가지입니다.

참고: 요소를 다른 요소의 하위로 지정하려면 상위 요소에서 항상 중간 시퀀스 또는 선택사항 컴포지터가 사용되어야 합니다. 컴포지터 노드는 커넥터 노드이지만 요소 참조 노드는 리프 노드입니다. 그러므로 컴포지터 노드는 항상 하나 이상의 하위 요소 참조 노드를 지정해야 합니다.

참고: 시퀀스 및 선택사항 컴포지터는 횟수에 관계없이 중첩되어 더 복잡한 문법을 작성할 수 있습니다.

참고: 문법에는 자기 참조 사이클이 포함될 수 없습니다. 금지된 사이클의 가장 기본적인 형태는 요소 A에 요소 B가 하위로 필요하고 요소 B에 요소 A가 하위로 필요한 경우 발생합니다.

하위가 없고 시작 및 끝 XML 태그에 텍스트를 지정할 수 있는 요소를 지정하려면(문자 컨텐츠) 속성, 컴포지터 및 요소 참조를 추가하지 않고 요소의 구조를 그대로 두십시오(요소 컨텐츠). 참고: 요소는 혼합 컨텐츠(문자 컨텐츠와 요소 컨텐츠 둘 다)를 지정할 수 없습니다.

설명 섹션

이 섹션에서는 편집된 스키마 문법 내의 요소, 속성 또는 컴포지터에 대한 간략한 설명을 제공합니다.

이 섹션은 스키마 정의 양식 페이지를 통해 직접 액세스할 수 있습니다.

설명 섹션

설명 섹션 필드

확장점 요소 섹션에서 선택한 현재 요소, 속성 또는 컴포지터 노드의 간략한 설명을 제공하도록 설명 텍스트 필드를 편집하십시오. 필요에 따라 이 필드 내에서 올바른 HTML 마크업을 사용할 수 있습니다.

참고: 요소 참조 설명을 업데이트하면 참조하는 글로벌 요소 선언의 설명도 업데이트되며, 그 반대도 마찬가지입니다.

요소 세부사항 섹션

이 섹션에서 요소 특성을 편집할 수 있습니다. 요소에는 두 가지 유형(확장 요소, 비확장 요소)이 있습니다. 확장 요소는 편집된 스키마 문법의 시작점을 정의하는 특수한 루트 요소 선언입니다. 비확장 요소는 편집된 스키마 문법 내에서 기본적인 구조적 빌딩 블록으로 사용되는 글로벌 요소 선언입니다.

이 섹션은 확장점 요소 섹션에서 extension 요소 노드 또는 비확장 요소 노드를 선택하여 활성화됩니다.

extension 요소의 요소 세부사항 섹션.

요소 세부사항 섹션 1

비확장 요소의 요소 세부사항 섹션.

요소 세부사항 섹션 2

요소 세부사항 섹션 필드

이름 필드를 편집하여 요소 이름을 지정하십시오.

내부 필드에서 참 단추 또는 거짓 단추를 클릭하여 내부 요소인지 여부를 표시하십시오. 플러그인 Manifest 편집기는 내부 확장 XML 마크업에 경고 플래그를 추가합니다(기본값). 이 필드는 내보낸 패키지의 x-internal 속성과 유사합니다.

사용되지 않음 필드의 참 단추 또는 거짓 단추를 클릭하여 요소가 사용되는지 여부를 표시하십시오. 플러그인 Manifest 편집기는 사용되지 않는 확장 XML 마크업에 경고 플래그를 추가합니다(기본값). 이 필드는 Java의 Javadoc @deprecated 태그와 유사합니다.

확장 요소가 사용되지 않는 것으로 표시된 경우, 바꾸기 필드를 편집하여 해당 위치에서 동일한 기능의 사용되는 확장점을 지정하십시오.

레이블 특성 필드에서 요소의 정의된 속성 중 하나를 선택하여 플러그인 Manifest 편집기에서 요소의 레이블로 사용할 속성 값을 지정하십시오. 예를 들어, 값을 선택하면 플러그인 Manifest 편집기 확장 페이지의 모든 확장 섹션에서 요소의 노드 레이블은 다음과 같이 됩니다. selected-attribute-value (element-name) 한편 값을 선택하지 않으면 요소의 노드 레이블은 다음과 같이 됩니다. (element-name).

아이콘 필드에서 요소의 정의된 자원 유형 속성 중 하나를 선택하여 플러그인 Manifest 편집기에서 요소의 노드를 나타내는 데 사용할 아이콘 자원을 지정하십시오. 요소의 노드 아이콘이 플러그인 Manifest 편집기에 있는 확장 페이지의 모든 확장 섹션에 올바르게 표시되도록 하려면 다음 조건을 충족해야 합니다.

변환 가능 필드에서 참 단추 또는 거짓 단추를 요소의 문자 컨텐츠가 변환 가능한지 여부를 표시하십시오. 이 필드는 지정된 하위(요소 컨텐츠) 또는 속성이 없는 경우에만 적용되며, 시작 및 끝 XML 태그 내에 텍스트를 지정할 수 있습니다(문자 컨텐츠). 요소의 문자 컨텐츠가 변환 가능으로 표시된 경우, PDE 도구를 사용하여 컨트리뷰션된 확장 XML 마크업에서 컨텐츠를 다중 언어 지원을 위한 특성 파일로 구체화할 수 있습니다.

요소 스키마 문법에서 동등한 요소 DTD 문법으로의 대략적인 일대일 맵핑을 보려면 읽기 전용 DTD 근사값 필드를 사용하십시오. DTD(Document Type Definition)는 XML 스키마 대신 사용되어 XML 문서의 공식 문법을 지정하며, 덜 강력하지만 더 읽기 쉽습니다. DTD 근사값을 지정하는 데에는 다음 표기법이 사용됩니다.

컴포지터 세부사항 섹션

이 섹션에서는 컴포지터의 특성을 편집할 수 있습니다. 컴포지터에는 시퀀스 컴포지터와 선택사항 컴포지터의 두 가지 유형이 있습니다. 시퀀스 컴포지터를 사용하면 편집된 스키마의 문법에서 요소의 하위가 다른 요소의 시퀀스로 작성되도록 지정할 수 있습니다. 선택사항 컴포지터를 사용하면 편집된 스키마의 문법에서 요소의 하위가 다른 요소의 선택사항으로 작성되도록 지정할 수 있습니다.

이 섹션은 확장점 요소 섹션에서 시퀀스 또는 선택사항 노드를 선택하여 활성화됩니다.

컴포지터 세부사항 섹션

컴포지터 세부사항 섹션 필드

다른 요소 및/또는 컴포지터로 구성되는 이 컴포지터가 컨트리뷰션된 확장 XML 마크업에 표시될 수 있는 최소 발생 횟수를 지정하려면 최소 발생 횟수 필드를 편집하십시오. 이 필드의 값은 플러그인 Manifest 편집기에서 PDE가 다중성 제한조건을 유효성 검증하는 데 사용됩니다. 요소 A에 단 하나의 요소 B 또는 요소 C가 하위로 필요하며 최소 발생 횟수 2를 지정하는 선택사항 컴포지터를 사용하는 경우, 올바른 상태가 되려면 요소 B의 두 인스턴스를 요소 C와 결합되어 제공된 확장 XML 마크업에 정의해야 합니다.

다른 요소 및/또는 컴포지터로 구성되는 이 컴포지터가 컨트리뷰션된 확장 XML 마크업에 표시될 수 있는 최대 발생 횟수를 지정하려면 최대 발생 횟수 필드를 편집하십시오. 이 필드의 값은 플러그인 Manifest 편집기에서 PDE가 다중성 제한조건을 유효성 검증하는 데 사용됩니다. 요소 A에 단 하나의 요소 B 또는 요소 C가 하위로 필요하며 최대 발생 횟수 2를 지정하는 선택사항 컴포지터를 사용하는 경우, 올바른 상태에서 최대 두 개의 요소 B 인스턴스가 요소 C와 결합되어 제공된 확장 XML 마크업에 정의할 수 있습니다.

제한 없음 필드를 선택하면 컨트리뷰션된 확장 XML 마크업에 표시할 수 있는 이 컴포지터의 최대 발생 횟수에 제한이 없도록 지정됩니다.

유형 필드에서 값을 선택하여 이 컴포지터가 시퀀스인지 선택사항인지 지정하십시오.

컴포지터 스키마 문법에서 동등한 컴포지터 DTD 문법으로의 대략적인 일대일 맵핑을 보려면 읽기 전용 DTD 근사값 필드를 사용하십시오. DTD 근사값을 지정하는 데 사용되는 표기법은 이 문서의 요소 세부사항 섹션 필드에서 설명합니다.

요소 참조 세부사항 섹션

이 섹션에서 요소 참조 특성을 편집할 수 있습니다. 요소 참조는 편집된 스키마의 문법에 있는 글로벌 요소 선언에 대한 참조입니다. 요소 참조는 컴포지터에서 글로벌 요소 선언의 문법을 정의하는 원자 빌딩 블록으로 사용됩니다.

이 섹션은 확장점 요소 섹션의 요소 참조 노드를 선택하여 활성화됩니다.

요소 참조 세부사항 섹션

요소 참조 세부사항 섹션 필드

컨트리뷰션된 확장 XML 마크업에 이 요소가 표시될 수 있는 최소 발생 횟수를 지정하려면 최소 발생 횟수 필드를 편집하십시오. 이 필드의 값은 플러그인 Manifest 편집기에서 PDE가 다중성 제한조건을 유효성 검증하는 데 사용됩니다. 요소 A가 최소 발생 횟수 2를 지정하는 경우, 올바른 상태가 되려면 요소 A의 두 인스턴스가 컨트리뷰션된 확장 XML 마크업에서 정의되어야 합니다.

컨트리뷰션된 확장 XML 마크업에 이 요소가 표시될 수 있는 최대 발생 횟수를 지정하려면 최대 발생 횟수 필드를 편집하십시오. 이 필드의 값은 플러그인 Manifest 편집기에서 PDE가 다중성 제한조건을 유효성 검증하는 데 사용됩니다. 요소 A가 최대 발생 횟수 2를 지정하는 경우, 올바른 상태에서 최대 2개의 요소 A 인스턴스가 컨트리뷰션된 확장 XML 마크업에 정의될 수 있습니다.

제한 없음 필드를 선택하면 컨트리뷰션된 확장 XML 마크업에 표시할 수 있는 이 요소의 최대 발생 횟수에 제한이 없도록 지정됩니다.

요소 스키마 문법에서 동등한 요소 DTD 문법으로의 대략적인 일대일 맵핑을 보려면 읽기 전용 DTD 근사값 필드를 사용하십시오. DTD 근사값을 지정하는 데 사용되는 표기법은 이 문서의 요소 세부사항 섹션 필드에서 설명합니다.

요소 참조 세부사항 섹션 조치

이 로컬 요소 참조가 참조할 글로벌 요소 선언의 특성을 편집하려면 참조 필드에서 요소-이름 하이퍼링크를 클릭하십시오. 이 조치가 완료되면 참조된 요소 노드가 확장점 요소 섹션에서 선택되고 해당 요소 세부사항 섹션이 활성화됩니다.

속성 세부사항 섹션

이 섹션에서 속성 특성을 편집할 수 있습니다. 속성은 요소에 대한 추가 정보를 제공하는 데 사용됩니다.

이 섹션은 확장점 요소 섹션에서 필수 속성, 선택적 속성, 클래스 속성 또는 자원 속성 노드를 선택하여 활성화됩니다.

열거 제한을 지정하는 문자열 유형의 필수 속성에 대한 속성 세부사항 섹션.

속성 세부사항 섹션 1

기본값을 지정하는 부울 유형의 선택적 속성에 대한 속성 세부사항 섹션.

속성 세부사항 섹션 2

속성 값이 나타내는 클래스가 지정된 클래스를 확장하거나 지정된 인터페이스를 구현해야 하는 클래스 속성에 대한 속성 세부사항 섹션.

속성 세부사항 섹션 3

자원 속성에 대한 속성 세부사항 섹션.

속성 세부사항 섹션 4

스키마 ID 속성 사용

확장점 작성자는 기타 속성을 참조하는 속성을 정의할 수 있습니다. 이는 확장점 속성을 유형 ID로 설정하고 참조하는 속성을 선택하여 수행됩니다. 이에 대한 예제는 org.eclipse.ui.handlers 확장점입니다. commandId 속성은 org.eclipse.ui.commands 확장점에 정의된 명령을 참조합니다.

스키마 ID 사용법

핸들러를 컨트리뷰션하는 확장자 개발자는 commandId 속성에 대한 모든 올바른 ID에서 선택할 수 있습니다. ID를 잘못 입력하는 실수를 막기 위해 존재하지 않는 ID에 대한 경고가 발행됩니다.

속성 세부사항 섹션 필드

이름 필드를 편집하여 속성 이름을 지정하십시오.

사용되지 않음 필드의 참 단추 또는 거짓 단추를 클릭하여 속성이 사용되는지 여부를 표시하십시오. 플러그인 Manifest 편집기는 사용되지 않는 확장 XML 마크업에 경고 플래그를 추가합니다(기본값). 이 필드는 Java의 Javadoc @deprecated 태그와 유사합니다.

사용 필드에서 값을 선택하여, 제공된 확장 XML 마크업 내에서 정의하는 요소에 속성을 지정해야 하는지 여부를 표시하십시오. 다음 선택사항을 사용할 수 있습니다.

기본값 필드를 편집하여 제공된 확장 XML 마크업 내에서 정의하는 요소에 속성이 지정되지 않은 경우 사용할 기본값을 지정하십시오. 이 필드는 사용 필드에서 기본값이 선택된 경우에만 적용 가능합니다.

유형 필드에서 값을 선택하여 속성 값 유형을 지정하십시오. 다음 선택사항을 사용할 수 있습니다.

변환 가능 필드에서 참 단추 또는 거짓 단추를 속성 값이 변환 가능한지 여부를 표시하십시오. 이 필드는 유형 필드에서 문자열 값이 선택된 경우에만 적용 가능합니다. 속성의 값이 변환 가능으로 표시된 경우, PDE 도구를 사용하여 컨트리뷰션된 확장 XML 마크업에서 해당 값을 다중 언어 지원을 위한 특성 파일로 구체화할 수 있습니다.

속성에서 소유하는 값으로 사용할 수 없는 문자열 값 목록을 보려면 제한사항 필드를 사용하십시오. 이 필드에 값이 없는 경우, 속성 값에 제한사항이 없습니다. 이 필드는 유형 필드에서 문자열 값이 선택된 경우에만 적용 가능합니다. 참고: 이 기능을 수행하기 위해 편집된 스키마의 문법에서 문자열 기반 유형에 대한 열거 제한사항이 사용됩니다.

확장 필드를 편집하여 속성 값으로 지정한 클래스의 서브클래스가 되어야 하는 대상 플랫폼의 클래스 경로에 완전한 클래스 이름을 지정하십시오(예: org.eclipse.ui.part.EditorPart). PDE는 컨트리뷰션된 확장 XML 마크업에서 클래스 속성 값을 유효성 검증하여 수퍼클래스를 확장하도록 합니다. 이 필드는 유형 필드에서 Java 값이 선택된 경우에만 적용 가능합니다.

구현 필드를 편집하여 속성 값으로 지정된 클래스가 구현해야 하는 대상 플랫폼의 클래스 경로에 완전한 인터페이스 이름을 지정하십시오(예: org.eclipse.ui.IEditorPart). PDE는 컨트리뷰션된 확장 XML 마크업에서 클래스 속성 값을 유효성 검증하여 인터페이스를 구현하도록 합니다. 이 필드는 유형 필드에서 Java 값이 선택된 경우에만 적용 가능합니다.

속성 세부사항 섹션 조치

속성 값에 새 제한사항을 추가하려면 제한사항 필드에서 추가... 단추를 클릭하여 새 제한사항 대화 상자를 여십시오. 대화 상자가 완료되면, 해당 속성이 소유한 값으로 사용할 수 없는 문자열 값 목록에 새 제한사항이 추가됩니다. 이 조치는 유형 필드에서 문자열 값이 선택된 경우에만 사용 가능합니다.

해당 속성이 소유한 값으로 사용할 수 없는 문자열 값 목록에서 제한사항을 제거하려면 제한사항 필드에서 문자열 값을 선택하고 제거 단추를 클릭하십시오. 이 조치는 유형 필드에서 문자열 값이 선택된 경우에만 사용 가능합니다.

확장 필드에 지정된 값이 대상 플랫폼 클래스 경로의 완전한 클래스 이름을 참조하는 경우, 확장 하이퍼링크를 클릭하면 해당 클래스가 새 Java 소스 편집기에 열립니다. 그렇지 않은 경우 확장 하이퍼링크를 클릭하면 새 Java 클래스 마법사가 열려서 새 클래스를 작성할 수 있습니다. 이 조치는 유형 필드에서 Java 값이 선택된 경우에만 사용 가능합니다.

구현 필드에 지정된 값이 대상 플랫폼 클래스 경로의 완전한 인터페이스 이름을 참조하는 경우, 구현 하이퍼링크를 클릭하면 해당 인터페이스가 새 Java 소스 편집기에 열립니다. 그렇지 않은 경우 확장 하이퍼링크를 클릭하면 새 Java 클래스 마법사가 열려서 새 인터페이스를 작성할 수 있습니다. 이 조치는 유형 필드에서 Java 값이 선택된 경우에만 사용 가능합니다.

대상 플랫폼의 클래스 경로에서 확장 필드의 값으로 사용할 기존 클래스를 선택하려면 찾아보기... 단추를 클릭하여 유형 선택 대화 상자를 여십시오. 이 조치는 유형 필드에서 Java 값이 선택된 경우에만 사용 가능합니다.

대상 플랫폼의 클래스 경로에서 구현 필드의 값으로 사용할 기존 인터페이스를 선택하려면 찾아보기... 단추를 클릭하여 유형 선택 대화 상자를 여십시오. 이 조치는 유형 필드에서 Java 값이 선택된 경우에만 사용 가능합니다.

관련 링크