ヘッダーをスキップ
Oracle® Fusion Middleware WebCenter Sites開発者ガイド
11gリリース1 (11.1.1.8.0)
E49681-03
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次
前
前 		 次
次		  

34 WebCenter SitesのAdminインタフェースのカスタマイズ

WebCenter Sitesの管理ユーザーおよび編集ユーザーは、Adminインタフェースに表示される様々なツリーを通して製品と対話します。こうしたツリーの変更により、WebCenter SitesのAdminインタフェースをカスタマイズできます。

この章では、ツリーの変更方法について説明します。この章は、次の項で構成されています。

34.1 ツリーの概要

次のスクリーン・キャプチャに示すように、ツリーは一連のタブとして、WebCenter SitesのAdminインタフェースの左側のペインに表示されます。

l_tree-tabs_small.pngの説明が続きます
図l_tree-tabs_small.pngの説明

WebCenter Sitesのツリー・タブは、ツリー・アプレットにより作成されます。ツリー・アプレットに渡される様々なパラメータを設定することにより、独自のツリーの作成または変更が可能です。ツリー・アプレットは、次に示す各種のパラメータを受け入れます。

データベースにある一連のツリー・タブ表には、タブ名、どのロールがタブへのアクセス権を持つか、およびツリー・タブにデータを移入するエレメントへのパスなど、ツリー構成に関する情報が格納されます。これらの表には、「ツリー・タブ」画面を使用して情報を入力します。この画面には、Adminインタフェースを使用して「管理」タブを選択し、「ツリー」ノードをクリックしてアクセスします。

この項の内容は、次のとおりです。

34.1.1 ツリー・タブのロード

WebCenter Sitesで提供されているデフォルトのツリー・タブのほとんどは、OpenMarket/Gator/UIFramework/LoadTabエレメントを通して渡されるツリー・データを要求します。LoadTabエレメントは、セッション・タイムアウトのチェックなど、複数の基本タスクを実行します。

たとえば、GEサンプル・サイトにある「Product」タブは、ロード時に次のステップを完了します。

  1. 「Product」タブにあるJavaコードにより、LoadTabエレメントがコールされます。

  2. LoadTabエレメントにより、TreeTabデータベース表に問合せが行われます。これにより、Productツリーの最上位ノードにデータをロードするエレメントが取得されます。この場合のエレメントは、OpenMarket/Xcelerate/ProductGroups/LoadTreeエレメントおよびOpenMarket/Xcelerate/Product/LoadTreeエレメントです。

  3. OpenMarket/Xcelerate/ProductGroups/LoadTreeエレメントおよびOpenMarket/Xcelerate/Product/LoadTreeエレメントにより、データベースに対して、ツリーのノードに対応するアセットの問合せが行われ、元のツリー・アプレットにノードのデータがストリームされます。

  4. ツリー・アプレットにより、ノード・データが解析され、ノードが表示されます。

  5. 「Product」タブのJavaコードにより、グローバル・コンテキスト・メニューを初期化するためのエレメント、つまりOpenMarket/Gator/UIFramework/LoadGlobalPopupエレメントがコールされます。このエレメントにより、「Products」タブからコールされた、各ツリーをロードするエレメントに対して、GetTypesコマンドが送信されます。ツリーをロードするエレメントにより、このコマンドが受信されると、スタート・メニュー・アイテムをグローバル・コンテキスト・メニューに表示する、アセット・タイプのリストが返されます。

  6. OpenMarket/Gator/UIFramework/LoadGlobalPopupエレメントにより、指定されたアセット・タイプのスタート・メニュー・アイテムが検索され、その情報が元のツリーにストリームされます。

システムの各アセット・タイプには、LoadTreeエレメントが必要なことに注意してください。LoadTreeエレメントは、実際にツリーをロードする、別のエレメントへのポインタです。アセット・タイプが子を持つことが可能な場合、それぞれの子は、LoadTreeエレメントを持つ必要があります。LoadTreeエレメントのパスは次のとおりです。

OpenMarket/Xcelrate/AssetType/MyAssetType/LoadTree

