15 Working with Items

15.2.1 Adding a File Item

When you add a file to a portal page, the display option that you select determines whether the content is displayed in place on the page or as a link. When a link displays, users click it to view item content or to download item content to their local file system.

To add a file-type item:

1. Log in to OracleAS Portal.

2. Go to the page to which to add the item.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Go to the region to which to add the item, and click the Add Item icon (Figure 15-2).

   Figure 15-2 The Add Item Icon

   
   
   
   

   Note: If the Add Item icon does not display next to the region, the region may be a portlet region. You can add items only to an item region.

   
   

   To add a sub-item to an existing item, click the Actions icon (Figure 15-3) next to that item and then choose Add a subitem.

   Figure 15-3 The Actions Icon

   
   
   
   

   Note: To add sub-items to an item, you must have the at least the item privilege Edit on the item.

   
   

5. On the Item Type Selection page, select a file-based item type from the Content Item Types list.

   For example, select File or Simple File. If the item type does not appear on the list, contact your page group administrator. The page group administrator specifies the types of items available to the page group.

   
   

   Note: If the page group administrator has configured the page group to allow only one type of item, the Item Type Selection page is skipped, and the Item Attributes page is displayed. For example, if the page group is configured to include only file-type items, when a user clicks the Add Item icon, the Item Attributes page for file-type items displays.

   
   

6. Click Next.

7. On the Item Attributes page, in the File Name field, enter the path and file name of the item or browse to and select the item.

   The file name is case sensitive and must be unique on the page. If the file name is not unique, a value is automatically added to the end of the name. Use up to 256 characters. In addition to character restrictions imposed by your operating system, you cannot use the following characters in the file name:

   & # %

   
   

   Note: For a summary of the rules governing the naming of objects in OracleAS Portal, see Appendix D, "Object Naming Rules in OracleAS Portal". In the OracleAS Portal user interface, an asterisk (*) indicates a field that requires a value.

   
   

8. In the Display Name field, enter a display name for the item.

   Use up to 256 characters. Use any character, including spaces. When the item displays as a link, the Display Name is the link text that users click to view the item. This field defaults to the file name when no Display Name is specified.

9. From the Category drop-down list, select the category that most accurately classifies item content.

10. In the Description field, enter a brief description of the item content.

11. In the Publish Date field, specify the date on which the item should display to other users.

    Use the format: DD-MON-YYYY HH12:MI PM. You will see the item when you edit the page, but no other users (except administrators) will see it until the publish date.

12. Specify an Expiration Date:

    On the day you specify, the content is marked (in Edit mode) as expired, and is removed from other users' view of the page. If the page group is configured to display expired items, you will still be able to see it in Edit mode and, if you wish, un-expire it, until the portal administrator purges expired items from the portal.

    Choose from:

    • Never Expires—The item does not expire.

    • Expires In [ ] Days—The item expires in the number of days you specify (calculated from the publish date).

    • Expires On [ ] (DD-MON-YYYY HH12:MI PM)—The item expires on the date and time you specify.

13. Click the perspectives you will use to classify this content in the Available Perspectives list, then click the Move icon that points to the Displayed Perspectives list.

    In Windows, press and hold the Ctrl key to select two or more perspectives. In UNIX, simply click each perspective.

14. Select an image/icon for the item.

    Either:

    • Click the Browse button to locate and select an image on your file system; or

    • Enter the URL or the internal name of a previously uploaded image.

    Add images in the JPEG, GIF, or PNG formats.

    Any images associated with the item—whether the image is the item itself or an attribute of the item—are affected by item versioning. If you are using item versioning and you always want to show the current version of the image, use the image's durable URL instead of the internal file name. The durable URL always picks up the latest version of the image. For more information, see Section 15.12.4, "Images and Item Versioning".

    You can use settings at the region level to ensure that all image/icons display in a uniform size. For more information, see Section 11.2.8, "Setting a Uniform Height and Width for Item Icons".

15. Select an image alignment from the Image Alignment drop-down list.

    Images are aligned relative to the item's Display Name. For illustrations of the image alignment options, see Table 15-1, "Item Image Alignment Options".

16. In the Basic Search Keywords field, enter keywords to assist users in finding this item during a search.

    Separate each word with a space, a comma, or some other punctuation mark.

17. In the Author field, enter the name of the item's author.

18. Select Enable Item Check-Out to enable users to check an item out for individual use.

    This prevents other users from overwriting the item while it is checked out. However, page group administrators and page designers can check-in items that have been checked-out by other users.

19. Select the way the item will display from the Display Options radio buttons.

    Choose from:

    • Link That Displays Item In Full Browser Window

      When users click the item link, the item content displays in the current browser window

    • Link That Displays Item In New Browser Window

      When users click the item link, the item content displays in a new, second browser window.

    A third display option, Item Displayed Directly In Page Area, is available for some items when you edit the item (though not when you add one). This option displays only when the item is of the type Text, PL/SQL, URL, or File, and only for Files of type text/html or text/plain.

    
    

    Note: You can use a Portal Template for items only when you select one of the Link display options when you specify item attribute values. The Link display options include Link That Displays Item In Full Browser Window and Link That Displays In New Browser Window. When you select the item display option Item Displayed Directly In Page Area, the Portal Template for items you have associated with the item in page properties or in item attributes is ignored. For more information on Portal Templates for items, see Chapter 13, "Providing a Standard Look and Feel".

    
    

20. Click Finish to save your changes and return to the page.

Table 15-1 Item Image Alignment Options

