> developer > dnu > courses > portal overview page 20

Novell Portal Services Overview and Gadget Development

April 2003

DeveloperNet University Course

Reader Rating    from ratings

Lab 2 - Pages

Pages can be assigned on a per object basis (U/G/C or Portal Group).

• One object can have multiple Pages.
  
  
• Controls which gadgets are assigned.
  
  
• Controls the layout of the assigned gadgets.
  
  
• Choose number of columns to use--One, two, or three
  
  
• You must "Refresh the Portal" after editing the "public" user.
  
  

Exercise 1: Create a "Home" Page for your Container (e.g. o=novell)

1. Log in as admin.
   
   
2. Under the "Portal Administration" Page click on the Administer The Portal button.
   
   
3. Select Pages.
   
   
4. Ensure "[Create New Top Level Page]" is selected and click on Create.
   
   
5. Enter the Page Name and optional Description.
   
   
6. Click the Create button.
   
   
7. Select OK.
   
   
8. The Page will now appear in the menu.
   
   
9. Click the Assign button.
   
   
10. Click the Add button.
    
    
11. Select Containers in the "Search for:" pull down and click OK.
    
    
12. Click on Search (searching for "containers"). (This will return a list of all your containers.)
    
    
13. Select your container (where the users objects reside).
    
    
14. Click the Assign button at the bottom of the page.
    
    
15. Click the Close button.
    
    

Exit the portal administration gadget and log out. Log in as a user in your "user's container" to view the change.

Figure 37: Pages.

Exercise 2: Assigning Gadgets to the "Home" Page

Phone Book Gadget

1. Navigate to the Pages administration screen we saw in the previous exercise.
   
   
2. Select the Home Page created in the last exercise and click Edit.
   
   
3. You should now be at the Edit a Page for the Home Page.
   
   
4. Select Add.
   
   
5. Select the Phonebook gadget from the list of gadgets and press Add.
   
   
6. For the Display name, type Phone Book.
   
   
7. For the Maximum number of users to display, leave this at 100.
   
   
8. If you press All Settings, you can position the gadget on the page. If you press Continue, the gadget will be placed by default in column 1.
   
   
9. Select Continue so the gadget on the Page is in column 1 by default.
   
   
10. You should now be at the Edit a Page screen.
    
    

Yahoo! Shopping - HTML Gadget

1. You should now be at the "Edit a Page" screen.
   
   
2. Select Add.
   
   
3. Select the HTML gadget from the list of gadgets and press Add.
   
   
4. For the Display name, type "Yahoo! Shopping."
   
   
5. Click the Edit button for the "Record sets for getting to and subdividing a URL."
   
   
6. For the beginning URL please add www.yahoo.com to the existing "http://"
   
   
7. Select OK.
   
   
8. You should now see the Yahoo page - select the OK button on the top of the page.
   
   
9. Now lets break the page up, select Subdivide Page.
   
   
10. Now select Subdivide Lower.
    
    
11. Select the check box by the section of the page for "Yahoo! Shopping."
    
    
12. Click on the Finish button.
    
    
13. You should now see the "Yahoo! Shopping" section that will be placed in the portal.
    
    
14. Select Finish.
    
    
15. Now select Continue. The gadget will be automatically placed in column 1 below the phonebook gadget.
    
    
16. You should now be at the "Edit a Page" for the "Home" Page.
    
    
17. Click on Save then OK.
    
    

Exit the portal administration gadget and log out. Log in as the admin user to view the change.

Exercise 3: Editing the "Portal Administration" Page on user (cn=admin,o=novell)

1. Log in as admin.
   
   
2. Under the "Portal Administration" Page click on the Administer The Portal button.
   
   
3. Select Pages.
   
   
4. Select the Portal Administration Page then Edit.
   
   

User Admin Gadget

1. Select Add on the bottom left of the page.
   
   
2. Select the UserAdmin gadget from the list of gadgets and press Select.
   
   
3. For the Display name, type User Admin Tool.
   
   
4. Leave all other configuration settings with default values.
   
   
5. Now select Continue. The gadget will be automatically placed in column 1 below the Portal Administration gadget.
   
   
6. You should now be at the Edit a Page for the Portal Administration Page.
   
   
7. Click on Save then OK.
   
   

