IPWorks EDI 2020 C++ Builder Edition

Questions / Feedback?

OFTPClient Component

Properties   Methods   Events   Configuration Settings   Errors  

The OFTPClient component implements the Odette File Transfer Protocol.

Syntax

TibeOFTPClient

Remarks

The OFTPClient component may be used to send and receive OFTP files to and from an OFTP server.

Receiving Files

The OFTPClient ReceiveFiles function requires certain server properties be set. You must set the RemoteHost property to the remote location of the desired OFTP server. You may also set a RemotePort if the server is not set to the default protocol port. For client authorization, you must set the ClientSSIDCode, ClientSFIDCode, and ClientPassword properties. And, for server authentication, you must set the ServerSSIDCode, ServerSFIDCode, and ServerPassword properties.

The component will connect to the OFTP server and download all files in the server's outgoing queue, and write these files to the directory specified by DownloadDirectory. The component creates a default location on the local machine based on the values of the DownloadDirectory and the Virtual Filename as received from the server. If a different location is preferred, you may set the LocalFile parameter of the StartTransfer event.

Sending Files

The OFTPClient SendFile function requires the same server and authentication properties to be set as the ReceiveFiles function.

The component will connect to the OFTP server and upload the file contained by the LocalFile parameter. It uses the name specified by VirtualFileName when sending to the server. If this is not specified, the filename of the local file is parsed and used as the virtual filename.

Property List


The following is the full list of the properties of the component with short descriptions. Click on the links for further details.

CertEncodedThe certificate (PEM/base64 encoded).
CertStoreThe name of the certificate store for the client certificate.
CertStorePasswordIf the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.
CertStoreTypeThe type of certificate store for this certificate.
CertSubjectThe subject of the certificate used for client authentication.
ClientPasswordThe client's password.
ClientSFIDCodeClient's SFID code.
ClientSSIDCodeThe client's SSID code.
CompressWhether or not to compress the outgoing file.
ConnectedShows whether the component is connected.
DownloadDirectoryDownload directory.
EncryptionAlgorithmThe encryption algorithm.
FirewallAutoDetectThis property tells the component whether or not to automatically detect and use firewall system settings, if available.
FirewallTypeThis property determines the type of firewall to connect through.
FirewallHostThis property contains the name or IP address of firewall (optional).
FirewallPasswordThis property contains a password if authentication is to be used when connecting through the firewall.
FirewallPortThis property contains the TCP port for the firewall Host .
FirewallUserThis property contains a user name if authentication is to be used connecting through a firewall.
LocalHostThe name of the local host or user-assigned IP interface through which connections are initiated or accepted.
MaxRecordSizeThe maximum length of a given record.
OverwriteWhether or not the component should overwrite files during transfer.
RecipientCertEncodedThe certificate (PEM/base64 encoded).
RecipientCertStoreThe name of the certificate store for the client certificate.
RecipientCertStorePasswordIf the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.
RecipientCertStoreTypeThe type of certificate store for this certificate.
RecipientCertSubjectThe subject of the certificate used for client authentication.
RemoteHostThe domain name or IP address of the OFTP server.
RemotePortThe port for the OFTP service (default is 3305).
SecureAuthenticationWhether or not the component should perform secure Odette authentication.
ServerPasswordThe server's password.
ServerSFIDCodeServer's SFID code.
ServerSSIDCodeThe server's SSID code.
SignedReceiptWhether or not to require signed receipts.
SSLAcceptServerCertEncodedThe certificate (PEM/base64 encoded).
SSLCertEncodedThe certificate (PEM/base64 encoded).
SSLCertStoreThe name of the certificate store for the client certificate.
SSLCertStorePasswordIf the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.
SSLCertStoreTypeThe type of certificate store for this certificate.
SSLCertSubjectThe subject of the certificate used for client authentication.
TimeoutA timeout for the component.
TrustedCertCountThe number of records in the TrustedCert arrays.
TrustedCertEncodedThe certificate (PEM/base64 encoded).
TrustedCertStoreThe name of the certificate store for the client certificate.
TrustedCertStorePasswordIf the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.
TrustedCertStoreTypeThe type of certificate store for this certificate.
TrustedCertSubjectThe subject of the certificate used for client authentication.
UseSSLUse SSL to access the RemoteHost .
VersionWhich version of the OFTP protocol the component is using.
VirtualFileDateThe date/time stamp for the virtual file.
VirtualFileFormatThe structure of the outgoing file.
VirtualFileSecurityLevelThe level of security for the file.

