Automatisch orders importeren in JamaData koppelen

Introductie#

JamaData draait lokaal op uw systeem, terwijl uw webshop op het internet opereert. Als u wilt integreren met uw webshop en orders automatisch wilt inlezen, kunt u het bijbehorende programma hiervoor gebruiken.

We leggen uit hoe dit proces werkt en raden aan om eerst te begrijpen hoe het werkt voordat u de configuratiestappen doorloopt.

We hebben geprobeerd om de uitleg zo beknopt mogelijk te houden, ondanks dat het een technisch onderwerp is.

Voorwaarden#

Voor het automatisch inlezen van orders zijn er enkele zaken belangrijk. We moeten nl. periodiek het programma automatisch kunnen uitvoeren.'

Dit betekent:

1. Het wachtwoord moet veilig opgeslaan kunnen worden. Het wachtwoord wordt weliswaar veilig opgeslaan in uw Windows gebruikersprofiel d.m.v. DPAPI, maar wordt wel getoond indien men ingelogd is op uw PC. Dit proces is vergelijkbaar met browsers. Zodoende: zonder toegang tot uw pc, heeft een derde persoon ook geen toegang tot uw wachtwoord. [x]

2. We moeten een programma programmatorisch kunnen aansturen. Dit wordt de CLI ( command line interface) genoemd, de CLI voert een commando uit die uw handeling via de UI vervangt.

Goed nieuws: LinqPad kan zowel via een UI kan werken als via een CLI

3. Gebruikersnaam, wachtwoord en de map waarin het moet worden geëxporteerd moeten allemaal geconfigureerd worden. Omdat het script zowel via een UI als via een CLI werkt, kunt u het instellen met de UI en vervolgens uitvoeren via de CLI, zonder ingewikkelde configuratie met XML-bestanden.

4. Het programma moet periodiek kunnen worden uitgevoerd. Dit kan worden gedaan via de Taakplanner / Task Scheduler, een handige en betrouwbare tool in Windows die commando’s via de CLI kan uitvoeren.

Conclusie: Alle benodigdheden zijn aanwezig om uw orders automatisch door te sturen.

Stappen#

1. Exporteer uw orders eenmalig via de UI om alles te configureren.

   

2. Ga naar ‘Taakplanner’ of ‘Task Scheduler’ in Windows.

3. Voeg een nieuwe Taak toe (rechts in het scherm of rechtermuisklik bij de lijst van taken)

4. In het tabblad: ‘Algemeen’:

Hier stelt u de bevoegdheden in:

• Geef uw taak een naam, bv. ‘Importeren orders van Sapico Shop naar JamaData’
• Vink aan ‘Uitvoeren, ongeacht of de gebruiker is aangemeld’

5. In het tabblad ‘Triggers’:

Hier stelt u de planning in. We geven hier een voorstel, maar pas deze aan volgens dat u het best past.

De taak ten minste elke 15 minuten uitvoeren. Indien u instelt dat het elke minuut wordt uitgevoerd, wordt u mogelijks geblokkeerd!

Zo stelt u een planner in:

• Start Dagelijks,
  • Begin om 08:10 ( begin van de dag dat het mag lopen, dit kunt u vrij aanpassen)
  • Herhaal elke: ‘1 dag’ ( recurrentie)
• Geavanceerd:
  • Vink aan: Taak uitstellen tot ( random) : 1 minuut
  • Vink aan: Taak herhalen elk ‘1 uur’ of ‘30 minuten’ (geprefereerd), in noodzaak elke 15 minuten ( minstens!).
  • Vink aan: Taak verlopen om: 18:00:00 ( indien de werkdag dan wordt beëindigd)

6. In het tabblad ‘Acties’:

Hier stelt u de CLI in om uitgevoerd te worden, ipv. het programma handmatig uit te voeren:

• Selecteer het programma: ‘LPRun6.exe’, in de map van JamaData die we hebben aangeleverd
• Voer de argumenten in met de link naar het ‘Bestellingen - Klaarzetten open orders.linq’ programma ¹

7. In het tabblad ‘Eigenschappen’

• Vink aan: Voer de taak zo snel mogelijk uit, als een geplande start werd gemist

8. Druk op de ‘OK’ om de creatie van de taak te bevestigen

9. Geef het wachtwoord in van uw huidige Windows gebruiker. Dit maakt het mogelijk om het script uit te voeren wanneer u niet aanwezig bent, maar wanneer u pc wel is opgestart.

10. U kunt het script testen door “Rechtermuisklik op de taak” en op ‘uitvoeren’ te drukken. Nu worden uw orders ( als er zijn) klaargezet in JamaData.

Screencast#

Tips#

• U kunt de taak instellen om:
  1. 04:00, voordat de leveringen uitgaan
  2. Elke 30 minuten tussen 08:00 tot 18:00, gedurende de werkuren, zodat ze ingelezen kunnen worden overdag op het bureau