B OracleAS Portal Seeded Objects

B.5.1.1 Customizing the Favorites Portlet

To add links to your favorite Web pages, you customize the Favorites portlet. You can also customize the Favorites portlet to:

• Change the name of the portlet (for example, from Favorites to Sarah’s Sites).

• Choose to display the favorites by group or as a flat list.

• Choose to display the default favorites as well as your own favorites.

• Choose to display the favorites in a new browser window.

• Control how many favorites are displayed in the portlet.

To customize the Favorites portlet settings:

1. In the Favorites portlet header, click the Customize link.

2. In the Display Name field, enter a descriptive display name for the Favorites portlet. The display name is displayed in the Favorites portlet header.

3. In the Structure list, choose Hierarchy to display your favorite groups, as well as the favorites within them. You can nest your groups to two levels within the portlet, not including the root level. Choose Flat to remove group names from the portlet and display all the favorites in a list.

4. Select the Display Default Favorites check box to include the default favorites in the portlet, as well as your own favorites.

5. Select the Open Favorites In New Browser Window check box to open the favorites in a new browser window.

6. In the Display radio group, select Show All to show all your favorites in the portlet, or select Limit List To and enter a number from 0 to 99 to control how many favorites are displayed.

7. Click OK.

   Click Reset to Defaults to restore the Favorites portlet settings to the default settings. This does not delete your favorites from the Favorites portlet, it simply resets the portlet settings, such as the Display Name and Structure.

To add a favorite:

1. In the Favorites portlet header, click the Customize link.

2. Click the Add Or Edit Favorites link.

3. To add a favorite at the top level, click the Create Favorite link next to Actions. To add a favorite to a group, click the Create Favorite link next to the group.

4. In the Display Name field, enter a descriptive display name for the favorite. The display name is displayed as a link in the Favorites portlet.

5. In the URL field, enter the URL of the Web page that you are adding as a favorite.

6. In the Description field, enter a description for the favorite. The description is visible only when you are editing the favorite.

7. Click Create.

To create a favorite group:

1. In the Favorites portlet header, click the Customize link.

2. Click the Add Or Edit Favorites link.

3. To create a favorite group at the top level, click the Create Group link next to Actions. To create a favorite group under another group, click the Create Group link next to the group.

4. In the Display Name field, enter a descriptive display name for the favorite group. The display name is displayed in the Favorites portlet.

5. In the Description field, enter a description for the favorite group. The description is visible only when you are editing the favorite group.

6. Click Create.

To edit a favorite or favorite group:

1. In the Favorites portlet header, click the Customize link.

2. Click the Add Or Edit Favorites link.

3. Click the Edit link next to the favorite or favorite group that you want to edit.

4. Edit the favorite or favorite group settings as required.

5. Click OK.

To move a favorite or favorite group:

1. In the Favorites portlet header, click the Customize link.

2. Click the Add Or Edit Favorites link.

3. Click the Move link next to the favorite or favorite group that you want to move.

4. Click the Move To link next to the group under which you want to move the favorite or favorite group.

To delete a favorite or favorite group:

1. In the Favorites portlet header, click the Customize link.

2. Click the Add Or Edit Favorites link.

3. Click the Delete link next to the favorite or favorite group that you want to delete.

4. If you are deleting a favorite group, click Yes in the confirmation page. If you are deleting a favorite, the favorite is deleted immediately. You are not prompted for confirmation.

   
   

   Note: When you delete a favorite group, all the favorites and favorite groups belonging to the deleted favorite group are also deleted.

   
   

B.5.1.2 Adding Default Favorites and Favorite Groups to the Favorites Portlet

In addition to the favorites that users create themselves, page designer can create default favorites that display to all users of the Favorites portlet. Both the user added favorites and the default favorites display in the Favorites portlet.

To add a default favorite:

1. Edit the page that contains the Favorites portlet.

2. Click the Edit Defaults icon next to the Favorites portlet.

