Denne artikel vil dække den mest almindelige anvendelse af nShift ApportConnect.
Sektioner i denne artikel:
Integration med TMS
Ved konfiguration af brugeren (læs mere), specificerer du en overvågningssti, der instruerer nShift ApportConnect til at overvåge den mappe for indkommende integrationsfiler.
Hvis det er første gang, du specificerer overvågningsstien, vil fem mapper blive oprettet i den mappe. Sørg for, at programmet har både læse- og skriveadgang til den specificerede sti. Overvågningsstien er unik og kan ikke opsættes for flere brugere.
Bemærk! nShift ApportConnect vil registrere enhver fil placeret i denne mappe. Sørg for, at mappen er fri for uønskede filer, før nShift ApportConnect begynder at bruge den.
Ved opdagelse af en ny fil i denne mappe sender nShift ApportConnect filen til TMS ved hjælp af domænet, brugernavnet og adgangskoden for den bruger, der overvåger mappen. Filen bliver derefter valideret, og hvis det lykkes, oprettes en eller flere forsendelser fra dens indhold.
Hvis filen er ugyldig, returnerer Apport en eller flere fejl, der fortæller dig, hvad der er galt.
Efter at en integrationsfil er blevet behandlet, vises den under Historik > Integrationssektion, hvor du kan se filens status og de oprettede forsendelser. Filen flyttes og omdøbes med et datostempel og kan findes i p_success eller p_error directory, afhængigt af dens status.
Du kan nemt se filen ved at klikke på Vis fil knappen. For at se forsendelsesdetaljer, klik på Vis forsendelse, og for at genudskrive valgte forsendelser, klik på Genudskriv valgte.
Automatisk udskrivning
Automatisk udskrivning findes under Settings > Administrer brugere > Filovervågning.
Du kan vælge at udskrive forsendelser automatisk, når de oprettes under integration med TMS. Dokumenterne vil blive hentet fra de forsendelser, der er oprettet fra integrationsfilen. Etiketten (og fragtbrevet, hvis relevant) vil blive udskrevet ved hjælp af den eller de printere, der er konfigureret til den bruger, der udfører integrationen.
Hvis denne mulighed ikke er valgt, kan du vælge at udskrive dokumenterne når som helst fra Historik > Integration fanen.
Svarfil
Hvis din integration med TMS har aktiveret brugen af en svarfil, vil den blive gemt i mappen kaldet p_responses. Denne fil indeholder normalt information om de oprettede forsendelser, valideringsfejl, priser og andre data.
Hvis du er usikker på, om du har denne mulighed aktiveret, eller gerne vil vide, hvordan det fungerer, bedes du kontakte nShift TMS kundeservice.
Multi User /Redirecting dokumenter
settings for at tillade Multi user findes under Settings > Administrer brugere > Filovervågning.
nShift ApportConnect er designet med visionen om at have forskellige brugere opsat med deres egne printere. Disse brugere har deres egne overvågningsstier og vil sende filer fundet i deres respektive mapper, mens de udskriver med deres egne printere.
Hvis du ikke har mulighed for at outputte filer i forskellige mapper/overvågningsstier for forskellige nShift ApportConnect-brugere, er der en måde at "omdirigere" eller ændre ejeren af forsendelser og dokumenter til en anden nShift ApportConnect-bruger. Denne funktion kaldes Multi User.
Funktionen Multi User fungerer ved at indtaste yderligere detaljer i din integrationsfil (den, der skal sendes til TMS). For at enable denne funktion, opsæt de brugere, du vil bruge (for eksempel to lagerbrugere) og husk deres nShift ApportConnect-aliaser. Integrationsbrugeren er blevet opsat med en overvågningssti, og Tillad 'Multi User' er markeret. Dette vil være den eneste bruger med en overvågningssti og funktionen Multi User aktiveret. Alle andre brugere behøver ikke dette.
Derefter skal du tilføje en brugerdefineret reference i din integrationsfil. Navnet/typen af referencen er printr_user_alias og værdien er et nShift ApportConnect-alias.
Hvis du bruger standard XML til at integrere, kunne det se sådan ud:
<?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 fil sendes til TMS af brugeren med en overvågningssti, vil forsendelsen blive oprettet (forudsat at alle nødvendige oplysninger er til stede). Så snart svaret returneres til nShift ApportConnect, vil filen/forsendelsen ændre ejerskab til den bruger, der er angivet i referencen (f.eks. "WAREHOUSE1" fra billedet ovenfor). Hvis det angivne nShift ApportConnect-alias ikke eksisterer, vil en besked blive logget, og ejerskabet vil forblive hos den oprindelige bruger, der sendte filen. Hvis ingen reference er angivet, mens Multi User er aktiveret, forbliver ejerskabet uændret.
Efter svaret er returneret og ejerskabet er ændret, vil integrationshistorikposten tilhøre den nye bruger. Hvis automatisk udskrivning er aktiveret for den nye bruger, vil dokumenter blive hentet og udskrevet automatisk ved hjælp af den nye brugers printere.
Eksempel på arbejdsgang:
Configuration:
- To nShift ApportConnect-brugere er opsat: DemoUser og WAREHOUSE1.
-
DemoUser har en overvågningssti specificeret og har aktiveret funktionen Multi User, men har ingen printere.
- Bruger WAREHOUSE1 har aktiveret automatisk udskrivning og har nogle printere opsat.
Arbejdsgang:
- En integrationsfil, der indeholder referencetypen=“printr_user_alias” med værdien=”WAREHOUSE1” placeres i DemoUsers's overvågningssti.
- Filen sendes til TMS ved hjælp af DemoUsers integrationsoplysninger.
- Forsendelsen oprettes, og et svar returneres til nShift ApportConnect.
- nShift ApportConnect ændrer ejeren af integrationsjobbet til bruger WAREHOUSE1
- Bruger WAREHOUSE1 anmoder om dokumenter (fordi brugeren har “Automatic Print” aktiveret), med brugerens egne integrationsoplysninger. (I ovenstående eksempel bruger både DemoUser og WAREHOUSE1 de samme integrationsoplysninger til at integrere.)
- De returnerede dokumenter udskrives på WAREHOUSE1s printere