MyAssetTypeは、LoadTreeエレメントにより参照されるアセット・タイプの名前です。

LoadTreeエレメントは、「ツリーの管理」フォームのSectionフィールドに設定されたアセット・タイプに基づいてコールされます。

コア・アセット・タイプでは、複数あるエレメントの1つを使用することで、ツリーがロードされます。次の表は、これらのエレメントのリストで構成されています。

表34-1 アセット・タイプのエレメント

アセット・タイプ 場所 説明

フレックス・グループ

OpenMarket/Gator/UIFramework/LoadGroupNodes

FlexGroupの親階層およびFlexAssetの子を表示します

フレックス・アセット

OpenMarket/Gator/UIFramework/LoadOrphanNodes

フレックス・グループに属さないフレックス・アセットを表示します

サイト・プラン・ツリー

OpenMarket/Xcelerate/AssetType/Page/LoadSiteTree

サイト・プラン・ツリーを表示します

サイト・プラン・アソシエーション

OpenMarket/Gator/UIFramework/LoadChildren

サイト・プラン・ツリーにおけるアセットのアソシエーションを表示します

ブックマーク

OpenMarket/Gator/UIFramework/LoadActiveList

ブックマーク・ツリーを表示します

管理ツリー

OpenMarket/Gator/UIFramework/LoadAdminTree

管理ツリーを表示します

管理ツリーのヘルパー・エレメント

OpenMarket/Gator/UIFramework/Admin

管理ツリー用のヘルパー・エレメントをロードします

アセット・タイプ

OpenMarket/Gator/UIFramework/LoadAdministrationAsset

ツリーの最上位レベルのアセット・タイプのノード、およびそのタイプのすべてのアセットの名前を、ツリーの下位レベルに表示します

ツリー内のノードの外観または動作を変更する場合は、これらの標準エレメントのいずれかに基づいて、ツリーをロードする新しいエレメントを作成します。その後、Webサイトの管理者がエレメント名およびそのエレメントへのパスを指定できるようになります。これは、「ツリー・タブ」フォームとは違う場所にある新規ツリー・フォームの「セクション名」フィールドおよび「エレメント名」フィールドで指定します。ツリーの追加と新規ツリー・フォームの詳細は、『Oracle Fusion Middleware WebCenter Sites管理者ガイド』を参照してください。

ツリー・ノードの変更の詳細は、第34.1.1.3項「ノードのパラメータ」を参照してください。

34.1.1.1 アプレット全体のパラメータ

アプレット全体のパラメータは、TreeAppletParams.xmlエレメントに設定されています。ツリー・アプレットの動作を変更するには、そこに設定されているパラメータ値を、次の表に示すとおりに変更します。

表34-2 アプレット全体のパラメータ

パラメータ 説明

Debug

デバッグのオン/オフを切り替えます。有効な値は、trueとfalseです。Debugがtrueに設定されていると、Javaコンソールのデバッグおよびエラー・メッセージングがオンになります。

ServerBaseURL

ベース文字列を、すべてのノード・データのURL文字列が付加されるように設定します。たとえば、ServerBaseURLがfile://localhostに設定され、LoadURLパラメータの値がNodeReader.testの場合、ツリーの子ノードをロードするために使用されるURLは次のようになります。

file://localhost/NodeReader.test

BackgroundColor

ツリーの背景色を、10進数のRGB値を使用して設定します。このパラメータが設定されていない場合、背景色は、ツリーが埋め込まれているHTMLフレームの色にデフォルトで設定されます。

TotalPanes

表示されるツリー・タブの数を設定します。この値は自動的に設定されます。

URLTarget

ノードのリンクを表示する対象のフレームです。デフォルト値は、XcelAction(ブラウザのウィンドウの右側にあるペインの名前)です。

34.1.1.2 ツリー固有のパラメータ

ツリー固有のパラメータは、「新規ツリー・タブの追加」フォームと「新規ツリー・タブの追加」フォームを作成するOpenMarket\Gator\UIFramework\TreeTabAdd.xmlエレメントにより設定されます。ツリーの外観または動作を変更するには、次の表に示すパラメータ値を変更します。パラメータ値を変更するには、フォームを使用するか、TreeTabAddエレメントを変更します。

