ユーザ管理ガイド

ユーザ プロファイルの作成と更新

開発者は、Workshop for WebLogic を使用して、ユーザ プロファイルの追加や編集を行う JSP タグおよびコントロールを作成することができます。ユーザ プロファイルは、ユーザ名と、ユーザに関して収集および格納される追加のプロパティから構成されます。これらのプロパティを使用すると、ポータルでユーザが行う操作をパーソナライズできます。

プロパティは、個人データ、作業関連データ、場所を表すデータ、またはユーザを論理的に分類するその他のデータで構成できます。たとえば、Workshop for WebLogic では、性別、雇用日、電子メール アドレスなどのプロパティを格納する従業員というプロパティ セットを作成できます。

プログラムによってユーザ プロファイルの作成、プロファイルのデフォルト プロパティ値の編集およびプロパティ値の暗号化を有効にするために、Workshop for WebLogic を使用する必要があります。

管理者は、プロファイルのプロパティ値を Administration Console で編集できます。詳細については、「ユーザ プロファイル プロパティの値の編集」を参照してください。

ユーザがポータルにログインするときに、ポータルはプロパティ値にアクセスし、設定したパーソナライゼーション ルールに基づいて、パーソナライズされたコンテンツ、電子メール、入力済みのフォーム、および割引にその値を適用できます。詳細については、『対話管理ガイド』を参照してください。

開発者は以下のツールを使用して、プログラムによってユーザ プロファイルのデフォルトのプロパティ値を作成および編集することができます。

この章の内容は以下のとおりです。

ユーザ プロファイルの作成

ユーザ プロファイルは、使用できるすべてのユーザ プロパティ セットからのユーザのプロパティ値の集合です。ユーザ プロファイルにある個々のメタデータが、ユーザ プロパティと呼ばれます。ユーザ プロファイル プロパティ セットは、格納するプロパティを整理し、特定の目的を持つプロパティ グループに名前を付けるための便利な方法を提供します。プロパティを作成し、パーソナライゼーション、委託管理、または訪問者の資格に関するルールの定義に使用することができます。

ユーザ プロパティは、ユーザの電話番号や電子メール アドレスなどの静的に定義されるプロパティから、ユーザの Web サイトのトラッキング情報などの動的に作成され、維持されるプロパティまで多岐にわたります。「パーソナル」というプロパティ セットには、年齢、性別、結婚歴、住所などのプロパティを含めることができます。「嗜好」という別のプロパティ セットには、趣味、好きな色、興味のあるニュースなどのプロパティを含めることができます。

Workshop for WebLogic で、ユーザ プロファイルの作成およびプロファイルのデフォルト値の編集を行います。プロファイルの値は、Workshop for WebLogic または Administration Console で編集できます。

WebLogic Portal には、共通のプロパティを持つ、CustomerProperties.usr というデフォルトのユーザ プロファイル プロパティ セットが用意されています。

この節では、次のトピックについて説明します。

ユーザ プロファイル プロパティ セットの作成

WebLogic Workshop では、ユーザ プロファイルおよびプロパティ セットを作成することができます。プロファイルのデフォルト値は、Workshop for WebLogic または Administration Console で編集できます。

ユーザ プロファイルのプロパティ セットを作成するには、以下の手順を実行します。

プロパティ セットへのプロパティの追加

「ユーザ プロファイル プロパティ セットの作成」にある手順に従ってプロパティ セットを作成したら、プロファイルにプロパティを追加してユーザ情報を取得することができます。

ユーザ プロファイルのプロパティ セットにプロパティを追加するには、以下の手順を実行します。

カスタム UUP 間の暗号化キーの転送

ユーザ データに対して複数の UUP を使用し、ポータル アプリケーションまたはドメイン全体で暗号化されたデータを共有する場合、暗号化キーを一つの UUP から別の UUP に転送する必要があります。3DES 対称アルゴリズムでは、同じキーを使用してデータの暗号化と復号化します。

プロファイル マネジャーを使用してプロファイル データを暗号化する場合、管理対象暗号化キーを別のポータル アプリケーションまたはドメインに転送する必要があります。プロファイル マネジャーが、ポータル アプリケーションのデプロイメント記述子とプランを使用して暗号化された個々のプロパティ セット用の暗号化キーを管理するので、この転送が必要です。暗号化キーを転送することにより、すべてのドメインとアプリケーションのために同じ暗号化キーを使用することが保証されます。

これは、アプリケーション用のデータを暗号化するための最良の方法であるかどうかを決定するには、「データ暗号化の計画」を参照してください。

暗号化キーを生成するには、以下のいずれかを実行します。