Alignment	Description	Example
Left	Aligns the image on the left side of the page.
Right	Aligns the image on the right side of the page.
Top	Aligns the top of the image with the top of the display name.
Bottom	Aligns the bottom of the image with the baseline of the display name. Same as Baseline.
Absolute Middle	Aligns the middle of the image with the absolute middle of the display name.
Absolute Bottom	Aligns the bottom of the image with the absolute bottom of the display name.
Text Top	Aligns the top of the image with the top (tallest text) of the display name.
Middle	Aligns the middle of the image with the baseline of the display name.
Baseline	Aligns the bottom of the image with the baseline of the display name. Same as Bottom.
Image Above Link	Aligns the image over the display name.

15.2.2 Adding Text to a Page

Using the OracleAS Portal rich text editor, you can add up to 32 KB of plain text, or embedded HTML, to a text-based item on a page. Use text-based items for:

• Browser-based authoring—Text, including HTML, can be added directly to portal pages through the addition of a Text item type. Enter HTML tags to format the content. Alternatively, use the embedded WYSIWYG rich text editor to build the underlying HTML for you.

• In-place display—Text item content can be displayed directly on a portal page. This is useful when you want to add headings, announcements, news summaries, product descriptions, and the like to portal pages.

This section describes how to add text to a page and how to use the OracleAS Portal rich text editor. It contains the following subsections:

• Adding a Text Item

• The Rich Text Editor

15.2.3 Adding a URL Link to a Page

You can add a link to another Web page, Web site, or document URL that is internal or external to the page group. To do this, you add a URL item to the page.

You can also add a direct link to an item in your portal by entering the item's path-based or durable URL. See Section 2.1.3, "Understanding Page and Item URLs".

To add a link to a URL:

1. Log in to OracleAS Portal.

2. Go to the page to which to add the item.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Go to the region to which to add the item, and click the Add Item icon (Figure 15-6).

   Figure 15-6 The Add Item Icon

   
   
   
   

   Note: If the Add Item icon does not display next to the region, the region may be a portlet region. You can add items only to an item region.

   
   

   To add a sub-item to an existing item, click the Actions icon (Figure 15-7) next to that item and then choose Add a subitem.

   Figure 15-7 The Actions Icon

   
   
   
   

   Note: To add sub-items to an item, you must have at least the item privilege Edit on the item.

   
   

5. On the Item Type Selection page, choose URL from the Content Item Types list.

   If the item type you are looking for does not appear in the list, contact your page group administrator. The page group administrator specifies the types of items available to the page group.

   
   

   Note: If the page group administrator has configured the page group to allow only one type of item, the Item Type Selection page is skipped, and the Item Attributes page is displayed. For example, if the page group is configured to include only file-type items, when a user clicks the Add Item icon, the Item Attributes page for file-type items displays.

   
   

6. Click Next.

7. On the Item Attributes page, in the URL field, enter the target URL.

   
   

   Note: When URL items with Display Options set to Item Displayed Directly In Page Area are to be rendered on Portal Templates for items, they cannot point to a URL that requires HTTP authentication. Such items rendered as links have no such restriction. In the OracleAS Portal user interface, an asterisk (*) indicates a field that requires a value.

   
   

   • If you want to add an e-mail link, enter the appropriate HTML code containing the person's e-mail address. For example, remove "https://" from the URL field and enter mailto:user@company.com.

     For a mailto link to work, the user's browser preferences must be properly configured. In Netscape browsers, you can find e-mail settings under Preferences in the Mail & Newsgroups section. In Internet Explorer browsers, you can find e-mail settings under Internet Options on the Programs tab.

   • For backward compatibility, the URL item type supports direct access, relative URLs. Users who click the resulting link are redirected to a splash screen that links to the item in the current URL syntax (if the splash screen is enabled, see Appendix C, "Formation of URLs in OracleAS Portal"). Keep in mind that if a URL item is not created with http:// or https:// at the beginning, the URL is treated as a relative URL, and not an absolute URL.

     To avoid the splash screen and redirection, consider using the Simple Item Link item type to link to objects that are inside your portal. See Section 15.2.4, "Adding a Simple Item Link to a Page".

     For more information about the formation of URLs in OracleAS Portal, see Appendix C, "Formation of URLs in OracleAS Portal".

   
   

   Note: URL-type items that point to locations outside the firewall require a reconfiguration of the Web Cache Manager's proxy server. For more information, see Oracle Application Server Portal Configuration Guide.

   
   

8. In the Display Name field, enter a display name for the item.

   This is used for the link text that users click to access the URL item's target. Use up to 256 characters. Use any character, including spaces.

   
   

   Note: For a summary of the rules governing the naming of objects in OracleAS Portal, see Appendix D, "Object Naming Rules in OracleAS Portal".

   
   

9. From the Category drop-down list, select the category that most accurately classifies item content.

10. In the Description field, enter a brief description of the item content.

11. In the Publish Date field, specify the date on which the item should display to other users.

    Use the format: DD-MON-YYYY HH12:MI PM. You will see the item when you edit the page, but no other users (except administrators) will see it until the publish date.

12. Specify an Expiration Date:

    On the day you specify, the content is marked (in Edit mode) as expired, and is removed from other users' view of the page. If the page group is configured to display expired items, you will still be able to see it in Edit mode and, if you wish, un-expire it, until the portal administrator purges expired items from the portal.

    Choose from:

    • Never Expires—The item does not expire.

    • Expires In [ ] Days—The item expires in the number of days you specify.

    • Expires On [ ] (DD-MON-YYYY HH12:MI PM)—The item expires on the date and time you specify.

13. Click the perspectives you will use to classify this content in the Available Perspectives list, and click the Move icon that points to the Displayed Perspectives list.

    In Windows, press and hold the Ctrl key to select two or more perspectives. In UNIX, simply click each perspective.