3. Click the Add Or Edit Default Favorites link.

4. To add a default favorite at the top level, click the Create Favorite link next to Actions. To add a default favorite to a group, click the Create Favorite link next to the group.

5. In the Display Name field, enter a descriptive display name for the default favorite. The display name is displayed as a link in the Favorites portlet.

6. In the URL field, enter the URL of the Web page that you are adding as the default favorite.

7. In the Description field, enter a description for the default favorite. The description is visible only when you are editing the default favorite.

8. Click Create.

To create a default favorite group:

1. Edit the page that contains the Favorites portlet.

2. Click the Edit Defaults icon next to the Favorites portlet.

3. Click the Add Or Edit Default Favorites link.

4. To create a default favorite group at the top level, click the Create Group link next to Actions. To create a default favorite group under another group, click the Create Group link next to the group.

5. In the Display Name field, enter a descriptive display name for the default favorite group. The display name is displayed in the Favorites portlet.

6. In the Description field, enter a description for the default favorite group. The description is visible only when you are editing the default favorite group.

7. Click Create.

B.5.2.1 Customizing the Recent Objects Portlet

You can customize the Recent Objects portlet to complete one or more of the following tasks:

• Change the name of the portlet (for example, from Recent Objects to Most Used).

• Control how many objects are displayed in the portlet.

• Choose which object attributes to display.

To customize the Recent Objects portlet:

1. In the Recent Objects portlet header, click the Customize link.

2. In the Banner field, enter a descriptive display name for the Recent Objects portlet. The display name is displayed in the Recent Objects portlet header.

3. In the Display radio group, select Show All to show up to 50 objects in the portlet, or select Limit List To and enter a number from 0 to 50 to explicitly control how many objects are displayed.

4. Select to appropriate Display check boxes to control what appears next to the objects in the portlet. Select:

   • Object Type to display the type of object, such as Page or Master-Detail Form.

   • Object Image to display a visual representation of the object.

   • Numbered List to place a number in sequential order to the left of each object.

5. Click OK.

   Click Reset to Defaults to restore the Recent Objects portlet settings to the default settings.

B.5.3.1 Customizing the External Applications Portlet

You can customize the External Applications portlet to complete one or more of the following tasks:

• Change the name of the portlet.

• Choose to display or hide certain applications.

• Supply your user name and password for applications so that OracleAS Portal can automatically log you in.

• Change the name of the application as it appears in the portlet.

To customize the External Applications portlet:

1. In the External Applications portlet header, click the Customize link.

2. In the Banner field, enter a descriptive display name for the External Applications portlet. The display name is displayed in the External Applications portlet header.

3. Select the appropriate Display check boxes to control which applications display in the portlet. If a check box is not selected, the associated application does not appear in the portlet.

   The portal administrator determines which applications are included in this list.

4. If you want OracleAS Portal to automatically log you into the application whenever you launch it from the External Applications portlet, click the Edit icon to enter your user name and password for the application.

   1. In the User Name/ID field, enter your user name for this application.

   2. In the Password field, enter your password for this application.

      If you ever change your password for this application, be sure to update your password on this page as well.

   3. Select the Remember My Login Information For This Application check box.

   4. Click OK.

5. To launch the application itself, click the link in the Application Name column. If necessary, fill in your user name and password, then click Login.

6. To change the name of the application as it appears in the portlet, enter the new name in the Preferred Name field.

7. Click OK.

   Click Reset to Defaults to restore the External Applications portlet settings to the default settings. Clicking Reset to Defaults returns you to your page.

B.5.4.1 Setting Up the Login Portlet

You can control the following aspects of the Login portlet:

• The name of the portlet.

• The pages to display on successful login or logout.

• Whether to display the Login portlet when users are logged on.

• Whether users can register themselves with the portal.

To set up the Login portlet:

1. Edit the page that contains the Login portlet.

2. Click the Edit Defaults icon next to the Login portlet.