Exit the portal administration gadget and log out. Log in as the admin user to view the change.

Figure 38: NPS Containers Column.

Try out this gadget, creating a user in the o=novell context by ensuring the (o=novell) is specified in the CONTAINERS column (Figure 38) and then click the create button with "User" selected in the pull down (again as above).

Exercise 4: Create a self-sign-up system using the Registration gadget

Create a "Registration" Page on user (cn=public,o=novell)

1. Log in as admin.
   
   
2. Under the "Portal Administration" Page click on the Administer The Portal button.
   
   
3. Select "Pages."
   
   
4. Ensure "[Create New Top Level Page]" is selected and click on Create.
   
   
5. Enter a Page Name of "Register" and optional Description.
   
   
6. Click the Create button.
   
   
7. Select OK.
   
   
8. The Page will now appear in the menu.
   
   
9. Click the Assign button.
   
   
10. Click the Add button.
    
    
11. Select Users in the "Search for:" pull down and click OK.
    
    
12. Click on Search (searching for "users"). (This will return a list of all your users.)
    
    
13. Select the "public" user.
    
    
14. Click the Assign button at the bottom of the page.
    
    
15. Click the Close button.
    
    

Registration Gadget

1. You should now be at the "Pages" screen.
   
   
2. Select the Register Page and then click Edit.
   
   
3. You should now be at the "Edit a Page" for the "Home" Page.
   
   
4. Select Add.
   
   
5. Select the Registration gadget from the list of gadgets and press Add.
   
   
6. For the Display name, type "Sign me up."
   
   
7. Fill in the "User Creation Context" field giving the destination context for new user objects (i.e. o=novell).
   
   
8. Select Continue.
   
   
9. Click on Save then OK.
   
   
10. Select Portal in the left most column.
    
    
11. Select Refresh Portal.
    
    
12. Select Refresh All to refresh the Portal.
    
    

The information required to self register comes from QueryInformation.xml which resides at:

<webapps>/nps/portal/gadget/com.novell.nps.gadgets.registration.RegistrationGadget/... /skins/default/devices/default

Since this process is effectively creating objects in the directory, the "creator" or trustee object requires the correct rights assignment. In our situation the Portal Configuration Object is the trustee. To make the rights assignment:

1. Open ConsoleOne.
   
   
2. Select the users' context.
   
   
3. Right-click and select Trustees of this object.
   
   
4. Select the Portal Configuration Object in the trustee list.
   
   
5. Click the Assigned Rights button.
   
   
6. Click the Add property button.
   
   
7. Select [Entry Rights].
   
   
8. In the Rights checkbox group check browse, create and delete.
   
   
9. Click OK and then OK again.
   
   

Close your browser and open a new one to see the changes.

Figure 39: No Self Registration.

Figure 40: New User? Sign Me Up!

Exercise 5 - Create a "Favorites" Page for your Container (e.g. o=novell)

1. Select Create.
   
   
2. Enter the Page Name and optional Description.
   
   
3. Click the Create button.
   
   
4. Select OK.
   
   
5. The Page will now appear in the menu.
   
   
6. Select the Favorites Page and click Edit.
   
   
7. Select Properties.
   
   
8. Set Priority to "2."
   
   
9. Select All Settings.
   
   
10. Enter values for the Advanced Configuration:
    
    
    1. User can add gadgets to this page: "True."
       
       
    2. Gadget Assignment to show first with PDA device: leave blank.
       
       
11. Click on Continue.
    
    
12. This scheme will be left without any gadget assignments for the user to add their favorite gadgets using the Preferences gadget in a later exercise.
    
    
13. Click Save then OK.
    
    
14. Click the Assign button.
    
    
15. Click the Add button.
    
    
16. Select Users in the "Search for:" pull down and click OK.
    
    
17. Click on Search (searching for "Containers"). (This will return a list of all your containers.)
    
    
18. Select your container (where the users' objects reside).
    
    
19. Click the Assign button at the bottom of the page.
    
    
20. Click the Close button.
    
    
21. Exit the portal administration gadget and logout. Log in as the admin user to view the change.