Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Appendix B Scripts : Overview

Overview
TIBCO BusinessConnect supports the use of scripts to manage file processing for FTP inbound and outbound transport and File outbound transport.
To use scripts you must install the FESI EcmaScript Interpreter as described in TIBCO BusinessConnect Installation and Configuration, Installing FESI EcmaScript Interpreter to Support Custom Scripts.
See FTP/S Inbound, FTP/S Outbound, and Configuring Outbound File Transport for a Partner for information on how to specify scripts in transport configuration dialogs.
Script activities can be captured as audit trails using the logging object available in the context of the script. See Audit Logging in Scripts. In addition, an error advisory is also published when error is logged using the Java object.
Scripts should use Java methods to throw exceptions for script failures. If no exceptions are thrown, TIBCO BusinessConnect considers the scripts as having completed successfully.
TIBCO BusinessConnect provides a Java API for use within scripts. For information on this API, see the TIBCO BusinessConnect API Reference.
This appendix also explains how to use the file specification dialog, which is used to specify DTD, guideline, and script files.
FTP Scripts
FTP scripts allow you to control the retrieval of files from and the storage of files on an FTP server. When FTP scripts are used, the normal file retrieval from or file storage to an FTP server is bypassed. Instead, the designated FTP script is called and the FTP script is responsible for retrieving or storing the files. It is also possible to perform pre- and post-processing, as appropriate for your application, from within your script.
For reference, see FTPClient, FTPReply, and UserLogAccess scripts in TIBCO BusinessConnect API Reference.
Secure FTP
Secure FTP (FTPS) is supported within FTP scripts by using the FTPClient API in secure mode. Secure mode is activated by providing the certificate specified for the trading partner to the setSSLCertificate(java.lang.String) method.
If the FTP server supports SSL with client authentication, then the host private key should also be set with setSSLHostKey(java.lang.String).
The default secure transport version is obtained from the FTPS configuration settings (see Selecting and Configuring FTP/S Inbound and Configuring FTP/S Outbound). You can modify the transport version with the method setTransportType(java.lang.String).
SSHFTP Scripts
For reference, see FileAttr, SSHFTPClient, SSHFTPReply, and IFTPFlavorReply scripts in TIBCO BusinessConnect API Reference.
Document Security through PGP
PGP (Pretty Good Privacy) packaging and un-packaging is also supported through FTP/FTPS/SSHFTP scripts to provide document security.
PGP is supported within FTP/FTPS/SSHFTP script also by using FTP/FTPS/SSHFTP Client API. You can set up PGP options (sign, encrypt, compress, format, and so on) by using methods defined in the FTP/FTPS/SSHFTP Client object; however, PGP keys and cipher algorithms used in PGP packaging or un-packaging still need to be configured in the business agreements's Document Exchange. For more details, see Business Agreement: Document Security Tab.
File Scripts
File scripts allow you to control the storage of files on the file system when using File outbound transport. When scripts are used, the normal file storage to the file system is bypassed. Instead, the designated script is called and the script is responsible for storing the files. You can also perform pre- and post-processing, as appropriate for your application, from within your script.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved