Set Properties

The Set Properties step allows you to set values for various Document and Process Properties Connector properties. This properties can be used to set outbound Connector attributes such as file name or email subject, or store certain values in memory to facilitate the integration. The property values can be comprised of static and/or dynamic values.

Please see Understanding Document Properties and Understanding Process Properties to learn more.

This step is most often used immediately before the outbound Connector. The type of Property set in the shape should correspond to the type of Connector the data will be sent to. For example, if you are sending data via FTP, you will want to use the Document Properties shape to set the FTP File Name as opposed to the Disk or SFTP File Name. (Technically you could set the Disk or SFTP File Name, but they would simply be ignored by the FTP Connector.)

Some common uses of the Set Properties shape:

• Setting the outbound Disk/FTP/SFTP file name from a mix of static and dynamic content
• Changing the subject for email alerts, allowing you to reuse the same Mail Operation Component
• Dynamically setting the outbound FTP/SFTP directory

Configuration

You can use the Set Properties step to set one or more properties for the current document. On the left side are the Properties to set. On the right side are the list of Parameters that define the value for the given Property. You can add multiple Parameter values to concatenate a more complex value with dynamic content.

1. Click the Add () button on the left side.
2. Navigate to and select the desired Property and click OK.
3. Select the newly added Property on the left and then click the Add () button on the right side.
4. Configure the type of Parameter to use as a value for the Property and click OK. Click here for more information on setting Parameter values.
5. Add additional Parameters and Properties as needed.
6. Click OK.

Use the Edit () and Delete () buttons to modify or remove Properties or Parameters.

Scenario

You can use multiple Parameters to create complex dynamic values for file names or directories. For example, suppose you wanted to write data out to Disk with the following file naming convention:

NEW_ORDER_<order number>_<current timestamp>.txt

You could use the Set Properties step to dynamically set the Disk File Name with five Parameters like this:

Parameter 1: Type=Static Value, value="NEW_ORDER_"
Parameter 2: Type=Profile Element, choose appropriate Profile Type, Profile, and Element
Parameter 3: Type=Static Value, value="_"
Parameter 4: Type=Date/Time, Date Mask="yyyyMMddHHmmss", Date Type=Current Date
Parameter 5: Type=Static Value, value=".txt"

---

See also:

• Understanding Document Properties
• Understanding Process Properties