Using the Registration Wizard

This chapter provides an overview of the Registration Wizard and describes how to:

Understanding the Registration Wizard

This section lists common elements and discusses the Registration Wizard.

Common Elements Used in This Chapter

content reference	A reference to a URL (Uniform Resource Locator) for a transaction page. Appears as a link in the navigation menu at runtime.
iScript	A specialized PeopleCode function that generates dynamic web content. See Internet Script Classes (iScript).
permission list	A set of access rights to application objects, including processes and reports, weblib functions, and other elements. See Setting Up Permission Lists.
portal registry	A tree structure in which content for a portal is organized, classified, and registered. A portal registry consists of folders, content references, and nodes. See Portal Registry.

Working With the Registration Wizard

After you create your pages and assign them to a component, you can register that component to display the transaction page in the browser. You can do this using the Registration Wizard. The wizard gathers information, then attaches the component to a menu, assigns a permission list to allow security access rights, and places a content reference entry in the portal registry, which displays the component to the user on the navigation menu.

Note. Before running the Registration Wizard, the menu definition, permission list, and folder must exist. The wizard does not create these definitions. Instead it matches existing definitions to one another and creates the content reference.

If change control is enabled while you are using the Registration Wizard you will only be allowed to associate components with locked menus.

Registering a Component or iScript

In Application Designer, open the component definition that you want to register. If you are creating a new component, make sure that you save it before opening the Registration Wizard. For iScripts, open the record definition that holds the iScript function. By convention, such records begin with the WEBLIB_ prefix.

You can access the Registration Wizard using any of these methods:

	Click the Register Component or Register iScript icon in the toolbar
Pop-up menu	Select Register Component from the pop-up menu after right clicking on the component.
Tools menu	Select Register Component or Register iScript from the Tools menu.

Note. All settings in the Registration Wizard default to those referenced in the previous wizard session.

The Create Content Reference screen of the Registration Wizard enables you to assign the component to a portal and assign a content reference name.

Target Content

Select this check box to register all forms of target content (excluding homepage).

Homepage Pagelet

Select to register a new homepage pagelet. The homepage template will be applied automatically.

Portal Name and Folder Name

Click the Select button to change the portal or folder name. Click the Open Selected button to launch a browser that will take you to the administration page to create a new folder if necessary. The default values are the last ones referenced by the wizard.

Content Reference Name

The name is automatically generated, including the market code as the suffix.

Content Reference Label

This is the CREF hyperlink that the user sees as the registry entry.

Long Description

Enter the hover text for the CREF link.

Sequence Number

Enter a numeral to control the order in which the component appears within the chosen folder.

Product

Enter the 2-character product code.

Template Name

Specify the template to be used from the drop-down menu.

If you specified that the target content should be accessed as a homepage pagelet, then this field will not be displayed, and the homepage template will be applied automatically.

Object Owner Id

Select the application development group that owns the object.

Node Name

Click Select to change the Node name, or click the Open Selected button to launch the administration page to view the properties of the node.

Always use default local node

Select to always override the selected node name with the specified default local node.

"Open" URI Base

Enter the Universal Resource Identifier (URI) that specifies for PeopleSoft Application Designer the location of your PeopleSoft Pure Internet Architecture site. This is for informational purposes only. It is used only for the Open Selected button and not stored to the database.

If you entered a base URI on the Browser tab of the Options dialog box, that value displays in this field.

The URI you enter in this field is reflected on the remaining pages of the Registration Wizard. If you make a change to this field on any page, the change is reflected throughout.

To register a component or iScript:

Open the component or iScript you want to register.

You can also launch the Registration Wizard from the menu definition by right clicking on a menu item that points to a component.

Open the Registration Wizard.

Select Tools, Register in Portal or click the icon on the Toolbar.

The Start screen of the Registration Wizard gives the option of adding the component to a menu, a portal registry, and/or a permission list. If this is a new component and the first time that you are running the wizard, you should select all three options. If you have already run the wizard on this particular component and just need to add it to an additional permission list or portal, deselect the other options.

Add this component to a menu

Select to add the component to a menu. You must create the menu definition first if it does not already exist. You specify the menu on the following screen of the Registration Wizard. If you do not select this option, you will need to add the component to the menu manually using the Menu designer.

See Creating Custom Component Menus.

Add this component to a portal registry

Select if you want to create a content reference for the component and adds it to the portal registry you specify on the Create Content Reference screen of the Registration Wizard.

Add this component to a permission list

Select if you want to specify the permission list on the final screen of the Registration Wizard.

If this is a new component or iScript and the first time that you’ve run the Registration Wizard, you will most likely want all three options selected. If you are rerunning the wizard to simply add the component to an additional permission list or another portal, you would clear the other options.

