POtoFile

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

Use this component to send a purchase order or other textual data to a file.

Intended use: Order Processing pipeline, Purchase Order Submit or Accept stage.

Configuration Values

You can determine where the POtoFile component retrieves the document and where it writes the result by setting component properties. Use the following boxes on the PO to File tab of the Component Properties dialog box to determine this information.

Box

Description

Source Field Name

The name of the field on the order from which the component reads the purchase order data. The default is po_text.

File Name

The full path of the file the component writes the purchase order to. To locate the file, click Browse.

File named in field

The name of the field in the Order dictionary whose value is the name of the file the component writes the purchase order to; for example, save_filename.

Temporary file, name saved in field

Specifies that the component should save the text to a temporary file, and then save the name of the temporary file in the field that is identified in the text box. For example, saved_filename.

Append to file instead of overwriting file

When checked, indicates that the text should be appended to the indicated file. Otherwise, the file is overwritten if it exists.

Values Read

The POtoFile component reads the value specified by the key in the Order dictionary indicated in the Source Field Name box.

Values Written

None.

Remarks

The File Name, File named in field, and Temporary file boxes are mutually exclusive; that is, you can select only one of the three.

Programmatic Use

To use this component outside a pipeline, you must configure it by assigning values to keys in the Configuration dictionary. The keys correspond to the indicated boxes in the Component Properties dialog box.

Key

Box

Description

SourceFieldName

Source Field Name

String.

SaveMode

N/A

Numeric. 0 for file name given; 1 for file name comes from SourceFieldName.

FixedSaveFileName

File Name

String.

SaveFileFieldName

File name in field

String.

TempFileFieldName

Temporary file, name saved in field

String.

IsAppendToFile

Append to file instead of overwriting file

Numeric. 0 for overwriting; 1 to append.

See Also

Other Resources

Pipeline Component Reference