36.90 PASSWORD_FIRST_USE_OCCURREDファンクション

アカウントを作成したか、Oracle Application Express管理者がパスワードのリセット操作を実行してアカウント保持者に新しいパスワードを電子メールで送信したか、あるいはユーザーがパスワードのリセット操作を開始した後に、アカウントのパスワードが変更された場合は、TRUEを戻します。このファンクションは、前述のイベントのいずれかが実行されてから、アカウントのパスワードが変更されていない場合は、FALSEを戻します。

このファンクションは、すべての認証済ユーザーによってページ・リクエストのコンテキストで実行される場合があります。

構文

APEX_UTIL.PASSWORD_FIRST_USE_OCCURRED (
    p_user_name IN VARCHAR2)
RETURN BOOLEAN;

パラメータ

表36-74 PASSWORD_FIRST_USE_OCCURREDのパラメータ

パラメータ 説明

p_user_name

ユーザー・アカウントのユーザー名

次の例に、PASSWORD_FIRST_USE_OCCURREDファンクションを使用する方法を示します。このファンクションを使用して、現行のワークスペースのApplication Expressユーザー・アカウント(ワークスペース管理者、開発者またはエンド・ユーザー)のパスワードが、アカウント作成中にパスワードが最初に設定された後に最初のログイン時にユーザーによって変更されたか、または前述のパスワードのリセット操作の1つによって変更されたかをチェックします。これは、CHANGE_PASSWORD_ON_FIRST_USE属性が「はい」に設定されているアカウントでのみ有効です。

BEGIN
    FOR c1 IN (SELECT user_name from apex_users) LOOP
        IF APEX_UTIL.PASSWORD_FIRST_USE_OCCURRED(p_user_name => c1.user_name) THEN
            htp.p('User:'||c1.user_name||' has logged in and updated the password.');
        END IF;
    END LOOP;
END;