表34-3 ツリー固有のパラメータ

パラメータ 説明

Title

タブに表示されるテキストを設定します。

この値は、「管理」タブにある、「ツリーの管理」フォームのTitleフィールドで設定されます。

ToolTip

マウス・ポインタがタブ索引上にあるときに表示されるテキストを設定します。

この値は、「管理」タブにある、「ツリーの管理」フォームのTool Tipフィールドで設定されます。

LoadURI

ノードの子を取得するためにコールするページのURIです。

この値は、TreeTabAddエレメントで設定されます。

ActionURL

ツリー内のノードに対するコンテキスト・メニュー・アクションを実行するページのURLです。デフォルト値は、OpURL.xmlエレメントを示します。

この値は、TreeTabAddエレメントで設定されます。

OpenIcon

展開されたノードを表すときに使用するアイコンへのパスです。デフォルトは、プラス記号(+)です。

この値は、TreeTabAddエレメントで設定されます。

CloseIcon

展開されていないノードを表すときに使用するアイコンへのパスです。デフォルトは、マイナス記号(-)です。

この値は、TreeTabAddエレメントで設定されます。

LineStyle

ツリーのノードを線でつなぐかどうかを設定します。有効な値はAngledと空白です(デフォルトはAngled)。パラメータがAngledに設定されている場合は、ノードが線でつながれます。値を空白にしておくと、ノードは線でつながれません。

この値は、TreeTabAddエレメントで設定されます。

RootID

ルート・ノードのIDを設定します。この文字列は、ノード・パスの指定に使用されます。デフォルトで、Titleパラメータの値が設定されます。

この値は、TreeTabAddエレメントで設定されます。

GlobalItems

この値は、「管理」タブにある、「ツリーの管理」フォームのGlobalItemsフィールドで設定されます。

NodeItems

この値は、「管理」タブにある、「ツリーの管理」フォームのNodeItemsフィールドで設定されます。

34.1.1.3 ノードのパラメータ

ノードのパラメータにより、ツリーのノードの外観および動作が決定されます。これらのノードの外観および動作を定義するには、エレメントを記述します。そのエレメントによって、次の表に示すノードのパラメータを設定し、ツリーのノードを作成するBuildTreeNode.xmlエレメントに値を渡します。

表34-4 ノードのパラメータ

パラメータ 説明

Label

このノードに表示されるテキストを指定します。値が一意である必要はありません。デフォルト値は""です。

ID

ツリー内で一意の文字列識別子です。WebCenter Sitesで選択中のパスの表現に使用されます。このIDは、WebCenter Sitesにより指定されます。

ExecuteURL

Executeアクションの完了時に表示するページのURI値です。この値の先頭には、ServerBaseURLの値が付加されます。

ノードが実行不可の場合は、このパラメータをノード・データに含めないでください。

URLTarget

ExecuteURLの対象のフレームです。ノード・データにExecuteURLが含まれていない場合は、アプレット全体のパラメータで指定された対象がデフォルトで設定されます。

Description

ツリー全体のコンテキスト・メニューでこのオプションを選択した場合、Labelで指定された文字列にかわるものです。デフォルト値は""です。

Level

このノードの相対レベルで、>= 0という数字で表されます。値が0(ゼロ)の場合は、このノードが、データを要求しているノードの直接の子であることを示します。

一度に複数レベルのノードをロードするには、この値に0(ゼロ)より大きい数字を設定します。デフォルト値は0(ゼロ)です。

Image

ラベルの先頭に付加されるイメージのURIです。このフィールドがノード・データに含まれていない場合は、そのノードにイメージが表示されません。

LoadURL

サブツリー階層のURIです。このフィールドがノード・データに含まれていない場合、このノードは追加のロードを必要としません。

このパラメータに指定されるURLには、ツリー・アプレットがノードの子を検索できるよう、十分な情報が含まれている必要があります。たとえば、階層が次のような場合、

製品タブ/Reebok社/ランニング・シューズ