14. Select an image/icon for the item; either:

    • Click the Browse button to locate and select an image on your file system; or

    • Enter the URL or the internal name of a previously uploaded image.

    Add images in the JPEG, GIF, or PNG formats.

    Any images associated with the item—whether the image is the item itself or an attribute of the item—are affected by item versioning. If you are using item versioning and you always want to show the current version of the image, use the image's durable URL instead of the internal file name. The durable URL always picks up the latest version of the image. For more information, see Section 15.12.4, "Images and Item Versioning".

15. Select an image alignment relative to the item display name from the Image Alignment drop-down list.

    For illustrations of the image alignment options, see Table 15-1, "Item Image Alignment Options".

16. In the Basic Search Keywords field, enter keywords to assist users in finding this item during a search.

    Separate each word with a space, a comma, or some other punctuation mark.

17. In the Author field, enter the name of the item's author.

18. Select Enable Item Check-Out to enable users to check an item out for individual use.

    This prevents other users from overwriting the item while it is checked out. However, page group administrators and page designers can check-in items that have been checked-out by other users.

19. From the Display Options radio buttons, select the way the item will display.

    Choose from:

    • Item Displayed Directly In Page Area

      The URL's target content displays in the current browser window.

    • Link That Displays Item In Full Browser Window

      When users click the item link, the item content displays in the current browser window

    • Link That Displays Item In New Browser Window

      When users click the item link, the item content displays in a new, second browser window.

    
    

    Note: You can use a Portal Template for items only when you select one of the Link display options when you specify item attribute values. The Link display options include Link That Displays Item In Full Browser Window and Link That Displays In New Browser Window. When you select the item display option Item Displayed Directly In Page Area, the Portal Template for items you have associated with the item in page properties or in item attributes is ignored. For more information on Portal Templates for items, see Chapter 13, "Providing a Standard Look and Feel".

    
    

20. Click Finish to save your changes and return to the page.

15.2.4 Adding a Simple Item Link to a Page

The Simple Item Link item type provides a swift, easy means of linking to existing portal content (such as, a file, text, a URL, an image, and so on) that is contained within the same page group as the link. Using this feature eliminates the need to upload separately-maintained copies of the item. Users click the item link, and the item is rendered on its own in the current browser window.

To add a Simple Item Link:

1. Log in to OracleAS Portal.

2. Go to the page to which to add the item.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Go to the region to which to add the item, and click the Add Item icon (Figure 15-8).

   Figure 15-8 Add Item Icon

   
   

5. Go to the region to which to add the item, and click the Add Item icon (Figure 15-12).

   Figure 15-9 The Add Item Icon

   
   
   
   

   Note: If the Add Item icon does not display next to the region, the region may be a portlet region. You can add items only to an item region.

   
   

   To add a sub-item to an existing item, click the Actions icon (Figure 15-13) next to that item and then choose Add a subitem.

   Figure 15-10 The Actions Icon

   
   
   
   

   Note: To add sub-items to an item, you must have at least the item privilege Edit on the item.

   
   

6. On the Item Type Selection page, choose Simple Item Link from the Content Item Types list.

   If the item type you are looking for does not appear in the list, contact your page group administrator. The page group administrator specifies the types of items available to the page group.

   
   

   Note: If the page group administrator has configured the page group to allow only one type of item, the Item Type Selection page is skipped, and the Item Attributes page is displayed. For example, if the page group is configured to include only file-type items, when a user clicks the Add Item icon, the Item Attributes page for file-type items displays. In the OracleAS Portal user interface, an asterisk (*) indicates a field that requires a value.

   
   

7. Under Item Attributes, click the Choose Item icon (Figure 15-11) next to the Item Link field.

   Figure 15-11 The Choose Item Icon

   
   

   The Select an item page displays.

8. Select an item, either:

   • Under Search, search for the item by its Display Name, Author, or Status. Click Go to execute the search. Click the item link in the search results to select the item. Click Reset to return to the original selection page; or

   • Under Select an item, click an item link to select an item or click a page link to drill to an item link on a sub-page.

9. Optionally, in the Display Name field enter a display name for the link text.

   If you leave this field blank, the Display Name of the referenced item is used. If the referenced item has no Display Name, nothing is used, and there is no apparent link for users to click.

10. Click OK to save your changes and return to the page.

15.2.5 Adding Dynamic Data (PL/SQL Item)

Use the following steps to add PL/SQL code that executes a PL/SQL procedure and displays the results on a page.

To add a PL/SQL item to a page:

1. Log in to OracleAS Portal.

2. Go to the page to which to add the item.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Go to the region to which to add the item, and click the Add Item icon (Figure 15-12).

   Figure 15-12 The Add Item Icon

   
   
   
   

   Note: If the Add Item icon does not display next to the region, the region may be a portlet region. You can add items only to an item region.

   
   

   To add a sub-item to an existing item, click the Actions icon (Figure 15-13) next to that item and then choose Add a subitem.

   Figure 15-13 The Actions Icon

   
   
   
   

   Note: To add sub-items to an item, you must have at least the item privilege Edit on the item.

   
   

5. On the Item Type Selection page, choose PL/SQL from the Content Item Types list.

   If the item type you are looking for does not appear in the list, contact your page group administrator. The page group administrator specifies the types of items available to the page group.

   
   

   Note: If the page group administrator has configured the page group to allow only one type of item, the Item Type Selection page is skipped, and the Item Attributes page is displayed. For example, if the page group is configured to include only file-type items, when a user clicks the Add Item icon, the Item Attributes page for file-type items displays.

   
   

6. Click Next.

7. On the Item Attributes page, in the PL/SQL Code field, enter the PL/SQL code to execute when this item is clicked.

   If the PL/SQL code you enter for the item is fairly long, consider putting it into a procedure and calling the procedure using the item.

   
   

   Note: The PL/SQL code you enter here is not validated when you finish creating or editing the item. Validation is performed when an attempt is made to execute the code. If the code is valid, it executes when the item is rendered. If the code is invalid, error messages are returned. Once you create the item, be sure to test the code. In the OracleAS Portal user interface, an asterisk (*) indicates a field that requires a value.

   
   