別のアプリケーションからユーザ プロファイル データを再使用するために、暗号化キーを転送するには、以下の手順を実行します。

プロパティおよび値の編集

Workshop for WebLogic を使用して、ユーザ プロファイルおよびプロファイルのデフォルト値を作成できます。プロファイルの値は、Workshop for WebLogic または Administration Console で編集できます。Administration Console でプロパティ セットの値を編集する手順については、「ユーザ プロファイル プロパティの値の編集」を参照してください。

この節では、次のトピックについて説明します。

プロパティ エディタでのプロパティおよび値の編集

開発者は、Workshop for WebLogic のユーザ プロファイル エディタを使用して、ユーザ プロファイルの作成およびプロファイルのプロパティの追加を行います。その後、各ユーザ プロファイルに含まれるプロパティ値およびそのデフォルト値を編集できます。

Workshop for WebLogic でプロパティおよびその値を変更するには、以下の手順を実行します。

JSP タグを使用したプロパティおよび値の編集

JSP タグのセットによって、プロパティ セット データに簡単にアクセスできます。

これらのタグの詳細については、「JSP タグの Javadoc」を参照してください。

<profile:getProperty> JSP タグは、特定のプロパティ セットのプロパティ値を取得します。<profile:setProperty> JSP タグは、セッションの現在のプロファイルまたは匿名ユーザ プロファイルのいずれかのプロパティ値を更新します。

通常は、<profile:getProfile> タグの呼び出し後に <profile:getProperty> タグを使用して、セッションが使用するプロファイルを取得します。<profile:getprofile> JSP タグは、ユーザ プロファイルおよびそのプロパティを取得します。<profile:getProperty> および <profile:setProperty> JSP を使用することで、開発者は多数のユーザのプロパティを取得し、迅速に編集することができます。<profile:getProperty> タグの使用前に <profile:getProfile> タグを使用しない場合は、匿名ユーザ プロファイルから特定のプロパティ値が取得されます。

Java クラスの詳細については、「JSP タグの Javadoc」を参照してください。

コード リスト 5-1 のコード サンプルに示されているように、ページ フローで <profile:getProfile> JSP タグを使用して、認証済みユーザ プロファイルを取得することができます。

<%@ page import="com.bea.p13n.usermgmt.SessionHelper"%>
<%@ taglib uri="http://www.bea.com/servers/p13n/tags/usermanagement"
   prefix="profile"%>
<%@ taglib uri="netui-tags-databinding.tld" prefix="netui-data"%>
<%@ taglib uri="netui-tags-html.tld" prefix="netui"%>
Profile is: [<code><%= SessionHelper.getProfile(request) %></code>]<br>
<%-- このタグは、ユーザが認証済みの場合に機能する。
<profile:getProfile profileKey="<%=request.getUserPrincipal().getName()%>"
   profileId="profile"/>
Profile is: [<code><%= profile %></code>]<br>

<%-- 通常は、JSP ではなくページ フローの中でこの処理を行う。
<netui-data:declareControl controlId="profileControl" 
   type="com.bea.p13n.controls.profile.UserProfileControl"/>
<netui-data:callControl resultId="getProfileFromRequestResult"
   controlId="profileControl" method="getProfileFromRequest">
<netui-data:methodParameter
   value="{request}"></netui-data:methodParameter>
