+

Search Tips   |   Advanced Search


Site management extension of the Portal Scripting Interface

You can use the site management extension bean of the Portal Scripting Interface to publish, promote, or demote portal content.

The portal content can consist of content nodes, labels, pages or partial hierarchies, compositions, or links to both internal and external URLs.

Example scenario:

A sales company has a test portal and a production portal. The administrator creates a page for a special sale on the test portal. When the approving parties are happy with that page, the administrator publishes the page by moving it from the test or source portal to the production or target portal. By personalization rules, only the administrator can view the page. For the start day of the sale, the administrator promotes the page on the production portal. This makes the page visible to portal users with the appropriate access permissions. When the sale period is over, the administrator demotes the page on the production portal. Users can then no longer view the page.

The methods listed in the following are available for site management. You can use them to publish, promote, or demote a page. All commands start with $Publish .Notes:

  1. None of the parameters for the methods listed here have default values. You need to specify values for all of the parameters, otherwise the script will not run.

  2. Parent and sibling pages or portlets that you publish by using site management must have a unique name assigned to them on both the source and target servers. For a portlet the unique name must be the same on both the source and the target server. Make sure that when you create your page that you assign it a unique name; otherwise, you cannot publish the page to another server. When you create a new page, the system assigns the page a Unique Identifier; this is not the unique name. To assign a unique name to your page or label, edit the page properties and enter a value in the Unique Name field, or use the Manage Custom Unique Names portlet.

  3. If the pages or portlets that you publish have existing personalization visibility rules associated with them, site management will publish the rule associations, but not the rules themselves.

    You must make sure that the same rules exist on both the source and target servers, and preserve the correct page-to-rule association by creating a Publish Server using the Personalization tools. Publish the required rule by selecting the Publish Selected menu option under Extra Options.

  4. Publish a page into the public area of the portal is not supported.

  5. When a page hierarchy that you publish contains a page that is marked private for yourself on the source server, that private page is published as a public page on the target server. In other words, users of the target portal might be able to see your private page there. This also applies to private changes that you made to a page that you publish. When you publish that page, other users can see the page just the same as you with all private changes that you made to the page.

  6. Pages that exist on the target server, but have not been created by a by site management publish step cannot be replaced by using the site management functionality. In such a scenario an error message is displayed.

  7. Pages managed by site management must only be changed on the source server, not on the target server; otherwise the site management function may not work any more.

  8. If two administrative users attempt to publish different versions of the same page at the same time, there is no support for merging these multiple publish actions. The last version of the page to be published is displayed. It overwrites other versions.

  9. To publish, promote, or demote portal content by using a secure connection with SSL (Secure Socket Layer), append the letter s to the http string of the source or target server URLs as follows: https. You might have to perform additional steps for the connection to work, such as importing a cert into cacerts.


Published items

The following information, or referenced items, are published if they are included in a page:

Limitations:


Script syntax

The following topics show the Portal Scripting Interface syntax for publishing, promoting, and demoting content.


Parent topic:

Manage your site


Related concepts


Work with the Portal Scripting Interface


Related tasks


Enable remote access to your servers
Manage your servers
Publish your page
Providing reviewer access to a published page
Promote your page
Demote your page
Republishing and promoting a page
Manage your site