Interacting with error handling

The ErrorHandlingConfig user control, provided with Nintex Workflow 2013, is a composite control that you can add to the configuration page to support error handling in a custom workflow action. For more information about error handling in custom workflow actions, see Supporting error handling.

The ErrorHandlingConfig user control allows the user to enable or disable error handling for the custom workflow action and, if enabled, specify the workflow variables used to contain error information.

Note: Only one instance of the ErrorHandlingConfig user control can be added to a configuration page.

The following image illustrates the appearance of an implemented ErrorHandlingConfig user control.

To add error handling to a configuration page

1. Register the ErrorHandlingConfig user control on the configuration page.

   <%@ Register TagPrefix="Nintex" TagName="ErrorHandlingConfig" Src="~/_layouts/NintexWorkflow/ErrorHandlingConfig.ascx" %>

2. Add an instance of the ErrorHandlingConfig user control to the collection for the TemplateRowsArea property of the ConfigurationPropertySection control, in the body of the configuration page, as shown.

   <asp:Content ID="ContentBody" ContentPlaceHolderID="PlaceHolderMain" runat="Server">
     <Nintex:ConfigurationPropertySection runat="server" Id="MainControls1">
       <TemplateRowsArea>
         ...
         <Nintex:ErrorHandlingConfig runat="server" id="errorHandlingConfig1"></Nintex:ErrorHandlingConfig>
         ...
       </TemplateRowsArea>
     </Nintex:ConfigurationPropertySection>
     ...
   </asp:Content>

3. In the TPARetrieveConfig JavaScript method for the configuration page, add the following code.

   LoadErrorHandlingSection();

4. In the TPAWriteConfig JavaScript method for the configuration page, add the following code.

   SaveErrorHandlingSection();

See Also

Concepts

Configuration pages

Operations

Working with workflow actions