Import Audit Log
- Michelle Cabaya (Unlicensed)
- Amy Mangueira
This page is for the Operations App. For the Classic Operations App please see Import Audit Log (Classic Operations App).
The Import Audit Log lists imports and results. Here you can find information on your integration import into the Operations App such as making sure the import was successful if there were any failures and errors, or when the import was processed.
To get to the Import Audit Log go to Maintenance > Import Audit Log.
Field Name | Description |
|---|---|
Process Date | The date and time that the activity occurred. For example, with a Type of ASN, this time represents when the file imported route stops into the system. |
Import PKID | Unique ID number, associated to each activity. |
Customer ID | The customer ID associated to the activity. |
LastProcessedTime | The date and time that the import was last processed. This is updated after every order/route stop is imported. |
Type | The type of import:
|
Total Successful | Total number of successful orders or route stops imported. Updates per every order/route stop imported. |
Total Failed | Total number of failed order or route stop imports. |
TotalConsolidated | Total number of consolidated orders or route stops imported. Updates per every order/route stop posted. |
IP Address | IP address of where the files were imported from. If a CANCELED or UNPOST action is taken, this field will display the username of the person who completed the action. |
Import File Name | Directory path to the processed folder where the imported file is located. If a CANCELED or UNPOST action is taken, this field will display information about the ASN or ON_DEMAND entry removed, including the corresponding Import PKID for the work. |
Errors | A clickable icon that will bring up a window providing the error information if there were any errors when processing, or the XML post info for a ROWS type. |
Alternate Lookup | Alternate Lookup of the customer associated with the import. See Customer Alternate Lookup. |
How to View Imported Orders or Route Stops
Go to Maintenance > Import Audit Log.
Click the action menu for the imported orders or route stops and select the Find… that you want to view.
Action Menu
ASN menu:
Find Imported Route Stops
Unpost Imported Route Stops
Unposting imported route stops will delete the imported route stops, and cannot be undone.
On-Demand menu:
Find Imported On-Demand Orders
Remove Imported On-Demand Orders
Removing imported On-Demand orders will delete the orders, and cannot be undone.
Failed Import and Error Text
If you experience any problems with importing your integration, you can find an error message in the Import Audit Log identifying what went wrong.
To view the error text double click on the link in the Errors column. This will open the ImportError.txt file in Notepad ++.
Quick Tips
Any routed imports that fail due to a deadlock will be unposted to prevent partial stops from being created. You can re-run the failed file to complete the import.
For ASN or On-Demand type imports, find "<ErrDescription>".
Troubleshooting
Problem: The Internet User for the integration does not have permission to create orders or route stops for the specified Customer ID. Internet User credentials are required to authenticate the request to insert orders and route stops into your system for a given customer.
Solution: Open the Internet User record (Maintenance > Internet Users), used for the integration in question. Check the "Allowed Customer Accounts" list, and ensure the checkbox is marked for all additional customers to be used for the integration configuration.
Problem: The Internet User for the integration is attempting to use invalid user ID and/or password credentials, as specified on the internet user record.
Solution: Contact CXT Technical Support to repair the integration configurations. Please ensure the user ID and password are not changed without CXT Software involvement.
Problem: During the process of the import configuration translating data from the inbound file into a readable format for X Import, one or more fields were translated into a format that is not acceptable in the database. For example (as pictured below), alpha characters in the CustID field, which is expected to be a numeric integer value.
Solution: Review all XML elements in the error file for unexpected values. Make the necessary corrections to the ASN file to ensure valid data is pushed to the database for the next import. Retry the import.
Problem: Parameters set on the order type are inconsistent with the data attempting to be imported in the file. Possibly, the order type does not have X Internet hours of operation enabled (which is required for integration imports), or the calculated distance is outside of specified bounds.
Solution: Check that the Order Type hours of operation are enabled, and the appropriate days / hours are checked. Confirm the order attempting to be imported does not exceed any maximum distance configurations.
[x] is based on the rate chart assigned to the customer being imported to. This occurs for route stops only.
Problem: The imported route stop was unable to find a Stamp Rate Chart on the associated customer's rate chart.
Solution: Check the rate chart grouping assigned to the customer for the imported route stop. Navigate to Maintenance > Rate Charts and confirm a Stamp Rate Chart exists in the appropriate rate chart group. If a chart does not exist, a new rate chart will need to be created, use the small down-arrow to the right of the "New" button at the top of the Classic Operations App, and scroll down to "Stamp Rate Chart"
Problem: If an X Stream > Import Audit Log is not visible (indicating the file was not available to attempt processing and product an error message), the issue likely lies with the file transmission.
Solution: Check the Error box (visible, if an error is present, in the bottom right area) within the X Stream Definition's schedule, to determine the failure. To open the schedule, double-click the highlighted schedule in the bottom left box of the X Stream Definition you set up for file transmission.