Method List


The following is the full list of the methods of the component with short descriptions. Click on the links for further details.

ChangeDirectionSends a Change Direction (CD) command.
ConfigSets or retrieves a configuration setting.
DoEventsProcesses events from the internal message queue.
ExchangeCertificateExchange a certificate with the remote host.
ImportTrustedCertsImports a list of trusted CA certificates.
InterruptInterrupts the current action.
LogoffLogoff from the OFTP server.
LogonLogon to the OFTP RemoteHost using the current client credentials.
ReceiveFilesReceive any files queued to be sent from the server.
ResetResets the state of the control.
SendEndResponseSends an EERP/NERP asynchronously.
SendFileSend the specified file to the server.

Event List


The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.

AcceptFileFired when the client receives a file.
CertificateReceivedFired when a certificate is received from the remote host.
EndResponseFired every time an end response is received from the server.
EndTransferFired when a file finishes transferring.
ErrorInformation about errors during data delivery.
PITrailFired when any protocol level communication occurs.
SSLServerAuthenticationFired after the server presents its certificate to the client.
SSLStatusShows the progress of the secure connection.
StartTransferFired when a document starts transferring.
TransferFired while a document transfers (delivers document).

Configuration Settings


The following is a list of configuration settings for the component with short descriptions. Click on the links for further details.

AcceptAnySFIDCodeIndicates that all SFID codes are acceptable.
AllowRetryWhether to send a retry indicator when rejecting a file.
CertificateTypeSpecifies the type of certificate being supplied.
ConnectionTypeSpecifies the type of connection that will be created.
CreditCountSpecifies the credit value.
DeleteOnErrorWhether received files are deleted when there is an error during processing.
DisconnectAfterEndSessionDetermines if the connection is closed immediately after ending the session.
EnforceProtocolVersionRequires the server to support the same OFTP version.
ExchangeBufferSizeSpecifies the data exchange buffer size in bytes.
ExchangeCertStoreTypeSpecifies the store type when loading a certificate to be exchanged.
ExchangeCertSubjectThe subject of the certificate being exchanged.
FailOnUntrustedCertWhether or not to throw an exception when untrusted certificates are used.
FileDescriptionAdditional description information sent with the file.
FileHashAlgorithmThe hash algorithm to use when sending a file.
FireEndResponseOnSendDetermines if the EndResponse event is fired for outgoing EERP and NERPs.
FollowRedirectsDetermines behavior when importing trusted certificates and a HTTP redirect is returned.
FriendlyLogFormatDetermines if a more friendly format is applied to PITrail event out.
MaskSensitiveMasks passwords in logs.
ReceiptHashAlgorithmThe receipt hash algorithm to request when sending a file.
ReceivedFileDateTimeThe datetime of the file being received.
ReceivedFileDescriptionAdditional description information received with the file.
ReceivedFileEncryptionAlgThe encryption algorithm used for the file being received.
ReceivedFileNameReturns the name of the received file.
ReceivedFileNameFormatThe name format of received files.
ReceivedFileNameFormatThe name format of received files.
RecipientCertificateTypeSpecifies the type of recipient certificate being supplied.
RetryIndicates whether the recipient allows the send to be retried.
SendCDAfterEFPASpecifies whether a CD is always sent after receiving an EFPA.
TempPathThe path of a directory where temporary files will be created.
TrustedCertsDataSpecifies the source to be used when importing trusted certificates.
VirtualFileDateFormatThe DateTime format of received files.
BuildInfoInformation about the product's build.
CodePageThe system code page used for Unicode to Multibyte translations.
LicenseInfoInformation about the current license.
UseInternalSecurityAPITells the component whether or not to use the system security libraries or an internal implementation.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks EDI 2020 C++ Builder Edition - Version 20.0 [Build 8203]