開発における GroupSpace の操作

「開発における GroupSpace の操作」では、電子メールベースの招待の有効化、および GroupSpace コミュニティを拡張するためのオプションの他の開発タスクの実行について述べられています。

GroupSpace コミュニティの作成

GroupSpace コミュニティの作成は、最終的にはポータル管理者が Administration Console で行います。または、適切な権限を持つ GroupSpace エンドユーザがコミュニティを作成します。GroupSpace コミュニティは、すべてのコミュニティと同様に、ファイルシステムではなくデータベースから表示されます。GroupSpace コミュニティを作成するには、これらの管理者およびユーザは、開発環境からアクセスすることのできるリソースに依存することになります。

開発タスクの場合でも、管理者やエンドユーザがデフォルトの GroupSpace コミュニティを作成する必要はありません。GroupSpace コミュニティの作成では主要なリソースが用意されていて、これらのリソースを開発者が必要に応じて拡張または修正することができます。

GroupSpace リソースについて

GroupSpace 共有 J2EE ライブラリには、以下のリソースがあります。これらのリソースを表示するには、マージ済みプロジェクトビューを開きます。

シェル - 訪問者ツールとコミュニティツールを含むコミュニティシェル。GroupSpace はこのシェルを使用して、ヘッダに外観を適用するためにルックアンドフィールオーバーライドを適用します。場所 : <portalWebProject>/communityFiles/
ルックアンドフィール - デフォルトの GroupSpace ルックアンドフィール。場所 : <portalWebProject>/framework/skins/ または <portalWebProject>/framework/skins/gsdefault/
招待 - コミュニティの被招待者に送信される招待電子メール。場所 : <portalWebProject>/invitations/
ポートレット - GroupSpace およびコラボレーションポートレット。場所 : <portalWebProject>/portlets/
groupspace.community ファイル - .community 拡張子を持つポータルファイル。ポータル管理者はこのファイルを使用して GroupSpace テンプレートを作成し、このテンプレートから GroupSpace コミュニティを作成できます。場所 : <portalWebProject>/<WebContent>/groupspace.community
groupspace.ctmeta ファイル - デフォルトの GroupSpace コミュニティにあらかじめコンフィグレーションされた設定を適用する、コミュニティテンプレートメタデータファイル。このファイルは、コミュニティテンプレートおよびコミュニティの作成に使用され、コミュニティに使用する .community ファイルを参照します。このファイルには、ポータル管理者がコミュニティテンプレートを簡単に作成できるようにする詳細設定も含まれています。場所 : <portalWebProject>/<WebContent>/groupspace.ctmeta
communities-config.xml ファイル - このエンタープライズアプリケーションレベルのファイルを使用すると、コミュニティの招待を送信するための電子メールサーバの電子メール設定をコンフィグレーションし、コミュニティにセキュリティ機能を追加できます。

デフォルトの GroupSpace コミュニティを作成するには、これらのリソースを変更せずに使用できます。カスタマイズを作成して、独自のバージョンの GroupSpace をコンフィグレーションすることもできます。作成できるカスタマイズの詳細については、「デフォルトの GroupSpace の拡張」を参照してください。

電子メールベースの招待の有効化

ポータルアプリケーションを作成したら、以下の方法のいずれかを使用して電子メールベースの招待を有効にすることができます。

GroupSpace コミュニティを起動し、UI で以下の手順を使用して電子メールの招待をコンフィグレーションします。

GroupSpace コミュニティにログインします。
[コミュニティ｜このコミュニティを管理] を選択します。
[Properties Page] タブで、[コミュニティの電子メールコンフィグレーション] をクリックします。
[返信先アドレス] フィールドに、電子メールアドレスを入力します。
[表示名] フィールドに、電子メールの [送信者] フィールドに表示させる名前を入力します。
[送信メールサーバ (SMTP)] フィールドに、送信ホスト名または IP アドレスを入力します。
[送信メールポート (SMTP)] フィールドに、送信メールサーバに接続するためのポート番号を入力します。たとえば、SMTP の場合は「25」を入力します。
[アカウントユーザ名 (SMTP)] フィールドにメールアカウントの名前を入力します。特殊文字は使用しないでください。
[アカウントパスワード (SMTP)] フィールドにパスワードを入力します。
[保存] をクリックします。

また、EAR アプリケーションの \META-INF ディレクトリに communities-config.xml ファイルを配置し、このファイルを編集することにより、電子メールの招待を手動でコンフィグレーションすることもできます。たとえば、C:\Documents and Settings\dsmith\workshop\myportalEAR\META-INF です。communities-config.xml ファイルがない場合は、コードリスト 4-1 をテキストファイルにコピーしてファイルを作成します。

テキストエディタで communities-config.xml ファイルを開き、コードリスト 4-1 に示されるとおりに、以下の行の情報をカスタマイズします。

