Upload stamgegevens

Datum: 2018-01-17
Versie: 1.0

Algemeen

Met behulp van deze tool is het mogelijk om geautomatiseerd importbestanden te uploaden naar Ecmanage.

Deze tool voert de volgende handelingen uit:

  1. De tool loopt door alle mappen in de IN-map heen
  2. Voor elke map doet de tool het volgende:
  1. Zoekt naar import bestanden (hiervoor dient dezelfde xml of excel bestanden als normaal importeren, dit is op basis van de Ecmanage Excel templates)
  2. Voor elke bestand doet de tool het volgende:
  1. Als het een Excel bestand is, converteert hij deze naar xml
  2. Valideert hij de xml
  3. Zet hij de xml in een zipbestand
  4. Upload hij het zipbestand naar Ecmanage
  5. Verwijderdt hij het zipbestand
  1. Gereed.

Bestand systeem

De mappen structuur waar de tool doorheen loopt moet er als volgt uit zien:

image0

Hierbij dient de naam van de map “[KLANT_ACRO_%]” overeen te komen met de acroniem van de klantomgeving waar u de bestanden voor wilt uploaden. De naam en locatie van de IN-map is in te stellen in het configuratiebestand.

In de [KLANT_ACRO_X]-map moeten dan alle importbestanden komen voor de inrichting en het logo van de klantomgeving. Het logo moet een bestand met de extensie “.jpg” of “.png” zijn en de naam moet met “logo” beginnen.

Indien u gebruik maakt vande optionele module voor logistiek en een integratie heeft voor afteken bewijzen: In de POD-map komen ontvangstbewijzen te staan. Deze bestanden moeten de extensie “.tif” hebben.

In de Product-map komen de plaatjes voor de producten te staan. De namen van deze plaatjes moeten overeenkomen met het externe id van het product waar ze bij horen en moeten de extensie “.jpg” of “.png” hebben. Om een plaatje voor het product met extern id “TUG-101” te uploaden, moet dit bestand bijvoorbeeld “TUG-101.jpg” heten.

Configuratie

In het bestand EcmanageUpload.exe.config staat de configuratie:

Configuratie Default Uitleg
MailServer mail.leverancier.nl Uw mailserver. Indien leeg dan worden er geen emails verstuurd.
MailFrom ecmanageupload@leverancier.nl Het from emailadres.
MailUser mailuser Eventueel een mailaccount naam voor inloggen voor verzenden.
MailPassword mailpwd Bijbehorend wachtwoord.
     
MailTo\Start support@leverancier.nl E-mailadres waar een bericht naar toe gestuurd wordt indien er een importbestand in de IN directory staat.
MailTo\Ok support@leverancier.nl E-mailadres waar een bericht naar toe gestuurd wordt indien een importbestand succesvol geüpload is.
MailTo\Error support@leverancier.nl E-mailadres waar een bericht naar toe gestuurd wordt indien er een probleem is.
     
ServiceName ECM_Upload Indien deze applicatie wordt gestart als service dan wordt deze naam gebruikt.
     
MONITOR\IN C:\Upload Directory waar de importbestanden worden geplaatst voor verwerking.
MONITOR\OUT C:\Done Directory waar de verwerkte orders naar worden verplaatst.
MONITOR\ERROR C:\Error Indien er tijdens de verwerking een probleem is dan wordt de order in deze directory geplaatst.
     
MONITOR\DELAY 10 Hoelang moet er gewacht worden voordat de upload begint? Indien deze instelling afwezig of ongeldig is wordt 10 seconden gebruikt.
     
EcmanageInternet http://kleding.ecmanage.nl/ Het internet adres waar het bestand naar geüpload moet worden.
EcmanageLeverancierPortal LeverancierAcro De acro van de leverancier portal. Meestal leeg omdat dit al onderdeel is van de instelling EcmanageInternet.
EcmanageGebruikernaam Username Gebruikersnaam om op de leverancierportal in te loggen.
EcmanageGebruikerwachtwoord password Wachtwoord om op de leverancierportal in de loggen.
     
Curl_EXE C:\curl.exe De locatie van de curl.exe die wordt gebruikt om te uploaden.
Curl_Timeout 240 Maximaal aantal seconden dat Curl heeft om een bestand te uploaden.
Curl_Options -u {0}:{1} -i –connect-timeout 60 -v -T De parameters die nodig zijn voor Curl om te kunnen uploaden naar Ecmanage.
     
DeleteEmptyFolders True Moeten de mappen in de IN-map verwijderd worden nadat de bestanden verwerkt zijn en deze leeg is? “true” is Ja, “false” is Nee.
Hold_On_Error True Indien een fout aanwezig wordt het bestand dan tegen gehouden. Deze instelling kan ook voorzien worden van de xml entiteit in hoofdletters, denk aan “BUDGETPERSONS\hold_on_error”. Dan werkt de instelling alleen voor dat type bestand.
SleepMilliseconds 0 Geeft aan hoeveel milliseconden (1000 milliseconden = 1 seconde) de koppeling moet wachten tussen elk bestand dat wordt geuploadt.
XMLSendAllRecords False Standaard wordt er bij XML import bestanden een vergelijk gemaakt met het laatste geimporteerde bestand van dezelfde soort. Alleen de wijzigingen worden naar ecmanage gestuurd. Dit diff xml bestand komt ook in de uit map. Het is mogelijk om deze instelling per xml type op te nemen, bijvoorbeeld “persons\XMLSendAllRecords”.
XMLDiffDays 7 Dit is het aantal dagen dat vergeleken wordt in de vergelijk van de xml bestanden. Als alle bestanden binnen dit aantal dagen dezelfde data heeft dan wordt een record niet meegenomen, anders wel. Het is mogelijk om deze instelling per xml type op te nemen, bijvoorbeeld “persons\XMLDiffDays”.