| Oracle® HTML DB User's Guide Release 1.6 Part Number B14303-02 |
|
|
View PDF |
| Oracle® HTML DB User's Guide Release 1.6 Part Number B14303-02 |
|
|
View PDF |
In the Oracle HTML DB development environment, developers log in to a shared work area called a workspace. Users are divided into two primary roles: developer and workspace administrator.
Developers can create and edit applications as well as view developer activity, session state, workspace activity, application, and schema reports. Workspace administrators additionally can create and edit user accounts, manage groups, manage development services. This section describes how to access many of these reports and perform Workspace administrator tasks.
This section contains the following topics:
In an Oracle HTML DB development environment there are two different administrator roles:
A Workspace administrator uses the Workspace Administration list, located on the Workspace home page, to manage their workspace. In contrast, an Oracle HTML DB administrator is a superuser that manages the entire hosted instance. In order to become a Workspace administrator, an existing administrator must give the developer administrator privileges on the Edit User Page.
See Also:
"Managing an Oracle HTML DB Hosted Service" for more information administering a workspace as an Oracle HTML DB administratorThe Workspace Administration list displays on right side of the Workspace home page. Both developers and workspace administrators have access to the following links:
Change Password links to a page where users can change their workspace password.
Manage Workspace links to the Manage Workspace page. Users can click the icons on this page to view the Developer Activity Log, access tools and reports for managing sessions state, view workspace activity reports as well as view application and schema reports
About HTML DB links to an About page. The About page lists basic product information including the product version, schema compatibility, application owner, workspace information, current user name, language preference, and database version.
Review Demonstration Applications links to the Demonstration Applications page. Demonstration Applications contains links to sample applications that install with Oracle HTML DB. Users can install and run these demonstration applications to learn more about the different types of functionality you can include in Oracle HTML DB applications.
Additionally, workspace administrators have access to the Manage Users and Manage Service links.
See Also:
"Creating New User Accounts" and "Editing Existing User Accounts" for more information on specifying a developer as an administrator
"Managing an Oracle HTML DB Hosted Service" for more information administering a workspace as an Oracle HTML DB administrator
All users can change their password using the Change Password page.
To change your password:
Navigate to the Workspace home page.
From the Workspace Administration list, select Change Password.
Type a new password in the Password field and then retype the password in the Confirm Password field.
Click Apply Changes.
Note:
All users (developers and administrators) can use the Change Password link on the Oracle HTML DB home page to reset their password.See Also:
"Changing a User Password"Both developers and workspace administrators can monitor workspace utilization and user activity by selecting reports on the Monitor page. To view counts of application changes by developer users can access the Developer Activity Log.
This section contains the following topics:
The Monitor page displays links to a variety of page and application reports, including top views, page view statistics, top application changes, and application change statistics.
To access the Monitor page:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Workspace Reporting, click Monitor Activity.
The Monitor page is divided into the following sections:
Top Views
Page View Statistics
Top Changes
Application Change Statistics
Select a report to review
The Developer Activity Log displays counts of application changes by developer, by day, and application.
To view Developer Activity Log:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Logs.
Click Monitor Developer Activity Log.
Specify a time frame, the appropriate number of rows, and click Go.
By default, the Developer Activity by Developer by Day report appears.
To view additional details, select a user ID.
To view additional activity reports, click one of the following buttons at the top of the page:
Application Changes by Month
Application Changes by Day Report
Application Changes by Day Link Chart
The Developer Activity Log track changes to applications within the current workspace. Log entries older then one month are automatically deleted. You can manually purge developer logs and the External Count Clicks log on the Log files page.
See Also:
"Managing Logs" for more information deleting log files as an Oracle HTML DB administratorTo purge the Developer Activity Log:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Logs.
Click Purge Dev. Log.
The External Clicks Log counts clicks from an Oracle HTML DB application to an external site. You can implement this functionality using COUNT_CLICK procedure.
See Also:
"COUNT_CLICK Procedure"To purge the External Clicks Log:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Logs.
Click Purge Click Log.
Application and schema reports are available to all users. Application Reports offer useful information about the size, scope, and content of the applications being developed in a workspace. Schema Reports offer summaries of database privileges by schema as well as a list of all database schemas available in the current workspace.
To view application and schema reports:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
The Administration Services page appears.
From the Tasks list on the right side of the page, select Application Reports.
The Administrative Reports page appears.
Select a report to review.
A session is a logical construct that establishes persistence (or stateful behavior) across page views. Each session is assigned a unique ID which the HTML DB engine uses to store and retrieve an application's working set of data (or session state) before and after each page view. Sessions persist in the database until purged by an administrator.
Workspace administrators can purge session state or user preferences within their workspace on the Session State Management page. Developers can purge their session state and user preferences for the current session.
Topics in this section include:
See Also:
Workspace administrators and developers can use the Session State Management page to manage session state and user preferences for the current session.
To manage session state and user preferences for the current session:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Session State.
When the Session State Management page appears, click Report, with an option to purge your current session.
Under Session State you can:
Reset the session state for the current session by clicking Purge Session State.
View information about the current session by clicking View Session State.
Under User Preferences, you can:
View preferences for the current user, by clicking View Preferences.
Reset user preferences for the current user by clicking Reset Preferences.
See Also:
"Viewing Session State"Sessions are used to maintain user state. Workspace administrators can purge existing sessions by age.
To purge existing session by age:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Session State.
On the Session State Management page, select Purge existing sessions by age.
Make a selection from the Sessions older than list.
Click one of the following buttons:
Report Session. Generates a report detailing the total number of sessions for the workspace, the number of users, and the number of old sessions.
Purge Sessions. Purges existing sessions by age.
See Also:
"Viewing Session State"Workspace administrators can determine whether to remove existing sessions by first reviewing session details on the Session State page.
To view session details prior to removing session state:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Session State.
On the Session State Management page, select Report recent sessions with drilldown to session details.
Select a session ID.
When Session Information appears, click either:
Remove State
Remove Session
Workspace administrators view preferences for a specific user on the Preferences Report.
To view the Preferences Report:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Session State.
On the Session State Management page, select Report preferences for users.
The Preferences Report page appears.
To search for a specific user, enter a user name in the User field and click Go.
Workspace administrators purge preferences for a specific user on the Purge Preferences page.
To purge preferences for a specific user:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Session State.
On the Session State Management page, select Purge preferences for a selected user.
The Purge Preferences page appears.
Select a specific user in the User field and click Report.
The User Preferences for the selected user appear.
To purge the displayed user preferences, click Purge User Preferences.
Workspace administrators can create new user accounts, manage existing user accounts, and change user passwords. User accounts are particularly useful if you are using HTML DB Authentication. HTML DB Authentication checks the username and password against the Oracle HTML DB account repository. The Oracle HTML DB account repository contains account information that developers and administrators when logging in to Oracle HTML DB applications.
Topics in this section include:
See Also:
"About HTML DB Account Credentials" for more information on implementing HTML DB AuthenticationWorkspace administrators create new user accounts on the Create User page.
To create a new user account:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Users.
The Manage Users page appears.
Under Manage Users, click Create New User.
The Create User page appears.
Under User Identification, enter the appropriate information. Required fields are marked with a red asterisk (*).
Under Developer Privileges, specify whether the user is a developer or an administrator.
User is a developer - These users can create and edit applications as well as view developer activity, session state, workspace activity, application, and schema reports.
User is an administrator - Workspace administrators additionally can create and edit user accounts, manage groups, alter passwords of users within the same workspace, and manage development services.
Under User Groups, select an optional user group.
You can use groups to restrict access to various parts of an application. Groups are primarily useful when using HTML DB Authentication.
Click Create User or Create and Create Another.
Workspace administrators edit existing user accounts on the Edit User page.
To edit an existing a user account:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Users.
The Manage Users page appears.
Under Manage Users, click Edit Users.
The Edit Users page appears. On the Edit Users page, you can:
Create a new user by clicking Create
Search for an existing user by entering a search condition in the Find field and clicking Go
To edit a user account, click the Edit icon.
The Edit User page appears.
Under Developer Privileges, specify whether the user is a developer or an administrator.
Developers having administrator privilege have access to all tools and reports available on the Workspace Administration list. These users can also alter passwords of users within the same workspace.
Under User Groups, select an optional user group.
You can use groups to restrict access to various parts of an application. Groups are primarily useful when using HTML DB Authentication.
Follow the on-screen instructions.
Workspace administrators can change the password of any user in their workspace.
To change a user password:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Users.
The Manage Users page appears.
Under Manage Users, click Edit Users.
The Edit Users page appears.
Locate the appropriate user and click the Edit icon. You can search for an existing user by entering a search condition in the Find field and clicking Go.
The Edit User page appears.
Scroll down to Password, type a new password in the Password and Confirm Password fields, and click Apply Changes.
Workspace administrators can create groups to restrict access to various parts of an application. Keep in mind, however, that groups are not portable over different authentication schemes. Groups are primarily useful when using HTML DB Authentication.
Topics in this section include:
See Also:
"About HTML DB Account Credentials" for more information on implementing HTML DB AuthenticationNavigate to the Workspace home page.
From the Workspace Administration list, select Manage Users.
Under Manage Groups, click Create New Group.
The Create User Groups page appears.
Specify a group name, description, and click Create Group.
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Users.
Under Manage Groups, click Edit Groups.
The Create User Groups page appears.
Click the Edit icon next to the appropriate group.
Make the appropriate change and click Apply Changes.
To view a report of user group assignments:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Users.
Under Manage Groups, click Report User Group Assignments.
The User Groups Assignments Report appears.
Navigate to the Edit User page:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Users.
Under Manage Users, click Edit Users.
The Edit Users page appears.
To edit a user account, click the Edit icon.
The Edit User page appears.
To add a user to a group:
Scroll down to User Groups.
Select a group from the Groups list.
To remove a user to a group:
Scroll down to User Groups.
Deselect the selected group in the Groups list.
Workspace administrators can use the Provisioning Services section of the Administration Services page to:
View information and reports describing the current workspace
Submit a request to the Oracle HTML DB administrator for a new database schema, additional storage, or to terminate workspace service
Topics in this section include:
Workspace administrators can view current workspace status on the Manage Development Services page.
To view current workspace status:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Manage Service.
The Manage Development Services page appears.
Select Report Utilization.
Follow the on-screen instructions.
To submit a request to the Oracle HTML DB administrator for a new database schema:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Manage Service.
The Manage Development Services page appears.
Select Request Schema.
Follow the on-screen instructions.
To submit a request to the Oracle HTML DB administrator for additional storage space for your workspace:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Manage Service.
The Manage Development Services page appears.
Select Request Storage.
Follow the on-screen instructions.
To submit a request to the Oracle HTML DB administrator to terminate workspace service:
Navigate to the Workspace home page.
From the Workspace Administration list, select Manage Workspace.
Under Administration Services, click Manage Service.
The Manage Development Services page appears.
Select Terminate Service.
Follow the on-screen instructions and click Request Termination.
