Microsoft Producer for PowerPoint 2003 SDK banner art
PreviousNext

action

The action element lists a single application-level Producer action, such as building or saving. The action is specified by the command attribute.

Syntax

<action 
    command="text string">
    <param>parameter value</param>
</action>

Attributes

command (required)

Required value specifying an action to take. Possible values are described in the following table.

Value Parameters Description
build None Builds a project or modifies project data using all the data in the presentation element, but does not save it. You must use the build value any time you change data in a project (for example, by specifying param elements or new media elements on the timeline), even if you are loading an existing project. To save this project after building, you must specify a save value for the command attribute.
publish none Publishes a presentation. Publish location is specified by the PublishDestination property element.
new None Creates a new project.
load Path and file name Loads an existing Producer project file, and performs additional actions upon it.
save Path and file name Saves a project as a Producer project file. Specify the full path and name, with an .MSProducer extension. If the path specified does not exist, this action will fail.
pack Path and file name Saves the presentation to an archive file using the path and file name specified. You must specify an .MSProducerZ file name extension. If the specified path does not exist, this action will fail. (See the topic Using the Pack and Go Wizard in Microsoft Producer Help for more information.)
  Integer value A second parameter for pack, specifies an integer value indicating the maximum size (in megabytes) of each piece of a multi-file archived project. Do not use, if you want the project saved as a single file.
unpackproject Path and file name Unpacks an existing Producer archive file. Include the full path and file name, including the .MSProducerZ extension. (See the topic Using the Pack and Go Wizard in Microsoft Producer Help for more information.)
exit None Closes Producer. Without this action, Producer remains open after the batch file is processed (unless an error occurs.
logging Path and file name Full path and file name of a text file that lists the actions taken when Producer reads the batch asset loading file. The file extension can be anything you choose, but is typically .txt or .log.

Remarks

When an attribute takes a parameter, such as a save location, the parameters follow the attribute, nested inside a param element. If an attribute value (such as pack) has multiple parameters, use separate param elements for each parameter, as shown in the following code:

<action command="pack">
    <param>C:\my projects\presentation.MSProducerZ</param>
    <param>1</param>
</action>

Example Code

<action command="load">
    <param>c:\my projects\myproj.msproducer</param>
</action>

Parent/Child Elements

Hierarchy Elements
Parent actions
Child
  • param (standard XML element not defined in these documents).

See Also

PreviousNext


© 2001-2003 Microsoft Corporation. All rights reserved.