Dit artikel behandelt het meest voorkomende gebruiksscenario van nShift ApportConnect.
Secties in dit artikel:
Integratie met TMS
Bij het configureren van de gebruiker (lees meer), specificeer je een bewaakpad, waarmee je nShift ApportConnect instrueert om die map te monitoren voor binnenkomende integratiebestanden.
Als dit de eerste keer is dat je het bewaakpad specificeert, worden er vijf mappen in die directory aangemaakt. Zorg ervoor dat het programma zowel lees- als schrijfrechten heeft voor het opgegeven pad. Het bewaakpad is uniek en kan niet voor meerdere gebruikers worden ingesteld.
Let op! nShift ApportConnect detecteert elk bestand dat in deze map wordt geplaatst. Zorg ervoor dat de map vrij is van ongewenste bestanden voordat nShift ApportConnect deze begint te gebruiken.
Bij het ontdekken van een nieuw bestand in deze map, stuurt nShift ApportConnect het bestand naar TMS met behulp van het domein, de gebruikersnaam en het wachtwoord van de gebruiker die de directory bewaakt. Het bestand wordt vervolgens gevalideerd en als dat succesvol is, worden er een of meer zendingen aangemaakt uit de inhoud ervan.
Als het bestand ongeldig is, retourneert Apport een of meer fouten die aangeven wat er mis is.
Nadat een integratiebestand is verwerkt, verschijnt het onder de Geschiedenis > Integratie sectie, waar je de status van het bestand en de aangemaakte zendingen kunt bekijken. Het bestand wordt verplaatst en hernoemd met een datumstempel en kan worden gevonden in de p_success of p_error directory, afhankelijk van de status.
Je kunt het bestand eenvoudig bekijken door op de knop Bestand bekijken te klikken. Om zendingdetails te zien, klik op Zending bekijken, en om geselecteerde zendingen opnieuw af te drukken, klik op Opnieuw afdrukken geselecteerd.
Automatisch afdrukken
Automatisch afdrukken is te vinden onder Settings > Beheer gebruikers > Bestandsbewaker.
Je kunt ervoor kiezen om zendingen die tijdens de integratie met TMS zijn aangemaakt automatisch af te drukken. De documenten worden opgehaald uit de zendingen die zijn aangemaakt uit het integratiebestand. Het label (en de vrachtbrief, indien van toepassing) wordt afgedrukt met behulp van de printer(s) die zijn geconfigureerd voor de gebruiker die de integratie uitvoert.
Als deze optie niet is geselecteerd, kun je ervoor kiezen om de documenten op elk moment af te drukken vanuit het tabblad Geschiedenis > Integratie.
Antwoordbestand
Als je integratie met TMS het gebruik van een antwoordbestand heeft ingeschakeld, wordt het opgeslagen in de map genaamd p_responses. Dit bestand bevat meestal informatie over de aangemaakte zendingen, validatiefouten, prijzen en andere gegevens.
Als je niet zeker weet of je deze optie hebt ingeschakeld of wilt weten hoe het werkt, neem dan contact op met nShift TMS Klantenservice.
Meerdere User /Redirecting documenten
De settings voor het toestaan van Multi user zijn te vinden onder Settings > Beheer gebruikers > Bestandsbewaker.
nShift ApportConnect is ontworpen met de visie dat verschillende gebruikers hun eigen printers instellen. Deze gebruikers hebben hun eigen bewaakpaden en zullen bestanden die in hun respectieve mappen worden gevonden, verzenden terwijl ze afdrukken met hun eigen printers.
Als je niet in staat bent om bestanden uit te voeren naar verschillende mappen/bewakingspaden voor verschillende nShift ApportConnect gebruikers, is er een manier om de eigenaar van zendingen en documenten te "omleiden" of te wijzigen naar een andere nShift ApportConnect gebruiker. Deze functie heet Multi User.
De Multi User functie werkt door extra details in je integratiebestand in te voeren (het bestand dat naar TMS moet worden gestuurd). Om deze functie te enable, stel de gebruikers in die je wilt gebruiken (bijvoorbeeld twee magazijngebruikers) en zorg ervoor dat je hun nShift ApportConnect aliassen onthoudt. De integratiegebruiker is ingesteld met een bewaakpad en Toestaan 'Multi User' is aangevinkt. Dit zal de enige gebruiker zijn met een bewaakpad en de Multi User functie ingeschakeld. Alle andere gebruikers hebben dit niet nodig.
Vervolgens moet je een aangepaste referentie toevoegen in je integratiebestand. De naam/type van de referentie is printr_user_alias en de waarde is een nShift ApportConnect alias.
Als je standaard XML gebruikt om te integreren, kan het er zo uitzien:
<?xml version="1.0" encoding="ISO-8859-1"?>
<ConsignmentList>
<Consignment orderNo="9925" automaticBooking="Y" templateName="Bring">
...
<Reference type="printr_user_alias">
<reference>WAREHOUSE1</reference>
</Reference
</Consignment>
</ConsignmentList>
Wanneer dit bestand naar TMS wordt gestuurd door de gebruiker met een bewaakpad, wordt de zending aangemaakt (mits alle benodigde informatie aanwezig is). Zodra de reactie is teruggestuurd naar nShift ApportConnect, verandert het bestand/zending van eigenaar naar de gebruiker die in de referentie is gespecificeerd (bijvoorbeeld "WAREHOUSE1" uit de afbeelding hierboven). Als de opgegeven nShift ApportConnect alias niet bestaat, wordt er een bericht gelogd en blijft het eigendom bij de oorspronkelijke gebruiker die het bestand heeft verzonden. Als er geen referentie wordt verstrekt terwijl Multi User is ingeschakeld, blijft het eigendom ongewijzigd.
Nadat de reactie is teruggestuurd en het eigendom is veranderd, behoort het integratiegeschiedenisitem tot de nieuwe gebruiker. Als automatisch afdrukken is ingeschakeld voor de nieuwe gebruiker, worden documenten automatisch opgehaald en afgedrukt met behulp van de printers van de nieuwe gebruiker.
Voorbeeldworkflow:
Configuration:
- Twee nShift ApportConnect gebruikers zijn ingesteld: DemoUser en WAREHOUSE1.
-
DemoUser heeft een bewaakpad gespecificeerd en heeft de Multi User functie ingeschakeld, maar heeft geen printers.
- Gebruiker WAREHOUSE1 heeft automatisch afdrukken ingeschakeld en heeft enkele printers ingesteld.
Workflow:
- Een integratiebestand met de referentie type=“printr_user_alias” met de waarde=”WAREHOUSE1” wordt in DemoUsers's bewaakpad geplaatst.
- Het bestand wordt naar TMS gestuurd met behulp van DemoUser’s integratiegegevens.
- De zending wordt aangemaakt en een reactie wordt teruggestuurd naar nShift ApportConnect.
- nShift ApportConnect verandert de eigenaar van de integratieopdracht naar gebruiker WAREHOUSE1
- Gebruiker WAREHOUSE1 doet een documentaanvraag (omdat de gebruiker “Automatic Print” heeft ingeschakeld), met de eigen integratiegegevens van de gebruiker. (In het bovenstaande voorbeeld gebruiken zowel DemoUser als WAREHOUSE1 dezelfde integratiegegevens om te integreren.)
- De geretourneerde documenten worden afgedrukt op de printers van WAREHOUSE1