8. In the Display Name field, enter the item's link text.

   This is the text that users click to execute the PL/SQL code.

9. Choose a category that describes this item.

10. Enter a Description for this item.

11. Change the Publish Date default to the date and time to publish the item to other users.

    The format is DD-MON-YYYY HH12:MI PM.

    When you upload the item, you can see it immediately, despite the Publish Date you enter here. Other users will not see this item until the date and time you specify.

12. Select an expiration option from the Expiration Period radio buttons.

    On the day you specify, the content is marked (in Edit mode) as expired, and is removed from other users' view of the page. If the page group is configured to display expired items, you will still be able to see it in Edit mode and, if you wish, un-expire it, until the portal administrator purges expired items from the portal.

    Choose from:

    • Never Expires—The item does not expire.

    • Expires In [ ] Days—The item expires in the number of days you specify (calculated from the publish date).

    • Expires On [ ] (DD-MON-YYYY HH12:MI PM)—The item expires on the date and time you specify.

    The format is DD-MON-YYYY HH12:MI PM.

13. In the Perspectives field, click the Move icons to move a perspective from the Available Perspectives to the Displayed Perspectives list.

    Use the Move icons to the right of Displayed Perspectives to set the order in which to display the perspectives.

    You can choose more than one perspective for an item. For example, a sales report might belong to both the Sales Representative and Marketing Manager perspectives. In Windows, select multiple perspectives by pressing and holding the Ctrl key while clicking each perspective. In UNIX, simply click each selection.

14. In the Image field, enter the location of the image/icon to associate with this item.

    Click the Browse button to locate and select the image from your file system. Alternatively, use the second field to enter the URL of an image, or reuse an image that has already been uploaded to the portal. To reuse an uploaded image, enter its internal name (not file name) without a path in this field, for example, enter 1645.GIF.

    To obtain the internal name OracleAS Portal has assigned to an image, go to a place within your portal where the image is already in use; right click it; and select Properties from the right-click menu.

    
    

    Note: If you are using item versioning and you always want to show the current version of an image, see Section 15.12.4, "Images and Item Versioning".

    
    

15. From the Image Alignment list, choose an alignment option for the item's image/icon.

    For descriptions and examples of image alignment options, see Table 15-1, "Item Image Alignment Options".

16. In the Basic Search Keywords field, enter one or more search terms for the item.

    Separate keywords by spaces, commas, or some other punctuation mark.

17. In the Author field, enter the name of the item's author.

18. Select Enable Item Check-Out to enable users to check this item into and out of the portal.

    Item check-out prevents other users from overwriting an item while it is being edited.

19. In the Display Options field, choose a display method for the item.

    Choose from:

    • Item Displayed Directly In Page Area to display the execution results in the portlet region that hosts this item.

    • Link That Displays Item In Full Browser Window to replace the displayed page with the execution results.

    • Link That Displays Item In New Browser Window to display the execution results in a second browser window.

    
    

    Note: You can use a Portal Template for items only when you select one of the Link display options when you specify item attribute values. The Link display options include Link That Displays Item In Full Browser Window and Link That Displays In New Browser Window. When you select the item display option Item Displayed Directly In Page Area, the Portal Template for items you have associated with the item in page properties or in item attributes is ignored. For more information on Portal Templates for items, see Chapter 13, "Providing a Standard Look and Feel".

    
    

20. In the PL/SQL Execute Options field, choose the database schema in which to execute this PL/SQL item: the Public schema or another schema that you select.

    To select a schema other than the Public schema, click the Browse Database Schemas icon next to the Schema field. A PL/SQL item is executed by default as the public user. You can also explicitly select a user to execute the item.

21. Click Finish to save your changes and return to the page.

15.2.6 Specifying How Item URLs Are Formed

When you add items to a page, you enter values for the item's attributes. You can choose to display those values by editing the attribute settings on the region that contains the item (for more information, see Section 11.2.9, "Changing the Attributes Displayed in a Region"). Included among the many item attributes you can display are item links that use the item's durable URL and item links that use the item's path-based URL.

A durable URL is formed using a globally unique identifier (GUID). Because the GUID of an item never changes, the URL continues to be valid if the item name changes.

In contrast, you can also use the item's path-based URL to form the item link. A path-based URL is formed by identifying the path taken through the portal to get to a particular item. This uses page and item names in the URL and thus, if the name of a page or an item within the path is changed, the URL is no longer valid.

Path-based URLs are a little more intuitive, because they follow an observable path through the portal. Durable URLs are a little more sturdy because they can withstand an item name change and still link to the item, and they can be reliably bookmarked.

The attributes of interest include:

• Link - Display Name—Path-based URL

• Link - Display Name (durable)—Durable URL

• Link - Image—Path-based URL

• Link - Image (durable)—Durable URL

• Link - Image and Display Name—Path-based URL

• Link - Image and Display Name (durable)—Durable URL

• Link - Image OR Display Name—Path-based URL

• Link - Image OR Display Name (durable)—Durable URL

To specify which type of URL to use for an item link, follow the steps provided in Section 11.2.9, "Changing the Attributes Displayed in a Region". To understand more about URLs in OracleAS Portal, see Appendix C, "Formation of URLs in OracleAS Portal". For a detailed explanation of what is rendered for each of these attributes, see Section A.2, "Base Attributes".

15.2.7 Tricks for Adding and Editing Items

This section provides a couple of tricks to simplify the process of adding content to a region or editing content. It contains the following subsections:

• Creating a Shortcut to Adding Content

• Creating a Shortcut to Editing Content

15.3.1 Preparing Zip Files for Upload

You can upload a Zip file as a File item type or a Zip File item type.

