Artlink niet ingelezen    

Vraag

Het ArtLink importbestand wordt niet ingelezen en verwerkt, de artlinkverwerking faalt.
 

Uitleg

De meest voorkomende oorzaken:
 
Geplande taak niet (goed) ingesteld
Zonder (juist ingestelde) geplande taak zal de artlink niet automatisch verwerkt worden. Klik hier voor meer informatie over het beheren van geplande taken.
Bestandsnaam onjuist.
In de geplande taak waarmee de Artlink wordt geïmporteerd, komt de opgegeven bestandsnaam niet overeen met de Artlink die op onze FTP server wordt geplaatst.
Wanneer er bijvoorbeeld een automatische datum/tijd in de bestandsnaam gebruikt wordt, zal deze nooit overeenkomen met de in de geplande taak vermelde bestandsnaam.
Onbekend formaat/ verkeerde extensie
Formaat moet .txt of .xml zijn, eventueel gezipped.
Sommige ERP pakketten voegen automatisch een volgnummer toe achter de extensie van de .xml voordat deze ingepakt wordt in een .ZIP die geupload wordt naar onze FTP server. Gevolg is dat het bestand dat in de zip staat bijvoorbeeld “Artlink.xml(1)” heet. Dit wordt ook als onbekend formaat gezien.
Uploaden mislukt
Het uploaden van het bestand naar de juiste map op onze FTP server is niet gelukt:
  • De naam van de map moet zijn: /in
  • Lees hier alles over onze FTP server en hoe inloggegevens aangevraagd kunnen worden.
Time Out
Als het erg druk is op het het systeem kan er een Time out optreden.
Als er handmatig geïmporteerd wordt, verschijnt de status "Mislukt" bij Lopende taken. Probeer het na minimaal een half uur nogmaals handmatig te importeren.
Indien de ArtLink via een geplande taak ingelezen wordt, zal op de FTP-server aan de bestandsnaam toegevoegd worden:  _TimeOut. Op een later moment zal dit bestand automatisch opnieuw geimporteerd worden.
Bestand te groot
Indien de ArtLink via een geplande taak ingelezen wordt en het uitgepakte bestand is groter dan 750 MB dan zal op de FTP server aan de bestandsnaam van het te grote bestand toegevoegd worden:  _FileTooBig. Het bestand zal niet worden ingelezen.
 
Na een handmatige import worden er twee controles uitgevoerd:
  • het te uploaden bestand is groter dan ongeveer 750MB (ongeacht of het gezipt is of niet).
    Dan verschijnt de volgende foutmelding: "Het te importeren bestand mag niet groter zijn dan ongeveer 750 MB." (750 MB is hier een benadering, wat het systeem maximaal aankan hangt af van diverse factoren.)
  • het uitgepakte bestand is groter dan 750 MB.
    Dan zal in Lopende taken de status "Mislukt" verschijnen.
     
    Verklein het bestand door onnodige artikelen of informatie niet op te nemen. Bijvoorbeeld:
  • artikelen die onvoldoende koppelbare data bevatten (artikelnummer, GLN, GTIN).
  • artikelen die redelijkerwijs niet bij EZ-base zullen voorkomen.
    Deze artikelen zullen geen koppelingen opleveren, neem deze daarom niet op in het bestand.
Incorrecte structuur of foutieve veldnamen
Een bestand met onjuiste tags of kolomkoppen wordt meestal wel verwerkt, de onjuiste tags en kolommen worden genegeerd.
Toch kan het voorkomen dat het bestand door dergelijke fouten in het geheel niet ingelezen wordt.  
Veld te lang of element komt te vaak voor
Overschrijding van de maximale veldlengte of aantal keer dat een element mag voorkomen.
Zie de regels die omschreven zijn in de xsd https://file.ez-base.nl/ArtLink1.0.xsd.
Gebruik de xsd om de .xml te valideren. 1
Speciale karakters
Speciale karakters maken het bestand onleesbaar.
  • Voor .txt bestanden gaat het hier om tekens zoals end-of-line, tab, aanhalingstekens die in de data voorkomen maar die in een tab-gescheiden bestand een bijzondere betekenis hebben.
  • Voor .xml bestanden gaat het om karakters zoals bijvoorbeeld (maar niet uitsluitend) <,>,& die in XML een speciale betekenis hebben.
In beide formaten kunnen controle-karakters ook voor problemen zorgen. Als algemeen advies geldt: produceer de bestanden bij voorkeur d.m.v. een gespecialiseerde bibliotheek die de afhandeling van bijzondere tekens voor zijn rekening neemt en zorg dat dit toegepast wordt op alle velden: in praktijk komt er uiteindelijk altijd ergens een “verboden” teken voor in een veld waar dit niet verwacht werd.
Encoding niet correct
De encoding van de artlink komt niet overeen met de XML declaratie: in het openingselement van de artlink kan een encoding opgegeven worden, de standaard hiervoor is UTF-8. Wanneer deze niet overeenkomt met de encoding waarin het bestand daadwerkelijk is geschreven leidt dit tot de foutmelding: "XMLException: There is no Unicode byte order mark. Cannot switch to Unicode." (bijvoorbeeld: als encoding is "UTF-16" opgegeven maar bestand is geschreven in "UTF-8") 1
EZ-catalog is tijdelijk niet beschikbaar
Zowel 's avonds als 's nachts vinden er diverse processen plaats. Zo worden wijzigingen die aangebracht zijn in EZ-catalog naar EZ-web gesynchroniseerd. Om deze verwerkingen zo optimaal mogelijk en foutloos te laten verlopen is het niet mogelijk gedurende deze processen een Artlink te importeren. Ook tijdens storingen of onderhoud kan het importeren van een Artlink onwenselijk zijn.
De knop Importeren voor een handmatige Artlink import wordt tijdens deze processen daarom tijdelijk uitgeschakeld.
Eventueel eerder opgestarte Artlink imports die nog niet afgerond zijn worden afgebroken voordat deze processen starten (in Lopende taken staat daarna "Mislukt" achter de Artlink import).
 
1 Indien de ArtLink via een geplande taak ingelezen wordt en de import faalt door inhoudelijke fouten, dan wordt het importbestand hernoemd: er wordt _Failed toegevoegd aan de naam. Het bestand zal niet worden ingelezen.
Bovendien wordt de gefaalde artlink automatisch gevalideerd met behulp van een xsd (vergelijkbaar met deze xsd) waarbij gekeken wordt of de xml kloppend is.
Het resultaat van deze validatie staat in het bestand met dezelfde naam als de gefaalde artlinkimport met daaraan toegevoegd "_Validation.log". Het logbestand wordt op onze FTP server gezet.