File-based

In the file-based exchange method, order information is loaded by scanning a barcode from an associated XML file. The scanned barcode serves as the filename or file prefix to identify the corresponding file.

How it works

After scanning a barcode, for example an order number, the machine searches for an XML file that has this barcode as a prefix in the filename. The file doesn't need to exactly match the scanned barcode but must use it as a prefix. For example, after scanning the barcode 4785216, it would search for a file named 4785216.xml or a similar file like 4785216_ABC.xml.

If multiple files with the same prefix are found, the machine selects the most recently modified or added file. Only files with the extension .xml are considered for import.

Configuring the file path

The path where the machine searches for order files can be configured in the settings. Note that searching is only possible within one folder. When using network paths, ensure that the machine has sufficient permissions to read and possibly write the files. Network drives can be used but carry the risk that they may not connect automatically when logging in, which can lead to errors. Using network paths can avoid this issue.

Order file structure

The order files must be in XML format and encoded in UTF-8. Other encodings like ASCII may work but could cause errors with special characters and country-specific characters.

<?xml version="1.0" encoding="utf-8"?>
<OrderImport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <OrderId>4785450</OrderId>
    <OrderPositionId>0001</OrderPositionId>
    <OrderPreviewImage>C:\Temp\Import\SewSyV4\closeUp.webp</OrderPreviewImage>
    <OrderLength>2500</OrderLength>
    <OrderWidth>4756</OrderWidth>
    <SewSyParameter>uml</SewSyParameter>
    <FabricName>Acryl White Uni</FabricName>
    <JoinMaterial>Tenara Black</JoinMaterial>
</OrderImport>

Element descriptions

Element	Description	Type	Optionality
OrderId	The order number that is displayed in the machine and used as filename.	String	Required
OrderPositionId	The order position number that is displayed in the machine.	String	Optional
OrderPreviewImage	A path or URL to an image that should be displayed.	URI/Path	Optional
OrderLength	The finished dimension length in millimeters	Integer	Required
OrderWidth	The finished dimension width in millimeters	Integer	Required
SewSyParameter	The parameter to be loaded, must be defined in the parameter.	String	Optional
FabricName	The fabric type/design used.	String	Optional
JoinMaterial	The joining variant, such as sewing thread.	String	Optional

INFO

If a path is specified in OrderPreviewImage, the machine must have access to this path. Otherwise, the image will not be displayed.