3. In the Banner field, enter a descriptive display name for the Login portlet. The display name is displayed in the Login portlet header.

4. In the On Success URL field, enter the URL of the page to display when users successfully log on.

   Leave this field blank if you want to display the same page that contains the Login portlet.

5. In the On Cancel URL field, enter the URL of the page to display when users log out.

   Leave this field blank if you want to display the same page that contains the Login portlet.

6. Select the Hide Portlet check box if you do not want to display the Login portlet when users are logged on.

   If you do not select this check box, the Login portlet is displayed containing a Logout link.

7. Select the Enable Self-Registration check box if you want to allow users to register with the portal and create their own user accounts.

   1. In the Self-Registration Link Text field, enter the text for the self-registration link. This is the link that users click to register with the portal and create their own user accounts. The default is Create New Account.

   2. In the Self-Registration URL field, enter the URL of the page to display when users click the self-registration link.

      If you do not have your own custom self-registration page, leave this field blank to use the default self-registration page provided by OracleAS Portal.

8. Click OK.

B.5.5.1 Setting Up the Set Language Portlet

You can control the following aspects of the Set Language portlet:

• The name of the portlet.

• How the languages are displayed in the portlet.

• Whether users can also set their territory.

To set up the Set Language portlet:

1. Edit the page that contains the Set Language portlet.

2. Click the Edit Defaults icon next to the Set Language portlet.

3. In the Banner field, enter a descriptive display name for the Set Language portlet. The display name is displayed in the Set Language portlet header.

4. Select the Display Languages Vertically check box if you want the list of languages to display in a single vertical list. If you do not select this check box, the list of languages displays horizontally in several rows.

5. Select the Enable Territory Selection check box if you want to enable users to specify their geographical location (territory) for the portal session.

6. Click OK.

B.5.7.1 Creating a Survey

Planning out your survey in advance will allow you, for example, to pre-build all your sections before you populate them with questions. This way, sections will be available for setting up triggered redirections as you build your survey. It isn’t required that you do this, however. If you wish, you can edit your survey after all sections and all questions are in place, adding redirections to different sections at this time.

To create a survey:

1. In the Survey Builder portlet, click the Create Survey link.

2. In the Name field, enter a name for your survey. This name will display in your survey’s portlet header.

3. In the Page Group list, choose the page group to use to store text responses.

4. In the Type radio group, make sure that Survey is selected.

5. In the Participant Identity section, select the check boxes next to the information you will use to identify survey participants.

   When users take this survey, whatever information is already available in their Portal User Profile will populate automatically. Otherwise, users will be prompted to supply this information. Any information they supply may also be written to their Portal User Profile if the user requests it. The default value is Anonymous (no check boxes are selected).

6. Select the Multiple Replies check box if you plan to allow participants to take the survey more than once.

   Selecting this option means that every time users log in, their view of the survey refreshes and their original answers do not appear. If you do not allow multiple replies, until users click the Finish button to complete the survey, every time they log in their view of the survey retains all of their answers. This option allows users to go back and modify their answers as well as to leave the survey—even to log off—and continue taking it later.

7. Select the Place Survey check box if you want to automatically place the survey on a specific page.

   1. From the Page Group list, choose the page group that owns the page on which you want to place the survey.

   2. In the popup window, click Return Object next to the page on which you want to place the survey.

   You can leave the Place Survey check box cleared and the page unspecified until you are completely satisfied with the survey. You can also add the survey to any page later by adding and editing the Survey Form portlet.

8. In the End of Survey Options section, choose what will happen once the user completes the survey and clicks Finish. Choose:

   • Show Chart of Responses to display a bar chart of participant responses.

   • Show Report of Responses to display a report of participant responses.

   • Allow Editing of Responses to return to the first survey question, with the user’s answers intact, allowing the user to revise any original responses.

   • Show Nothing to close the Survey Form portlet (that is, the portlet containing the survey will no longer display on the user’s page).

