Service Registry 3.1 관리 설명서

웹 콘솔 구성

관리자는 구성 파일을 편집하여 웹 콘솔 표시의 일부 측면을 사용자 정의할 수 있습니다.

이 절에서는 다음 작업에 대해 설명합니다.

웹 콘솔 사용에 대한 자세한 내용은 Service Registry 3.1 사용자 설명서를 참조하십시오.

미리 정의된 쿼리 추가

Service Registry에는 미리 정의된 쿼리 선택 드롭다운 목록의 웹 콘솔 검색 양식에 표시되는 미리 정의된 여러 쿼리가 포함되어 있습니다. 관리자는 해당 레지스트리 설치에 특정한 새 쿼리를 드롭다운 목록에 추가할 수 있습니다.

미리 정의된 쿼리를 추가하는 방법

웹 콘솔을 사용하여 레지스트리에 쿼리 객체 AdhocQuery를 게시합니다.

쿼리에 대해 지정하는 이름 및 설명이 미리 정의된 쿼리의 드롭다운 목록에 나타납니다. 쿼리에 대한 SQL 문에서 다음과 같이 사용자가 제공한 데이터를 작은따옴표 쌍으로 묶어 자리 표시자를 지정합니다.
```
select * from registryobject where id = ''$lid''
```

쿼리 객체 AdhocQuery 및 SQL 문 자리 표시자의 고유 식별자를 입력하거나 파일에 복사 및 붙여넣기합니다.

RegistryDomain-base/3.0/jaxr-ebxml 디렉토리로 변경합니다.

텍스트 편집기에서 registry-browser-config.xml 파일을 엽니다.

필요한 경우 변경 사항을 다시 되돌릴 수 있도록 원래 파일의 복사본을 만듭니다.

다음 형식을 사용하여 registry-browser-config.xml 파일에 항목을 추가합니다. SQL 문의 각 자리 표시자에 대한 Parameter 요소를 지정합니다.
```
<Query>
  <AdhocQueryRef id="unique-identifier"/>
  <Parameter parameterName="$placeholder-name" datatype="string">
    <rim:Name>
      <rim:LocalizedString xml:lang="en" charset="UTF-8" 
        value="parameter-name-in-en-locale"/>
      <rim:LocalizedString xml:lang="fr" charset="UTF-8" 
        value="parameter-name-in-fr-locale"/>
    </rim:Name>
    <rim:Description>
      <rim:LocalizedString xml:lang="en" charset="UTF-8" 
        value="parameter-description-in-en-locale"/>
      <rim:LocalizedString xml:lang="fr" charset="UTF-8" 
        value="parameter-description-in-fr-locale"/>
    </rim:Description>
  </Parameter>
  ...
</Query>
```
unique-identifier는 쿼리 객체 AdhocQuery의 고유 식별자입니다.

각 매개 변수의 parameterName 속성 값은 쿼리에 대한 SQL 문의 자리 표시자에서 가져와야 합니다.

datatype 속성은 다음 값 중 하나를 가질 수 있습니다.
- string: 매개 변수가 검색 양식의 텍스트 필드로 나타납니다.
- taxonomyElement: 매개 변수가 검색 양식의 드롭다운 목록으로 나타납니다. taxonomyElement 데이터 유형을 지정하는 경우 이름 및 설명 요소 뒤에 다음과 같은 SlotList 요소가 있어야 합니다.
```
<rim:SlotList>
  <rim:Slot name="domain">
    <rim:ValueList>
      <rim:Value>
      classification-scheme-or-concept-id
      </rim:Value>
    </rim:ValueList>
  </rim:Slot>
</rim:SlotList>
```
  classification-scheme-or-concept-id는 해당 개념(또는 하위 개념)이 드롭다운 목록에 나타나야 하는 분류 체계 또는 개념의 고유 식별자입니다. 분류 체계를 게시해야 합니다(레지스트리에 해당 체계가 없는 경우 해당).
  
  슬롯 이름은 "domain"이어야 합니다.
- boolean: 매개 변수가 검색 양식에서 확인란으로 표시됩니다.
datatype이 string 또는 boolean이면 Parameter 요소에 defaultValue 속성을 추가하여 검색 양식에 표시할 기본값을 지정할 수도 있습니다.