コードリスト 4-1 communities-config.xml ファイルに値を入力

<?xml version="1.0" encoding="UTF-8"?>
<communities-config xmlns="http://www.bea.com/ns/portal/ 90/communities-config">
     <properties-config>
          <property-map>
               <name>groupspace.DefaultEmailConfiguration</name>
               <property>
                    <name>replyToAddress</name>
                    <value>--Please Change-- some.user@
                         yourcompany.com</value>
               </property>
               <property>
                    <name>displayName</name>
                    <value>GroupSpace Emailer</value>
               </property>
               <property>
                    <name>smtpServer</name>
                    <value>--Please Change-- smtp.yourdomain.com</value>
               </property>
               <property>
                    <name>smtpPort</name>
                    <value>25</value>
               </property>
               <property>
                    <name>smtpUsername</name>
                    <value>--Please Change-- smtpuserid</value>
               </property>
               <property>
                    <name>smtpPassword</name>
                    <value>--Please Change-- smtppassword</value>
               </property>
          </property-map>
     </properties-config>
</communities-config>

communities-config.xml ファイルを保存します。これらの設定は、GroupSpace コミュニティで [コミュニティ｜このコミュニティを管理] を選択し、[Properties Page] タブを選択することで後からでも変更可能です。GroupSpace インスタンスごとにこれらの設定の変更が可能です。

注意 :

サンプルの GroupSpace アプリケーションを実行するのであれば、データベースはすでにコンフィグレーションされています。デフォルトでは、すべてのドメインが PointBase を使用するようにコンフィグレーションされています。

新しいドメイン内のデータベースのコンフィグレーション

WebLogic Portal 9.2 ドメインでは WebLogic Portal GroupSpace Framework Application テンプレートを使用して GroupSpace データベースを作成していましたが、Portal 10.0 ドメインでは WebLogic Portal GroupSpace Application Collaboration Repository を使用します。詳細については、「ポータルドメインへの GroupSpace の追加」を参照してください。

Configuration Wizard を使用して新しいドメインを作成した場合、または既存のドメインを拡張した場合は、PointBase 以外のデータベースを使用することができます。PointBase はデフォルトのデータベースです。GS Example Community で作成する項目は、GroupSpace データベースに格納されます。CM Browser ポートレットには共有コンテンツリポジトリの読み込み専用コンテンツが表示されます。

以下の手順を実行して GroupSpace コンテンツリポジトリデータベースオブジェクトを追加します。その後、PointBase 以外の指定の GroupSpace データベースを指す appsGroupSpaceDataSource を追加し、コンフィグレーションします。

WebLogic Server および WebLogic Portal Administration Console が実行中の場合は停止します。
データベースベンダの説明に従って、データベースデータをバックアップします。
新しい 10.0 ドメインの場合は、デフォルトの PointBase データベースに WEBLOGIC_GROUPSPACE スキーマが自動的に作成されます。appsGroupSpaceDataSource が新しいドメインに自動的に追加され、WEBLOGIC_GROUPSPACE スキーマにアクセスするようにコンフィグレーションされます。GroupSpace データベースオブジェクトは、メインのポータルデータベースオブジェクト (デフォルトでは、WEBLOGIC PointBase スキーマに作成される) とは別のデータベーススキーマに存在する必要があります。

PointBase データベースの場合は、手順 d に進みます。以下のタイプのデータベースの場合は、データベース管理者は WebLogic GroupSpace データベーススキーマ用のデータベースユーザまたはデータベースを定義する必要があります。

Oracle の場合は、<WL_HOME>/portal/db/oracle/admin/create_tablespaces.sql および create_users.sql を参照。
SQL Server の場合は、<WL_HOME>/portal/db/sql_server/admin/create_database.sql を参照。
mySQL Server の場合は、<WL_HOME>/portal/db/mysql/admin/create_database.sql を参照。
Sybase の場合は、<WL_HOME>/portal/db/sybase/admin/create_devices および create_database.sql を参照。
DB2 の場合は、<WL_HOME>/portal/db/db2/admin/create_tablespaces.sql および create_user.sql を参照。

これらのスクリプトの実行の詳細については、『データベース管理ガイド』を参照してください。