9. In the Welcome message field, enter a message that will precede the first question in the survey.

10. Select the First page shows only welcome message to include the welcome message on its own page. The first question in the survey will be displayed on the next page.

11. In the Closing comments field, enter a message that will follow the last question in the survey.

12. Click Next.

13. From the Section list, choose the section in which to include the question. To create a new section, choose -- new --. If you are creating a new section:

    1. In the Section field, enter a name for the section.

    2. In the Message field, enter a message to display at the beginning of the section, before any questions.

    3. From the Copy from list, choose a section from which to copy questions.

    4. Click Finish.

14. In the Question field, enter a question. Each question can contain up to 500 characters.

15. From the Display Style list, choose the format for the response to the question. Choose from Check Box, Radio Buttons, Pull Down List, and Text. Check boxes and radio buttons will display to the left of each response. Users will click one or more of these to respond. Pull down lists will populate with whatever answers you enter in the Answer Choices field. Users will choose one or more items from this list. Text boxes are suitable for essay questions. Users will enter their answers in the text field to respond to this question.

    Text responses are stored on a page with the same name as the survey in the page group specified in the step 3 of this task.

16. Select the Allow Multiple Responses check box if you want users to be able to select more than one check box or item from the pull down list in response to this question.

17. Select the Include "Other" choice and "Please Explain" field check box if you want users to be able to respond with an answer other than those provided for this question.

    Responses entered in the Please Explain field are stored on a page with the same name as the survey in the page group specified in step 3 of this task.

18. Select the Response is optional check box if you want to allow users to finish the survey without providing an answer to the question.

19. In the Image field, enter the path and file name of an image to associate with the question.

20. In the Answer choices field, enter the allowable responses for the question. Press Enter after each choice. This field can contain up to 32,000 characters. Do not enter any values in this field if you chose Text as the Display Style for the question.

21. If you want some responses to lead the user to another section of the survey, in the Trigger section:

    1. From the This answer list, select the response that will trigger the redirection.

    2. From the Triggers section list, select the section to go to when the user provides the chosen response.

22. Click Add another question.

    When you add a question, it is listed on the left hand side of the page. You can click the Edit icon next to the question to edit the question later.

23. If you want to add another question, repeat steps 13 through 22. If you have finished entering your questions, click Next.

24. If you are happy with your survey, click Finish. If you are not, click Back to edit your questions.

B.5.7.2 Creating a Poll

Polls are straightforward lists of questions and potential responses, either multiple choice, or text. Compared with surveys, polls are much simpler. Polls are useful when your information gathering requirements are simple and do not require the identification of your respondents.

To create a poll:

1. In the Survey Builder portlet, click the Create Poll link.

2. In the Name field, enter a name for your poll. This name will display in your poll’s portlet header.

3. In the Page Group list, choose the page group to use to store text responses.

4. In the Type radio group, make sure that Poll is selected.

5. Select the Multiple Replies check box if you plan to allow participants to take the poll more than once.

   Selecting this option means that every time users log in, their view of the poll refreshes and their original answers do not appear. If you do not allow multiple replies, until users click the Finish button to complete the poll, every time they log in their view of the poll retains all of their answers. This option allows users to go back and modify their answers as well as to leave the poll—even to log off—and continue taking it later.

6. Select the Place Poll check box if you want to automatically place the poll on a specific page.

   1. From the Page Group list, choose the page group that owns the page on which you want to place the poll.

   2. In the popup window, click Return Object next to the page on which you want to place the poll.

   You can leave the Place Poll check box cleared and the page unspecified until you are completely satisfied with the poll. You can also add the poll to any page later by adding and editing the Survey Form portlet.

7. In the Finish Button Text field, enter the text that you want to appear on the poll’s Finish button.