</netui-data:callControl>
Profile is: [<code><netui:label value="
   {pageContext.getProfileFromRequestResult}"></netui:label> </code>]<br>

コード リスト 5-2 のコード サンプルに示されているように、ユーザが登録済みの場合は、セッションを参照せずにそのユーザのプロファイルを取得することができます。セッション オブジェクトへのアクセス権がない場合は、この方法が便利です。

import com.bea.p13n.usermgmt.profile.ProfileFactory;
import com.bea.p13n.usermgmt.profile.ProfileNotFoundException;
import com.bea.p13n.usermgmt.profile.ProfileWrapper;
import java.rmi.RemoteException;
public class MyHelper 
{
    public static String helperMethod(String username)
    {
        try
        {
            ProfileWrapper profile =
               ProfileFactory.getProfile(username,null);
            // ここで何らかの処理を行う
            return profile.toString();
        }
        catch (RemoteException ex)
        {
        }
        catch (ProfileNotFoundException ex)
        {
        }
        return null;
   }

匿名ユーザおよび追跡された匿名ユーザの場合は、セッションからプロファイルを取得する必要があります。匿名プロファイルには ID がありません。追跡された匿名プロファイルには ID がありますが、認証に使用できる有効なものではありません。ユーザのプロファイル タイプに応じて、安全にユーザの ID を取得する方法については、コード リスト 5-3 を参照してください。このコード サンプルでは、現在の ProfileWrapper を取得し、ラッパーに関連するユーザ名を取得します。

<%@ page import="com.bea.p13n.usermgmt.SessionHelper"%>
Profile Id is: [<code><%= SessionHelper.getUserId(request) %></code>]<br>

返された以下の値を使用して、ユーザ タイプを決定します。

コントロールを使用したプロパティおよび値の編集

開発者は、プロパティ コントロールの getProperty アクションおよび setProperty アクションを使用して、ユーザによるプロパティ セットのプロパティ値の取得、およびセッションの現在のプロファイルまたは匿名ユーザ プロファイルのいずれかのプロパティ値の更新を許可します。

プロパティ コントロールおよびそのプロパティの使用の詳細については、「Javadoc」を参照してください。

コード リスト 5-4 は、プロパティ コントロールの setProperty アクションを使用して ProfileWrapper を編集する方法を示しています。コード サンプルでは、ユーザが好みの色を設定できるようにするために、コントロールを使用してフォームを表示するページ フロー (および関連する JSP) の例を示します。この例では、ユーザ プロファイル プロパティ セットのファイルである Generalnfo.usr が data プロジェクトの \userprofiles フォルダに存在している必要があります。また、単値、制限付きタイプで、テキスト プロパティ FavoriteColor が定義されている必要があります。詳細については、Workshop for WebLogic のヘルプを参照してください。

<%@ page language="java" contentType="text/html;charset=UTF-8"%>
<%@ taglib uri="netui-tags-databinding.tld" prefix="netui-data"%>
<%@ taglib uri="netui-tags-html.tld" prefix="netui"%>
<%@ taglib uri="netui-tags-template.tld" prefix="netui-template"%>
<netui:html>
   <body>
      <netui:form action="setColor">
         <table>
            <tr valign="top">
               <td>Favorite Color:</td>
               <td>
               <netui:select dataSource="{actionForm.color}" 
                  defaultValue="{pageFlow.usersColor}"
                  optionsDataSource="{pageFlow.possibleColors}">
               </netui:select>
               </td>
            </tr>
         </table>
         <br/>&nbsp;
         <netui:button value="Set Color" type="submit"/>
     </netui:form>
   </body>
</netui.html>

ProfileWrapper オブジェクトを使用したプロパティおよび値の編集

開発者は、ProfileWrapper オブジェクトを直接呼び出すことによって、ユーザ プロファイル プロパティの値を変更することができます。詳細については、「Javadoc」を参照してください。

ユーザ プロファイルの取得

実行時の ProfileWrapper サクセサをコンフィグレーションして、ユーザが継承するユーザまたはグループ プロパティのセットを指定する必要があります。ProfileWrapper は、初期化に使用されるプロファイル ID に基づいて適切な ProfileManager セッション Bean にアクセスできる軽量オブジェクトです。ProfileManager には、getAllProfileNames メソッドと listAllProfiles メソッドがあります。listAllProfiles(int pageSize) メソッドは、すべてのユーザ プロファイルまたはグループ プロファイルを効率的に取得します。詳細については、「Javadoc」を参照してください。

プロパティ セットおよびプロパティの削除

Workshop for WebLogic を使用すると、プロパティ セットから個々のプロパティを削除したり、プロパティ セット全体を削除することができます。

この節では、次のトピックについて説明します。

プロパティの削除

プロパティ セットから個々のプロパティを削除するには、以下の手順を実行します。

プロパティ セットの削除

プロパティ セットを削除するには、以下の手順を実行します。

また、ページ フローのプロパティ コントロールで <profile:removeProperty> JSP タグまたは removeProperty アクションを使用すると、既存のプロパティまたはユーザのプロファイルを削除することができます。詳細については、「Javadoc」を参照してください。

外部ユーザ ストアからのプロパティの使用

UUP を作成して外部ユーザまたはグループ プロパティにアクセスしている場合は、これらのプロパティを使用して、パーソナライゼーション、委託管理、または訪問者の資格に関するルールを定義することができます。

外部ユーザ ストア (たとえば、openLDAP サーバ) のプロパティにアクセスするための UUP を作成後、これらの外部プロパティにアクセスするには、WebLogic Portal の JSP タグ、コントロール、または API を使用する必要があります。これらの外部プロパティは、Administration Console ではまだアクセスすることができません。

パーソナライゼーション、委託管理、または訪問者の資格に関するルールの定義にこれらのプロパティを使用する場合は、Administration Console にこれらの外部プロパティを表示する必要があります。

外部ユーザ ストアからプロパティを使用するには、以下の手順を実行します。