Edit D:\app\Administrator\product\11.2.0\dbhome_1\apex\images\doc\AEADM\aadm_user_pref.htm
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> <title>Managing User Preferences</title> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 5.1" /> <meta name="date" content="2009-04-14T17:6:25Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Managing User Preferences" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="E12512-01" /> <link rel="copyright" href="../dcommon/html/cpyr.htm" title="Copyright" type="text/html" /> <link rel="stylesheet" href="../dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> <link rel="contents" href="toc.htm" title="Contents" type="text/html" /> <link rel="up" href="preface.htm" title="Home" type="text/html" /> <link rel="up" href="wrkspc.htm" title="Workspace and Application A..." type="text/html" /> <link rel="up" href="aadm_mg_sessions.htm" title="Managing Session State and ..." type="text/html" /> <link rel="up" href="aadm_user_pref.htm" title="Managing User Preferences" type="text/html" /> <link rel="prev" href="aadm_purge_session.htm" title="Previous" type="text/html" /> <link rel="next" href="aadmn_mg_cache.htm" title="Next" type="text/html" /> </head> <body> <p id="BREADCRUMBING"><a href="preface.htm" title="Home">Home</a> > <a href="wrkspc.htm" title="Workspace and Application A...">Workspace and Application A...</a> > <a href="aadm_mg_sessions.htm" title="Managing Session State and ...">Managing Session State and ...</a> > Managing User Preferences</p> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> <col width="86%" /> <col width="*" /> <tr valign="bottom"> <td align="left"></td> <td align="center"><a href="aadm_purge_session.htm"><img src="../dcommon/gifs/leftnav.gif" alt="Previous" /><br /> <span class="icon">Previous</span></a> </td> <td align="center"><a href="aadmn_mg_cache.htm"><img src="../dcommon/gifs/rightnav.gif" alt="Next" /><br /> <span class="icon">Next</span></a></td> </tr> </table> <p><a id="BABHFEFD" name="BABHFEFD"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1><a name="AEADM116" id="AEADM116"></a>Managing User Preferences</h1> <p>You can use preferences to store values for a specific Application Express user across distinct sessions. Once set, these preferences can be removed programmatically or manually. You can set user preferences by creating a page process, by the calculation of a preference Item Source Value, or programmatically by using a PL/SQL API.</p> <a id="sthref46" name="sthref46"></a> <p class="subhead2">Topics:</p> <ul> <li> <p><a href="#BEJIEGFH">Viewing and Resetting Preferences for the Current User</a></p> </li> <li> <p><a href="#BABCFIAC">Viewing Preferences by User</a></p> </li> <li> <p><a href="#BABJADGJ">Setting User Preferences</a></p> </li> <li> <p><a href="#CHDJIFAC">Removing User Preferences Programmatically</a></p> </li> <li> <p><a href="#BABHHGBI">Resetting User Preferences Using a Page Process</a></p> </li> <li> <p><a href="#CHDBBHGA">Purging Preferences for a Specific User</a></p> </li> </ul> <a id="BEJIEGFH" name="BEJIEGFH"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="AEADM117" id="AEADM117"></a>Viewing and Resetting <a id="sthref47" name="sthref47"></a>Preferences for the Current User</h2> <p>To manage user preferences for the current user:</p> <ol> <li> <p>Navigate to the Workspace home page.</p> </li> <li> <p>Click <span class="bold">Manage Services</span> on the Administration list.</p> <p>The Manage Services page appears.</p> </li> <li> <p>Under Session State, click <span class="bold">Manage Preferences</span>.</p> <p>The Manage Preferences page appears.</p> </li> <li> <p>To view preference information about the current user, click <span class="bold">Report Current User Preferences</span>.</p> <p>The Current User Preferences page appears.</p> </li> <li> <p>To view and reset preferences for the current user, click <span class="bold">Purge Preferences for Current User</span>. On the Purge Preferences page, click the appropriate button:</p> <ul> <li> <p><span class="bold">Reset Preferences</span></p> </li> <li> <p><span class="bold">View Preferences</span></p> </li> </ul> </li> </ol> </div> <!-- class="sect3" --> <a id="BABCFIAC" name="BABCFIAC"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="AEADM118" id="AEADM118"></a>Viewing Preferences by <a id="sthref48" name="sthref48"></a>User</h2> <p>To view the preferences for specific users:</p> <ol> <li> <p>Navigate to the Workspace home page.</p> </li> <li> <p>Click <span class="bold">Manage Services</span> on the Administration list.</p> <p>The Manage Services page appears.</p> </li> <li> <p>Under Session State, click <span class="bold">Manage Preferences</span>.</p> <p>The Manage Preferences page appears.</p> </li> <li> <p>To view preference information about a specific user, click <span class="bold">Preferences by User</span>.</p> <p>Use the search bar at the top of the page to narrow the display.</p> </li> <li> <p>To view and reset preferences for the current user:</p> <ol> <li> <p>Click <span class="bold">Purge Preferences by User</span>.</p> </li> <li> <p>Select a user from the list and click <span class="bold">Report</span>.</p> <p>A report appears.</p> </li> <li> <p>To purge user preferences, click <span class="bold">Purge User Preferences</span>.</p> </li> </ol> </li> </ol> </div> <!-- class="sect3" --> <a id="BABJADGJ" name="BABJADGJ"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="AEADM119" id="AEADM119"></a>Setting User <a id="sthref49" name="sthref49"></a>Preferences</h2> <p>You can set user preferences within your application through the creation of a page process, by creating a preference item, or programmatically.</p> <a id="sthref50" name="sthref50"></a> <p class="subhead2">Topics:</p> <ul> <li> <p><a href="#BABGIDAJ">Setting User Preferences Using a Page Process</a></p> </li> <li> <p><a href="#BABBEDHA">Setting the Source of an Item Based on a User Preference</a></p> </li> <li> <p><a href="#BABFFEFA">Setting User Preferences Programmatically</a></p> </li> </ul> <a id="BABGIDAJ" name="BABGIDAJ"></a> <div class="sect4"><!-- infolevel="all" infotype="General" --> <h3><a name="AEADM120" id="AEADM120"></a>Setting User Preferences Using a Page Process</h3> <p>To set user preference values by creating a page process:</p> <ol> <li> <p>Navigate to the appropriate Page Definition. See "Accessing a Page Definition" in <a href="../bldr_goto_pgdef.htm"><span class="italic">Oracle Application Express Application Builder User’s Guide</span></a>.</p> </li> <li> <p>Under Processes, click the <span class="bold">Create</span> icon.</p> <p>The Create Page Process Wizard appears.</p> </li> <li> <p>For the process category, select <span class="bold">Session State</span>.</p> </li> <li> <p>For the process type, select one of the following:</p> <ul> <li> <p><span class="bold">Set Preference to value of item</span></p> </li> <li> <p><span class="bold">Set Preference to value of item if item is not null</span></p> </li> </ul> </li> <li> <p>Specify a process name, sequence, and processing point.</p> </li> <li> <p>Specify the preference value in the field provided using the format:</p> <pre xml:space="preserve" class="oac_no_warn"> PreferenceName:Item </pre></li> <li> <p>Click <span class="bold">Page Items</span> to see a list of available items.</p> </li> <li> <p>Click <span class="bold">Create Process</span>.</p> </li> </ol> </div> <!-- class="sect4" --> <a id="BABBEDHA" name="BABBEDHA"></a> <div class="sect4"><!-- infolevel="all" infotype="General" --> <h3><a name="AEADM121" id="AEADM121"></a>Setting the Source of an Item Based on a User Preference</h3> <p>You can set the source of an item based on a user preference by defining the item source type as Preference.</p> <p>To define the source of item based on a user preference:</p> <ol> <li> <p>Navigate to the appropriate Page Definition. See "Accessing a Page Definition" in <a href="../bldr_goto_pgdef.htm"><span class="italic">Oracle Application Express Application Builder User’s Guide</span></a>.</p> </li> <li> <p>Under Items, click the <span class="bold">Create</span> icon.</p> <p>The Create Item Wizard appears.</p> </li> <li> <p>For the item type, select <span class="bold">Hidden</span>.</p> </li> <li> <p>Specify the Item Name, sequence, and region.</p> </li> <li> <p>From the Item Source list, select <span class="bold">Preference</span>.</p> </li> <li> <p>In Item Source Value, enter the name of the preference.</p> </li> <li> <p>Click <span class="bold">Create Item</span>.</p> </li> </ol> </div> <!-- class="sect4" --> <a id="BABFFEFA" name="BABFFEFA"></a> <div class="sect4"><!-- infolevel="all" infotype="General" --> <h3><a name="AEADM122" id="AEADM122"></a>Setting User Preferences Programmatically</h3> <p>To set or reference user preferences programmatically, you must use a PL/SQL API. User-level caching is available programmatically. You can use the <code>SET_PREFERENCE</code> procedure to set a user level preference called <code>NAMED_PREFERENCE</code>. For example:</p> <pre xml:space="preserve" class="oac_no_warn"> APEX_UTIL.SET_PREFERENCE( p_preference=>'NAMED_PREFERENCE', p_value =>:ITEM_NAME); </pre> <p>You can reference the value of a user preference using the function <code>GET_PREFERENCE</code>. For example:</p> <pre xml:space="preserve" class="oac_no_warn"> NVL(APEX_UTIL.GET_PREFERENCE('NAMED_PREFERENCE'),15) </pre> <p>In the previous example, the preference would default to the value 15 if the preference contained no value.</p> <div align="center"> <div class="inftblnotealso"><br /> <table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p class="notep1">See Also:</p> "<a href="http://www.oracle.com/pls/db112/lookup?id=AEAPI142">GET_PREFERENCE Function</a> and "<a href="http://www.oracle.com/pls/db112/lookup?id=AEAPI180">SET_PREFERENCE Procedure</a> in <span class="italic">Oracle Application Express Application Builder User’s Guide</span></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblnotealso" --></div> </div> <!-- class="sect4" --></div> <!-- class="sect3" --> <a id="CHDJIFAC" name="CHDJIFAC"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="AEADM123" id="AEADM123"></a>Removing User <a id="sthref51" name="sthref51"></a>Preferences Programmatically</h2> <p>To remove user preferences programmatically, you must use a PL/SQL API. You can use the <code>REMOVE_PREFERENCE</code> procedure to remove a user level preference called <code>NAMED_PREFERENCE</code>. For example:</p> <pre xml:space="preserve" class="oac_no_warn"> APEX_UTIL.REMOVE_PREFERENCE( p_preference=>'NAMED_PREFERENCE'); </pre></div> <!-- class="sect3" --> <a id="BABHHGBI" name="BABHHGBI"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="AEADM124" id="AEADM124"></a>Resetting User Preferences Using a Page <a id="sthref52" name="sthref52"></a>Process</h2> <p>You can reset user preferences by creating a page process and selecting the Reset Preferences process type.</p> <p>To reset user preferences using a page process:</p> <ol> <li> <p>Navigate to the appropriate Page Definition. See "Accessing a Page Definition" in <a href="../bldr_goto_pgdef.htm"><span class="italic">Oracle Application Express Application Builder User’s Guide</span></a>.</p> </li> <li> <p>Under Processes, click the <span class="bold">Create</span> icon.</p> <p>The Create Page Process Wizard appears.</p> </li> <li> <p>For the process category, select Session State.</p> </li> <li> <p>From Type, select <span class="bold">Reset Preferences</span>.</p> </li> <li> <p>Specify a process name, sequence, and process point.</p> </li> <li> <p>Follow the on-screen instructions.</p> </li> </ol> </div> <!-- class="sect3" --> <a id="CHDBBHGA" name="CHDBBHGA"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="AEADM125" id="AEADM125"></a>Purging Preferences for a Specific <a id="sthref53" name="sthref53"></a><a id="sthref54" name="sthref54"></a>User</h2> <p>You can purge preferences for a specific user on the Purge Preferences page.</p> <p>To purge preferences for a specific user:</p> <ol> <li> <p>Navigate to the Workspace home page.</p> </li> <li> <p>Click <span class="bold">Manage Services</span> on the Administration list.</p> <p>The Manage Services page appears.</p> </li> <li> <p>Under Session State, click <span class="bold">Manage Preferences</span>.</p> </li> <li> <p>Click <span class="bold">Purge preferences by User</span>.</p> <p>The Purge Preferences page appears.</p> </li> <li> <p>Select a specific user and click <span class="bold">Report</span>.</p> <p>A report appears at the bottom of the page.</p> </li> <li> <p>To purge the displayed user preferences, click <span class="bold">Purge User Preferences</span>.</p> </li> </ol> </div> <!-- class="sect3" --></div> <!-- class="sect2" --> <!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> <col width="86%" /> <col width="*" /> <tr> <td align="left"><span class="copyrightlogo">Copyright © 2003, 2009, Oracle and/or its affiliates. All rights reserved.</span><br /> <a href="../dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> <td align="center"><a href="aadm_purge_session.htm"><img src="../dcommon/gifs/leftnav.gif" alt="Previous" /><br /> <span class="icon">Previous</span></a> </td> <td align="center"><a href="aadmn_mg_cache.htm"><img src="../dcommon/gifs/rightnav.gif" alt="Next" /><br /> <span class="icon">Next</span></a></td> </tr> </table> </div> <!-- class="footer" --> </body> </html>
Ms-Dos/Windows
Unix
Write backup
jsp File Browser version 1.2 by
www.vonloesch.de