8. In the End of Poll Options section, choose what will happen once the user completes the poll and clicks Finish. Choose:

   • Show Chart of Responses to display a bar chart of participant responses.

   • Show Report of Responses to display a report of participant responses.

   • Allow Editing of Responses to return to the first poll question, with the user’s answers intact, allowing the user to revise any original responses.

   • Show Nothing to close the Survey Form portlet (that is, the portlet containing the poll will no longer display on the user’s page).

9. In the Welcome message field, enter a message that will precede the first question in the poll.

10. Click Next.

11. In the Question field, enter a question. Each question can contain up to 500 characters.

12. From the Display Style list, choose the format for the response to the question. Choose from Check Box, Radio Buttons, Pull Down List, and Text. Check boxes and radio buttons will display to the left of each response. Users will click one or more of these to respond. Pull down lists will populate with whatever answers you enter in the Answer Choices field. Users will choose one or more items from this list. Text boxes are suitable for essay questions. Users will enter their answers in the text field to respond to this question.

    Text responses are stored on a page with the same name as the poll in the page group specified in the step 3 of this task.

13. Select the Allow Multiple Responses check box if you want users to be able to select more than one check box or item from the pull down list in response to this question.

14. Select the Include "Other" choice and "Please Explain" field check box if you want users to be able to respond with an answer other than those provided for this question.

    Responses entered in the Please Explain field are stored on a page with the same name as the poll in the page group specified in step 3 of this task.

15. Select the Response is optional check box if you want to allow users to finish the poll without providing an answer to the question.

16. In the Image field, enter the path and file name of an image to associate with the question.

17. In the Answer choices field, enter the allowable responses for the question. Press Enter after each choice. This field can contain up to 32,000 characters. Do not enter any values in this field if you chose Text as the Display Style for the question.

18. Click Add another question.

    When you add a question, it is listed on the left hand side of the page. You can click the Edit icon next to the question to edit the question later.

19. If you want to add another question, repeat steps 11 through 18. If you have finished entering your questions, click Next.

20. If you are happy with your poll, click Finish. If you are not, click Back to edit your questions.

B.5.7.3 Creating a Test

Use tests to evaluate your participants’ level of understanding of a particular subject area, and to assign scoring values to your participants’ correct responses. With the Survey Builder, you can create complex tests with multiple sections and automatic redirection based on participant responses, or simple tests comprised of lists of questions and potential answers.

Planning your test in advance will allow you, for example, to prebuild all your sections before you populate them with questions. This way, sections will be available for setting up triggered redirections as you build your test. It isn’t required that you do this, however. If you wish, you can edit your test after all sections and all questions are in place, adding redirections to different sections at this time.

To create a test:

1. In the Survey Builder portlet, click the Create Test link.

2. In the Name field, enter a name for your test. This name will display in your test’s portlet header.

3. In the Page Group list, choose the page group to use to store text responses.

4. In the Type radio group, make sure that Test is selected.

5. In the Participant Identity section, select the check boxes next to the information you will use to identify test participants.

   When users take this test, whatever information is already available in their Portal User Profile will populate automatically. Otherwise, users will be prompted to supply this information. Any information they supply may also be written to their Portal User Profile if the user requests it. The default value is Anonymous (no check boxes are selected).

6. Select the Multiple Replies check box if you plan to allow participants to take the test more than once.

   Selecting this option means that every time users log in, their view of the test refreshes and their original answers do not appear. If you do not allow multiple replies, until users click the Finish button to complete the test, every time they log in their view of the test retains all of their answers. This option allows users to go back and modify their answers as well as to leave the test—even to log off—and continue taking it later.

7. Select the Place Test check box if you want to automatically place the survey on a specific page.

   1. From the Page Group list, choose the page group that owns the page on which you want to place the test.

   2. In the popup window, click Return Object next to the page on which you want to place the test.

   You can leave the Place Test check box cleared and the page unspecified until you are completely satisfied with the test. You can also add the test to any page later by adding and editing the Survey Form portlet.

