Modify an SFTP (embedded) pickup or delivery

After you create an SFTP pickup or delivery, you can view and modify certain fields that define the object.

SFTP (embedded) settings tab (pickup)

• Embedded SFTP server – The name of the server. A link is provided to view the settings for the embedded server. You also can change servers.
  • View settings for this embedded server – Click this link to open the Change this embedded server screen for this exchange. This enables you to configure settings for the screens described below. For a description of the fields you can view when you click this link, see SFTP (embedded) server fields.
• Host – The name used by Activator for the computer running the embedded server. You cannot change this field.
• Host used by partners – The fully qualified domain name or IP address your partners use pick up messages from this exchange. When you export your community profile as a partner profile, the host information becomes part of your exported partner profile.
• You can change this field by clicking View settings for this embedded server (see above) and changing the External host or IP address field. If your network uses a load balancer or firewall, contact your network administrator for the correct value. Any change to this field affects all delivery exchanges that reference the server.

SFTP (embedded) settings tab (delivery)

• Embedded SFTP server – The name of the server. A link is provided to view the settings for the embedded server. You also can change servers.
• View settings for this application – Click this link to open the Modify Application Pickup screen for this exchange. This enables you to configure settings for the screens described below. For a description of the fields you can view when you click this link, see SFTP (embedded) transport configuration.
• Host – The name used by Activator for the computer running the embedded server. You cannot change this field.
• Host used by partners – The fully qualified domain name or IP address your partners use to send messages to this delivery exchange. When you export your community profile as a partner profile, the host information becomes part of your exported partner profile.
• You can change this field by clicking View settings for application (see above) and changing the External host or IP address field. If your network uses a load balancer or firewall, contact your network administrator for the correct value. Any change to this field affects all delivery exchanges that reference the server.
• Preserve original filenames – Select this option if you want original file names to be preserved when Activator delivers messages.
• For binary messages, we recommend that you preserve original file names. Otherwise, Activator assigns a unique file name that does not readily identify the contents of the file. Preserving original file names also allows your back-end application to process binary messages based on their file names.
  • Overwrite duplicate filenames – An option when you choose to preserve original file names. If duplicate file names are detected, Activator overwrites the existing file.
  • Sequentially number duplicate filenames – An option when you choose to preserve original file names. If duplicate file names are detected, Activator appends a number to the new file. For SFTP, the appended number is hexadecimal and has the format: filename_c4.
• Generate unique filenames – Select this option to have the system provide a unique file name instead of using the original name.
• When this option is selected, files are given arbitrary names. The names always have less than 30 characters and often have less than 20 characters.
• Appended to the file name is a hex representation of a monotonically increasing file name counter that is maintained in the database and guaranteed to be unique. In addition, if the original file name had an extension, the same extension is appended to the unique name the system generates.
• The following are examples of unique file names generated by the system, one with the original file extension and one without:
  • dabeed45_4cb.edi
  • z47e4120_4ce

Directories tab (pickup)

On this tab you configure pickup directories associated with SFTP user accounts. Paths begin from the home directory of the SFTP user account. Activator places messages in these directories for the partners or for the back-end system to download.

If the partner or back-end system uses the same account to upload messages, you must configure a separate directory for uploads on a delivery exchange.

If no account exists, click Add to add an account and associated directory.

Directories tab (delivery)

On this tab you configure delivery directories associated with SFTP user accounts. Paths begin from the home directory of the SFTP user account. Activator places messages in these directories for the partners or for the back-end system to upload.

If the partner or back-end system uses the same account to pick up messages, you must configure a separate directory for pickups on a pickup exchange.

If no account exists, click Add to add an account and associated directory.

Advanced tab (pickup)

• Allow SFTP clients to add, remove subdirectories – Enable subdirectory management on the client side.
• Back up the files that go through this transport – Indicates whether the system backs up copies of the messages it retrieves from integration or receives from partners.
• Backing up files is strongly recommended. This is required for the system to perform fail-over operations such as attempting to send messages again (retries) in case of a transport connection failure. Without backups, a message in process cannot be recovered if the server stops or restarts. Backups also are needed if you want the ability to resubmit messages to a back-end application or resend messages to partners.
• Backup files are stored in \<install directory>\common\data\backup, unless you specify otherwise.
• Process consumed messages using community collaboration settings – Apply the community collaboration settings to the messages that are consumed by this pickup.
• Perform content processing on consumed messages – Select this option if you want to apply processing to the messages you pick up using this exchange. If you select this option you can then select a service to supply the processing.
  • Services – From the drop-down list, select the service to use for message processing.
• Restrict maximum file size for this transport – Select this option to specify the maximum size of files the exchange can handle. If the trading engine receives a file larger than the maximum, the file is rejected and a message is written to the events log.
  • Maximum file size – Enter the maximum file size in bytes. Do not use commas.

Advanced tab (delivery)

• Delete file after it is downloaded – Select this if you want the server to delete files after they have been downloaded from it.
• Allow SFTP clients to add, remove subdirectories – Enable subdirectory management on the client side.
• Back up the files that go through this transport – Indicates whether the system backs up copies of the messages it retrieves from integration or receives from partners.
• Backing up files is strongly recommended. This is required for the system to perform fail-over operations such as attempting to send messages again (retries) in case of a transport connection failure. Without backups, a message in process cannot be recovered if the server stops or restarts. Backups also are needed if you want the ability to resubmit messages to back-end applications or resend messages to partners.
• Backup files are stored in \<install directory>\common\data\backup, unless you specify otherwise.
• Post-processing script – The full path to an executable file that contains post-processing commands.