ドメインの groupspace_database.properties ファイルを編集し、GroupSpace コンテンツ管理リポジトリデータベース用にデータベースおよびユーザ情報の設定を行います。
BEA WebLogic Configuration Wizard (詳細については、BEA Products でのコンフィグレーションウィザードを使用した WebLogic ドメインの作成ガイドを参照) を使用するか、create_db.cmd -database.properties=groupspace_database.properties を、ドメインのホームディレクトリ (または ../create_db.sh -database.properties=groupspace_database.properties) から実行して、GroupSpace データベースオブジェクトを追加します。
新しい 9.x ドメインで PointBase 以外のデータベースを定義したら、ドメイン内の appsGroupSpaceDataSource (デフォルトでは PointBase を指す) を適切なドライバディレクトリのものと置き換え、データベース環境用に更新します。手順 c でコンフィグレーションしたデータベース用に @CMREPO_DB...@ 変数を手動で編集します。各データベース用のサンプルの appsGroupSpaceDataSource-jdbc.xml 定義ファイルおよび BEA がサポートするドライバは、<WL_HOME>/portal/db/jdbc/<database_driver> にあります。たとえば、oracle_bea または sybase_bea です。

GroupSpace データベースの設定の詳細については、『データベース管理ガイド』を参照してください。

/<WL_Home>/samples/domains/portal/bin/ ディレクトリに移動し、「startWebLogic.cmd」と入力してサーバを起動します。サンプルデータにある GS Example Community は http://<localhost>:7041/groupspace/ groupspace.jsp に表示されます。CM Browser ポートレットは共有コンテンツリポジトリを使用します。つまり、他のすべてのデータはコミュニティリポジトリに格納されます。

ポータルを作成したら、次にコミュニティテンプレートを作成します。コミュニティテンプレートはパッケージ化されたリソースのセットです。コミュニティテンプレートを使用することで、プロジェクトの管理またはコラボレーションアプリケーションを構築することができます。コミュニティテンプレートを作成し、そのテンプレートを使用することで、余分なコードを記述することなく新しいコミュニティを作成することができます。GroupSpace コミュニティテンプレートの作成手順については、「GroupSpace コミュニティテンプレートの作成」を参照してください。

ステージング段階で GroupSpace テンプレートを作成したら、そのテンプレートをプロダクション環境に伝播できます。プロダクション環境では、GroupSpace テンプレートを使用して GroupSpace コミュニティを作成します。

デフォルトの GroupSpace の拡張

デフォルトの GroupSpace テンプレートおよびリソースを使用すると、フル機能の GroupSpace コミュニティを迅速かつ簡単に作成できます。ただし、デフォルトの GroupSpace テンプレートの変更が必要になる場合もあります。次に例を示します。

GroupSpace コミュニティを拡張することによって、機能を追加できる場合もあります。次に例を示します。

以降の節では、デフォルトの GroupSpace コミュニティテンプレートを拡張する方法について説明します。

変更してはいけないファイル

特定のファイルを編集すると、GroupSpace が正常に機能しなくなります。以下の GroupSpace リソースは変更しないでください。

ライブラリからのソースファイルのコピー

GroupSpace で使用されているリソースを変更する場合は、そのリソースを共有ライブラリからコピーします。ライブラリからファイルシステムにリソースをコピーすると、ファイルシステムのコピーがライブラリリソースよりも優先的に使用されます。

共有ライブラリから GroupSpace リソースをコピーするには、次の手順を実行します。

ポータルパースペクティブに含まれている [マージ済みプロジェクト] ビューに切り替えます。
使用可能な共有ライブラリリソース (斜体で表示) を右クリックし、[プロジェクトにコピー] を選択します。
[ナビゲーター] ビューに切り替え、変更するリソースを開きます。

ファイルの共有ライブラリバージョンを再度使用するには、そのファイルを [ナビゲーター] ビューから削除します。ファイルを削除する前に、共有ライブラリに格納されているファイルかどうかを確認します。GroupSpace に用意されたファイルの一部は共有ライブラリにはないため、そのファイルを [ナビゲーター] ビューから削除すると、完全に削除されることになります。

GroupSpace の招待電子メールの文面の変更

招待用にコミュニティに送信される電子メールの文面を変更する場合は、/invitations/email/invite_body.jsp ファイルと invite_subject.jsp ファイルを変更します。

この 2 つのファイルのいずれかを変更したら、変更を有効にするためにサーバを再起動する必要があります。

groupspace.community ファイルの変更

<portalWebProject>/<WebContent>/groupspace.community にある groupspace.community ファイルは、.community 拡張子を持つポータルファイルです。このファイルには GroupSpace 機能のフルセットが含まれており、そのまま GroupSpace コミュニティの作成に使用できます。

このファイルは、必要に応じて変更できます。たとえば、このファイルから作成される GroupSpace コミュニティで Mail ポートレットを使用しない場合は、ポータルエディタでポートレットを削除できます。

ただし、このファイルには簡単な変更を加えるだけにしてください。このファイルを大幅に変更する場合は、コピーを作成するか、新しいコミュニティファイルを作成し、そのファイルに対してより大規模な変更を行ってください。

groupspace.ctmeta ファイルの変更

