• My Cart
    • Item Qty Sub-Item Qty Price
      Trading Partner License 0 0 0
      Basic Kit 0 0 0
      Extended Kit 0 0 0
      X12 Transaction 0 0 0
      SubTotal 0.00

DiTranslator FAQs


Top  |  Back


  • Q: How do I allow partners who trade a transaction using multiple GS/group IDs, but only one ISA/interchange ID?
  • A: Install a separate instance of each transaction set for each partner's business unit or GS profile onto one partner. When installing the transaction set, the Transaction Wizard will prompt you to "Enter the name to display". To distinguish between each transaction instance, assign a suffix to the Name field and use the same suffix in the Folder field.

    For example: If a partner's two GS IDs identify their West and East divisions and you're installing a version 4010 850 for the West division, replace the "850 Ver4010" in the name field with "850 Ver4010_West" and replace the "Ansi\850\4010" value in the Folder field with "Ansi\850\4010_West".

    Top  |  Back

  • Q: Why isn't my file-triggered task list always triggered when two files are written to a directory nearly simultaneously?
  • A: When a file-triggered task list is scheduled using a wildcarded trigger file, the event may not always trigger correctly if a second matching file is created just after the first matching file triggers a previous instance of the task list. To allow this, you must check the "Trigger Action When File: is changed" checkbox in the Schedule Event.

    Top  |  Back

  • Q: Where can I get the information to fill the form below?

    A: From your Trading Partner, VAN, or Hub. Typically this information comes from the party controlling the EDI interactions.

    Top  |  Back

  • Q: Why does nothing happen when Validation button is selected?
  • A: The Validation button on the Element Properties of the Database map will bring up a dialog for adding validation values for any field that has a corresponding validation for the Element in the translator map. If there is no validation for the Element in the translator map, the button is non-functional.


    Top  |  Back

  • Q: How do I migrate a DiTranslator installation to a new PC?
  • A: Use the technique below to migrate DiTranslator environment from one machine to another while maintaining the same directory structure.

    On the old machine, open DiTranslator, select "About" from the "Help" menu and note the version number. Ensure that DiTranslator version in the new PC is the same version as the one in the existing PC. If you are doing both a migration and an upgrade, complete them separately. Always use the same DiTranslator version when migrating from one machine to another.

    Close DiTranslator, close DiTranslator Task Queue by right-mouse clicking on the DiTranslator icon in the system tray and selecting "Close". Create a backup of your DiTranslator program folder. (This is usually located at C:\Program Files\DiCentral\DiTranslator\) If the edata directory isn't kept in the program directory, make a backup of it as well.

    • Install DiTranslator on the new machine. If the old installation didn't use the standard C:\Program Files\DiCentral\DiTranslator\ location, change the program and edata directories to match the old locations when prompted.
    • After the installation is complete, close DiTranslator. Stop any remaining DiTranslator components (tppc, tppc32, and tppcsrvr) using the Windows task manager. Rename the new tppc32.ini file (located in the DiTranslator program directory) using a name like tppc32.ini.new.
    • Copy the backups from the old machine over the new DiTranslator program and edata directories. When prompted whether to replace files, select "Yes To All".
    • Open the DiTranslator program directory. Replace the tppc32.ini file with the tppc32.ini.new file.
    • Run the DiTranslator installation wizard again. When prompted, select "Repair" as the installation type.


    Top  |  Back

  • Q: How do I compact the DiTranslator database?
  • A: This can be configured to run automatically on shutdown or can be done manually.


    DiTranslator can be configured to automatically compact its databases when the software shuts down. From the Tools menu, select System Configuration. Go to the Database Maintenance tab. Select "After every normal database shutdown".


    To shutdown DiTranslator so that the database compact occurs:

    1. Close the DiTranslator window.
    2. Shutdown the DiTranslator Task Queue: Right mouse click on the DiTranslator icon in your Windows System Tray and select Close.
    3. Wait for 15-30 seconds to ensure that the DiTranslator server closes.

    After completing the shutdown and database compact, restart the DiTranslator Task Queue by going to Start > All Programs > Startup > DiTranslator Task Queue.



    Close DiTranslator, as it cannot be running when the compact is performed. Open the Windows Task Manager by right-mouse clicking on the Windows taskbar. Go to the Processes tab. Close the TPPC.exe and TPPCSRVR.exe processes by selecting each and then clicking on End Process.



    Navigate to the DiTranslator code directory (By default this is located at C:\Program Files\DiCentral\DiTranslator\Code). Double-click on tppcsrvr.exe. This opens two windows, one inside the other. Close the inside window. Then from File menu, select Compact Database.



    Top  |  Back

  • Q: How do I send an SMS text message notification from DiTranslator?
  • A: Use your carrier's SMS email account in a DiTranslator Send Mail task (description below) to send SMS text messages to a user's phone. Most mobile phone carriers provide an email account that will forward messages to a cell phone via text message. (Note that the recipient of the text message may incur a standard text message charge from their carrier.)

    SMS email addresses are based on the 10-digit phone number. Here is the format used by the largest US carriers:

    • AT&T: phonenumber@txt.att.net
    • Sprint: phonenumber@messaging.sprintpcs.com
    • T-Mobile: phonenumber@tmomail.net
    • Verizon: phonenumber@vtext.com

    If your carrier isn't on this list, check your carrier's website or contact their customer service department to get details about their email-to-SMS address format.


    Description on Send Mail task:


    Send Email task can be used to send email notifications or email files as attachments. This task uses Outlook or Outlook Express as its email client. To operate, one of these email programs must be configured to connect to an email account and be set as Windows' default email client.

    To add a Send Email task to DiTranslator, perform the following instructions.

    1. Access the branch of the DiTranslator tree view where you would like to create the Send Email task icon. A Send Email task can be added to any branch in the Trading Partner tree view.
    2. Click on a task, right-mouse click and click New. The DiTranslator Setup window displays. Click the New button.
    3. Select the "Create a Custom Task" option, then click Next.
    4. Enter the name you want to display beneath the new icon you are creating in the Task Name box. In the Task Type box, select File Utility Task and click Next.


    5. Configure the tabs as they're described below:

    • Addressing: Enter your email's addressing and subject details.
    • Attachments: Browse to or enter the path to any files that will be sent as attachments.
    • Message Text: Enter the text of the body of your email.
    • Process Qualifiers
    • Zip all attached files: Check "Enable" to zip all email attachments. Use the other zip settings to control the file naming convention that the zip file will use.
    • Task List Processing: If the Email Task is called from a task list, this setting will affect whether the task list is aborted in certain conditions.
    • Send Qualifier: Select the conditions that should be met for the email to be sent.
    • After Send: This setting affects how backup copies of attachment files are managed.
    • Maximum accumulated attachment size: The maximum size permitted for attached files.
    • Append status information to EmailStatus.txt: Check this box to log details about the task execution in the EmailStatus.txt file.


    Top  |  Back

    6. Click OK to save your changes.


  • Q: How do I handle a Sort Mail error that reads "Error 1403: Transmission Incomplete. GS=1, GE=0"?
  • A: This error can usually be resolved by turning on the "Filter Input File" setting in Sort Mail properties.

  • Q: During Sort Mail process, I experienced the below error message. How can I troubleshoot it?
  • A: The error you are seeing is an indication that the data trying to sort contains a transaction for a trading partner whose ISA and GS configuration does not match any trading partner currently configured under that network. This is an indication that either the partner does not exist at all, the partner configuration is in error, or that the information in the transaction is in error. To troubleshoot this, the indication is that this is occurring on line 1, so it is the first transaction in the file. You need to verify that the configuration for a trading partner actually exists and matches that transaction.

Top  |  Back