51.94 PASSWORD_FIRST_USE_OCCURREDファンクション

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

このファンクションは、前述のイベントのいずれかが実行されてから、アカウントのパスワードが変更されていない場合は、FALSEを戻します。

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

構文

APEX_UTIL.PASSWORD_FIRST_USE_OCCURRED (
    p_user_name     IN VARCHAR2 )
RETURN BOOLEAN;

パラメータ

表51-67 PASSWORD_FIRST_USE_OCCURREDのパラメータ

パラメータ 説明
p_user_name ユーザー・アカウントのユーザー名

次の例では、現在のワークスペースのAPEXユーザー・アカウント(ワークスペース管理者、開発者またはエンド・ユーザー)のパスワードが、アカウント作成中にパスワードが初期設定された後にユーザーが初めてログインしたときにユーザーによって変更されたか、または前述のいずれかのパスワード・リセット操作によって変更されたかをチェックします。これは、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;