Oracle® WebCenter Framework Developer's Guide 10g (10.1.3.2.0) Part Number B31074-05 |
|
|
View PDF |
This appendix discusses basic Oracle WebCenter Wiki administration tasks. This appendix contains the following sections:
Note:
For more information on administrating wiki and other related topics, refer tohttp://yawiki.jzonic.org/page/show.jz?page=yawiki:TheIntroduction
.To access the Oracle WebCenter Wiki Administration mode, first log in using the administrator user name and password you created during the installation of Oracle WebCenter Wiki. In the upper right menu of each wiki page, you can click the Administration link to access the Administration mode. Figure E-1 shows this link.
Once you click this link, you see the Administration mode, as shown in Figure E-2.
To exit the Administration mode, click Exit Admin Mode under General.
The wiki administrator organizes the wiki pages into domains, then can create menus to enable easy access to pages within each domain. This section discusses basic domain and menu administration tasks.
As a wiki administrator, you create, edit, or delete the domains that will contain the pages the wiki users then create, edit, or delete. In Oracle WebCenter Wiki, a domain is the highest level of categorization and all wiki pages must belong to a domain.To create a new domain, in the Administration mode, under General, click Domains.
Figure E-3 Administration Page of the Wiki
To create a new domain as shown in Figure E-3, click Add a new domain. Enter a domain name, a description, and a name for your new start page, then click Save, as shown in Figure E-4.
Tip:
When naming your page, ensure you adhere to the wiki markup standards, as explained in Table 6-2 in Chapter 6, "Integrating Oracle WebCenter Wiki".The new domain displays on the Administer domains page as shown in Figure E-5.
Return to the wiki home page by clicking Exit Admin Mode in the navigation bar. If your new start page does not automatically display, click the All Domains link in the upper left corner to view the existing domains. You can then click the new page in your new domain, for example My Wiki. Once you have created a new page, you can edit it using the Edit tab.
As an administrator, you can create a single menu for each domain, then modify them. The following is an example of how you can modify the existing menu in the domain.
First, in the menu, click the Edit this menu link, as shown in Figure E-6.
When you click the edit link, you can edit the menu the same way you edit a page, using the Edit page text box as shown in Figure E-7.
The menu consists of menu topics. The menu topics display as headers of every block of menu items. For example, in the owc_wiki domain in Oracle WebCenter Wiki, General is menu topic and All Pages is a menu item. The topics display in the order you create them. Within each topic, you can define menu items, which can be links to wiki pages or links to targets external to the wiki. When you create a menu item, you must specify a name and either a wiki page name or a URL. The name displays in the menu.
Note:
After you create a menu, it is good practice to change the mode to only administrators are allowed to edit (from the Mode drop-down list, select this option). Although wiki automatically removes the Edit this menu link from the menu if the registered user is not administrator, users may accidentally edit the menu page.As the administrator, you can configure the locking and unlocking of wiki pages. Every time a user edits a wiki page, the page is locked for a specified time period for that particular user before other users can modify that page. As the administrator, you can configure the time period during which only the current user can modify the page. To specify the time period (in minutes), click the Configuration link under General in the administration menu, then enter a time in the Time in minutes to lock a page field. Figure E-8 shows this page.
You can also unlock these pages by clicking the Locked Pages link under the General category. Here, you can view a list of all the locked pages and unlock a page by clicking the remove lock link next to the desired page. Figure E-9 shows this page.
Templates enable you to set up a framework for users when they create pages. You can create new user interface templates as well as edit or delete existing ones. To access the templates, in the Administration mode, under General, click Templates. Use the links next to an existing template name to modify it. Or, click Add new template to create a new template (Figure E-10).When you name, edit, and create a template, use the wiki markup language described in Section 6.3.3, "Wiki Markup". Template names should follow the same convention as page names.
After you create a new template, users can choose to use this new template when creating a page (Figure E-11).
Figure E-11 Creating a New Page with a Template
You can apply themes to change the look and feel of your wiki. To change the theme, in the Administration mode, under General, click Configuration. Choose a different theme from the Theme drop-down list.
Exit the Administration mode to see your changes take effect.
The monitoring log file is located in OC4J_HOME
/bin/owc_wiki.log
. To change the log level, modify the jlo_logging.xml
file located here:
ORACLE_HOME/j2ee/home/owc_wiki/
You can change the targets of the loggers in this file. The following targets are currently supported: trace
, info
, debug
, warn
, error
, and fatal
. You can also use two special targets: off
(to switch of all the targets) or all
(to switch on all the targets). For more information on the jLo logger, see http://jlo.jzonic.org/GettingStarted.html
.
Note:
You can also change the location of the log file by using the jLo handlers. For more information, seehttp://jlo.jzonic.org/AllHandlers.html
.For additional troubleshooting information, refer to Appendix G, "Troubleshooting WebCenter Applications".
You can back up wiki content by using the file system. To do so, make a copy of the following folder:
OC4J_HOME/applications/application_name/owc_wiki/pages
You can restore the content by overwriting this folder with the back-up copy of the folder.
Oracle WebCenter Wiki enables you to export a wiki domain as static HTML files. You can use the wiki as a simple content management system (CMS) on a local computer, then export the content and upload the HTML files to a Web server.
When you export the contents of your domain, Oracle WebCenter Wiki replaces the wiki links with the corresponding HTML filename. The wiki renames all start pages in your domain index.html
.
Note:
While you can export plain HTML content, you cannot currently export attachments or images.While your domain displays, access the Administration mode. In the navigation bar, under Domain related, click Export Domain. If you do not see this option and you are logged in as an administrator, you may need to add this specific permission. To do so, under User Management, click Roles. Then, edit the ADMIN role and add the ExportDomain permission. For more information, refer to Section E.10, "Permissions".
On the Export domain page, you can update the options described in Table E-1. After you have chosen the desired options, click export domain.
Table E-1 Export Domain Options
Option | Action |
---|---|
export file |
Choose a template from this drop-down list. This list contains the velocity templates that are located in the owc_wiki/export directory. Oracle WebCenter Wiki uses this template when rendering each static HTML file for this domain. |
css file |
Choose a CSS file from this drop-down list that Oracle WebCenter Wiki will export into the same directory as the static HTML files. These CSS files are located in the same directory as the templates. |
The directory |
Type the directory path where you want the HTML and CSS files to be exported. |
You can block Edit access to the wiki from a certain IP address. To do so, under General, click Manage Blacklist (Figure E-13). Enter the IP address you wish to block, then click Save. The IP address you have blocked displays in the Blacklist.
You can set permissions for the two roles user
and admin
for the wiki operations from the Administration mode. In the navigation bar, under User Management, click Roles. Under the role you want to modify, click edit. For example, under the USER role, click edit to view the page in Figure E-14.
By default, only registered users can access pages in the Oracle WebCenter Wiki. However, you can also enable anonymous access so that users can view pages without logging in. To do so, in the Administration mode, under General, click Settings. Next to Is this owc_wiki installation only available for registered users, choose NO from the drop-down list (Figure E-15), then click the save button.
In the Administration mode, you can configure the following options:
The name of the file where the last recent updates are stored
The default attachment size in kilobytes (KB)
The default domain
The supported attachment types
The default wiki page
The maximum number of LRU pages stored
You can find these options and others by choosing Configuration under General, as shown in Figure E-16.