LoadURLの値は次のようになります。

ContentServer?pagename=OpenMarket/Gator/UIFramework/LoadTab&AssetType=ProductGroups&populate=OpenMarket/Xcelerate/AssetType/ProductGroups/LoadTree&op=load&parent=Variables.parentid

parentidは、ランニング・シューズ・アセットのアセットIDであり、opとpopulateは、ツリーをロードするエレメントをルーティングするためにLoadTabで使用されます。

OKAction

ノードのコンテキスト・メニューに表示されるアクションです。この文字列は、同一ノードのデータ・セットに複数回出現することがあります。

OpURL

サーバーに対して、指定されたアクションを実行するためのURLです。この値の先頭には、ServerBaseURLパラメータの値が付加されます。

NodeItemsパラメータの値がNULL文字列で、そのためOKActionが指定されていない場合でないかぎり、このパラメータをノード・データに含めてください。

RefreshKeys

ツリーのリフレッシュに使用できる、1つまたは一連のキーを作成します。この値を、現在のノードのIDに設定します。

LoadAdministrationAssetエレメントの抜粋を次に示します。この抜粋では、ノードのパラメータの値が設定され、その値がBuildTreeNodeエレメントに渡されます。

この抜粋で参照されているListofAssetリストは、指定されたタイプのアセットに関する情報のリストです。このリストは、エレメントの別の場所で実行される、SQL問合せにより生成されたものです。

<CALLELEMENT NAME="OpenMarket/Gator/UIFramework/BuildTreeNode">
  <ARGUMENT NAME="Label" 
    VALUE="ListofAsset.name"/>
  <ARGUMENT NAME="Description" 
    VALUE="ListofAsset.description"/>
  <ARGUMENT NAME="ID" 
    VALUE="Variables.TreeNodeID"/>
  <ARGUMENT NAME="OpURL" 
    VALUE="ContentServer?pagename=
    OpenMarket/Gator/UIFramework/TreeOpURL&#38;
    AssetType=Variables.AssetType"/>

  <ARGUMENT NAME="ExecuteURL" 
    VALUE="ContentServer?pagename=
    OpenMarket/Gator/UIFramework/TreeOpURL&#38;
    AssetType=Variables.AssetType&#38;n0_=
    Variables.packedTreeNodeID&#38;op=displayNode"/>

  <ARGUMENT NAME="OKActions" 
    VALUE="Status;Inspect;Edit;Delete;refresh"/>
  <ARGUMENT NAME="Image" 
    VALUE="Xcelerate/OMTree/TreeImages/AssetTypes/Variables.AssetType.gif"/>
  <ARGUMENT NAME="RefreshKeys" 
    VALUE="ListofAsset.id"/>
</CALLELEMENT>

ツリーのノードの外観または動作をカスタマイズするには、標準エレメントの1つをコピーし、ノードの引数を変更します。ツリーをロードするエレメントには、次の変数が渡されていることに注意してください。そのため、作成またはカスタマイズした、ツリーをロードするすべてのエレメントでは、次の変数を考慮する必要があります。

LoadTreeエレメントにより渡された変数

  • AssetType: 「新規ツリー」フォームを使用して作成されたセクション名に設定されています

  • op: initに設定されています

LoadGlobalPopupエレメントにより渡された変数

  • command: GetTypesに設定されています

  • AssetType: 「新規ツリー」フォームを使用して作成されたセクション名に設定されています

  • varname: スタート・メニュー・アイテムの表示対象とするアセット・タイプを、カンマ区切りのリストで設定します

  • popupvar: グローバル・コンテキスト・メニューにアイテムを追加する場合はtrue、コンテキスト・メニューにアイテムを追加する必要のない場合はfalseに設定します

34.1.1.4 ノードのコンテキスト・メニューのコマンド

ツリーの各ノードには、ユーザーがマウスで右クリックすると表示されるメニューがあります。このメニューのコマンドを使用すると、ノードをリフレッシュしたり、ブラウザのウィンドウの右側にページをロードできます。ノードのコンテキスト・メニューには、コマンドが追加できます。これにより、状態フォームやパブリッシュ・フォームなどのフォームのロードが可能になります。アセット・タイプおよびIDを使用してコールされるフォームはいずれも、ノードのコンテキスト・メニュー・コマンドからコールされる可能性が高いものです。

