Aptean Ship Connector

The Aptean Ship Connector controls the connection to local hardware necessary for generating labels, shipping docs and reading weight from electronic scales.

Desktop Application vs. Windows Service

The Aptean Ship Connector can be run as either a desktop application or as a Windows service. The installer will install the files necessary to run in both modes. The mode in which you run the Connector is up to you.

Running the Connector as a desktop application rather than a service removes the need to manage many Windows user permissions required for the connector service to run correctly. We recommend running connectors used for Printing traffic as a Desktop application for this reason.

The mode in which the Connector is running is indicated at the top of the Connector screen.

Service mode

When running the Connector in service mode, we advise running the Connector service as the user that will be signed into the local machine with the printers attached and this user should have local administrative rights.  This will provide the print agent service with the permission to run and allow the logged-in user to see all of their previously added printers.

Set Up the Connector

The Aptean Ship Connector can be launched from Aptean Ship Program menu (Start > Programs > Aptean Ship > Aptean Ship Connector). The Connector runs in the Windows System Tray. Double-click the icon to open it.

Any component – Scales, and/or Printing – can be unchecked if not needed on this PC. Components that are not enabled will not appear in Aptean Ship.

Scales

On the Scales tab, check “Scales Support Enabled” to enable and set up a scale. Then, enter the Scale Server address.

Scales setup

 

Click Setup Scales to set up a USB or COM scale. For USB scales, the list of scales will display any USB scales that are currently connected and active in Windows.

To add a COM scale, click the Add COM Scale button. Select the scale type and the COM port from the drop-down lists.

Scale Setup

Configure the scale communication parameters and click Save. You can review the factory settings for all supported scales here.

Once you are done configuring scales, click the Save Config for Selected Scale button.

Printing/EDI Support

In Printing, you can configure printing settings, enable Print Agents and set the number of Print Agents for each Aptean Ship Location, and set the location of the Shared EDI folder.

Configure Printing Values

  • Printing Support Enabled: This check box must be checked in order to print or to enable EDI.[/ht_message]
  • Aptean Ship Server Address: This is the address and port for the Aptean Ship Server.
  • Printing Service Address: This is the Aptean Ship Server address and port 20003. Ex: “net.tcp:ApteanShipServer:20003”
  • Print Agent Timeout: This is the maximum time in seconds to start and initialize the Print Agent before timing out.
  • Print Job Timeout: This is the maximum time in minutes to complete a printing task before timing out.
  • Printing Path Folder: Select a folder to which files should be printed.
  • Shared EDI Folder: Aptean Ship will create the EDI files and save them to a shared folder that is defined here. Each person using a different Connector for printing will also need to point to the same shared EDI folder. Therefore, each user with a different printing Connector needs to set up this shared location in their Connector’s Printing settings. If the EDI path is remote you should use a UNC path instead of a mapped drive.
    Aptean Ship will create subfolders under the folder specified here for each EDI Provider in use.

Set Up Printing Locations

  1. Click the Configure button to see the list of locations.
  2. Check the “Enabled” column for the locations to use with this Connector.
  3. Set the number of Print Agents per location.
Settings

The settings section contains the paths to locations of the logging and config files. Check the AutoUpdate Enabled check box to enable automatic updating of the Connector. If the current Connector won’t work with the new Aptean Ship version, the Connector will auto update immediately; if it will work with the new Aptean Ship version, the Connector waits until 3 – 4 AM to auto update.

Diagnostics

This section allows you to tests communications between the Connector and the Aptean Ship Server.