Creating valid XML files - AFS@Store - Technical Notes

AFS@Store - Tips

AFS@Store Version
Technical Notes
Note: Prior to reading this section, it is recommended to read Appendix A: Transmitting the data in AFS@Store Integration Guide.

This section is about XML file generation. It is important to know what to export and into which files.

  • The first constraint is that you cannot mix several languages into a single file: that is to say that one file can contain only one language. For instance, if a product has two translations, then you must export it into two separate files (but with same ID). As a matter of fact, unique ID for indexed documents is the combination of their id and xml:lang attributes.
  • Note that if you have several web sites, you may export your data in a "one file per web site and language" basis, e.g., catalog-mywebsite1-de.xml and catalog-mywebsite2-de.xml
  • Only ISO 639-1 (Alpha 2) language codes may be used in xml:lang attributes, as well as in file names (for the list of supported languages, please report to the Appendix C of the AFS@Store Integration Guide)
  • All files need to be properly encoded in UTF-8. Else you may get weird accents after indexation. Please check that your files begin with this line:
<?xml version="1.0" encoding="UTF-8"?>
  • When files are not too large (several Mb at most), check their XML validity by simply opening them in a web browser to check against an error.
  • Or you can check them using a Linux terminal and this command: %xmllint --noout catalog-mystore-en.xml