When you upload a Zip file as a File item type, users can click the file link to initiate a download to their local systems.

When you add a Zip file as a Zip File, you can upload compressed files from your computer to pages in OracleAS Portal. Users with the appropriate security privileges can upload compressed files of virtually any size or quantity.

Each extracted file in the Zip file is displayed in the page area as an item link. By creating descriptive file names before zipping files to be uploaded, you can provide meaningful link names to guide users to the file.

Uploaded files are accessible through automatically created links in the page area:

• If you do not include path information in your Zip file, links for the uploaded pages display in a single page that you specify.

  To upload files without path information, when you create the Zip file, clear the Include sub-pages and Save Extra Page Info check boxes in the WinZip application.

• If you include path information in your Zip file, links for each level are displayed in a common page for each level.

  To upload path information, when you create the Zip file select Include sub-pages and Save Extra Page Info. The relative locations of your files when you zip them are the relative locations they have when uploaded.

• If you are uploading an HTML file with a title, the text between the <TITLE></TITLE> tags becomes the item's display name link text.

You can associate categories and perspectives with any bulk upload file. Once associated, both categories and perspectives are retained by bulk upload files, even if those files are overwritten with newer files of the same name. However, categories and perspectives are not maintained if item version control is enabled and when the Create New Version option is selected for bulk upload files.

15.3.2 Adding a Zip File as a File

When you add a Zip file as a File item type, it displays without the Unzip link and can be downloaded to your local system. This is useful when you want to make a set of files available for download to other users.

To add a Zip file as a file:

1. Log in to OracleAS Portal.

2. Go to the page on which to add a Zip file.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Add Item icon in the region in which to add the Zip file (Figure 15-16).

   Figure 15-16 The Add Item Icon

   
   
   
   

   Note: If the Add Item icon does not display next to the region, the region may be a portlet region. In this case, you cannot add items to this region.

   
   

5. On the Item Type Selection page choose File from the Content Item Type list.

   
   

   Note: If you do not see File in the list, the page group that owns the page may not allow files to be uploaded, or your administrator may not have selected this item type to display here. Contact your page group administrator for more information. If you are the administrator or have administrative privileges, you can click the configure the list of available item types link on this page and configure the page group to include the File item type. If the page group administrator has configured the page group to allow only one type of item, Item Type Selection page is skipped, and the Item Attributes page is displayed. For example, if the page group is configured to include only file-type items, when a user clicks the Add Item icon, the Item Attributes page for file-type items displays.

   
   

6. Click Next.

7. On the Item Attributes page, in the File Name field, click the Browse button to locate and select the file.

8. In the Display Name field, enter the item's link text.

   This is what users click to view the item.

9. Click Finish to upload the Zip file as a file and return to the page.

15.3.3 Adding a Zip File as a Zip File

When you upload a Zip file as a Zip File type item, it displays with an Unzip link you can click to upload the files to your portal. If directories are preserved through a setting in the WinZip application, they become sub-pages under the page on which you add the Zip file.

To add a Zip file that you will unzip within Portal for bulk page creation and file uploading:

1. Log in to OracleAS Portal.

2. Go to the page on which add a Zip file.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Add Item icon in the region in which to add the Zip file (Figure 15-17).

   Figure 15-17 The Add Item Icon

   
   
   
   

   Note: If the Add Item icon does not display next to the region, the region may be a portlet region. In this case, you cannot add items to this region.

   
   

5. On the Item Type Selection page choose Zip File from the Content Item Type list.

   
   

   Note: If you do not see Zip File in the list, the page group that owns the page may not allow Zip files to be uploaded, or your administrator may not have selected this item type to display here. Contact your page group administrator for more information. If you are the administrator or have administrative privileges, you can click the configure the list of available item types link on this page and configure the page group to include the Zip File item type. If the page group administrator has configured the page group to allow only one type of item, Item Type Selection page is skipped, and the Item Attributes page is displayed. For example, if the page group is configured to include only file-type items, when a user clicks the Add Item icon, the Item Attributes page for file-type items displays.

   
   

6. Click Next.

7. On the Item Attributes page, in the File Name field, click the Browse button to locate and select the file.

8. In the Display Name field, enter the item's link text.

   This is what users click to view the item.

9. Click Finish to upload the Zip file and return to the page.

Item attributes such as Author, Description, Image, New Item Indicator, and so on are available on the Add <Item> page only if the item was configured to include them. For more information, see Chapter 6, "Preparing to Add Content".

15.3.4 Extracting a Zip File Within OracleAS Portal

OracleAS Portal maintains any directory structure that is included with a Zip file. If the Zip file contains directories, OracleAS Portal creates sub-pages during the extraction process, matching each directory with a sub-page. OracleAS Portal creates the sub-pages under the page on which the Zip file is being unzipped. The files in a directory are placed on the directory's related portal sub-page.

To extract the content of a Zip file to a page:

1. Log in to OracleAS Portal.

2. Add the Zip file to the page as described in Section 15.3.3.

3. Click the Unzip link next to the Zip file.

4. Click the Browse icon next to the Target Page field, and select a page, or a tab on a page, on which to add the Zip file's content.

5. (Optional) Select Run Unzip In Background to run the extraction process in the background.

   When you clear this check box, you remain on this page until the content of the Zip file had been extracted to the target page. When you select this check box, this page does not display and you can perform other tasks.

   
   

   Note: If the Run Unzip in Background option does not function properly, your system administrator may need to set JOB_QUEUE_PROCESSES in the init.ora file to a value greater than one.

   
   