groupspace.ctmeta ファイルは、<portalWebProject>/<WebContent>/groupspace.ctmeta にあり、コミュニティテンプレートのデフォルト設定 (多くは詳細設定) を指定するコミュニティテンプレートメタデータファイルです。ポータル管理者はこのファイルを使用して、コミュニティテンプレートを迅速かつ簡単に作成し、作成したコミュニティテンプレートを使用して、その設定を持つコミュニティを作成します。このファイルの設定の中でとりわけ重要なのは、groupspace.community がコミュニティに使用される .community ファイルとして指定されていることです。

このファイルは、必要に応じて変更できます。たとえば、新しいコミュニティの基礎として使用する新しい .community ファイルを作成する場合は、そのファイルを .ctmeta ファイルで参照できます。

元の groupspace.ctmeta ファイルを保持する場合は、groupspace.ctmeta をコピーして、独自の .ctmeta ファイルを作成できます。

このファイルの任意の設定を変更できます。ただし、GroupSpace が正常に機能するように、次のプロパティは変更しないでください。

GroupSpace セキュリティ機能の変更

GroupSpace には、作成者、所有者、寄稿者、および表示者というセキュリティ機能、つまりロール名が用意されています。(作成者と所有者は、非 GroupSpace コミュニティを含むすべてのコミュニティにデフォルトで用意されています)。GroupSpace はこれらの機能を使用して、GroupSpace でユーザが実行する作成、読み込み、更新、および削除の各アクションを管理します。

これらの機能は、GroupSpace 共有ライブラリの /META-INF/communities-config.xml ファイルで定義されています。このファイルは変更できません。ただし、<portalEARproject>/META-INF/communities-config.xml ファイルに機能を追加したり、これらの機能を使用するカスタム機能を開発することができます。

コミュニティ管理権限を持つユーザは、コミュニティツールで機能の権限をオーバーライドすることもできます。たとえば、コミュニティ管理者は表示者に「更新」権限を追加できます。更新された機能の設定は、データベースに格納されます。

コミュニティ機能を変更する場合は、次の事項を考慮してください。

GroupSpace コミュニティでは、デフォルトの各機能 (作成者、所有者、寄稿者、および表示者) に権限が定義されています。コミュニティツールで機能の権限を変更すると、その権限の変更はデータベースに格納され、デフォルトの権限をオーバーライドします。

GroupSpace コントロールの使用

GroupSpace には、ページフローに追加できる多数の便利なコントロールが用意されています。これらのコントロールを使用すると、さまざまなタイプの GroupSpace 機能を開発したり、便利な検索機能を使用したりできます。

ページフローに GroupSpace コントロールを追加するには、以下の手順を実行します。

ページフローコントローラを開き、ページフローエクスプローラビュー (ページフローパースペクティブからアクセス可能) に切り替えます。
[参照先のコントロール] を右クリックし、[コントロールの追加] を選択します。
[コントロールの選択] ウィンドウで、適切な [Portal GroupSpace] コントロールグループを展開し、使用するコントロールを選択して、[OK] をクリックします。
[参照先のコントロール] にコントロールが表示されます。このコントロールを展開し、必要なアクションをページフローにドラッグできます。

GroupSpace コントロールの API レベルの情報については、Javadoc の com.bea.apps.groupspace.*.controls を参照してください。

GroupSpace API の使用

GroupSpace には、カスタムの GroupSpace 機能を開発するための豊富な API が用意されています。GroupSpace API を使用して開発された機能は、GroupSpace コミュニティのコンテキストでのみ使用できます。たとえば、com.bea.apps.groupspace.rss.feed.Feed クラスを使用してカスタムの GroupSpace RSS ポートレットを開発した場合、そのポートレットは非 GroupSpace コミュニティでは機能しません。

GroupSpace API の詳細については、Javadoc の com.bea.apps.groupspace.* パッケージを参照してください。

独自のコミュニティポートレットの追加

独自に作成したポートレットを GroupSpace コミュニティに追加できます。GroupSpace コントロールやコミュニティフレームワーク API などのリソースを使用して、必要な機能を含むポートレットを開発し、そのポートレットを所属先の .community ファイルに追加します。

コミュニティフレームワーク API を使用して開発したポートレットは、コミュニティのコンテキストでのみ実行できます。同様に、GroupSpace API を使用して開発したポートレットは、GroupSpace コミュニティのコンテキストでのみ実行できます。

GroupSpace イベントの使用

GroupSpace には、ユーザが GroupSpace コミュニティと対話するときに自動的にトリガされる、事前に定義された多数のイベントがあります。各イベントが発生すると、事前に定義されたイベントリスナによってそのイベントがバッファに追加されます。バッファがデータベースにフラッシュされると、発生した各イベントタイプのカウントが更新されます。GroupSpace は、各タイプのイベントが発生した回数のみを追跡します。