8. In the End of Test Options section, choose what will happen once the user completes the test and clicks Finish. Choose:

   • Show Chart of Responses to display a bar chart of participant responses.

   • Show Report of Responses to display a report of participant responses.

   • Allow Editing of Responses to return to the first test question, with the user’s answers intact, allowing the user to revise any original responses.

   • Show Nothing to close the Survey Form portlet (that is, the portlet containing the test will no longer display on the user’s page).

9. In the Welcome message field, enter a message that will precede the first question in the test.

10. Select the First page shows only welcome message to include the welcome message on its own page. The first question in the test will be displayed on the next page.

11. In the Closing comments field, enter a message that will follow the last question in the test.

12. Click Next.

13. From the Section list, choose the section in which to include the question. To create a new section:

    1. From the Section list, choose -- new --.

    2. In the Section field, enter a name for the section.

    3. In the Message field, enter a message to display at the beginning of the section, before any questions.

    4. From the Copy from list, choose a section from which to copy questions.

    5. Click Finish.

14. In the Question field, enter a question. Each question can contain up to 500 characters.

15. From the Display Style list, choose the format for the response to the question. Choose from Check Box, Radio Buttons, Pull Down List, and Text. Check boxes and radio buttons will display to the left of each response. Users will click one or more of these to respond. Pull down lists will populate with whatever answers you enter in the Answer Choices field. Users will choose one or more items from this list. Text boxes are suitable for essay questions. Users will enter their answers in the text field to respond to this question.

    Text responses are stored on a page with the same name as the test in the page group specified in the step 3 of this task.

16. Select the Response is optional check box if you want to allow users to finish the test without providing an answer to the question.

17. In the Image field, enter the path and file name of an image to associate with the question.

18. In the Answer choices field, enter the allowable responses for the question. Press Enter after each choice. This field can contain up to 32,000 characters. Do not enter any values in this field if you chose Text as the Display Style for the question.

19. If you want some responses to lead the user to another section of the test, in the Trigger section:

    1. From the This answer list, select the response that will trigger the redirection.

    2. From the Triggers section list, select the section to go to when the user provides the chosen response.

20. From the Correct Answer list, choose the correct answer to the question.

21. In the Scoring Weight field, assign a score for the correct value. You can enter a score for text answers too. This value will be used as the default score for a correct response when hand scoring is run.

22. Click Add another question.

    When you add a question, it is listed on the left hand side of the page. You can click the Edit icon next to the question to edit the question later.

23. If you want to add another question, repeat steps 13 through 22. If you have finished entering your questions, click Next.

24. If you are happy with your survey, click Finish. If you are not, click Back to edit your questions.

B.5.7.4 Adding a Survey, Poll, or Test to a Page

When you create or edit a survey, poll, or test, you can choose to automatically place it on a particular page. Alternatively, you can add the survey, poll, or test to any page yourself.

To add a survey, poll, or test to a page:

1. Edit the page to which you want to add the survey, poll, or text.

2. In the region where you want to add the survey, poll, or test, click the Add Portlets icon.

   If you do not see the Add Portlets icon, the region may be an item region, in which case, you cannot add portlets to this region.

3. Click the link for the Survey Form portlet.

   By default, the Survey Form portlet is located under the Survey Builder page of the Portlet Repository (which in turn is under the Portal Tools page). If you cannot find the My Notifications portlet under this page, use the Search field.

4. Click OK.

5. Next to the portlet, click the Edit Defaults icon.

6. In the Name field, enter the name of the survey, poll, or test.

7. In the Start Date field, enter the date on which to make the survey, poll, or test available to participants.

8. In the End Date field, enter the date on which the survey, poll, or test ends.

9. In the Questions per page field, enter the number of questions to appear on each page of the survey, poll, or test. Enter All to display all the questions on a single page.

10. Use the Font Face, Color, Size, A (bold), A (italic), and A (underscored) settings to determine the appearance of the different types of text in the survey. You can set different font settings for questions, instructions, answers, and identification information. You can also set the background color of the survey, poll, or test itself.

11. Click OK.