Administration Portal の外観の変更

WebLogic Portal に付属する WebLogic Administration Portal の外観は、画像 (.gif および .jpg ファイル) およびカスケーディングスタイルシート (.css ファイル) を変更することによって更新できます。また、ログイン画面に表示されるテキストも、login.properties ファイルを変更することによって更新できます。この機能により、企業の独自性や固有のパーソナライゼーションのニーズを反映した Administration Portal の実装が可能になります。

このドキュメントでは、これらの変更を行って、更新されたファイルをデプロイする方法について説明します。この作業は、次の 4 つの手順に分けられます。

手順 1 : Portal の外観の変更に使用するファイルの検索

必要なファイルの編集可能なバージョンは、次のディレクトリに格納されています。

<BEA_HOME>\weblogic81\portal\lib\adminPortalBranding

これらのファイルの更新後のバージョンは、adminPortal.war (WebLogic Administration Portal の Web アプリケーションアーカイブ) にインストールすることになります。

手順 2 : ファイルの変更

ファイルが見つかったら、ニーズに合わせて必要な変更を行うことができます。ただし、ファイルを変更するときは、以下のガイドラインに従ってください。ガイドラインに従わないと、WebLogic Administration Portal の機能を損なう危険性があります。

CSS ファイル (main.css のみ) : 変更可能な値は、color 値 (#FFFFFF、#9FB8D4 など) と font-family 値のみです。
画像ファイル (*.gif、*.jpg) : 一般に、画像ファイルを変更することは、デフォルトのファイルを独自のバージョンで上書きすることを意味します。画像ファイルの高さと幅は変更しないでください。サイズを変更すると、Adminstration Portal の外観に深刻な影響を及ぼす可能性があります。例外として、ファイル名が button_ で始まる画像にはこのガイドラインは適用されません。これらの画像は、ボタンのラベルテキストに合わせて変更できます。ただし、できるだけ画像を小さくしておく必要があります。
プロパティファイル (login.properties) : このファイルからはキーを削除しないでください。キーとは、行の先頭にあり、後ろに等号 (=) が続いているテキストです。特定のテキストを削除する場合は、等号の後ろの部分のみを削除します。

警告 : ファイル名は変更しないでください。名前が変更されたファイルはブラウザの表示中に無視されるため、情報を表示できなくなります。

手順 3 : 変更内容のプレビュー

adminPortal.war ファイルを更新したり、再デプロイしたりしなくても、さまざまな画像や CSS スタイルに行った変更を簡単にプレビューできます。これには、previewChanges.htm ファイルを表示します。このファイルは次の場所にあります。

<BEA_HOME>\weblogic81\portal\lib\adminPortalBranding

このファイルには、ローカルの画像と CSS ファイルが使用されます。したがって、行った変更のうち、これらのファイルに影響を与えるものはすべて表示されます。使用している CSS スタイルによっては、ブラウザに previewChanges.htm を開くだけで、ほとんどの変更をプレビューすることができます。

CSS スタイルの中には、デフォルトの previewChanges.htm で使用されないものもあります。また、変更内容をプレビューするときに、表示されるものと表示されないものを一覧することも、使用可能な CSS スタイルがあまりに多過ぎて困難です。デフォルトのページには、最もよく使用されるスタイルのみが表示されます。

previewChanges.htm を開いたときに現れるフローティングパレット (図 1) には、マウスポインタが置かれている要素に使用されている CSS クラス名が表示されます。CSS クラス名によって識別される要素を強調表示するには、[Highlight current element] を選択します。

図 1 変更内容のプレビューで表示されるフローティングパレット

手順 4 : 更新されたファイルのインストール

この節では、更新されたファイルを adminPortal.war にインストールするために必要な手順を説明します。詳細な手順については、以下の項目を参照してください。

インストールを行う前に、「更新されたファイルのインストール準備」を一読してください。

更新されたファイルのインストール準備

更新されたファイルをインストールする前に、以下の必要条件を確認します。

jar コマンドにアクセスできることを確認する。このコマンドは、adminPortal.war ファイルの更新に必要です。このコマンドにアクセスできるかどうかは、コマンドプロンプトで jar と入力することによって確認できます。Java SDK または JDK が正しくインストールされている場合は、jar と入力すると、このコマンドの使用方法のリストが表示されます。Java SDK のインストールが必要な場合は、システム管理者に連絡するか、http://java.sun.com/downloads/ を参照してください。
次のディレクトリから、インストール先の adminPortal.war ファイルのパスを確認する。

<bea_home>¥weblogic81¥portal¥lib¥adminPortalBranding

このパスは、インストール時に必要となります。

ファイルのロックやリソースのキャッシュの問題により、デプロイされている .war ファイルを更新できない可能性があることを確認する。更新できない場合は、作業用のコピーを変更して元の .war ファイルと置き換えるか、更新するファイルをアンデプロイします。いずれの方法も、変更した .war ファイルを使用できるようにするには、このファイルをデプロイする必要があります。

更新された CSS および画像ファイルのインストール

CSS ファイルと画像ファイルをインストールし、更新するには、以下の手順に従います。

コマンドプロンプトから、次の場所に移動します。

<bea_home>¥weblogic81¥portal¥lib¥adminPortalBranding

次のコマンドを入力します (pathToWarFile は、インストール先となる adminPortal.war ファイルのパスです)。

jar uvf pathToWarFile framework/*

たとえば、次のパスにあるファイルを更新するとします。 {bea_home}¥user_projects¥applications¥myApp¥adminPortal.war
この場合は、次のコマンドを入力します。 jar uvf ..¥..¥..¥..¥user_projects¥applications¥myApp¥adminPortal.war framework/*

サーバが稼動中の場合は、WebLogic Server Console を使用して Web アプリケーションを再デプロイし、変更内容を反映させる必要があります。

更新されたプロパティファイルのインストール

更新されたプロパティファイルをインストールするには、以下の手順に従います。