GroupSpace では、GroupNote、リンク、ドキュメントライブラリ、問題、および RSS チャネルで作成、読み込み、更新、および削除の各操作を自動的に追跡します。現在、GroupSpace では、リンク (表示と削除)、ドキュメントライブラリ (作成と更新)、RSS チャネル (表示) を追跡しません。

カウントは、Community_Repository\Groupspace\<AppName>\<WebApp>\<CommunityName>\groupspace\ Analytics\ <EventName> に格納されます。たとえば、

\Groupspace\myPortalEAR\myPortalWebProject\ myGroupSpace\ groupspace\ Analytics\ LoginEventx295rf29v6ljstcmjryfey3dhysvdlo

などです。WebLogic Portal のコンテンツ管理 API を使用すると、独自の分析用にイベントカウントにアクセスできます。

イベントリスナ (com.bea.apps.groupspace.analytics.listeners. AnalyticEventListener) は非同期リスナとして Administration Console に登録されます。[コンフィグレーションとモニタ｜サービス管理] を選択します。[パーソナライゼーション] フォルダを展開し、[イベントサービス] を選択します。イベントカウントの追跡を中止する場合は、リスナの登録を解除できます。

パフォーマンスを最適化するため、次のガイドラインに従ってください。

リスナクラスの詳細については、『対話管理ガイド』を参照してください。

コミュニティプロパティリファレンス

[タイトル] - ユーザインタフェースで表示されるコミュニティのデフォルト名。タイトルは、ローカライズされたコミュニティタイトルでオーバーライドされます。
[説明] - ユーザインタフェースで表示されるコミュニティのデフォルトの説明。説明は、ローカライズされたコミュニティの説明でオーバーライドされます。
[このコミュニティへの非メンバーのアクセスを許可する] - チェックして true に設定すると、メンバー登録なしで誰でもコミュニティにアクセスできます。
[コミュニティメンバシップの登録をすべてのユーザに許可する] - チェックして true に設定すると、招待を受けずに誰でもコミュニティにメンバー登録できます。
[自分のビューのカスタマイズ、および個人ページの追加を許可する] - チェックせずに false に設定すると、コミュニティでは訪問者ツールは無効にされます。ただし、コミュニティ管理者はコミュニティツールにアクセスできます。
[登録 URI / ページ] - コミュニティ登録ページへのパスで、通常はコミュニティのホームページ。
[エラー URI / ページ] - ユーザがメンバーでない場合やコミュニティが無効にされている場合など、ユーザがコミュニティへのアクセスを許可されていない場合に表示されるエラーページへのパス。
[有効期限] - コミュニティが自動的に非アクティブになる日付。
[今すぐこのコミュニティをアクティブにする / ステータス] - [非アクティブ] に設定すると、管理機能を持ったユーザのみがコミュニティにアクセスできます。
[このコミュニティへのメンバーの訪問を記録する] - yes に設定すると、メンバーがコミュニティを訪問した回数が、仮想コンテンツリポジトリに保存されます。
[コールバッククラス] - コミュニティが作成、アクティブ化、非アクティブ化、または削除される場合に、特別なタスクを実行する (パッケージパス情報を含めた) クラスの名前。たとえば、GroupSpace のコールバッククラスは com.bea.apps.groupspace.security.GroupSpaceCallbackImpl です。開発チームが独自のコールバッククラスを提供することもできます。
[ツリー最適化を有効にする] - true に設定すると、コミュニティのパフォーマンスが向上します。この機能の詳細については、『ポータル開発ガイド』の「最適なパフォーマンスを得るためのポータルの設計」を参照してください。

GroupSpace イベントの分析

GroupSpace コミュニティには、ユーザが GroupSpace コミュニティと対話するときに自動的にトリガされる、事前に定義されたイベントがあります。各イベントが発生すると、事前に定義されたイベントリスナによってそのイベントが取得されバッファに格納されます。バッファ情報がデータベースに書き込まれると、発生した各イベントタイプのカウントが更新されます。

イベントが UI に表示されない場合は、イベントを後で表示して分析できます。イベントを取得して格納する機能はデフォルトでオンになっており、これらのイベントは GroupSpace コミュニティ内で発生する必要があります。

GroupSpace コミュニティイベントは、表 4-1 にリストされているポートレットに対する以下の作成、読み込み、更新、および削除操作を自動的に追跡します。

イベントは非同期イベントで、\Community_Repository\Groupspace\<AppName>\<WebApp>\ <CommunityName>\Analytics\<EventName> にあるコミュニティリポジトリに格納されます。たとえば、\Groupspace\myPortalEAR\ myPortalWebProject\myGroupSpace\Analytics\LoginEventx295rf29v6ljstcmjryfey3dhysvdlo などです。WebLogic Portal のコンテンツ管理 API を使用すると、独自の分析用にイベントカウントにアクセスできます。

