| Oracle® Fusion Middleware Oracle WebCenter Portal開発者ガイド 11g リリース1 (11.1.1.6.0) B72084-01 |
|
 前 |
 次 |
| Oracle® Fusion Middleware Oracle WebCenter Portal開発者ガイド 11g リリース1 (11.1.1.6.0) B72084-01 |
|
前 |
次 |
この付録では、デフォルトのカタログ定義ファイルの構成、場所および属性に関する参照情報について説明します。この情報は、第III部「アプリケーションのカスタマイズとカスタマイズ・オプションの拡張」で説明されているタスクの実行時に役立ちます。
リソース・カタログの詳細は、第16章「リソース・カタログの作成と管理」を参照してください。
この付録の内容は、次のとおりです。
adf-config.xmlファイルのrcv-configセクションは、デフォルトのカタログの名前を定義します。rcv-config要素は、アプリケーションのデフォルトではadf-config.xmlファイル内で使用できません。デフォルト・カタログの名前を変更する場合や、複数のカタログを実装する場合には、これを追加する必要があります。
<rcv:rcv-config>
<rcv:catalog-selector class-name=""/>
<rcv:default-catalog catalog-name="/oracle/webcenter/portalapp/catalogs/default-catalog.xml"/></rcv:rcv-config>
リソース・カタログ・サービスにより、resource-catalog-rootにあるMDSにカタログ定義ファイルが格納されます。resource-catalog-rootはMDSネームスペースとして定義されるため、正確な場所はMDS構成により異なります。デフォルトのresource-catalog-rootは、adf-config.xmlのadf-rcs-config要素のdefault-scope属性により定義されます。この属性は"/"に設定されます。これは、カタログIDが完全修飾MDSパスで表現されることを意味します。
<rcs:adf-rcs-config>
<rcs:rcs-config>
<rcs:catalog-config default-scope="/"
default-registry="/oracle/webcenter/portalapp/catalogs/catalog-registry.xml"/>
. . .
<rcs:security-manager class-name="oracle.webcenter.portalframework.genericsiteresources.internal.security.CatalogSecurityManager"/>
</rcs:rcs-config>
security-manager要素は、セキュリティ・マネージャの実装を定義します。
例C-1に、参照用のカタログ定義のXMLスキーマを示します。
例C-1 カタログ定義のXMLスキーマ
<xsd:schema elementFormDefault="qualified"
targetNamespace="http://xmlns.oracle.com/adf/rcs/catalog"
xmlns:rcs="http://xmlns.oracle.com/adf/rcs/catalog"
xmlns:md="http://xmlns.oracle.com/bali/xml/metadata"
xmlns:mds="http://xmlns.oracle.com/mds"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" jaxb:version="1.0">
<xsd:annotation>
<xsd:appinfo>
<jaxb:schemaBindings>
<jaxb:package name="oracle.adfinternal.rc.catalog.xml"/>
</jaxb:schemaBindings>
</xsd:appinfo>
</xsd:annotation>
<!-- declare all elements as top-level elements so they appear in the
component palette pages generated by XMLEF -->
<!-- IMPORTANT: catalogDefinition & navigationModel CANNOT share a common type -->
<!-- MDS cannot handle it. -->
<xsd:element name="catalogDefinition" type="rcs:catalogDefinitionType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<!-- enable customization for navigation models -->
<xsd:element name="navigationDefinition" type="rcs:navigationDefinitionType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<!-- disable customization of the schema definition for both catalog & navigation models -->
<xsd:element name="schema" type="rcs:schemaType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="descriptor" type="rcs:descriptorType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="attributes" type="rcs:attributesType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="attribute" type="rcs:attributeType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
<!-- ### this marks "attributeId" attribute as "locally unique" within the <attributes> tag -->
<mds:localUniqueAttribute>attributeId</mds:localUniqueAttribute>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="parameters" type="rcs:parametersType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="parameter" type="rcs:parameterType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
<!-- ### this marks "id" attribute as "locally unique" within the <parameters> tag -->
<mds:localUniqueAttribute>id</mds:localUniqueAttribute>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="contents" type="rcs:contentsType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="folder" type="rcs:folderType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="resource" type="rcs:resourceType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="includeCatalog" type="rcs:includeCatalogType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="includeNavigation" type="rcs:includeNavigationType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="repository" type="rcs:repositoryType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="dynamicFolder" type="rcs:dynamicFolderType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="source" type="rcs:dynamicFolderSourceType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="customFolder" type="rcs:customFolderType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="component" type="rcs:componentType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="url" type="rcs:urlType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="customContent" type="rcs:customContentType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="separator" type="rcs:separatorType">
<xsd:annotation>
<xsd:appinfo>
<md:elementMetadata>
<mds:customizationAllowed>true</mds:customizationAllowed>
</md:elementMetadata>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:complexType name="descriptorType">
<xsd:attribute name="attributeId" type="xsd:string" use="required"/>
<xsd:attribute name="labelKey" type="xsd:string"/>
<xsd:attribute name="shortLabelKey" type="xsd:string"/>
<xsd:attribute name="helpTextKey" type="xsd:string"/>
<xsd:attribute name="hintTextKey" type="xsd:string"/>
<xsd:attribute name="searchable" type="xsd:boolean" default="true"/>
<xsd:attribute name="multivalue" type="xsd:boolean" default="false"/>
<xsd:attribute name="endUserVisible" type="xsd:boolean" default="true"/>
<xsd:attribute name="resourceBundle" type="xsd:string"/>
</xsd:complexType>
<xsd:complexType name="schemaType">
<xsd:sequence>
<xsd:element ref="rcs:descriptor" minOccurs="1" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="resourceBundle" type="xsd:string"/>
</xsd:complexType>
<xsd:complexType name="attributeType">
<xsd:attribute name="attributeId" type="xsd:string" use="required"/>
<xsd:attribute name="value" type="xsd:string" use="required"/>
<xsd:attribute name="isKey" type="xsd:boolean" default="false"/>
<xsd:attribute name="resourceBundle" type="xsd:string"/>
</xsd:complexType>
<xsd:complexType name="attributesType">
<xsd:sequence>
<xsd:element ref="rcs:attribute" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="resourceBundle" type="xsd:string"/>
</xsd:complexType>
<xsd:complexType name="parameterType">
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="id" type="xsd:string" use="required"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="parametersType">
<xsd:sequence>
<xsd:element ref="rcs:parameter" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="itemType">
<xsd:all>
<xsd:element ref="rcs:attributes" minOccurs="0" maxOccurs="1"/>
<xsd:element ref="rcs:parameters" minOccurs="0" maxOccurs="1"/>
</xsd:all>
<xsd:attribute name="id" type="xsd:ID" use="required"/>
<xsd:attribute name="name" type="xsd:string"/>
<xsd:attribute name="description" type="xsd:string"/>
<xsd:attribute name="visible" type="xsd:string" default="true"/>
</xsd:complexType>
<xsd:complexType name="includeCatalogType">
<xsd:complexContent>
<xsd:extension base="rcs:itemType">
<xsd:attribute name="scope" type="xsd:string" use="required"/>
<xsd:attribute name="catalogId" type="xsd:string" use="required"/>
<xsd:attribute name="insertFolderContents" type="xsd:boolean" default="false"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:complexType name="includeNavigationType">
<xsd:complexContent>
<xsd:extension base="rcs:itemType">
<xsd:attribute name="scope" type="xsd:string" use="required"/>
<xsd:attribute name="navigationId" type="xsd:string" use="required"/>
<xsd:attribute name="insertFolderContents" type="xsd:boolean" default="false"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:complexType name="repositoryType">
<xsd:complexContent>
<xsd:extension base="rcs:itemType">
<xsd:attribute name="repository" type="xsd:string" use="required"/>
<xsd:attribute name="path" type="xsd:string"/>
<xsd:attribute name="includeSubfolders" type="xsd:boolean" default="true"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:complexType name="dynamicFolderSourceType">
<xsd:attribute name="repository" type="xsd:string"/>
<xsd:attribute name="path" type="xsd:string"/>
<xsd:attribute name="includeSubfolders" type="xsd:boolean" default="true"/>
</xsd:complexType>
<xsd:complexType name="dynamicFolderType">
<xsd:complexContent>
<xsd:extension base="rcs:itemType">
<xsd:sequence>
<xsd:element ref="rcs:source" minOccurs="1" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="expression" type="xsd:string"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:complexType name="customContentType">
<xsd:complexContent>
<xsd:extension base="rcs:itemType">
<xsd:attribute name="contentProviderClass" type="xsd:string" use="required"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:complexType name="customFolderType">
<xsd:complexContent>
<xsd:extension base="rcs:itemType">
<xsd:attribute name="factoryClass" type="xsd:string" use="required"/>
<xsd:attribute name="path" type="xsd:string"/>
<xsd:attribute name="insertFolderContents" type="xsd:boolean" default="false"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<!-- this is a bit of a kludge. To keep MDS happy we must define a type -->
<!-- for separators even though they don't have any special attributes -->
<xsd:complexType name="separatorType">
<xsd:complexContent>
<xsd:extension base="rcs:itemType"/>
</xsd:complexContent>
</xsd:complexType>
<!-- implementation of filters has been deferred
<xsd:complexType name="filterType">
<xsd:complexContent>
<xsd:extension base="rcs:itemType">
<xsd:attribute name="expression" type="xsd:string"/>
<xsd:attribute name="filterClass" type="xsd:string"/>
<xsd:attribute name="scope" type="xsd:string" default="subtree"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
-->
<xsd:group name="folderContentGroup">
<xsd:choice>
<xsd:element name="folder" type="rcs:folderType"/>
<xsd:element name="repository" type="rcs:repositoryType"/>
<xsd:element name="resource" type="rcs:resourceType" />
<xsd:element name="dynamicFolder" type="rcs:dynamicFolderType" />
<xsd:element name="customFolder" type="rcs:customFolderType"/>
<xsd:element name="customContent" type="rcs:customContentType"/>
<xsd:element name="component" type="rcs:componentType"/>
<xsd:element name="url" type="rcs:urlType"/>
<xsd:element name="includeCatalog" type="rcs:includeCatalogType"/>
<xsd:element name="includeNavigation" type="rcs:includeNavigationType"/>
<xsd:element name="separator" type="rcs:separatorType"/>
</xsd:choice>
</xsd:group>
<xsd:complexType name="contentsType">
<xsd:group ref = "rcs:folderContentGroup" minOccurs="0" maxOccurs="unbounded" />
</xsd:complexType>
<!-- contents is optional to allow resourceType to extend folderType -->
<!-- most resources won't have children so the contents element should be optional -->
<xsd:complexType name="folderType">
<xsd:complexContent>
<xsd:extension base="rcs:itemType">
<xsd:all>
<!-- <xsd:element name="filter" type="rcs:filterType" minOccurs="0" maxOccurs="unbounded"/> -->
<xsd:element ref="rcs:contents" minOccurs="0" maxOccurs="1"/>
</xsd:all>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<!-- resourceType extends folderType to allow resource elements to have children -->
<xsd:complexType name="resourceType">
<xsd:complexContent>
<xsd:extension base="rcs:folderType">
<xsd:attribute name="repository" type="xsd:string" use="required"/>
<xsd:attribute name="path" type="xsd:string" use="required"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<!-- resourceType extends folderType to allow component elements to have children -->
<xsd:complexType name="componentType">
<xsd:complexContent>
<xsd:extension base="rcs:folderType">
<xsd:attribute name="factoryClass" type="xsd:string" use="required"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<!-- resourceType extends folderType to allow URL elements to have children -->
<xsd:complexType name="urlType">
<xsd:complexContent>
<xsd:extension base="rcs:folderType">
<xsd:attribute name="url" type="xsd:string" use="required"/>
<xsd:attribute name="factoryClass" type="xsd:string" use="required"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:complexType name="catalogDefinitionType">
<xsd:complexContent>
<xsd:extension base="rcs:folderType">
<xsd:all>
<xsd:element ref="rcs:schema" minOccurs="0" maxOccurs="1"/>
</xsd:all>
<xsd:attribute name="contact" type="xsd:string"/>
<xsd:attribute name="definitionFilter" type="xsd:string"/>
<xsd:attribute name="resourceBundle" type="xsd:string"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:complexType name="navigationDefinitionType">
<xsd:complexContent>
<xsd:extension base="rcs:folderType">
<xsd:all>
<xsd:element ref="rcs:schema" minOccurs="0" maxOccurs="1"/>
</xsd:all>
<xsd:attribute name="contact" type="xsd:string"/>
<xsd:attribute name="definitionFilter" type="xsd:string"/>
<xsd:attribute name="resourceBundle" type="xsd:string"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
</xsd:schema>
カタログ定義スキーマにより、リソース・カタログの構造およびコンテンツを指定できる豊富な要素のセットが提供されます。
この項の内容は、次のとおりです。
カスタム・カタログ定義ファイルを作成する方法の例は、第16.2項「カスタム・リソース・カタログの作成」を参照してください。
catalogDefinition要素では、変換済の文字列の場所など、カタログの全体的な特性を定義します。
例C-2に、catalogDefinitionの使用方法を示します。
例C-2 catalogDefinitionの例
<catalogDefinition id="DefaultCatalog" visible="#{true}"
resourceBundle="portal.catalog.DefaultCatalogBundle"
definitionFilter="portal.catalog.DefaultCatalogFilter"
xmlns="http://xmlns.oracle.com/adf/rcs/catalog">
表C-1に、catalogDefinition要素のキーワードを示します。要素にattributesを指定する方法の詳細は、第C.3.8項「attributes」を参照してください。
表C-1 catalogDefinitionのキーワード
| キーワード | 説明 |
|---|---|
xmlns |
http://xmlns.oracle.com/adf/rcs/catalog |
id |
このカタログ定義を参照する際に使用される識別子。 |
|
visible |
リソース・カタログを実行時に選択できるようにする必要があるかどうかを指定します。この属性は、EL値を取得し、このカタログを特定のユーザーやグループに条件付で表示するために使用できます。デフォルトでの値は#{true}で、カタログは常時表示されます。 |
resourceBundle |
|
definitionFilter |
|
カタログには、タイトル、件名および説明などのattributesを含めることができます。attributesを組み込む方法の詳細は、第C.3.8項「attributes」を参照してください。
folder要素では、カタログのコンテンツの編成に使用されるカタログ・フォルダを定義します。フォルダには、その他のフォルダを含め、任意の数のエントリを含めることができます。同じフォルダに異なるタイプのカタログ要素を混在させることができます。
フォルダには、他のエントリと同様にattributesがあります。要素にattributesを指定する方法の詳細は、第C.3.8項「attributes」を参照してください。
例C-3に、folder要素の使用方法を示します。
例C-3 folderの例
<folder visible="#{true}" id="webDevFolder">
<attributes>
<attribute value="WEB_DEV_FOLDER.TITLE" attributeId="Title"
isKey="true"/>
<attribute value="WEB_DEV_FOLDER.DESCRIPTION" attributeId="Description"
isKey="true"/>
<attribute value="WEB_DEV_FOLDER.KEYWORDS" attributeId="Subject"
isKey="true"/>
<attribute value="/adf/webcenter/folderlayout_qualifier.png"
isKey="false" attributeId="IconURI"/>
</attributes>
<contents/>
<folder>
表C-2に、folder要素のキーワードを示します。
表C-2 folderのキーワード
| キーワード | 説明 |
|---|---|
id |
このフォルダを参照する際に使用される一意の識別子。 |
visible |
リソースがカタログでレンダリングされる必要があるかどうか。この属性はEL値を取ります。この属性を使用して、特定のユーザーまたはグループに、条件に基づいてリソースを表示できます。デフォルト値は#{true}で、これはリソースが常にすべてのカタログで表示されることを意味します。 |
カタログ定義のソースにコードを追加するよりも、カタログ定義ファイルの「設計」ビューにフォルダを追加する方が簡単な場合があります。詳細は、第16.2.3.1項「フォルダの追加」を参照してください。
url要素は、カタログの次のタイプのリンクを定義するために使用します。
タスク・フロー: WebCenter Portalサービスのタスク・フロー、またはOracle JDeveloperで作成したカスタム・タスク・フローへのリンク。
ポートレット: 登録済のポートレット・プロデューサへのリンク。
コンテンツ: 既存のコンテンツ・リポジトリ接続からファイルまたはディレクトリへのリンク。
その他: カスタム・コンポーネント(そのコンポーネントのXMLコードを提供することで作成します)へのリンク。
例C-4に、url要素の使用方法を示します。
例C-4 urlリソースの例
<url visible="#{true}"
factoryClass="oracle.webcenter.portalframework.sitestructure.rc.TaskFlowResourceFactory"
id="tagCloud"
url="taskflow://oracle/webcenter/tagging/controller/taskflows/tag-selection.xml#tag-selection">
<attributes>
<attribute value="TAG_CLOUD.TITLE" attributeId="Title" isKey="true"/>
<attribute value="TAG_CLOUD.DESCRIPTION" attributeId="Description"
isKey="true"/>
<attribute value="TAG_CLOUD.KEYWORDS" attributeId="Subject"
isKey="true"/>
<attribute value="oracle.webcenter.tagging"
attributeId="WEBCENTER_SERVICE_ID" isKey="false"/>
<attribute value="/adf/webcenter/label_qualifier.png"
attributeId="IconURI"/>
<attribute value="height:211px" attributeId="attr.contentStyle"
isKey="false"/>
</attributes>
<contents/>
</url>
表C-3に、url要素のキーワードを示します。
表C-3 urlのキーワード
| キーワード | 説明 |
|---|---|
id |
このフォルダを参照する際に使用される一意の識別子。 |
|
visible |
リソースがカタログでレンダリングされる必要があるかどうか。この属性はEL値を取ります。この属性を使用して、特定のユーザーまたはグループに、条件に基づいてリソースを表示できます。デフォルト値は#{true}で、これはリソースが常にすべてのカタログで表示されることを意味します。 |
factoryClass |
カスタム・コンポーネントを追加する場合には、コンポーネントのファクトリ・クラスを指定します。その他のすべてのリソース・タイプには、設計モードのタイプを選択した時点で 使用可能なリソース・タイプのファクトリ・クラスは、次のとおりです。
|
URL |
ソースにアクセスするためのURL。リンク・タイプごとに、異なるURL形式がサポートされています。詳細は、表16-1「異なるリソース・タイプに対応するURLの形式」を参照してください。 |
リソース・リンクでは、タイトル、サブジェクト、説明およびパラメータなどの属性を使用できます。詳細は、第C.3.8項「attributes」および第C.3.10項「parameters」を参照してください。
カタログ定義のソースにコードを追加するよりも、カタログ定義ファイルの「設計」ビューにリンクを追加する方が簡単な場合があります。詳細は、第16.2.3.2項「リンクの追加」を参照してください。
includeCatalog要素は、他のカタログ定義ファイルへの参照を組み込むために使用します。
例C-5に、includeCatalog要素の使用方法を示します。
例C-5 ネストされたリソース・カタログの例
<includeCatalog visible="#{true}" scope="/" id="users-catalog"
catalogId="/oracle/webcenter/portalapp/catalogs/users-catalog.xml">
<attributes>
<attribute value="catalog" isKey="false" attributeId="Title"/>
</attributes>
</includeCatalog>
includeCatalog要素は、catalogDefinition要素と同じキーワードをサポートします。includeCatalog要素のキーワードは表C-1を参照してください。
カタログには、タイトル、件名および説明などのattributesを含めることができます。要素にattributesを指定する方法の詳細は、第C.3.8項「attributes」を参照してください。
カタログ定義のソースにコードを追加するよりも、カタログ定義ファイルの「設計」ビューにカタログを追加する方が簡単な場合があります。詳細は、第16.2.3.3項「リソース・カタログの追加」を参照してください。
component要素は、単純なADF Facesコンポーネントや通常のHTMLなどのカスタムXMLリソースをカタログに組み込むために使用します。component要素は、contentsセクション内に配置する必要があります。カタログ定義ファイルには複数のcomponentを追加できます。
component要素には、parameters要素とネストされたparameter要素が含まれている必要があります。parameter要素のidをxmlに設定します。このparameter要素内にXMLフラグメントを含めます。実行時にコンポーネントのADF Faces IDを生成するには、コンポーネントのIDを# (ハッシュ・シンボル)に設定します。
例C-6は、Boxコンポーネントをリソース・カタログに追加するコードを示しています。
例C-6 カタログ定義ファイルのPanel Customizableコンポーネント
<component id="pc" visible="#{true}"
factoryClass="oracle.adf.rc.component.XmlComponentFactory">
<attributes>
<attribute attributeId="Title" value="BOX" isKey="true"/>
<attribute attributeId="Description" value="BOX.DESCRIPTION"
isKey="true"/>
<attribute attributeId="Subject" value="BOX.KEYWORDS" isKey="true"/>
<attribute attributeId="IconURI"
value="/adf/webcenter/panelcustomizable_qualifier.png"/>
</attributes>
<parameters> <parameter id="xml"><cust:panelCustomizable id="#" xmlns:cust="http://xmlns.oracle.com/adf/faces/customizable"/>
</parameter></parameters>
</parameters>
</component>
表C-4に、component要素のキーワードを示します。要素にattributesを指定する方法の詳細は、第C.3.8項「attributes」を参照してください。
表C-4 componentのキーワード
| キーワード | 説明 |
|---|---|
|
|
カタログ定義内のコンポーネントの一意の識別子。 |
|
visible |
リソースがカタログでレンダリングされる必要があるかどうか。この属性はEL値を取ります。この属性を使用して、特定のユーザーまたはグループに、条件に基づいてリソースを表示できます。デフォルトでの値は |
|
|
|
カスタム・コンポーネントでは、タイトル、サブジェクト、説明およびパラメータなどの属性を使用できます。詳細は、第C.3.8項「attributes」および第C.3.10項「parameters」を参照してください。
カタログ定義ファイルの「設計」ビューにカスタム・コンポーネントを追加することが簡単な場合があります。詳細は、第16.2.3.4項「コンポーネントの追加」を参照してください。
customFolder要素は、リソース・カタログ・アダプタを使用して生成されたコンテンツを定義します。この要素は、実行時に動的にコンテンツを移入するフォルダをレンダリングします。カタログには、フォルダ内リソースがない場合でもそのフォルダが表示されます。
例C-7に、分析サービスからタスク・フローをレンダリングするcustomFolder要素の使用方法を示します。
例C-7 customFolderリソースの例
<customFolder factoryClass="oracle.webcenter.analytics.view.rc.ASServiceContextFactory" id="analyticsServiceFolder" visible="#{true}">
<attributes resourceBundle="oracle.webcenter.spaces.resource.DefaultGroupSpaceCatalogBundle">
<attribute attributeId="Description" isKey="true" resourceBundle="oracle.webcenter.spaces.resource.DefaultGroupSpaceCatalogBundle" value="ANALYTICS_FOLDER.DESCRIPTION"/>
<attribute attributeId="IconURI" isKey="false" value="/adf/webcenter/folderanalytics_qualifier.png"/>
<attribute attributeId="Subject" isKey="true" resourceBundle="oracle.webcenter.spaces.resource.DefaultGroupSpaceCatalogBundle" value="ANALYTICS_FOLDER.KEYWORDS"/>
<attribute attributeId="WEBCENTER_SERVICE_ID" isKey="false" value="oracle.webcenter.analytics"/>
<attribute attributeId="attr.text" isKey="false" value="#{uib_o_w_s_r_DefaultGroupSpaceCatalog['ANALYTICS_FOLDER.TITLE']}"/>
<attribute attributeId="Title" isKey="true" resourceBundle="oracle.webcenter.spaces.resource.DefaultGroupSpaceCatalogBundle" value="ANALYTICS_FOLDER.TITLE"/>
</attributes>
<parameters/>
</customFolder>
表C-5に、customFolder要素のキーワードを示します。
表C-5 customFolderのキーワード
| キーワード | 説明 |
|---|---|
id |
このフォルダを参照する際に使用される一意の識別子。 |
|
visible |
リソースがカタログでレンダリングされる必要があるかどうか。この属性はEL値を取ります。この属性を使用して、特定のユーザーまたはグループに、条件に基づいてリソースを表示できます。デフォルト値は#{true}で、これはリソースが常にすべてのカタログで表示されることを意味します。 |
|
factoryClass |
サービスのファクトリ・クラス。 サポートされているファクトリ・クラスに関する情報は、第C.4項「カタログへの動的リソースの追加に使用可能なファクトリ・クラス」を参照してください。 |
カスタム・フォルダでは、タイトル、サブジェクト、説明およびパラメータなどの属性を使用できます。詳細は、第C.3.8項「attributes」および第C.3.10項「parameters」を参照してください。
カタログ定義のソースにコードを追加するよりも、カタログ定義ファイルの「設計」ビューにカスタム・フォルダを追加する方が簡単な場合があります。詳細は、第16.2.3.5項「フォルダの追加」を参照してください。
customContent要素は、リソース・カタログ・アダプタを使用して生成されたコンテンツを定義します。この要素は、実行時に動的に生成されるリソースを含んだフォルダをレンダリングします。customFolder要素と違い、customContent要素は、フォルダ内にリソースがある場合にのみカタログ内のフォルダをレンダリングします。
例C-8に、customContent要素の使用方法を示します。
例C-8 customContentリソースの例
<customContent contentProviderClass="com.oracle.ensemble.interop.adf.EnsembleContentProvider"
id="ensembleContentProvider" visible="true">
<attributes resourceBundle="oracle.webcenter.spaces.resource.DefaultGroupSpaceCatalogBundle"/>
</customContent>
表C-3に、customContent要素のキーワードを示します。
表C-6 customContentのキーワード
| キーワード | 説明 |
|---|---|
id |
このフォルダを参照する際に使用される一意の識別子。 |
|
visible |
リソースがカタログでレンダリングされる必要があるかどうか。この属性はEL値を取ります。この属性を使用して、特定のユーザーまたはグループに、条件に基づいてリソースを表示できます。デフォルト値は#{true}で、これはリソースが常にすべてのカタログで表示されることを意味します。 |
|
contentProviderClass |
|
カスタム・コンテンツ・プロバイダでは、タイトル、サブジェクト、説明およびパラメータなどの属性を使用できます。詳細は、第C.3.8項「attributes」および第C.3.10項「parameters」を参照してください。
カタログ定義のソースにコードを追加するよりも、カタログ定義ファイルの「設計」ビューにカスタム・コンテンツ・フォルダを追加する方が簡単な場合があります。詳細は、第16.2.3.6項「カスタム・コンテンツ・プロバイダの追加」を参照してください。
リソース・カタログのエントリには、エントリを表現する属性が関連付けられています。いくつかの属性の値は、リソースから直接取得するか、カタログ定義にある各XML要素のnameとdescription属性から取得できます。ただし、これらの値は、エンド・ユーザーに適用するには適切でない場合があります。それらは、他の言語では利用できない場合がしばしばあります。カタログ定義のattributes要素を使用して定義された属性は、他の場所から提供されている属性をオーバーライドするために使用できます。さらに、これらの属性に、リソース・バンドルへのキーについて定義することで、表示される実際の値に現在のユーザーのロケールを反映できます。
attributes要素には、リソース・カタログ・エントリに適用する必要のある属性を定義する個別のattribute要素を必要なだけ挿入できます。
例C-9に、attributes要素の使用方法を示します。
例C-9 attributesおよびattribute要素の例
<attributes> <attribute value="ANNOUNCEMENTS_MAIN_VIEW.TITLE" attributeId="Title" isKey="true"/> <attribute value="ANNOUNCEMENTS_MAIN_VIEW.DESCRIPTION" attributeId="Description" isKey="true"/> <attribute value="ANNOUNCEMENTS_MAIN_VIEW.KEYWORDS" attributeId="Subject" isKey="true"/> <attribute value="oracle.webcenter.collab.announcement" attributeId="WEBCENTER_SERVICE_ID" isKey="false"/> </attributes>
表C-7に、attributes要素のキーワードを示します。
attribute要素は、schema要素のディスクリプタに対応するリソース・カタログ・エントリの属性を定義します。属性の詳細は、第C.3.8項「attributes」を参照してください。コンポーザは次の属性を使用します。
Title
Description
Subject
IconURI
ToolTip
各カタログ・エントリには、少なくともTitleとDescription属性を指定する必要があります。リソース・カタログのキーワード検索を実行しやすくするために、Subject属性を使用することもお薦めします。Title属性は、親要素のname属性をオーバーライドします。また、リソース・バンドルによって翻訳された表示名を宣言するために使用します。同様にDescription属性は、親要素のdescription属性をオーバーライドします。また、リソース・バンドルによって翻訳された説明を宣言するために使用します。
schema要素に独自の属性を含めることで、それらを宣言できます。詳細は、第C.3.11項「schema」を参照してください。
例C-10に、attribute要素の使用方法を示します。
例C-10 attributesおよびattribute要素の例
<attributes> <attribute value="ANNOUNCEMENTS_MAIN_VIEW.TITLE" attributeId="Title" isKey="true"/> <attribute value="ANNOUNCEMENTS_MAIN_VIEW.DESCRIPTION" attributeId="Description" isKey="true"/> <attribute value="ANNOUNCEMENTS_MAIN_VIEW.KEYWORDS" attributeId="Subject" isKey="true"/> <attribute value="oracle.webcenter.collab.announcement" attributeId="WEBCENTER_SERVICE_ID" isKey="false"/> </attributes>
表C-8に、attribute要素のキーワードを示します。
表C-8 attributeのキーワード
| キーワード | 説明 |
|---|---|
attributeId |
|
value |
属性の値 |
isKey |
値がリテラル値( |
resourceBundle |
変換された属性値の取得に使用されるリソース・バンドルの名前。 |
リソース・カタログに含まれるタスク・フローの場合、attribute要素を使用してタスク・フロー・パラメータと包含Show Detail Frameコンポーネントの属性を渡すことができます。これには、次の例のようにタスク・フロー・パラメータのattributeIdの値と、Show Detail Frame属性の先頭に、それぞれparameter.とattr.を付けます。
<attributes> <attribute value="dark" attributeId="attr.background" isKey="false"/> <attribute value="#{myBean.myParam1}" attributeId="parameter.myParam1" isKey="false"/> </attributes>
詳細は、第16.2.9項「タスク・フローに対する包含Show Detail Frameのタスク・フローのパラメータと属性の定義方法」を参照してください。
リンク、カスタム・コンポーネントおよびカスタム・フォルダなど、リソース・カタログのコンポーネントのいくつかでは、パラメータがサポートされています。パラメータは、カスタム・コンポーネント用にXMLコードを提供したり、リソースをアプリケーション内の他のアーティファクトにバインドするために使用します。parameters要素を使用して、リソースのパラメータを定義できます。parameters要素は、リソースのタグ内に配置する必要があります。各parameters要素では、複数のparameterタグを使用できます。定義するパラメータにはそれぞれIDと値を指定する必要があります。
カスタムXMLコンポーネントにパラメータを定義するとき、パラメータIDにxmlを指定し、値にはカスタム・コンポーネントのコードを指定する必要があります。コード内で、コンポーネントのIDは#にして、実行時に生成させる必要があります。さらに、コンポーネントのネームスペースを指定する必要があります。
例C-11に、カスタムXMLコンポーネントの定義におけるparameters要素の使用方法を示します。
schemaには、1つ以上のdescriptor要素を指定します。descriptor要素は、カタログ内で使用される属性に関する情報(それらの属性が検索可能かどうかなど)とともに、リソース・カタログ・サービスを提供します。属性のTitle、Description、Subject、ToolTipおよびIconURIはリソースに対して最初からサポートされています。リソースで公開する他のカスタム属性を追加できます。
例C-12に、schema要素の使用方法を示します。
例C-12 schemaの例
<schema resourceBundle="oracle.adf.rc.attribute.nls.AttributeBundle"
xmlns="http://xmlns.oracle.com/adf/rcs/catalog">
<descriptor labelKey="TITLE.PROMPT_KEY" endUserVisible="true"
multivalue="false" searchable="true" attributeId="Title"
shortLabelKey="TITLE.SHORT_PROMPT_KEY"
xmlns="http://xmlns.oracle.com/adf/rcs/catalog"/>
<descriptor labelKey="DESCRIPTION.PROMPT_KEY" endUserVisible="true"
multivalue="false" searchable="true" attributeId="Description"
shortLabelKey="DESCRIPTION.SHORT_PROMPT_KEY"
xmlns="http://xmlns.oracle.com/adf/rcs/catalog"/>
<descriptor labelKey="SUBJECT.PROMPT_KEY" endUserVisible="true"
multivalue="false" searchable="true" attributeId="Subject"
shortLabelKey="SUBJECT.SHORT_PROMPT_KEY"
xmlns="http://xmlns.oracle.com/adf/rcs/catalog"/>
<descriptor labelKey="TOOL_TIP.PROMPT_KEY" endUserVisible="true"
multivalue="false" searchable="false" attributeId="ToolTip"
shortLabelKey="TOOL_TIP.SHORT_PROMPT_KEY"
xmlns="http://xmlns.oracle.com/adf/rcs/catalog"/>
<descriptor labelKey="ICON_URI.PROMPT_KEY" endUserVisible="false"
multivalue="false" searchable="false" attributeId="IconURI"
shortLabelKey="ICON_URI.SHORT_PROMPT_KEY"
xmlns="http://xmlns.oracle.com/adf/rcs/catalog"/>
</schema>
表C-9に、descriptor要素のキーワードを示します。
表C-9 descriptorのキーワード
| キーワード | 説明 |
|---|---|
attributeId |
説明する属性の識別子。 |
searchable |
リソース・カタログ検索に属性を含めるか( |
multivalue |
リソース・カタログ検索に属性を含めるか( |
endUserVisible |
エンド・ユーザーに属性を公開するか( |
resourceBundle |
ラベル・キーの変換に使用されるリソース・バンドルの名前。 |
labelKey |
属性のラベルのリソース・バンドル・キー。 |
shortLabelKey |
ショート・ラベルのリソース・バンドル・キー。 |
resource要素は、タスク・フローなど、個々のリソースをカタログに宣言する際に使用します。この要素は、「コンポーザ」のスタンドアロン・バージョン(WebCenter Portal: Frameworkを使用しない「コンポーザ」)を使用する場合に必要になります。
|
注意:
|
例C-13に、resource要素の使用方法を示します。
例C-13 resourceの例
<resource id="weatherTF"
repository="application.classpath"
path="TaskFlow.jar/ADF_TaskFlow/oracle+composer+internal+test+weather-tfdefn.xml#weather_tf_defn" visible="#{true}">
<attributes>
<attribute value="/images/bulbgauge_ena.png" attributeId="IconURI"/>
<attribute value="never" attributeId="attr.showResizer"/>
<attribute value="Weather in Bangalore is rainy"
attributeId="parameter.message"/>
<attribute value="WeatherBee" isKey="false" attributeId="Title"/>
<attribute value="Displays the weather of your city" isKey="false"
attributeId="Description"/>
<attribute value="Weather widget" isKey="false" attributeId="ToolTip"/>
</attributes>
<parameters/>
</resource>
表C-10に、resource要素のキーワードを示します。要素にattributesを指定する方法の詳細は、第C.3.8項「attributes」を参照してください。
表C-10 resourceのキーワード
| キーワード | 説明 |
|---|---|
|
|
カタログの要素の識別子。識別子は必須で、フォルダ・レベルで一意である必要があります。 |
|
|
クラスパスに含まれるADFライブラリにアクセスするパス。 |
|
|
リソースへのパス。ADFライブラリのタスク・フローの場合は、パスは次の形式になります。
次に例を示します。 ツールチップ:
|
リソース・カタログ・アダプタは、リソースをカタログに動的に追加するために使用します。たとえば、すべての使用可能なコンテンツ・リポジトリ接続をユーザーに表示するフォルダなどです。カタログの作成時にはこのようなフォルダの内容は特定できないため、アダプタによって動的にフォルダへの移入を確認します。
アダプタを使用するには、リソースを追加する際に、リソース定義の一部としてファクトリ・クラスを指定する必要があります。この項では、サポートされているファクトリ・クラスについて説明します。この章の内容は、次のとおりです。
<component>構造内のoracle.adf.rc.component.XmlComponentFactoryクラスは、カタログにXMLコンポーネントを含めるために使用します。XmlComponentFactoryクラスはxmlという名前のパラメータを1つ要求し、このパラメータの値は、XMLのブロックで、ページに追加可能な1つ以上のコンポーネントを表します。次の例は、Panel Customizableコンポーネントをリソース・カタログに追加するコードを示しています。
<component id="pc" factoryClass="oracle.adf.rc.component.XmlComponentFactory">
<attributes>
<attribute attributeId="Title" value="Box"/>
<attribute attributeId="Description" value="Container for other objects"/>
<attribute attributeId="IconURI" value="/adf/webcenter/panelcustomizable_qualifier.png"/>
</attributes>
<parameters>
<parameter id="xml">
<cust:panelCustomizable id="#" xmlns:cust="http://xmlns.oracle.com/adf/faces/customizable"/>
</parameter>
</parameters>
</component>
手順の詳細は、第16.2.3.4項「コンポーネントの追加」を参照してください。
ContentUrlResourceFactoryクラスは、UCM接続からポータル・フレームワークのコンテンツを含めるために使用します。コンテンツ・タイプのURLリソースをカタログに追加するときに使用します。次の例では、ContentUrlResourceFactoryの使用方法を示しています。
<url id="contentItem"
factoryClass="oracle.webcenter.content.model.rc.ContentUrlResourceFactory"
url="content://UCM/PersonalSpaces/weblogic/content.xml">
<attributes>
<attribute value="Personal Document" isKey="false" attributeId="Title"/>
</attributes>
<parameters>
<parameter id="templateView">SpaceTemplate</parameter>
</parameters>
</url>
ここで、idはリソースの固有の識別子であり、urlはリソースへアクセスするURLです。ContentUrlResourceFactoryを使用する場合、URLはcontent:で始める必要があります。さらに、templateViewパラメータを追加することで、使用するコンテンツ・プレゼンタ表示テンプレートを指定できます。
詳細は、第16.2.3.2項「リンクの追加」を参照してください。
ContentFolderContextFactoryクラスは、アプリケーションで使用可能なすべてのコンテンツ・リポジトリ接続をリストするために使用します。次の例に示すように、customFolderリソースをカタログに追加し、このファクトリ・クラスを指定できます。
<customFolder id="AllConnections" factoryClass="oracle.webcenter.content.model.rc.CustomFolderContextFactory" />
カスタム・フォルダの詳細は、第16.2.3.5項「カスタム・フォルダの追加」を参照してください。
WebCenter Portal: Spacesコンテキストでは、DefaultFolderContextFactoryクラスが現在のスペースのフォルダをレンダリングするために使用されます。ユーザーがホーム・スペース内にある場合、ユーザーの個人フォルダがレンダリングされます。次の例に示すように、customFolderリソースをカタログに追加し、このファクトリ・クラスを指定できます。
<customFolder id="GroupDocuments"
factoryClass="oracle.webcenter.doclib.model.rc.DefaultFolderContextFactory" />
カスタム・フォルダの詳細は、第16.2.3.5項「カスタム・フォルダの追加」を参照してください。
ContentListFactoryクラスは、フォルダの動的リストをカタログに追加するために使用します。次の例に示すように、customFolderリソースをカタログに追加し、このファクトリ・クラスを指定できます。
<customFolder id="customFolder-folder" visible="#{true}" path=""
factoryClass="oracle.webcenter.content.model.rc.ContentListFactory">
<attributes>
<attribute attributeId="Title" value="Folders List" isKey="false"/>
</attributes>
<parameters>
<parameter id="datasource">UCM#dCollectionID:60</parameter>
<parameter id="datasourceType">dsTypeFolderContents</parameter>
</parameters>
</customFolder>
ContentListFactoryクラスでは、次のパラメータがサポートされます。
datasource: コンテンツのデータソース。この値は、datasourceTypeの値に依存します。
datasourceType: コンテンツのデータソース・タイプ。使用可能な値はdsTypeSingleNode、dsTypeFolderContents、dsTypeQueryExpression、dsTypeMultiNodeおよびdsTypeScenarioResultsです。
templateView: 使用するコンテンツ・プレゼンタ表示テンプレートを指定します。
コンテンツ・プレゼンタを使用する方法の詳細は、第31章「ポータル・ページへのコンテンツ・タスク・フローおよびドキュメント・コンポーネントの追加」を参照してください。
EnsembleContentProviderクラスは、すべての登録済ページレット・プロデューサを表示するために使用します。次の例に示すように、customContentリソースをカタログに追加し、このファクトリ・クラスを指定できます。
<customContent contentProviderClass="com.oracle.ensemble.interop.adf.EnsembleContentProvider"
id="ensembleContentProvider" visible="true">
<attributes resourceBundle="oracle.webcenter.spaces.resource.DefaultGroupSpaceCatalogBundle"/>
</customContent>
カスタム・コンテンツ・プロバイダの詳細は、第16.2.3.6項「カスタム・コンテンツ・プロバイダの追加」を参照してください。