지원하는 로켈의 각 매개 변수 이름 및 설명에 대해 현지화된 문자열 값을 지정합니다. 현재 로켈의 parameter-name은 검색 양식에 매개 변수 레이블로 표시됩니다.

registry-browser-config.xml 파일의 기존 항목은 참조용으로 사용합니다.

registry-browser-config.xml 파일을 저장한 다음 닫습니다.

레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

기본 쿼리 변경

미리 정의된 쿼리 선택 드롭다운 목록에 기본값으로 표시되는 쿼리는 사용자가 이름, 설명 및 분류 기준으로 레지스트리 객체를 검색할 수 있는 기본 쿼리입니다.

관리자는 이 기본값을 설치에 적절한 쿼리로 변경할 수 있습니다. 예를 들어, 미리 정의된 쿼리 추가에 설명된 대로 기본 쿼리를 레지스트리에 추가한 미리 정의된 새 쿼리로 지정할 수 있습니다. 이를 변경하려면 구성 파일의 등록 정보를 편집합니다.

기본 쿼리를 변경하는 방법

RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

텍스트 편집기에서 jaxr-ebxml.properties 파일을 엽니다.

jaxr-ebxml.thin.defaultQueryPanel 등록 정보의 정의를 찾습니다. 기본적으로 이 등록 정보는 다음과 같이 주석 처리됩니다.
```
#jaxr-ebxml.thin.defaultQueryPanel=
```