あらかじめコンフィグレーションされているイベントリスナ (com.bea.apps.groupspace.analytics.listeners. AnalyticEventListener) は非同期リスナとして Administration Console に登録されます ([コンフィグレーションとモニタ｜サービス管理] を選択して、[パーソナライゼーション] フォルダを展開し、[イベントサービス] を選択します)。

イベントリスナは p13-config.xml ファイルにあります。イベントカウントの追跡を中止する場合は、リスナの登録を解除できます。各コミュニティに対して格納されるイベント情報はイベント名、カウントおよび日付です。リスナクラスの詳細については、『対話管理ガイド』を参照してください。

パフォーマンスを最適化するため、次のガイドラインに従ってください。

GroupSpace ルックアンドフィールの変更

ルックアンドフィールによって、ページの要素の配置と動作からポートレットタイトルバーに使用されるカラーに至るまで、GroupSpace コミュニティの外観が決まります。

ルックアンドフィールファイル (.laf) は XML ブロックで、.portal XML ファイルのあらゆる場所に挿入されます。ルックアンドフィールファイルは特定のスキンとスケルトンを参照します。スキンは、画像のセット、JavaScript 関数、CSS ファイルを提供し、これらはスケルトン JSP が参照します。スケルトン JSP は、ポータル XML コンポーネントを最終的な HTML 出力に変換します。ルックアンドフィール、スキン、およびスケルトンの詳細については、『ポータル開発ガイド』を参照してください。

WebLogic Portal には、GroupSpace コミュニティ内では動作しないルックアンドフィールファイルが付属しています。これは、A GroupSpace コミュニティの実装の詳細が GroupSpace のカスタムルックアンドフィール (gsdefault) と緊密に結合しているためです。

GroupSpace コミュニティのルックアンドフィールを変更するには、次のいずれかの方法を選択します。

ライブラリモジュールにあるものをオーバーライドして、既存のルックアンドフィールを変更する
デフォルトの GroupSpace ルックアンドフィールをコピーして編集し、新しいルックアンドフィール作成する。この方法では、資格により無効にする場合を除き、元のルックアンドフィールは保持されます。

デフォルトの GroupSpace ルックアンドフィールの変更

以下の手順では、デフォルトの GroupSpace ルックアンドフィールの一部である GroupSpace ロゴを変更する方法について説明します。

デフォルトの GroupSpace ルックアンドフィールを変更するには、以下の手順を実行します。

Workshop for WebLogic で、ポータル Web プロジェクトに訪問者ツールのプロジェクトファセットがインストールされていることを確認します。新しいルックアンドフィールを有効にする方法については、『ポータル開発ガイド』で「訪問者ツールの有効化」参照してください。
[ウィンドウ｜ビューの表示｜マージ済みプロジェクト] を選択します。マージ済みプロジェクトのビューはプロジェクトの仮想ビューを与えます。ここで、斜体の項目は、WebLogic Portal に付属するライブラリモジュールにあり、その他の項目はプロジェクトディレクトリにあります。プロジェクトディレクトリ内の項目は、ライブラリモジュール内に同じ名前とパスの項目が存在する場合は、これに代わって使用されます。WebLogic Portal には、ライブラリモジュールのファイルをオーバーライドしたローカルコピーを作成する機能があります。
図 4-1 に示すように、ポータル Web プロジェクトディレクトリ内の次の斜体のディレクトリを展開します: framework > skins > gsdefault > images。

図 4-1 images ディレクトリ

images ディレクトリ

たとえば、/images ディレクトリにある斜体の header-logo.gif ファイルを右クリックし、[プロジェクトにコピー] を選択します。この項目は斜体表示ではなくなります。これは、プロジェクトにファイルのローカルコピーが作られ、ライブラリモジュールバージョンの代わりに使用されるためです。
ファイルのコピーを右クリックして [プロパティ] を選択し、ファイルがローカルディスクのどこにあるか確認し、ファイルを右クリックして [に表示｜ナビゲーター] を選択してプロジェクトの結合されていないビューでローカルファイルを表示します。
図 4-2 に示すように、header-logo.gif ファイルのローカルコピーを画像エディタで編集します。変更内容を保存します。

図 4-2 header-logo.gif ファイルの編集

header-logo.gif ファイルの編集

ブラウザで GroupSpace コミュニティにアクセスし、変更を表示します。変更が表示されない場合は、古い画像がブラウザにキャッシュされている可能性があります。ブラウザを更新して、すべての画像と CSS を再ロードします。
同じ手順を行って、その他のルックアンドフィールと CSS ファイルを修正します。GroupSpace コミュニティの他の機能に影響を与えるので、これらのファイルを変更する場合は注意して行ってください。変更箇所は度々テストしてください。

新しい GroupSpace ルックアンドフィールの作成

