X Import
X Import requires an X Stream license. Additional charges may apply.
X Stream provides smooth, quick data transfer from your customer’s system, whether it is Windows® based or not, and from virtually any manufacturer.
An X Import preprocessor is at its most basic an executable that accepts a filename as its first command-line argument. It then performs data aggregation or transformation and outputs data to STDOUT in a format that can be processed by X Import.
Workflow
X Import reads in all the configuration files from its working directory set.
X Import monitors a directory for files (DataPath).
If a file is found that matches the extension (DataMask) then the file is selected for processing.
If the configuration file specifies a preprocessor, then pass the current filename to Ratepreprocessor and use the data returned by the preprocessor for further parsing.
Once the file (or preprocessor output) is read, data is parsed according to the configuration file.
X Import iterates through input file, building an internal list of orders or route stops.
X Import iterates through its internal list of orders/stops and posts them to XMLListener (see Posting Process below)
When X Import has attempted to place all orders/routes, it creates an audit log which is available in the Operations App through X Stream > Import Audit Log.
If the import has inactive or terminated drivers assigned to incoming orders the driver ID will be removed and the orders will be unassigned.
Posting Process
On Demand Orders
Send OrderRequest to XMLListener
Receive OrderResponse/ErrorResponse from XMLListener
Send OrderSelectedRequest to XMLListener
Receive OrderSelectedResponse/ErrorResponse from XMLListener
Route Stops
Send ProcessASNRequest to XMLListener
Receive ProcessASNResponse/ErrorResponse from XMLListener
Related Articles:
- Data Items (Fixed-Width)
- Data Items (Delimited)
- X Import as a Service (Deprecated)
- Chaining Preprocessors
- File Format (Decrypt File) - *.XENCRYPTINI
- Config file functions
- Configuration: X Import Translations
- File Format (General)
- Data Items (XML)
- File Format (On Demand) - *.XINI
- File Format (Routed ASN) - *.XASN