주석 문자(#)를 제거합니다.

다음 예와 같이 기본값이 될 쿼리의 논리 식별자를 지정하여 등록 정보 값을 설정합니다.
```
jaxr-ebxml.thin.defaultQueryPanel=urn:oasis:names:tc:ebxml-regrep:query:MyQuery
```

jaxr-ebxml.properties 파일을 저장한 다음 닫습니다.

레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

분류 체계 숨기기

분류 체계의 트리 구조는 다음 웹 콘솔 영역에 표시됩니다.

검색 메뉴 영역의 분류 노드 선택을 누를 때 또는 일부 유형의 레지스트리 객체에 대한 개념을 선택해야 할 때 나타나는 분류 체계/개념 선택기 창
탐색 영역 메뉴

Service Registry 사용자가 분류 체계를 사용하지 못하게 하려면 관리자는 보기에서 해당 분류 체계를 숨길 수 있습니다. 분류 체계를 숨기려면 구성 파일에서 등록 정보를 정의합니다.

분류 체계 숨기기 방법

RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

텍스트 편집기에서 jaxr-ebxml.properties 파일을 엽니다.

다음 구문을 사용하여 jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList 등록 정보를 설정합니다. 모든 등록 정보 정의는 한 줄로 입력해야 하며 공백을 포함할 수 없습니다.
```
jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList=
class-scheme-id1|class-scheme-id2|...
```
숨길 각 분류 체계의 논리 식별자를 지정합니다. 식별자를 2개 이상 지정하려면 다음 예와 같이 세로 막대(|)를 사용하여 식별자를 구분합니다.
```
jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList=
urn:oasis:names:tc:ebxml-regrep:classificationScheme:StatusType|
urn:oasis:names:tc:ebxml-regrep:profile:ws:classificationScheme:BindingType
```

jaxr-ebxml.properties 파일을 저장한 다음 닫습니다.

레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

검색 결과 표시 구성

웹 콘솔은 기본적으로 각 쿼리에 대해 한 번에 25개의 검색 결과를 표시합니다. 25개가 넘는 검색 결과가 반환되면 사용자는 추가 결과 페이지를 표시할 수 있습니다. 관리자는 각 페이지에 표시되는 검색 결과 수를 수정할 수 있습니다.

웹 콘솔은 기본적으로 검색 결과 영역에 특정 열을 표시합니다. 각 객체에 대해 객체 유형, 이름, 설명, 버전 및 버전 주석을 표시합니다. 일부 객체 유형의 경우에는 기본 표시와는 다른 표시로 구성됩니다. 예를 들어, 서비스 바인딩(ServiceBinding) 객체의 경우 버전 정보 대신에 종점이 포함되어 표시됩니다. 관리자는 구성 정보를 추가하여 선택 객체 유형에 대한 기본값이 아닌 데이터를 표시할 수 있습니다.

이러한 작업을 각각 수행하려면 구성 파일을 편집합니다.

검색 결과 표시에 행 수 구성

RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

텍스트 편집기에서 jaxr-ebxml.properties 파일을 엽니다.

omar.client.thinbrowser.numSearchResults 등록 정보의 정의를 찾습니다.
```
omar.client.thinbrowser.numSearchResults=25
```

25를 원하는 값으로 변경합니다.

jaxr-ebxml.properties 파일을 저장한 다음 닫습니다.

레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

검색 결과 영역의 열 구성

객체 유형별로 검색 결과 영역의 열을 구성할 수 있습니다. 열에는 객체의 속성이 표시됩니다.

RegistryDomain-base/3.0/jaxr-ebxml 디렉토리로 변경합니다.

텍스트 편집기에서 registry-browser-config.xml 파일을 엽니다.

registry-browser-config.xml 파일에 항목을 추가하거나 기존 항목을 편집합니다. 다음 형식을 사용합니다.

다음 예에서는 서비스(Service) 객체에 대해 기본값이 아닌 표시를 구성합니다.
```
<ObjectTypeConfig 
    className="org.freebxml.omar.client.xml.registry.infomodel.ServiceImpl" 
    id="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Service">
  <SearchResultsConfig>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Object Type" columnWidth="25" editable="false" 
      method="getObjectType"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Name" columnWidth="25" editable="true" method="getName"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Description" columnWidth="30" editable="true" 
      method="getDescription"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Status" columnWidth="15" method="getStatusAsString"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Version" columnWidth="5" method="getVersionName"/>
  </SearchResultsConfig>
</ObjectTypeConfig>
```
registry-browser-config.xml 파일은 ObjectTypeConfig 요소에 대한 구문을 제공합니다. 파일에 있는 기존 요소를 예로 사용합니다. 이러한 요소는 외부 링크(ExternalLink), 외부 객체(ExtrinsicObject) 및 서비스 바인딩(ServiceBinding) 객체에 대해 기본값이 아닌 표시를 구성할 뿐 아니라, 레지스트리 객체에 대해 기본 표시를 구성합니다.

구성할 수 있는 열은 최대 30개입니다.

SearchResultsColumn 요소의 경우 다음과 같은 특징이 있습니다.
- columnClass 속성 값은 항상 java.lang.Object입니다.
- columnHeader 속성 값은 웹 콘솔 자원 번들 파일의 메시지에 대한 키입니다. 이 파일은 registryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes/org/freebxml/omar/client/ui/thin/ 디렉토리에 포함되어 있습니다. 예를 들어, columnHeader 값에 Object Type을 입력하면 웹 콘솔의 백킹 Bean은 WebResourceBundle 클래스를 사용하여 해당 키가 있는 메시지를 조회합니다. WebResourceBundle이 메시지 찾기에 실패하면 해당 키를 소문자로 변환하여 검색을 다시 시도합니다. 이 작업도 실패하게 되면 메시지 값을 "???"+key+"???"로 설정하고 누락된 자원 번들 항목에 대한 경고 메시지를 기록합니다. 따라서, 현지화된 새 columnHeader 값을 추가하려면 이 디렉토리에 포함된 ResourceBundle 파일에 새 메시지 키를 입력해야 합니다.
- columnWidth 속성은 웹 콘솔에서 사용되지 않습니다.
- editable 속성은 웹 콘솔에서 사용되지 않습니다.
- 대부분의 경우 ebXML Registry Information Model Version 3.0 사양의 클래스 속성에서 method 속성에 대한 메소드 이름을 추정할 수 있습니다(자세한 내용은 이 설명서를 읽기 전에 참조). getStatusAsString 메소드는 RegistryObjectImpl 구현 클래스에서 찾을 수 있습니다. (그러나 이번 Service Registry 릴리스에는 API 설명서가 포함되어 있지 않습니다.)
각 omar.client.xml.registry.infomodel 클래스 이름당 ObjectTypeConfig 요소를 하나만 가질 수 있습니다.

registry-browser-config.xml 파일을 저장한 다음 닫습니다.

레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

재구성을 확인하려면 웹 콘솔의 검색 또는 탐색 메뉴를 사용하여 해당 열이 변경된 객체를 표시합니다.