+

Search Tips   |   Advanced Search


Create a Web content page with the XML configuration interface

As with other portal pages, you can create a Web content page with the XML configuration interface (xmlaccess command). Page definition is similar to a standard portal page, with the addition of a page parameter that specifies the site or site area that is associated with the Web content page.

  1. When creating your xmlaccess command, specify your page parameters as you would for a standard portal page, and add the additional parameter com.ibm.portal.wcm.contentroot.

    The com.ibm.portal.wcm.contentroot parameter indicates the site or site area that is associated with the Web content page, and the value can be either the unique ID or the content path of the site or site area. When you add a Web content page with the portal interface, this parameter contains the unique ID or the site or site area. However, because it can be difficult to determine the unique ID of a site or site area when creating a Web content page with the XML configuration interface, the com.ibm.portal.wcm.contentroot parameter also allows you to specify the content path to the site or site area.

    If you configure a site or site area by its path rather than by its ID, that configuration breaks if the corresponding site or site area is renamed or moved. If a site or site area has been configured by its path, the page properties portlet displays a small path icon beside the value. If the associated site or site area is reconfigured in the page properties portlet, the parameter is always filled with the unique ID of the new site or site area.

  2. When creating your xmlaccess command, include the additional parameter param.sharing.scope.

    The value of the parameter can be arbitrary, but it must be unique between pages. Here is an example parameter definition for Web content pages when using the XML configuration interface:

       <parameter name="com.ibm.portal.wcm.contentroot" 
                  type="string" 
                  update="set">
    
          <![CDATA[/mylib/mysite/mysitearea]]>
    
       </parameter>
    
       <parameter name="param.sharing.scope" 
                  type="string" 
                  update="set">
    
          <![CDATA[ibm.wcm.0.34110624169073556]]>
    
       </parameter>
    

  3. When creating your xmlaccess command, add at least one JSR 286 Web Content Viewer that is configured to listen to other portlets and make dynamic broadcasts. This ensures that content selected for this page is rendered correctly and that links between pages work properly.Here is an example of how to add the JSR 286 Web Content Viewer using the XML configuration interface:

    <component action="update" 
               active="true" 
               deletable="undefined" 
               domain="rel" 
               modifiable="undefined" 
               objectid="7_U796BB1A0OS250IOS7F1BP3081" 
               ordinal="100" 
               orientation="H" 
               skinref="undefined" 
               type="container" 
               width="undefined">
    
      <component action="update" 
                 active="true" 
                 deletable="undefined" 
                 domain="rel" 
                 modifiable="undefined" 
                 objectid="7_U796BB1A0OS250IOS7F1BP3085" 
                 ordinal="100" 
                 orientation="V" 
                 skinref="undefined" 
                 type="container" 
                 width="undefined">
    
        <component action="update" 
                   active="true" 
                   deletable="undefined" 
                   domain="rel" 
                   modifiable="undefined" 
                   objectid="7_U796BB1A0OS250IOS7F1BP3087" 
                   ordinal="100" 
                   skinref="undefined" 
                   type="control" 
                   width="undefined">
    
          <portletinstance action="update" 
                           domain="rel" 
                           objectid="5_U796BB1A0OS250IOS7F1BP3083" 
                           portletref="3_U796BB1A008OD0IOS2ODAD28U4">
    
            <preferences name="WCM_BROADCASTS_TO" update="set">
              <value><![CDATA[WCM_LINKING_DYNAMIC]]></value>
            </preferences>
    
            <preferences name="WCM_LISTENS_TO" update="set">
              <value><![CDATA[WCM_LINKING_OTHER]]></value>
            </preferences>
    
          </portletinstance>
        </component>
      </component>
    </component>
    


Parent topic:

Work with Web content pages


Related concepts


The XML configuration interface