6. In the Item Type section, select the type of items to create for the different types of files in the Zip file.

   
   

   Note: If items with the same name already exist, and you plan to choose Overwrite Existing Files or Create New Version in Step 7, the item type of the extracted files will be the same as the existing files, rather than the item type specified here.

   
   

   For example, you can specify that all of the images in your Zip file will be extracted as File items instead of Image items.

   1. For document files, such as *.doc, *.pdf, or *.htm, select an item type from the File list.

      When the process is complete, an item of the type you selected is added to the target page for each document file.

      
      

      Note: The list of item types may include File, Simple File, Zip File, and custom item types based on File item types.

      
      

   2. For image files, such as *.gif and *.jpg, select an item type from the Image list.

      When the process is complete, an item of the type you selected is added to the target page for each image file.

      
      

      Note: The list of item types may include Image, Simple Image, Simple Image Map, File, Simple File, Zip File, and custom item types based on Image item types.

      
      

   3. If your Zip file contains other archive files that do not end with a *.zip extension, such as *.jar files, select an item type from the Zip File list.

      When the process is complete, an item of the type you selected is added to the target page for each Zip file.

      If your Zip file contains other Zip files that do end with a *.zip extension, you do not need to select an item type here. Zip File items will be created automatically for each of the files.

      
      

      Note: The list of item types may include File, Simple File, Zip File, and custom item types based on Zip File item types.

      
      

7. In the Overwrite Or Rename Files? section, choose whether to overwrite or rename existing files of the same name on the target page.

   If item versioning is enabled at the page level on the target page, the Create New Version option displays. Choose this to create a new version of any existing files that have the same name as those files being extracted into the target page.

8. Click Unzip to begin the file extraction process.

   This process may take several minutes depending on the number and size of the files. Do not extract another Zip file while the extraction process is underway.

   If you selected Run Unzip In Background, you are returned to the page. If you did not select this option, you remain on the Bulk Load page.

9. After the extraction process is complete, read the Bulk Load Log for information on the pages and items created.

   If you selected Run Unzip In Background, you can access the Bulk Load Log after the extraction process is complete by clicking the Unzip link next to the Zip file.

Only Zip files that are added as Zip File item types display the Unzip link. You cannot extract files from Zip files that are added as File or Simple File item types.

15.4.1 Editing an Item

To edit an item:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item to be edited.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Edit Item icon next to the relevant item (Figure 15-18).

   Figure 15-18 Edit Item Icon

   
   

5. Make your changes to the item attributes.

   
   

   Note: For descriptions of item attributes, see Appendix A, "OracleAS Portal Seeded Objects". For information about attributes related to item versions and translations, see Section 15.12, "Using Item Version Control". For information about naming rules associated with items, see Appendix D, "Object Naming Rules in OracleAS Portal".

   
   

6. Click OK to save your changes and return to the page.

15.4.2 Classifying the Content of an Item

When you add items to a page it is important to classify their content. This is useful because the details entered here assist users in finding your content and enable them to determine if the item is of interest.

For example, you can apply a category and one or more perspectives to each item and assign keywords that describe the content or purpose of the item.

This section describes how to edit item classifiers. It contains the following subsections:

• Changing the Category of an Item

• Changing the Perspectives of an Item

• Changing the Search Keywords for an Item

15.4.3 Setting a Publish Date for an Item

You can add items to a page in advance, then delay their display to other users until a day and time you specify. For example, you can add a file item for a document that discusses next month's Sales Targets and set a publish date that coincides with the day of the meeting that discusses the targets.

To set publish date details for an item:

1. Log in to OracleAS Portal.

2. Add the item to a page.

   For information on adding items to pages, see Section 15.2, "Adding Items to a Page".

3. On the Item Attributes page, go to the Publish Date field, and enter the date and time on which this item is to be published to other users.

   Use the format DD-MON-YYYY HH12:MI PM; for example:

   12-JAN-2006 01:00 PM
   
   

4. Click OK.

15.4.4 Enabling Item Check Out

Item checkout provides document control for items that are managed by multiple users. When a user checks an item out, the item is locked and other users cannot overwrite the item. Other users can view the item, but not modify it. With the appropriate privilege, users can copy checked-out items. The copy is automatically checked in.

After the user checks the item in, another user can check the item out and edit it. This prevents users from overwriting each other's changes.

Item check-out is enabled on an item-by-item basis. Consider enabling it for items that are edited by multiple users.

To enable item check-out:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item for which to enable item check-out.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Edit Item icon beside the relevant item (Figure 15-22).

   Figure 15-22 The Edit Item Icon

   
   

5. Select Enable Item Check-Out.

   Contact your page group administrator if this option is not available.

6. Click OK.

For information on checking items out and into OracleAS Portal, see Section 15.5, "Checking Items Out and In".

15.5.1 Checking an Item Out

Use item check-out as a means of preventing other users from overwriting an item with their own versions while you are editing the current version.

To check an item out:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item to be checked out.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Actions icon beside the item to be checked out (Figure 15-23).

   Figure 15-23 The Actions Icon

   
   

5. Click the Check Out link.

The item is now checked out. Other users cannot edit the item.

While you have an item checked out, you can edit the item by clicking the Edit Item icon next to item. You can also perform many actions on the item, such as hide, move, copy, and expire. Click the Actions icon beside the item to see the list of available actions.

When you have finished working with the item, remember to check it in so it is available to the other users.

15.5.2 Checking an Item In

Checking an item in returns it to general use by users who have access to the item. The item can be overwritten by a more current version. And other users can check the item out. For the most part, only a user who has checked an item out can check it back in. There is an exception, however. Page group administrators and page designers can check in items that are checked out by other users.

To check an item in:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item to be checked in.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Actions icon beside the relevant item (Figure 15-24).

   Figure 15-24 The Actions Icon

   
   

5. Click the Check In link.

   The item is now available for other users to edit.

15.7.1 Copying a Single Item

To copy an item:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item to be copied.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Actions icon beside the item to be copied (Figure 15-26).

   Figure 15-26 The Actions Icon

   
   

