Document! X 2017
Project Fundamentals / Build Configurations / Build Configuration Event Actions
In This Topic
    Build Configuration Event Actions
    In This Topic

    Build Configurations allow you to define a specific set of Build Profiles, Additional Locales and Publishing Targets so that you can quickly Build and Publish a set of outputs as a single operation.

    Build Configurations can have one or more Event Actions that will be executed each time the Build Configuration is Built. Event Actions can invoke an external program or script, or show / log a message. You might define a Event Action to invoke some external process that must be run each time you rebuild the documentation, or show a message during the Build process to remind/warn the user performing the build that some related manual process must take place.

    Event Actions will execute when building interactively as well as when you build using Command Line.

    Event Action Fundamentals

    Create a new Event Action

    1. Click the Project Settings button on the Project Ribbon Tab;
    2. Select the Build Configurations page;
    3. Select the Build Configuration you wish to add an Event Action to;
    4. Under the Custom Event Actions heading, click the Add New Event Action drop down button;
    5. Choose the Event Type (Build or Publishing). Publishing events are useful if you are using Publishing features and you want an action to execute only after Publishing has completed;
    6. The new Event Action will be created and added to the list;
    7. Use the provided drop down lists to select the Event Action Sequence (Before or After Build/Publishing) and the Action Kind (Run a Program / Script or Show a Message);
    You can give the Event Action an identifying name (using the editable field directly beside the Delete button) in order to identify it in the Build log.

     

    Delete an Event Action

    1. Click the Project Settings button on the Project Ribbon Tab;
    2. Select the Build Configurations page;
    3. Select the Build Configuration you wish to add an Event Action to;
    4. Click the Delete toolbar button at the top right of the Event Action in order to Delete it.

     

    See Also