The wizard remembers the selection that you made the last time that you ran the wizard and selects those values by default.

Click Next.

If you selected to add the component to a menu, the next screen, Add to Menu and Bar, opens.
Click the Select button to find the menu name and the drop-down list box to assign the bar name, then click Next.

These names are not exposed to users, but are required for internal location purposes. Click the Open Selectedbutton to open the menu that you selected in Application Designer. To view the menu definition without closing the wizard, drag the Registration Wizard to the side.
On the Create Content Reference screen, select Target Content or Homepage Pagelet.

If the component is a standard transaction, register it as Target Content.
Complete all fields in the Create Content Reference screen and click Next.
Click the Select button to find your menu name, then use the drop-down list box to select the name that displays on the bar.

Menus are used as logical groupings to which you can apply security, PeopleSoft components are addressed by menu name (the URL includes the menu name). To add this component to a menu, specify the menu name and bar name.

If you did not select the Add this component to a menucheck box on the Prompt page, this page displays the menu name and the Select button only. You then must select the correct menu that already contains the component.

If you are working with an iScript, you must select the iScript function to register.
Click Next.
Select Target Content if your component is a standard transaction and complete the appropriate fields.

The previous term table defines each of these fields.

If you did not select Add this Component to a Portal Registry on the Prompt page, this page does not display.
Click Next.
Select the appropriate permission list, select all the actions that you want to grant this component or iScript, and enter the base URI.

Use the Select button to view and select a permission list.

If you did not select Add this Component to a Permission List, this page does not display.
Click Next.
Review the selections made so far. If you need to change anything, use the Back button to edit your entries.

Select the options in the Add to project area to place your item into an active PeopleTools project. This is cumulative behavior—the more times you run the wizard while the project is active, the more menus, registry structures, and permission lists are added to that project.
Click Finish to complete the registry process into the specified portal.

If you click Cancel all of the entries that you have made in the wizard will be lost and no changes will be made.

Registering a Component in Multiple Portals

After you have used the Registration Wizard to register your new component into the portal you may need to register the component in other portals also.

There are two ways to do this.

You can use the Portal Registration Wizard again. Select only the second option: Add this component to a portal registry. Then reenter the content reference label, long description, and sequence number (if not 1) to match the other portal’s entry.
You can just copy the component to other portals from portal Administration pages in the web client.

See Enterprise PeopleTools 8.49 PeopleBook: Internet Technology.

Registering a Mobile Page

As with a component or iScript, you can also register a mobile page in the portal using the Registration Wizard, though the wizard is slightly different. This wizard always assigns the mobile page to the MOBILE portal and does not require a node name.

To register a mobile page in the portal:

Open the mobile page that you want to register.
Open the Registration Wizard.

Use any one of three methods to do this:
- Click the Registration Wizard icon in the toolbar.
- Select Tools, Register Component from the menu.
- Select Register Component from the pop-up menu.
Set the Folder Name and content reference information.
Assign the Sequence Number, Product, and Template Name.
Select the object owner ID from the drop-down list box.
Click Next.

The final screen of the wizard opens enabling you to verify the settings that you have selected. The registration wizard also adds your registry entry to the current project. The Registry entry check box is selected by default.
Review your settings in the output window and click Finish.

Target Content	Select this check box to register all forms of target content (excluding homepage).
Homepage Pagelet	Select to register a new homepage pagelet. The homepage template will be applied automatically.
Portal Name and Folder Name	Click the Select button to change the portal or folder name. Click the Open Selected button to launch a browser that will take you to the administration page to create a new folder if necessary. The default values are the last ones referenced by the wizard.
Content Reference Name	The name is automatically generated, including the market code as the suffix.
Content Reference Label	This is the CREF hyperlink that the user sees as the registry entry.
Long Description	Enter the hover text for the CREF link.
Sequence Number	Enter a numeral to control the order in which the component appears within the chosen folder.
Product	Enter the 2-character product code.
Template Name	Specify the template to be used from the drop-down menu. If you specified that the target content should be accessed as a homepage pagelet, then this field will not be displayed, and the homepage template will be applied automatically.
Object Owner Id	Select the application development group that owns the object.
Node Name	Click Select to change the Node name, or click the Open Selected button to launch the administration page to view the properties of the node.
Always use default local node	Select to always override the selected node name with the specified default local node.
"Open" URI Base	Enter the Universal Resource Identifier (URI) that specifies for PeopleSoft Application Designer the location of your PeopleSoft Pure Internet Architecture site. This is for informational purposes only. It is used only for the Open Selected button and not stored to the database. If you entered a base URI on the Browser tab of the Options dialog box, that value displays in this field. The URI you enter in this field is reflected on the remaining pages of the Registration Wizard. If you make a change to this field on any page, the change is reflected throughout.