Skip to main content

 Services

Web services from /about to /webhooks

start uri publish

/members/{member}/groups/{group}/uris/{uri}/publish/start [GET]

Description

Start a document or folder publish job.

The target PSML ANT script must already be configured on the Publish Engine.

The Publish Engine on a different PageSeeder server can be used by setting the property publishEngineUrl in the global.properties.

The progress of the job can be monitored by getting the log messages from Service: /members/{member}/publish/check [GET]. The logs can also be accessed through the Admin user interface and are stored under the following location: /WEB-INF/state/logs/publish .

To invoke this service from ANT use the publish task which will return logs from the publish action and wait until it is finished.

Parameter values can be used in the ANT script using ${ps.param.[name]} after calling the <ps:config /> task. e.g.

<ps:config />
<echo>The xyz parameter is ${ps.param.xyz}</echo>

Parameters

NameDescriptionRequiredTypeDefault value
projectThe project containing the ANT scriptyesstring
targetThe target name in the scriptyesstring
typeThe type of action export|publish|processyesenum
documenttypeThe document type (only applies to PSML documents)nostring
log-levelThe level of logging the script should output info|verbose|warn|error|debugnoenuminfo
ps-param-[name]The value of a parameter for the scriptnostring

Permission

Requires guest or higher access to the group.

Response

XML returned:

<check date="2018-10-08T14:11:51+11:00">
  <publish id="[job ID]">
    <parameters>
      <param name="ps-userFirstname" value="[first name]" />
      ... 
    </parameters>
    <status>in-progress</status>
    <message logged="false"
             type="in-progress"
             target="starting"
             progress="0">Publish Job started
    </message>
  </publish>
</check>

Error Handling

No specific errors expected for this service.

Created on , last edited on