1 ..

     2     ============================================================================ 

     3     Name        : final.rst

     4     Part of     : Helium 

     5     

     6     Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

     7     All rights reserved.

     8     This component and the accompanying materials are made available

     9     under the terms of the License "Eclipse Public License v1.0"

    10     which accompanies this distribution, and is available

    11     at the URL "http://www.eclipse.org/legal/epl-v10.html".

    12     

    13     Initial Contributors:

    14     Nokia Corporation - initial contribution.

    15     

    16     Contributors:

    17     

    18     Description:

    19     

    20     ============================================================================

    21 

    22 .. index::

    23   single: Stage - Final operations

    24 

    25 Final operations

    26 ================

    27 

    28 Final operation are steps which could happen at the workflow completion.

    29 

    30 

    31 Running a target at build completion

    32 ------------------------------------

    33 

    34 Helium offers the possibility to run a final target despite any error which could occur during the build.

    35 The configuration of the target is done using the **hlm.final.target** property.

    36 

    37 e.g:

    38 ::

    39    

    40    <property name="hlm.final.target" value="my-final-target" />

    41    

    42 

    43 Running action on failure

    44 -------------------------

    45 

    46 The signaling framework will automatically run all signalExceptionConfig in case of Ant failure at the

    47 end of the build. 

    48 

    49 This example shows how simple task can be run in case of failure: 

    50 ::

    51    

    52        <hlm:signalExceptionConfig id="signal.exception.config">

    53            <hlm:notifierList>

    54                <hlm:executeTaskNotifier>

    55                    <echo>Signal: ${r'$'}{signal.name}</echo>

    56                    <echo>Message: ${r'$'}{signal.message}</echo>

    57                    <runtarget target="build-log-summary" />

    58                </hlm:executeTaskNotifier>

    59            </hlm:notifierList>

    60        </hlm:signalExceptionConfig>

    61    

    62 

    63