How to Create a Custom Pipeline

With the Pipeline Editor, you can create a custom pipeline without basing it on one of the preconfigured pipeline template files (.pct).

Note

You cannot use the Expression Evaluator with your own custom-built pipelines.

To create a custom pipeline

  1. Click Start, click Programs, click Microsoft Commerce Server 2009 R2 , click Tools, and then click Pipeline Editor.

  2. In the Pipeline Editor, on the File menu, click New.

  3. In the Choose a Pipeline Template box, select Empty.pct, and then click OK.

    An empty pipeline file appears.

  4. Right-click Empty Pipeline Template, and then click Properties.

  5. In the Pipeline Properties dialog box, do the following:

    Use this

    To do this

    Label

    Type a name for the pipeline.

    Transaction Compatibility

    Select a transaction compatibility option from the drop-down list. The options are the following:

    • Any pipeline. May be loaded into any pipeline.

    • Requires transacted pipeline. Must be loaded into an MtsTxPipeline or PooledTxPipeline pipeline.

    • Requires a non-transacted pipeline. Must be loaded into an MtsPipeline or PooledPipeline pipeline.

    Supply a currency LCID

    Specify a locale ID (LCID) for currency handling. The default value is zero (0), which uses the default locale ID of the server.

    Supply the number of decimal places used for currency rounding

    Type the number for digits of precision to be held by the currency, for example, two digits are held for United States pennies. You use this value for default rounding processing, and to determine the scaling factor used in legacy currency keys.

    Description

    Type a description for the pipeline.

  6. Click Apply, and then click OK.

  7. In the Pipeline Editor, right-click the name of the new pipeline, and then click Insert Stage.

    A New Stage placeholder appears in the pipeline.

  8. Right-click New Stage, and then click Properties.

  9. In the Stage Properties dialog box, do the following:

    Use this

    To do this

    Label

    Type a name for the stage.

    Description

    Type a description for the stage.

    GUID

    Type a GUID for the stage.

    Mode

    A value of zero (0) prevents the stage from running.

    Error level

    Specify the error level for the stage.

    Dd464400.alert_note(en-us,CS.95).gifNote:
    When any component in the stage generates an error at or above the level specified in the Error level box, the stage stops running and generates an error. For more information about error levels, see What Are Pipeline Component Error Levels?
  10. Click Apply, and then click OK.

  11. Right-click the name of the new stage, and then click Insert Component.

  12. In the Choose a component dialog box, do the following:

    Use this

    To do this

    Stages

    Select a stage option.

    Components

    Select the name of the component you want to insert.

  13. Click OK.

  14. To configure the new component, right-click the component, and then click Properties. Modify the properties of the component as required, and then click OK.

  15. On the File menu, click Save As, and then type a name for the pipeline configuration file in the File name box.

The file is saved with the .pcf file name extension.

See Also

Other Resources

Extending Commerce Foundation

How to Open an Existing Pipeline for Editing

How to Create a New Pipeline

How to Add a Component to a Pipeline

How to Change the Order of Components in a Pipeline Stage

Pipeline Editor Property Pages