5. Click the Copy link.

6. Select the destination page, and click Copy Here.

   If necessary, expand the page nodes to access sub-pages. If you are copying the item to a different region on the same page, click the Copy Here link next to the current page.

7. Select a destination region for the item, and click Copy.

15.7.2 Copying Multiple Items

To copy multiple items:

1. Log in to OracleAS Portal.

2. Go to the page that contains the items to be copied.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the List editing view in the toolbar at the top of the page.

5. Select one or more items to copy.

6. Click the Copy button.

7. Click the Copy Here link next to the destination page.

   If you are copying the items to a different region on the same page, click the Copy Here link next to the current page. If necessary, expand the page nodes to access sub-pages.

8. Select a destination region for the items, and click Copy.

15.8.1 Moving a Single Item

To move an item:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item to be moved.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Actions icon next to the item to be moved (Figure 15-27).

   Figure 15-27 The Actions Icon

   
   

5. Click the Move to Another Region or Move to Another Page link.

   If you choose to move the item to another page, select the page to which to move the item, and click Move Here.

6. Select the region to which to move the item, and click Move.

15.8.2 Moving Multiple Items

To move multiple items at once:

1. Log in to OracleAS Portal.

2. Go to the page that contains the items to be moved.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the List editing view in the toolbar at the top of the page.

5. Select one or more items to move.

6. Click the Move button.

7. Click the Move Here link next to the destination page.

   If you are moving all the items to another region on the same page, click the Move Here link next to the current page. If necessary expand the page nodes to access sub-pages.

8. Select a target region for the items, and click Move.

15.9.1 Rearranging the Order of Ungrouped Items

To rearrange ungrouped items:

1. Go to the page that contains the items you will rearrange.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

2. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

3. In the region that contains the items that you want to rearrange, click the Arrange Items icon (Figure 15-28).

   Figure 15-28 Arrange Items Icon

   
   

4. In the Arrange Items list, select an item and use the Move icons to re-order it in relation to the other items in the list. Repeat this step for all items you will rearrange.

5. When you are done, click OK.

15.9.2 Rearranging the Order of Grouped Items

To rearrange grouped items:

1. Go to the page that contains the items you will rearrange.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

2. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

3. In the region that contains the items that you want to rearrange, click the Arrange Items icon (Figure 15-29).

   Figure 15-29 Arrange Items Icon

   
   

4. Select the group name from the <grouping criterion> drop-down list.

   This list displays when the item region is configured to group items by a selected criterion, either category, author, date, or base item type. Use it to select the group-by criterion of the items you want to rearrange.

5. In the Arrange Items list, select an item and use the Move icons to re-order it in relation to the other items in the list.

   Repeat this step for all items you will rearrange within the selected group.

6. When you are done, click OK.

   Repeat steps 3 through 6 to rearrange items in other groups.

15.10.1 Deleting a Single Item

To delete one item:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item to be deleted.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Actions icon beside the item to be deleted (Figure 15-30).

   Figure 15-30 The Actions Icon

   
   

5. Click the Delete link.

6. Click Yes to confirm.

The items are removed from View mode, but may still be visible in Edit mode with a status of Deleted if the page group setting Display Unpublished, Expired, and Deleted Items In Edit Mode is selected. They will be removed entirely at the next system purge. For information on purging expired and deleted items, see Section 6.5.3.3, "Permanently Removing Expired and Deleted Items".

The expired item no longer displays in View mode. It displays in Edit mode only when the page group setting Display Unpublished, Expired, and Deleted Items In Edit Mode is selected.

For information on which items are accessible in what states, see Section 18.9.3, "Item URL Security".

15.10.2 Deleting Multiple Items

To delete multiple items simultaneously:

1. Log in to OracleAS Portal.

2. Go to the page that contains the items to be deleted.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the List editing view in the toolbar at the top of the page.

5. Select one or more items to delete.

6. Click the Delete button.

7. Click OK to confirm.

The items are removed from View mode, but may still be visible in Edit mode with a status of Deleted if the page group setting Display Unpublished, Expired, and Deleted Items In Edit Mode is selected. They will be removed entirely at the next system purge. For information on purging expired and deleted items, see Section 6.5.3.3, "Permanently Removing Expired and Deleted Items".

For information on which items are accessible in what states, see Section 18.9.3, "Item URL Security".

15.10.3 Restoring a Deleted Items

Your page group can be set up to retain deleted items in Edit mode and to allow deleted items to be restored. For more information, see Section 6.5.3.2, "Retaining Deleted Items".

You can restore one item at a time or multiple items simultaneously. This section provides information on restoring files both ways. It contains the following subsections:

• Restoring One Deleted Item

• Restoring Multiple Deleted Items

If the restore option is not available, check with your page group administrator.

15.11.1 Setting the Expiration Details for an Item

To set expiration details for an item:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item for which to set an expiration date.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Edit icon beside the relevant item (Figure 15-32).

   Figure 15-32 The Edit Item Icon

   
   

5. In the Expiration Period section, choose whether this item is always available, available only for a specified number of days, or if it expires on a certain date and time.

   Use the format DD-MON-YYYY HH12:MI PM; for example:

   02-DEC-2010 02:02 PM
   
   

6. Click OK.

15.11.2 Expiring a Single Item

To expire one item instantly:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item to be expired.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Actions icon beside the item to be expired (Figure 15-33).

   Figure 15-33 The Actions Icon

   
   

4. On the Select Action page, click the Expire link.

The expired item no longer displays in View mode. It displays in Edit mode only when the page group setting Display Unpublished, Expired, and Deleted Items In Edit Mode is selected.

For information on which items are accessible in what states, see Section 18.9.3, "Item URL Security".

15.11.3 Expiring Multiple Items Instantly

