Denne artikkelen vil dekke den vanligste bruken av nShift ApportConnect.

Seksjoner i denne artikkelen:

• Integrasjon med TMS
• Automatisk utskrift
• Responsfil
• Multi User/Redirecting dokumenter

Integrasjon med TMS

Når du konfigurerer brukeren (les mer), spesifiserer du en overvåkingssti, som instruerer nShift ApportConnect til å overvåke den katalogen for innkommende integrasjonsfiler.

Hvis dette er første gang du spesifiserer overvåkingsstien, vil fem mapper bli opprettet i den katalogen. Sørg for at programmet har både lese- og skrivetillatelser for den spesifiserte stien. Overvåkingsstien er unik og kan ikke settes opp for flere brukere.

Merk! nShift ApportConnect vil oppdage enhver fil plassert i denne mappen. Sørg for at mappen er fri for uønskede filer før nShift ApportConnect begynner å bruke den.

Ved å oppdage en ny fil i denne mappen, sender nShift ApportConnect filen til TMS ved å bruke domenet, brukernavnet og passordet til brukeren som overvåker katalogen. Filen blir deretter validert, og hvis vellykket, opprettes en eller flere forsendelser fra innholdet.

Hvis filen er ugyldig, returnerer Apport en eller flere feil, som forteller deg hva som er galt.

Etter at en integrasjonsfil er behandlet, vises den under History > Integration section, hvor du kan se filens status og de opprettede forsendelsene. Filen flyttes og gis nytt navn med et datostempel og kan finnes i p_success eller p_error directory, avhengig av statusen.

Du kan enkelt se filen ved å klikke på View file knappen. For å se detaljer om forsendelsen, klikk View consignment, og for å skrive ut valgte forsendelser på nytt, klikk Re-print Selected.

Automatisk utskrift

Automatisk utskrift finnes under Settings > Manage users > File watcher.

Du kan velge å automatisk skrive ut forsendelser opprettet under integrasjon med TMS. Dokumentene vil bli hentet fra forsendelsene opprettet fra integrasjonsfilen. Etiketten (og fraktbrevet, hvis aktuelt) vil bli skrevet ut ved å bruke skriverne som er konfigurert for brukeren som utfører integrasjonen.

Hvis dette alternativet ikke er valgt, kan du velge å skrive ut dokumentene når som helst fra History > Integration fanen.

Responsfil

Hvis integrasjonen din med TMS har aktivert bruk av en responsfil, vil den bli lagret i mappen kalt p_responses. Denne filen inneholder vanligvis informasjon om de opprettede forsendelsene, valideringsfeil, priser og andre data.

Hvis du er usikker på om du har dette alternativet aktivert eller ønsker å vite hvordan det fungerer, vennligst kontakt nShift TMS kundeservice.

Multi User /Redirecting dokumenter

settings for å tillate Multi user finnes under Settings > Manage users > File watcher.

nShift ApportConnect er designet med visjonen om å ha forskjellige brukere satt opp med sine egne skrivere. Disse brukerne har sine egne overvåkingsstier og vil sende filer funnet i sine respektive mapper, mens de skriver ut med sine egne skrivere.

Hvis du ikke har muligheten til å sende filer til forskjellige mapper/overvåkingsstier for ulike nShift ApportConnect-brukere, er det en måte å "omdirigere" eller endre eieren av forsendelser og dokumenter til en annen nShift ApportConnect-bruker. Denne funksjonen kalles Multi User.

Multi User funksjonen fungerer ved å legge inn ytterligere detaljer i integrasjonsfilen din (den som skal sendes til TMS). For å enable denne funksjonen, sett opp brukerne du vil bruke (for eksempel to lagerbrukere) og husk deres nShift ApportConnect-aliaser. Integrasjonsbrukeren er satt opp med en overvåkingssti, og Allow 'Multi User' er krysset av. Dette vil være den eneste brukeren med en overvåkingssti og Multi User funksjonen aktivert. Alle andre brukere trenger ikke dette.



Deretter må du legge til en tilpasset referanse i integrasjonsfilen din. Navnet/typen på referansen er printr_user_alias og verdien er et nShift ApportConnect-alias.

Hvis du bruker standard XML for å integrere, kan det se slik ut:

<?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 denne filen sendes til TMS av brukeren med en overvåkingssti, vil forsendelsen bli opprettet (forutsatt at all nødvendig informasjon er til stede). Så snart responsen returneres til nShift ApportConnect, vil filen/forsendelsen endre eierskap til brukeren spesifisert i referansen (f.eks. "WAREHOUSE1" fra bildet ovenfor). Hvis det oppgitte nShift ApportConnect-aliaset ikke eksisterer, vil en melding bli logget, og eierskapet vil forbli hos den opprinnelige brukeren som sendte filen. Hvis ingen referanse er oppgitt mens Multi User er aktivert, forblir eierskapet uendret.

Etter at responsen er returnert og eierskapet har endret seg, vil integrasjonshistorikkposten tilhøre den nye brukeren. Hvis automatisk utskrift er aktivert for den nye brukeren, vil dokumentene bli hentet og skrevet ut automatisk ved å bruke den nye brukerens skrivere.

Eksempel arbeidsflyt:

Configuration:

• To nShift ApportConnect-brukere er satt opp: DemoUser og WAREHOUSE1.
   
• DemoUser har en overvåkingssti spesifisert og har aktivert Multi User funksjonen, men har ingen skrivere.
   
• Bruker WAREHOUSE1 har aktivert automatisk utskrift og har noen skrivere satt opp.
   

Arbeidsflyt:

1. En integrasjonsfil som inneholder referansetypen=“printr_user_alias” med verdien=”WAREHOUSE1” legges i DemoUserss overvåkingssti.
    
2. Filen sendes til TMS ved å bruke DemoUsers integrasjonslegitimasjon.
    
3. Forsendelsen opprettes og en respons returneres til nShift ApportConnect.
    
4. nShift ApportConnect endrer eieren av integrasjonsjobben til bruker WAREHOUSE1
    
5. Bruker WAREHOUSE1 gjør en dokumentforespørsel (fordi brukeren har “Automatic Print” aktivert), med brukerens egne integrasjonslegitimasjon. (I eksempelet ovenfor bruker både DemoUser og WAREHOUSE1 de samme integrasjonslegitimasjonene for å integrere.)
    
6. De returnerte dokumentene skrives ut på WAREHOUSE1s skrivere