デフォルトの gsdefault.laf ファイルを使用して新しい GroupSpace のルックアンドフィールを作成できます。(その他の新しいルックアンドフィールの作成方法については、『ポータル開発ガイド』を参照してください。)

GroupSpace 全体のデフォルトのルックアンドフィールを複製し、独自のルックアンドフィールを編集するには、以下の手順を実行します。

ポータル Web プロジェクトに訪問者ツールのプロジェクトファセットがインストールされていることを確認します。新しいルックアンドフィールを有効にする方法については、『ポータル開発ガイド』で「Workshop for WebLogic での訪問者ツールの有効化」参照してください。
[マージ済みプロジェクト] ビューで /framework/skin ディレクトリを展開し、/gsdefault ディレクトリが表示されるようにします。
/gsdefault ディレクトリを右クリックし、[プロジェクトにコピー] を選択します。
ローカルディスクで、gsdefault ディレクトリ (プロジェクトの /framework/skins ディレクトリの下) の名前を新しいルックアンドフィールの名前に変更します。名前にはスペースが含まれないようにします。
[マージ済みプロジェクト] ビューで /framework/markup/lookandfeel ディレクトリを展開し、gsdefault.laf ファイルが表示されるようにします。
gsdefault.laf を右クリックし、[プロジェクトにコピー] を選択します。
ローカルディスクで、gsdefault.laf ファイル (プロジェクトの framework/markup/lookandfeel ディレクトリ内) の名前を手順 4 の新しいルックアンドフィールの名前に変更します。
新しい .laf ファイルを次のように編集します: タイトル、説明、definitionLabel、markupName (definitionLabel に合わせる)、スキン (手順 4 および手順 7 の名前に合わせる) を変更し、変更結果を保存します。スケルトン、skeletonPath、skinPath は変更しないでください。
新しいルックアンドフィールを表示するには、アプリケーションを再デプロイするか、またはサーバを再起動します。新しいルックアンドフィールは、GroupSpace コミュニティの [カスタマイズ｜色] メニューから使用できるはずです。
変更するには、新しい /skin ディレクトリの画像と CSS を編集します。

また、スキンも /<プロジェクト>/wlpAppsCollaborationCore ディレクトリにある CSS と画像を参照します。ここに、特定のファイルのローカルコピーやディレクトリ全体を作成できます。このディレクトリには Javascript があります。特定のファイルをオーバーライドするのではなく、ディレクトリ全体を名前を変更したディレクトリで置き換える場合は注意が必要です。

リッチテキストエディタの設定

一部の GroupSpace ポーレットには、ドキュメントや他の項目にフォーマットを適用するリッチテキストエディタがあります。ポータル管理者は、ユーザにポートレットのフォーマットツールバーやボトムツールバーへのアクセスを許可できます。これにより、ユーザは項目の HTML テキストを表示したり、項目をプレビューできます。

たとえば、GS Issues ポーレットでリッチテキストの編集を有効にすると、ユーザはフォーマットツールバーにより太字、斜体、インデント、色付きフォントなどが使用できます。GS Issues ポートレットのボトムツールバーを有効にすると、ユーザは [HTML]、[編集]、[プレビュー] の各ボタンを表示して使用できます。

以下のポートレットのリッチテキストエディタの設定は有効または無効にできます。

リッチテキスト編集の有効化

GS Example Community では、デフォルトでリッチテキストエディタが有効に、ボトムツールバーが無効になります。その他の Web アプリケーションの場合は、システム管理者が web.xml ファイルを編集してリッチテキストエディタやボトムツールバーを有効にし、続いてポータル管理者がポートレットプリファレンスを設定する必要があります。

リッチテキストエディタを有効にするには、以下の手順を実行します。

システム管理者はテキストエディタを使用して、/WEB-INF ディレクトリの web.xml ファイルを編集し、コードリスト 4-2 に示すように必要なコンテキストパラメータと値を追加します。ファイルを編集したら、WebLogic サーバを再起動します。web.xml ファイルの値の設定方法を決定するには、次のガイドラインに従います。

リッチテキストエディタ (RichTextEditorEnabled) の値が web.xml ファイルで false に設定されていると、リッチテキスト編集は有効化されず、ボトムツールバーも有効化されずにポートレットに表示されません。手順 2 で説明しているように、Administration Console の設定をオーバーライドすることはできません。
ボトムツールバー (RichTextEditorHTMLToolBarEnabled) の値が web.xml ファイルで false に設定されており、リッチテキストエディタの値が true に設定されている場合は、リッチテキスト編集は有効化されますが、ボトムツールバーは有効化されません。そのため、ボトムツールバーはポートレットに表示されません。Administration Console でボトムツールバーの設定をオーバーライドすることはできません。
ボトムツールバーの値を true に設定し、リッチテキストエディタを false に設定している場合は、ボトムツールバーは有効化されず、リッチテキストエディタも有効化されません。Administration Console でこの設定をオーバーライドすることはできません。

