Den här artikeln beskriver det vanligaste användningsområdet för nShift ApportConnect.
Avsnitt i den här artikeln:
Integrering med TMS
När du konfigurerar användaren (Läs mer) anger du en övervakningssökväg, vilket instruerar nShift ApportConnect att bevaka den katalogen för inkommande integrationsfiler.
Om det är första gången du anger övervakningssökvägen, skapas fem mappar i den katalogen. Se till att programmet har både läs- och skrivbehörighet för den angivna sökvägen. Övervakningssökvägen är unik och kan inte konfigureras för flera användare.
Obs! nShift ApportConnect identifierar alla filer som placeras i den här mappen. Se till att mappen är fri från oönskade filer innan nShift ApportConnect börjar använda den.
När en ny fil upptäcks i den här mappen skickar nShift ApportConnect filen till TMS med domänen, användarnamnet och lösenordet för den användare som övervakar katalogen. Filen valideras sedan, och om det lyckas skapas en eller flera sändningar från dess innehåll.
Om filen är ogiltig returnerar ApportConnect ett eller flera felmeddelanden som beskriver vad som är fel.
När en integrationsfil har bearbetats visas den under History > Integration, där du kan se filens status och de skapade sändningarna. Filen flyttas och får ett datumstämpel i filnamnet och kan hittas i katalogen p_success eller p_error, beroende på status.
Du kan enkelt visa filen genom att klicka på knappen View file. Om du vill se sändningsdetaljer klickar du på View consignment, och för att skriva ut valda sändningar på nytt klickar du på Re-print Selected.
Automatisk utskrift
Automatisk utskrift finns under Settings > Manage users > File watcher.
Du kan välja att automatiskt skriva ut sändningar som skapas vid integrering med TMS. Dokumenten hämtas från de sändningar som skapas från integrationsfilen. Etiketten (och fraktsedeln om tillämpligt) skrivs ut på den eller de skrivare som konfigurerats för den användare som utför integreringen.
Om det här alternativet inte är valt kan du välja att skriva ut dokumenten när som helst från fliken History > Integration.
Svarsfil
Om din integrering med TMS har aktiverat användning av en svarsfil sparas den i mappen som heter p_responses. Den här filen innehåller vanligtvis information om de skapade sändningarna, valideringsfel, priser och andra uppgifter.
Om du är osäker på om du har det här alternativet aktiverat eller vill veta hur det fungerar, vänligen kontakta nShift TMS kundtjänst.
Flera användare / Omdirigering av dokument
Inställningarna för att tillåta Multi user finns under Settings > Manage users > File watcher.
nShift ApportConnect är utformat med visionen att olika användare konfigureras med egna skrivare. Dessa användare har egna övervakningssökvägar och skickar filer som finns i respektive mapp, samtidigt som de skriver ut med sina egna skrivare.
Om du inte har möjlighet att skicka filer till olika mappar/övervakningssökvägar för olika nShift ApportConnect-användare finns det ett sätt att "omdirigera" eller ändra ägaren av sändningar och dokument till en annan nShift ApportConnect-användare. Den här funktionen kallas Multi User.
Funktionen Multi User aktiveras genom att du lägger till ytterligare uppgifter i din integrationsfil (den som ska skickas till TMS). För att aktivera funktionen konfigurerar du de användare du vill använda (till exempel två lageranvändare) och ser till att du kommer ihåg deras nShift ApportConnect-alias. Integreringsanvändaren har konfigurerats med en övervakningssökväg och Allow 'Multi User' är ikryssat. Det är den enda användaren med en övervakningssökväg och funktionen Multi User aktiverad. Alla övriga användare behöver inte detta.
Därefter måste du lägga till en anpassad referens i din integrationsfil. Referensens namn/typ är printr_user_alias och värdet är ett nShift ApportConnect-alias.
Om du använder standard-XML för integrering 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 den här filen skickas till TMS av användaren med en övervakningssökväg skapas sändningen (förutsatt att all nödvändig information finns). Så snart svaret returneras till nShift ApportConnect ändras ägarskapet för filen/sändningen till den användare som anges i referensen (t.ex. "WAREHOUSE1" från exemplet ovan). Om det angivna nShift ApportConnect-aliaset inte finns loggas ett meddelande och ägarskapet förblir hos den ursprungliga användaren som skickade filen. Om ingen referens anges medan Multi User är aktiverat, förblir ägarskapet oförändrat.
När svaret har returnerats och ägarskapet har ändrats, tillhör integreringshistorikobjektet den nya användaren. Om automatisk utskrift är aktiverad för den nya användaren hämtas och skrivs dokument ut automatiskt med den nya användarens skrivare.
Exempel på arbetsflöde:
Konfiguration:
- Två nShift ApportConnect-användare konfigureras: DemoUser och WAREHOUSE1.
- DemoUser har en angiven övervakningssökväg och har aktiverat funktionen Multi User, men har inga skrivare.
- Användaren WAREHOUSE1 har aktiverat automatisk utskrift och har konfigurerat ett antal skrivare.
Arbetsflöde:
- En integrationsfil som innehåller referenstypen printr_user_alias med värdet WAREHOUSE1 placeras i DemoUsers övervakningssökväg.
- Filen skickas till TMS med DemoUsers integreringsuppgifter.
- Sändningen skapas och ett svar returneras till nShift ApportConnect.
- nShift ApportConnect ändrar ägarskapet för integreringsjobbet till användaren WAREHOUSE1.
- Användaren WAREHOUSE1 gör en dokumentförfrågan (eftersom användaren har "Automatic Print" aktiverat) med användarens egna integreringsuppgifter. (I exemplet ovan använder både DemoUser och WAREHOUSE1 samma integreringsuppgifter.)
- De returnerade dokumenten skrivs ut på WAREHOUSE1:s skrivare.