Denna artikel kommer att täcka det vanligaste användningsfallet för nShift ApportConnect.
Avsnitt i denna artikel:
Integration med TMS
När du konfigurerar användaren (läs mer), specificerar du en övervakningsväg, vilket instruerar nShift ApportConnect att övervaka den katalogen för inkommande integrationsfiler.
Om detta är första gången du specificerar övervakningsvägen, kommer fem mappar att skapas i den katalogen. Se till att programmet har både läs- och skrivbehörighet för den angivna vägen. Övervakningsvägen är unik och kan inte ställas in för flera användare.
Observera! nShift ApportConnect kommer att upptäcka alla filer som placeras i denna mapp. Se till att mappen är fri från oönskade filer innan nShift ApportConnect börjar använda den.
Vid upptäckt av en ny fil i denna mapp, skickar nShift ApportConnect filen till TMS med hjälp av domänen, användarnamnet och lösenordet för användaren som övervakar katalogen. Filen valideras sedan, och om den är framgångsrik, skapas en eller flera försändelser från dess innehåll.
Om filen är ogiltig, returnerar Apport ett eller flera fel som talar om vad som är fel.
Efter att en integrationsfil har bearbetats, visas den under Historik > Integrationssektionen, där du kan se filens status och de skapade försändelserna. Filen flyttas och byts namn med ett datumstämpel och kan hittas i p_success eller p_error katalog, beroende på dess status.
Du kan enkelt se filen genom att klicka på knappen Visa fil. För att se försändelsedetaljer, klicka på Visa försändelse, och för att skriva ut valda försändelser igen, klicka på Skriv ut valda igen.
Automatisk utskrift
Automatisk utskrift finns under Settings > Hantera användare > Filövervakare.
Du kan välja att automatiskt skriva ut försändelser skapade under integrationen med TMS. Dokumenten hämtas från försändelserna skapade från integrationsfilen. Etiketten (och fraktsedeln, om tillämpligt) skrivs ut med den eller de skrivare som är konfigurerade för användaren som utför integrationen.
Om detta alternativ inte är valt kan du välja att skriva ut dokumenten när som helst från fliken Historik > Integration.
Svarfil
Om din integration med TMS har aktiverat användningen av en svarfil, kommer den att sparas i mappen som kallas p_responses. Denna fil innehåller vanligtvis information om de skapade försändelserna, valideringsfel, priser och annan data.
Om du är osäker på om du har detta alternativ aktiverat eller vill veta hur det fungerar, vänligen kontakta nShift TMS kundservice.
Flera User /Redirecting dokument
settings för att tillåta Multi user finns under Settings > Hantera användare > Filövervakare.
nShift ApportConnect är utformad med visionen att ha olika användare inställda med sina egna skrivare. Dessa användare har sina egna övervakningsvägar och kommer att skicka filer som finns i deras respektive mappar, medan de skriver ut med sina egna skrivare.
Om du inte har möjlighet att mata ut filer i olika mappar/övervakningsvägar för olika nShift ApportConnect-användare, finns det ett sätt att "omdirigera" eller ändra ägaren av försändelser och dokument till en annan nShift ApportConnect-användare. Denna funktion kallas Multi User.
Funktionen Multi User fungerar genom att ange ytterligare detaljer i din integrationsfil (den som ska skickas till TMS). För att enable denna funktion, ställ in de användare du vill använda (till exempel två lageranvändare) och se till att komma ihåg deras nShift ApportConnect-alias. Integrationsanvändaren har ställts in med en övervakningsväg, och Tillåt 'Multi User' är markerad. Detta kommer att vara den enda användaren med en övervakningsväg och funktionen Multi User aktiverad. Alla andra användare behöver inte detta.
Nästa steg är att lägga till en anpassad referens i din integrationsfil. Namnet/typen av referensen är printr_user_alias och värdet är ett nShift ApportConnect-alias.
Om du använder standard-XML för att integrera kan det se ut så här:
<?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>
När denna fil skickas till TMS av användaren med en övervakningsväg, kommer försändelsen att skapas (förutsatt att all nödvändig information finns). Så snart svaret returneras till nShift ApportConnect, kommer filen/försändelsen att byta ägare till den användare som anges i referensen (t.ex. "WAREHOUSE1" från bilden ovan). Om det angivna nShift ApportConnect-aliaset inte existerar, kommer ett meddelande att loggas, och ägandet kommer att förbli hos den ursprungliga användaren som skickade filen. Om ingen referens anges medan Multi User är aktiverad, förblir ägandet oförändrat.
Efter att svaret har returnerats och ägandet har ändrats, kommer integrationshistorikposten att tillhöra den nya användaren. Om automatisk utskrift är aktiverad för den nya användaren, kommer dokumenten att hämtas och skrivas ut automatiskt med den nya användarens skrivare.
Exempel på arbetsflöde:
Configuration:
- Två nShift ApportConnect-användare är inställda: DemoUser och WAREHOUSE1.
-
DemoUser har en övervakningsväg specificerad och har aktiverat funktionen Multi User, men har inga skrivare.
- Användare WAREHOUSE1 har aktiverat automatisk utskrift och har några skrivare inställda.
Arbetsflöde:
- En integrationsfil som innehåller referenstypen=“printr_user_alias” med värdet=”WAREHOUSE1” placeras i DemoUserss övervakningsväg.
- Filen skickas till TMS med DemoUsers integrationsuppgifter.
- Försändelsen skapas och ett svar returneras till nShift ApportConnect.
- nShift ApportConnect ändrar ägaren av integrationsjobbet till användare WAREHOUSE1
- Användare WAREHOUSE1 gör en dokumentförfrågan (eftersom användaren har “Automatic Print” aktiverad), med användarens egna integrationsuppgifter. (I exemplet ovan använder både DemoUser och WAREHOUSE1 samma integrationsuppgifter för att integrera.)
- De returnerade dokumenten skrivs ut på WAREHOUSE1s skrivare