コードリスト 4-2 コンテキストパラメータと値を web.xml ファイルの末尾に追加する

<context-param>
     <param-name>com.bea.apps.groupspace.RichTextEditorEnabled</param-name>
    <param-value>true</param-value>
</context-param>

<context-param>
    <param-name>com.bea.apps.groupspace.RichTextEditorHTMLToolBarEnabled
         </param-name>
    <param-value>true</param-value>
</context-param>

<context-param>
    <param-name>collaboration.RichTextEditorEnabled</param-name>
    <param-value>true</param-value>
</context-param>

コンテキストパラメータが web.xml ファイルに追加されたら、ポータル管理者は Administration Portal を使用して各ポートレットのポートレットプリファレンスを変更します。「リッチテキスト編集のポートレットプリファレンスの変更」を参照してください。

リッチテキスト編集のポートレットプリファレンスの変更

個々のポートレットのリッチテキストエディタとボトムツールバーをコントロールするには、ポートレットプリファレンスを使用します。

リッチテキスト編集とボトムツールバーのポートレットプリファレンスを変更するには、Administration Console で次の手順を実行します。

Administration Console で、[ポータル｜ポータル管理] を選択します。
ポータルリソースツリーで [ライブラリ] および [ポートレット] フォルダを展開します。
[次] または [前] をクリックして変更するポートレットを見つけ、図 4-3 に示すように選択して強調表示します。

図 4-3 変更するプリファレンスのポートレットを選択

変更するプリファレンスのポートレットを選択

ポーレットを選択したら、[ポーレットプリファレンス] をクリックします。
図 4-4 に示すように、変更するプリファレンスを見つけます。

図 4-4 [編集] をクリックして、プリファレンスを変更

[編集] をクリックして、プリファレンスを変更

GS Issues、GS GroupNotes、および GS Announcement の各ポートレットには RichTextEditorEnabled.というプリファレンスがあります。プリファレンスの設定が true に設定されていることを確認して、ポーレットがリッチテキストエディタを表示できるようにします。このプリファレンスが true 以外に設定されていると、ポーレットは情報を入力するテキストエリアを表示します。その他のポーレット (Contact のアドレス帳、メール、カレンダー、タスク、ディスカッションフォーラム) にもリッチテキストエディタを有効にできるプリファレンスがありますが、GS ポーレットとは異なる名前が付けられています。変更するポータルプリファレンスを見つけたら、[編集] をクリックします。

RichTextEditorEnabled プリファレンスの [変更可能か] チェックボックスを選択し、ユーザがこのプリファレンスを変更できるようにします。[多値か] チェックボックスは選択しません。[保存] をクリックします。

図 4-5 ポートレットのリッチテキストエディタ

ポートレットのリッチテキストエディタ

ヒント :

WebLogic Portal に付属の GS Example Community では、デフォルトでリッチテキストエディタのフォーマットツールバーは有効に、ボトムツールバーは無効になります。その他の Web プロジェクトでは、すべてのポーレットのリッチテキスト編集はデフォルトで有効ではありません。

また、プリファレンスを変更してボトムツールバーの表示をコントロールすることができます。たとえば、GS Issues の RichTextEditorHTMLToolBarEnbled プリファレンスを true に設定すると、リッチテキストエディタが使用できる場合にポートレットはボトムツールバーを表示します。このツールバーは [編集]、[HTML]、および [プレビュー] の各ボタンをコントロールします。[HTML] クリックすると、ユーザは HTML を直接テキストエリアに入力できます。図 4-6 を参照してください。

図 4-6 リッチテキストの編集が可能なポートレットのボトムツールバー

リッチテキストの編集が可能なポートレットのボトムツールバー

他のポートレットには設定できる別のプリファレンスがあります。たとえば、メールポートレットには collaboration.max.attachment.size プリファレンスがあり、ユーザが送受信できるメールの添付ファイルのサイズをコントロールします。
ポートレットプリファレンスを変更して、[保存] をクリックすると、コミュニティデスクトップのポートレットに変更が表示されます。プリファレンスの変更をライブラリレベルで行った場合は、[インスタンスへ伝播] をクリックして、このプリファレンスの伝達をこのポーレットのすべてのインスタンスに強制します。WebLogic Portal はデスクトップインスタンスのプリファレンスをすべてライブラリプリファレンスで上書きします。インスタンスへの伝播の詳細については、『ポートレット開発ガイド』を参照してください。

	作成	読み込み	更新	削除
GS Links		X		X
GS Document Library	X		X
GS Issues
GS RSS Reader		X
GroupNotes

GroupSpace ガイド