File Masks

You can use file masks to configure how to retrieve files from and send files to a trading partner.

FTP Inbound File Name Masks

You use inbound file name masks to control which files FTP-GET retrieves from an FTP server. The FTP-GET mask option is available in the FTP Edit Settings dialog, which is accessible in the Transports tab for a protocol binding.

See TIBCO BusinessConnect™ Container Edition Trading Partner Management Guide for more information.

File Name Mask Examples

If the trading partner name is receiver, and the host name is sender, to generate an inbound file named receiver.sender.12202004-TIBCO.edi on December 20, 2004, enter the following mask in the File Mask field:

#(TpName).#(HostName).#(MMDDYYYY)-TIBCO.edi

Some other examples are as follows:

• MyFile.dat. This example specifies the exact name of the file to be retrieved.
• TIBCO_#(YYYYMMDD).dat. This example uses a standard predefined variable for retrieving the file.
• #(var1)_#(var2).dat. This example uses user-defined variables for retrieving the file.
• *. This example uses the asterisk wildcard character (*) to retrieve files. This retrieves all files.
• #(var1)_#(var2)*.dat. If var1 is defined as TIBCO and var2 is defined as X12, this would retrieve all files with names beginning with TIBCO_X12 and ending with .dat.

When wildcard characters are used in the mask, files are retrieved using mget. Not all FTP servers implement mget. Be sure to verify that your trading partner FTP server supports mget before defining file name masks, which use the asterisk wildcard character (*).

Note: The following characters are treated as special in EDI for masks: #, (, ). Any value between # and first closing parenthesis ')' will be checked for a replacement and, if not found, will be made an empty string

File Name Mask Syntax

The following table lists the mask syntax supported for FTP-GET.

Note: You can use an asterisk (*) in an FTP-GET mask. This acts as a wildcard. Masking applies only to file names. It does not apply to any directory name in the FTP URL. For example, if the FTP URL is /local/tibco/bc/#(TPNAME)/REQUEST/, and /local/tibco/bc/SELLER-AXNT15/REQUEST/ exists, FTP fails.

FTP-GET File Name Mask Syntax

Mask Name Case Sensitivity Description
#(TpName) Case-insensitive Trading partner name
#(HostName) Case-insensitive Host Name
#(DDD) Case-insensitive Day of the year
#(MMDDYYYY) Case-insensitive MM = Month, DD = Day, YYYY = Year
#(HHMISSNNN) Case-insensitive HH = hour, MI = minute, SS = second, NNN = milliseconds