17 Working with Resource Catalogs

You can add different types of resources to a resource catalog as described in the following sections:

• Saving a Task Flow to a Resource Catalog

• Adding a Resource from the Resource Registry

1. Navigate to one of the following:

   • To add a custom component to an application-level resource catalog, go to the Shared Assets page. For more information, see Accessing Shared Assets.

   • To add a custom component to a portal-level resource catalog, go to the Assets page for the portal. For more information, see Accessing Portal Assets.

2. In the left panel, under Structure, click Resource Catalogs.
3. Click the Edit quick link in the row for the resource catalog that you want to edit.
4. In the Edit dialog, from the Add menu, select Component.
5. On the Target tab of the Edit Resource Catalog Item - Component dialog, in the Name field, enter a name to display for the component in the resource catalog.

   Figure 17-6 The Edit Resource Catalog Item - Component Dialog

   
   Description of "Figure 17-6 The Edit Resource Catalog Item - Component Dialog"
6. In the Description field, enter a brief description of the component.
7. Select Visible if you want to display the component in the resource catalog.

   Alternatively, you can specify an EL expression to determine under which conditions the resource displays in the resource catalog. For example, to specify that the resource should be visible only to users with the Portal Manager role, use the following EL expression:

   #{WCSecurityContext.userInScopedRole['Moderator']}
   

   If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing WebCenter Portal Assets and Custom Components with Oracle JDeveloper.

8. In the XML text area, enter the XML code for the component.

   The following are a few examples of custom components:

   • Output Text component:

     <af:outputText xmlns:af="http://xmlns.oracle.com/adf/faces/rich" 
                      value="Weather Forecast for the Day" id="#"/>
     

   • Custom navigation:

     <af:forEach xmlns:af="http://xmlns.oracle.com/adf/faces/rich" 
                 var="level_1_menu"
                  items="#{SiteStructureContext.defaultSiteStructure.listModel['startNode=/, includeStartNode=false']}">
     <af:outputText id="#" 
                    xmlns:af="http://xmlns.oracle.com/adf/faces/rich" 
                    value="#{level_1_menu.title}"/>
     </af:forEach>
     

   • External HTML content:

     <f:verbatim xmlns:f="http://java.sun.com/jsf/core">
       <![CDATA[
         <object width="640" height="385">
           <param name="movie" value="http://www.youtube.com/v/KO2ti-B00gw&hl=en_US&fs=1">
           </param>
           <param name="allowFullScreen" value="true">
           </param>
           <param name="allowscriptaccess" value="always">
           </param>
           <embed src="http://www.youtube.com/v/KO2ti-B00gw&hl=en_US&fs=1" 
                  type="application/x-shockwave-flash" allowscriptaccess="always" 
                  allowfullscreen="true" width="640" height="385">
           </embed>
         </object>]]>
     </f:verbatim>
     

     An alternative to this is to create a new task flow and add an HTML Markup component inside it.

9. On the Options tab, set the display options for the component. For more information, see Setting Properties on a Resource.
10. On the Parameters tab, enter values for any parameters supported by the component.

    You can also add custom parameters.

11. Click OK.
12. When you are done, click Save and Close.

1. Navigate to one of the following:

   • To add a folder to an application-level resource catalog, go to the Shared Assets page. For more information, see Accessing Shared Assets.

   • To add a folder to a portal-level resource catalog, go to the Assets page for the portal. For more information, see Accessing Portal Assets.

2. In the left panel, under Structure, click Resource Catalogs.
3. Click the Edit quick link in the row for the resource catalog that you want to edit.
4. In the Edit dialog, from the Add menu, select Folder.
5. On the Target tab of the Edit Resource Catalog Item - Folder dialog, in the Name field, enter a name to display for the folder in the resource catalog.
6. In the Description field, enter a brief description of the contents of the folder.
7. Select Visible if you want to display the folder in the resource catalog.

   Alternatively, you can specify an EL expression to determine under which conditions the folder displays in the catalog. For example, to specify that the folder should be visible only to users with the Portal Manager role, use the following EL expression:

   #{WCSecurityContext.userInScopedRole['Moderator']}
   

   If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing WebCenter Portal Assets and Custom Components with Oracle JDeveloper.

8. On the Options tab, set the display options for the folder. For more information, see Setting Properties on a Resource.
9. On the Parameters tab, enter values for any parameters supported by the folder.

   You can also add custom parameters.

10. Click OK.
11. When you are done, click Save and Close.

    You can now add resources inside this folder, or move resources inside it by dragging and dropping them from the top level folder.

1. Navigate to one of the following:

   • To set properties on a resource in an application-level resource catalog, go to the WebCenter Portal Shared Assets page. For more information, see Accessing Shared Assets.

   • To set properties on a resource in a portal-level resource catalog, go to the Assets page for the portal. For more information, see Accessing Portal Assets.

