Write String operation

Writes the content of A string value that is in the process data to a file in the file system of the LiveCycle Server.

For information about the General and Route Evaluation property groups, see Common operation properties.

Input operation

Properties that specify the file to write.

Pathname Pattern

A string value that represents the fully qualified name of the file to create in the file system of the LiveCycle Server. The pathname pattern can include the following parameters that are replaced with specific values at run time.

Parameter

Description

%Y

The current year (four digits)

%y

The current year (last two digits)

%M

The current month

%D

The current day of the month

%d

The current day of the year

%H

The current hour using the 24-hour clock

%h

The current hour using the 12-hour clock

%m

The current minute

%s

The current second

%R

A random number between 0 and 9

Value

A string value that represents the content to write to the file.

CharSet

(Optional) A string value that represents the character set to use to interpret the text that is written to the file. The following values can be specified:

  • Big_Five

  • GB_2312

  • ISO_8859_1

  • ISO_8859_2

  • ISO_8859_7

  • KSC_5601

  • Shift_JIS

  • US_ASCII

  • UTF_16

  • UTF_16BE

  • UTF_16LE

  • UTF_8

Make Unique

A boolean value that specifies whether the name of the file is to be made unique. A value of True indicates the file name should be made unique and a value of False indicates the file name is not unique. The default is False.

To specify the literal value of True, select Make Unique. To specify the a literal value of False, deselect Make Unique.

The following behavior occurs if a file exists with the same file name that is specified for the new file:

  • If Make Unique is set to true, an index is appended to the name of the file that is created. The index distinguishes the new file from the existing file.

  • If Make Unique is set to false, the value of the Over Write property determines the behavior:

    • if Over Write is set to true, the existing file is overwritten with the new file.

    • If Over Write is set to false, an exception is thrown.

Over Write

A boolean value that specifies whether to replace a file of the same name provided for Pathname Pattern if it exists. A value of True indicates the file is replaced and a value of False indicates the file name is not replaced. The default is False.

To specify the literal value of True, select Over Write. To specify the a literal value of False, deselect Over Write.

Note: An exception is thrown when a file exists with the same name that is specified for the new file, Over Write is set to false, and Make Unique is set to false.

Output properties

Properties for saving the operation results.

Result

(Optional) The location to store the name of the file that was written. The data type is string.

Exceptions

The exception event attached to this operation can receive FileUtilsException exceptions.

// Ethnio survey code removed