To expire multiple items instantly:

1. Log in to OracleAS Portal.

2. Go to the page that contains the items to be expired.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the List editing view in the toolbar at the top of the page.

5. Select the items that you want to expire, then select Expire from the Actions drop-down list.

6. Click Go.

The expired item no longer displays in View mode. It displays in Edit mode only when the page group setting Display Unpublished, Expired, and Deleted Items In Edit Mode is selected.

For information on which items are accessible in what states, see Section 18.9.3, "Item URL Security".

15.11.4 Restoring an Expired Item

Your page group can be set up to display expired items in Edit mode and allow such items to be restored. If the restore option is not available, check with your page group administrator.

To restore an expired item:

1. Log in to OracleAS Portal.

2. Go to the page that contains the item to be restored.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Actions icon beside the relevant item (Figure 15-34).

   Figure 15-34 The Actions Icon

   
   

5. Click the Un-Expire link.

You can un-expire multiple items in the List editing view.

15.12.1 Changing Version Control Settings for an Item

When version control is enabled for items on a page, you can change the version control settings for most items. Exceptions to this include items with a status of either pending or draft. Such items do not have version control settings.

To change version control settings for an item:

1. Log in to OracleAS Portal.

2. Go to the page that contains the items for which to set a versioning level.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Edit Item icon beside the relevant item (Figure 15-35).

   Figure 15-35 The Edit Item Icon

   
   

5. In the Item Version Control radio group, select the item version control option to apply to this item.

   • Simple

     • Add Item As New version, but not as Current Version

     • Add Item As New and Current Version

     • Overwrite Current Version

     For the first two options, OracleAS Portal maintains a record of the item's previous versions.

   • Audit

     • Add Item As New version, but not as Current Version

     • Add Item As New and Current Version

     For both of these options, OracleAS Portal maintains a record of the item's previous versions.

6. Click OK.

15.12.2 Changing the Active Current Version of an Item

Once you have multiple versions of an item, you may want to change which version of the item is displayed to users.

To change the current version of an item:

1. Log in to OracleAS Portal.

2. Go to the page where the item for which to set versioning is located.

   For information on locating a page through the Page Groups portlet, see Section 9.1, "Locating Pages in OracleAS Portal".

3. Click the Edit link at the top of the page.

   This opens the page in Edit mode.

4. Click the Actions icon next to the relevant item (Figure 15-36).

   Figure 15-36 The Actions Icon

   
   

5. Click the Versions link.

6. Select the version to use as the current active version, and click OK.

   The selected version of the item now displays to users. All other versions are maintained in the database and are available for selection as the current version.

15.12.3 Using Your Own Version Numbering Scheme

Using custom item types, you can establish your own version numbering scheme for versions of items that you add to your portal. Every time users update an item, they can manually enter the next version according to your company's version numbering scheme, then save the item as a new version.

If users do not provide a value for the Version Number attribute when they save the item as a new version, OracleAS Portal automatically assigns a new value, using the algorithm ceil() + 1. (Ceil stands for ceiling, which is the next available whole number following a fraction.)

For example, if the last version was 3, then 4 is automatically assigned as the next version. However, if the last version was 3.1, then 5 is automatically assigned as the next version. This is because the ceiling for the number 3.1 is 4, and 4 + 1 = 5.

Keep in mind that you must use numerals and no other type of character. Additionally, you can use only one decimal point. You can establish a version series, such as 1, 2, 3 or 1.1, 1.2, 1.3, but not 1.1.1 or 1a.

To use your own version numbering scheme:

1. Create a custom item type.

   For information on how to create a custom item type, see Chapter 6, "Preparing to Add Content".

2. Add the Version Number attribute to the item type.

   Be sure to expose the Version Number attribute in the Add and Edit wizards.

3. Configure the page group to allow the new item type.

   For information on how to make an item type available to a page group, see Section 6.2.2.3, "Making an Item Type Available to a Page Group".

4. Turn on item versioning for the page.

   For information on enabling item versioning for a page, see Chapter 8, "Defining and Displaying Page Information".

5. Add an item of the new custom type to the page.

   The Add Item wizard includes the Version Number attribute that you added to the custom item type on which this item is based.

   For information on adding an item to a page, see Section 15.2, "Adding Items to a Page".

6. Provide a numeric value for the Version Number attribute.

   This value must be an arabic numeral (that is, 1, 2, 3, and so on) and can include one decimal point.

7. Finish adding your item.

When users update the item, the Version Number attribute is exposed in the Edit Item wizard. Users can enter the appropriate incremental value according to your established numbering scheme and save the item as a new version.

15.12.4 Images and Item Versioning

If you are using item versioning and you always want to show the current version of an image—whether the image is the item itself or an attribute associated with the item—use the image's durable URL instead of the internal file name. The durable URL always picks up the latest version of the image. So, instead of entering the image's internal name, for example, 1645.GIF, enter:

/portal/page/<DAD>/<GUID>

This is the relative URL format of a durable URL. With values, it looks like the following:

/portal/page/mydad/A47D41ECA23648A9E030007F0100118A

Always use relative URLs to maintain the integrity of the reference should the host or domain name change, or should the content be exported to another site.

You can obtain the item's durable URL by displaying the Property Sheet attribute in the region hosting the item. Once the Property Sheet attribute is displayed in the region, click the Property Sheet icon (Figure 15-37) next to the item, and copy the portion of the durable URL you will be using. The durable URL is listed next to the heading Item Link. For more information about displaying region attributes, see Section 11.2.9, "Changing the Attributes Displayed in a Region".

Figure 15-37 The Item Property Sheet Icon

The property sheet you view when you click the Property Sheet icon is different from the one you view when you right click the image and select Properties from the resulting pop-up menu. To get the image's durable URL, always click the Property Sheet icon.