次の手順を完了することによって、ノードのコンテキスト・メニューに新規コマンドを追加します。

  1. ノードのOKActionsフィールドに、新規コマンドを実際の表示どおりに追加します。

  2. ノードのOpURLが参照するエレメント(通常はTreeOpURLエレメント)に、ロード対象のフォームをコールする新規のIF文を追加します。

    たとえば、次のTreeOpURLエレメントのコードにより、ノードが表示されます。

    <IF COND="Variables.op=displayNode">
     <THEN>
      <callelement NAME="OpenMarket/Gator/UIFramework/TreeIDFromPath">
      <argument NAME="TreePath" VALUE="Variables.TreeNodePath"/>
      </callelement>
         <setvar NAME="id" VALUE="Variables.ID"/>
         <callelement NAME="OpenMarket/Xcelerate/UIFramework/ApplicationPage">
         <argument NAME="ThisPage" VALUE="ContentDetailsFront"/>
         <argument NAME="contentfunctions" VALUE="true"/>
         <argument NAME="AssetType" VALUE="Variables.AssetType"/>
     </callelement>
    </THEN>

34.1.2 ツリーのリフレッシュ

ツリーを変更可能なエレメントでは、ツリーが現在のデータを表示するようにリフレッシュする必要があります。指定可能なリフレッシュ・アクションには、次の3種類があります。

  • Self: 指定されたノードの子をリフレッシュします

  • Parent: 指定されたノードおよびその子をリフレッシュします

  • Root: ツリー全体をリフレッシュします

ツリーをリフレッシュする手順には次の2つがあります。

  1. ツリーをカスタマイズするエレメントをコーディングし、リフレッシュ対象のツリー・ノードがRefreshKeysを保持するようにします。RefreshKeysは、リフレッシュの発生を許可するキー(通常は現在のノードのアセットID)です。

  2. OpenMarket/Xcelerate/UIFramework/UpdateTreeOMTreeエレメントをコールして_TreeRefreshKeys_変数を渡し、目的のリフレッシュのタイプを可変の値で指定します。

ノードのRefreshKeysは、BuildTreeNodeエレメントにRefreshKeys引数を渡して設定します。第34.1.1.3項「ノードのパラメータ」にコードのサンプルを示します。

ツリーをリフレッシュするには、OpenMarket/Xcelerate/UIFramework/UpdateTreeOMTreeエレメントを、次の例に示すとおりにコールします。

<CALLELEMENT NAME="OpenMarket/Xcelerate/UIFramework/UpdateTreeOMTree">
    <ARGUMENT NAME= "_TreeRefreshKeys_" VALUE= "Root:ActiveList"/>
</CALLELEMENT>

34.2 ツリーとセキュリティ

WebCenter Sitesでは、SitesのAdminインタフェースでツリーへのアクセスを制御するためにロールを使用します。システム定義の「管理」タブ、「サイト管理者」タブ、および「ワークフロー」タブについても、それらのタブのユーザーはxceladmin ACLを持っている必要があります。

追加の制御を使用できるようにするには、futuretense_xcel.iniのプロパティを設定します。たとえば、xcelerate.showSiteTreeでは、デフォルトでツリーを表示するかどうかを決定します。また、xcelerate.restrictSiteTreeでは、どのユーザーがツリーを表示または非表示にできるかを決定します。ツリーとセキュリティの詳細は、『Oracle Fusion Middleware WebCenter Sites管理者ガイド』を参照してください。

34.3 ツリーのエラー・ロギング

ツリー関連のエラーおよびデバッグ・メッセージは、すべてJavaコンソールにログ出力されます。ツリーの作成時にDebugパラメータに値を指定することで、デバッグのオン/オフを切り替えることができます。

デバッグを有効にするとパフォーマンスに影響するため、配信システムでは通常、エラー・ロギングをオフにしておいてください。

  前
前 		 次
次
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次