2. In the left panel, under Structure, click Resource Catalogs.
3. Click the Edit quick link in the row for the resource catalog that you want to edit.
4. Select the resource that you want to edit.

   Tip:

   If the resource you want to edit is inside a folder in the catalog, expand the folder first.

5. In the toolbar, click Edit.
6. On the Target tab of the Edit Resource Catalog Item dialog, in the Name field, edit the name of the resource as it should appear in the resource catalog.
7. In the Description field, enter a brief description to display below the resource name in the resource catalog.
8. Select Visible if you want to display the resource in the resource catalog.

   Alternatively, you can specify an EL expression to determine under which conditions the resource displays in the catalog. For example, to specify that the resource should be visible only to users with the Portal Manager role, use the following EL expression:

   #{WCSecurityContext.userInScopedRole['Moderator']}
   

   If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing WebCenter Portal Assets and Custom Components with Oracle JDeveloper.

9. The remaining fields on this tab are specific to the resource type. See Table 17-4 for details.

   Table 17-4 Fields for Specific Resource Catalog Resources

   Field	Applies to	Description
   Path	Links	Enter the URL to access the resource. The URL format is different depending on what you are linking to: Task Flow: taskflow://Path_to_Task_Flow/Task_Flow_Definition_File_Name#Task_Flow_ID Portlet: portlet://Producer_ID/Portlet_ID Content: content://Content_Connection_ID/Document_ID If you do not know the location, click the Select icon to browse for available resources. Note: In the Select dialog, the Select button is active only when you select a resource that can be included in the navigation model. For example, if you expand the Portlets node and select a portlet producer, then the Select button is disabled. If you expand the portlet producer and select a portlet, then the Select button is enabled.
   Repository	Resources that require a repository connection	The name of the connection used to lookup the resource.
   Include Catalog	Nested Resource Catalogs	Select the resource catalog to nest within the current catalog.
   Hide Top-Level Folder	Custom folders that are populated dynamically at runtime.	Select to include contents from the selected folder directly under the parent folder; for example, if you select this option for the Data Controls folder, then any data controls created at runtime are displayed directly under Integration. The Data Controls folder is not displayed. You can preview the catalog to see this change.
   Factory Class	Custom folders that are populated dynamically at runtime	The factory class used to create the folder. The factory classes for the folders available in the default catalog are as follows: Task flow: oracle.webcenter.portalframework.sitestructure.rc.TaskFlowResourceFactory Portlet: oracle.webcenter.portalframework.sitestructure.rc.PortletResourceFactory Content: oracle.webcenter.content.model.rc.ContentUrlResourceFactory Data control: oracle.webcenter.datacomposer.internal.adapter.datacontrol.DataControlContextFactory

10. Click the Options tab. (Figure 17-7)

    Figure 17-7 The Options Tab of the Edit Resource Catalog Item Dialog

    
    Description of "Figure 17-7 The Options Tab of the Edit Resource Catalog Item Dialog"
11. Set the various display options, as described in Table 17-5.

    Table 17-5 Resource Catalog Item Display Options

    Option	Description
    attr.ATTRIBUTE_NAME	For each attribute, enter an initial value for the attribute. These are attributes defined against portlets or task flows at design time. When the task flow or portlet is consumed on a page, the attribute is exposed along with the enclosing chrome's attributes; for example, attr.text defines the default title for the task flow or portlet and attr.contentStyle defines the CSS style to be applied. An attribute is not exposed on the chrome if you do not set an initial value for it.
    parameter.PARAMETER_NAME	For each parameter, enter an enter initial value for the parameter. These are parameters defined against portlets or task flows at design time. When the task flow or portlet is consumed on a page, the parameter is exposed along with the enclosing Show Detail Frame or Movable Box component's properties. A parameter is not exposed on the chrome if you do not set an initial value for it.
    Large Icon URI	Enter the path of an icon to display next to the resource in the catalog. The icon should preferably be 32 x 32 pixels in size.
    Small Icon URI	Enter the path of an icon to display next to the resource when it appears in the Up menu in the catalog. The icon should preferably be 16 x 16 pixels in size.
    Tool Tip	Enter the text to display when users hover the mouse over the resource in the catalog.

12. In the New Attribute Name field, enter the name of an attribute that has been defined for the resource but is not exposed in the dialog. You can also select an attribute from the drop-down list.
13. In the New Attribute Value field, enter a value for the attribute specified in the New Attribute Name field, and click Add.

    Tip:

    You can click Add even without specifying a value for the attribute. You can specify the value once the field is displayed in the dialog along with the other display options.

14. Click the Parameters tab and define parameter values for resources that support wiring, for example, portlets and task flows. For details about supported parameters for a resource, refer to the documentation for that resource.
15. Click OK.
16. When you are done, click Save and Close.