ApportConnect is een applicatie waarmee je zendingen kunt aanmaken in TMS zonder in te hoeven loggen op de service. In plaats daarvan voeg je bestanden met zendingsinformatie toe aan een lokale map op je computer. De bestanden worden vervolgens met ApportConnect geïmporteerd in TMS. Er wordt een antwoordbestand naar je verzonden en de vrachtdocumenten worden afgedrukt op de geselecteerde printers. Alles gebeurt automatisch.
Inhoud van dit artikel:
1. Algemene disclaimer
Apport Connect wordt geleverd als een zelfstandige oplossing die als programma of service wordt uitgevoerd. Die service moet toegang hebben tot internet, het lokale netwerk en de aangewezen printers.
De ApportConnect-software is afhankelijk van:
- Serverhardware
- Serverbesturingssysteem
- Toegangsrechten (inclusief lezen/schrijven)
- Internettoegang
- Toegang tot lokaal netwerk en printers
- Printer
- Printerdrivers/configuratie
nShift kan niet verantwoordelijk worden gehouden als een van deze onderdelen invloed heeft op latency, doorvoer of kwaliteit in de ApportConnect-software.
2. Vereisten
Printers en lokaal netwerk
De ApportConnect-software biedt geen ondersteuning voor printerdrivers of de specifieke instellingen die nodig zijn voor de afzonderlijke printers die worden gebruikt; de software gaat ervan uit dat een correcte printerdriver en correcte instellingen zijn geïnstalleerd en ingesteld in het besturingssysteem en op de server waarop de applicatie wordt uitgevoerd.
ApportConnect kan alleen verbinding maken met en documentgegevens communiceren naar de aangewezen printers via de Windows-printers die zijn geïnstalleerd op dezelfde server waarop de applicatie wordt uitgevoerd. De verbinding van de Windows-printer naar de fysieke printer kan worden afgehandeld via een directe verbinding met het IP-adres van de printer of als de printer op een andere server wordt gedeeld. Nadat de applicatie documenten naar de gebruikte wachtrijen heeft gestuurd, neemt nShift geen verantwoordelijkheid meer voor ondersteuning van de configuratie.
Het account dat de ApportConnect-applicatie in applicatie- of servicemodus uitvoert, heeft passende toegang nodig om printopdrachten naar de gebruikte printers te plaatsen.
De prestaties van de printers en het afdrukken hangen af van de lokale configuratie van de servers, rechten en AD-beperkingen, evenals infrastructuur en LAN- of WAN-communicatie, en de gebruikte printers. Dit valt volledig buiten de mogelijkheden en verantwoordelijkheid van nShift om ondersteuning voor te bieden.
Labelprinten
Dit geldt voor het afdrukken van verzendlabels. Labels kunnen worden afgedrukt op A4-laserprinters, maar nShift raadt aan om een speciale labelprinter aan te schaffen en te gebruiken.
Elke labelprinter met een correcte configuratie en bijbehorende Windows-printerdriver kan worden gebruikt.
nShift TMS produceert de verzendlabels in ZPL-formaat, wat Zebra Programming Language is, of als PDF-bestanden. Alle instellingen voor formaat, papierbron, papierbestemming, kopieën of andere instellingen moeten worden ingesteld in de printer-/driverinstellingen. Bij gebruik van ZPL-formaat is de behoefte aan drivers beperkt tot Generic/Text only.
nShift doet geen aanbevelingen en neemt geen verantwoordelijkheid voor de gebruikte of geconfigureerde printers. nShift heeft alle transportlabels ontworpen en getest op printers van Zebra Technologies en raadt aan dat de gebruikte printers en het labelpapier een formaat hebben van 105 mm breed en maximaal 253 mm lang (afhankelijk van de vervoerdersservice).
Andere A4-documenten
Dit geldt voor het afdrukken van vrachtbrieven, CMR, ontvangstlijsten of vergelijkbare A4-documenten. Elke laserprinter met een correcte en bijbehorende Windows-printerdriver kan worden gebruikt.
nShift TMS produceert deze documenten als PDF-bestanden. Wanneer deze via de printerdriver worden verzonden, moeten alle instellingen voor formaat, papierbron, papierbestemming, kopieën of andere instellingen worden ingesteld in de printer-/driverinstellingen.
nShift doet geen aanbevelingen en neemt geen verantwoordelijkheid voor de printer of configuratie.
Aanbevolen hardware en besturingssysteem
nShift raadt aan om Microsoft Windows Server 2019 of een nieuwere versie als besturingssysteem te gebruiken. Hardwarevereisten hangen ook af van welke andere applicaties en services op de specifieke server worden uitgevoerd. Onze aanbeveling is 2-4 GB intern geheugen, een 64-bits CPU met dual-core of beter, en 2-5 GB schijfruimte voor ApportConnect-installatiebestanden, logbestanden en transactiebestanden.
Back-up en onderhoud van configuratiebestanden en transactionele gegevensbestanden moeten door de klant worden uitgevoerd. Alle onderhoudsroutines zijn volledig de verantwoordelijkheid van de klant. Systeemprestaties zijn afhankelijk van de totale configuratie, inclusief hardware, infrastructuur en configureerbare elementen. nShift neemt geen verantwoordelijkheid voor deze aspecten.
3. Prestaties
nShift voert regressietests uit om de prestaties van de huidige en vorige versies van ApportConnect te valideren en heeft een doorvoer bereikt van 2500-4000 aangemaakte zendingen en afgedrukte documenten per uur voor één instantie van ApportConnect. Het aantal zendingen en afgedrukte documenten hangt af van veel factoren, zoals het type service, het aantal pakketten per zending en of alleen labels of ook vrachtbrieven worden aangemaakt, evenals hardware en infrastructurele configuratie, zoals beschreven in de vereisten en aanbevelingen.
Prestaties worden ook beïnvloed door externe afhankelijkheden wanneer nShift door de vervoerders wordt gedwongen om met externe webservices te communiceren (Fedex, UPS en andere internationale vervoerders).
4. Downloaden
De nieuwste versie van nShift ApportConnect kan hier worden gedownload:
Zorg ervoor dat je het juiste installatiebestand voor je besturingssysteem downloadt als je een oudere versie wilt gebruiken die niet langer wordt ondersteund. Installatie van niet-ondersteunde versies is op eigen risico.
- ApportConnect voor OSX (oudere versie, wordt niet langer ondersteund)
- ApportConnect voor Linux (oudere versie, wordt niet langer ondersteund)
- ApportConnect voor JAR (oudere versie, wordt niet langer ondersteund)
5. Installatie
Installeren op Windows
Zorg ervoor dat je Microsoft Visual C++ 2010 Redistributable hebt geïnstalleerd voordat je ApportConnect installeert.
- Zoek je gedownloade installatieprogramma in .EXE-formaat en dubbelklik erop om de installatiewizard te starten. (Het bestand heet "nShift ApportConnect-XX", waarbij XX het versienummer is).
- Klik op Next.
- Accepteer de End-User License Agreement en klik op Next.
- Klik op Install. Het programma gebruikt standaard het volgende pad, maar dit kan tijdens de installatie worden gewijzigd: C:\Users\<username>\AppData\Local\nShift ApportConnect\
- Je bent nu klaar om enkele gebruikers in het programma in te stellen.
Installeren op Mac OSX
Let op: deze legacy-versie wordt niet langer ondersteund! Installatie is op eigen risico.
- Zoek het gedownloade DMG-bestand met de installatie van Unifaun ApportConnect.
- Dubbelklik op het gedownloade bestand; het zou op je Mac-systeem moeten worden gekoppeld. Je krijgt een installatiescherm met slepen en neerzetten te zien. Sleep het Unifaun ApportConnect-pictogram naar de map Applications zoals in de afbeelding wordt weergegeven.
- De installatie is nu voltooid!
- Start het programma via je Dashboard of door naar de map Applications te gaan.
Ga verder met het instellen van enkele gebruikers.
Installeren op Linux
Let op: deze legacy-versie wordt niet langer ondersteund! Installatie is op eigen risico.
Het installatieproces voor ApportConnect verschilt afhankelijk van de Linux-distributie die je gebruikt. Deze handleiding bevat specifieke instructies voor Ubuntu 16.04, maar vergelijkbare stappen kunnen worden aangepast voor andere distributies. Raadpleeg altijd de documentatie van je distributie voor exacte details.
In dit voorbeeld wordt Ubuntu 16.04 gebruikt, Debian-gepackageerd. Je kunt het desgewenst ook uitvoeren vanuit een ruwe .jar-file.
- Zoek het gedownloade .deb-bestand voor Unifaun ApportConnect.
- Dubbelklik op het .deb-pakket om het te openen in Ubuntu Software Center.
- Klik op de knop Install. Als je een melding krijgt over de pakketkwaliteit, klik dan op Ignore and install.
- Authenticeer indien vereist.
- Het programma wordt geïnstalleerd in /opt/UnifaunApportConnect.
- Pas indien nodig mapmachtigingen aan om het programma correct te kunnen gebruiken (bijv. sudo chmod -R 777 /opt/UnifaunApportConnect).
Bijwerken en verwijderen
Belangrijk! nShift ApportConnect MUST BE volledig afgesloten voordat het upgradeproces wordt gestart. (Dit geldt ook als je nShift ApportConnect als service uitvoert)
Upgrade je vanaf 1.2.1 of eerder?
De applicatie wordt op een nieuwe locatie geïnstalleerd omdat deze wordt omgedoopt tot “nShift ApportConnect”. (Voorheen Memnon PrintR) Je kunt je oude instellingen importeren vanuit de oude installatiemap (voornamelijk “settings.printr”). Raadpleeg de afzonderlijke instructies voor Migrating from PrintR to ApportConnect voor hulp bij het importeren van oude instellingen.
Volg deze instructies om nShift ApportConnect bij te werken:
- Download de nieuwe versie van nShift ApportConnect.
- Verwijder de momenteel geïnstalleerde versie van nShift ApportConnect. (Zie de onderstaande stappen voor het verwijderen)
- Voer het installatieprogramma uit en volg de instructies op het scherm. Een update werkt precies hetzelfde als het installeren van een nieuwe kopie van nShift ApportConnect. Je instellingen blijven behouden.
Verwijderen
Je instellingen en ApportConnect-gebruikers worden niet verwijderd als je deze stappen volgt:
Windows
- Zoek de installatiemap van ApportConnect. (Ofwel in C:\Users\<username>\AppData\Local\ApportConnect of C:\Documents and Settings\<username>\Application Data\Local\ApportConnect)
- Klik op het verwijderprogramma (unins000.exe) en volg de instructies.
- Wanneer dit is voltooid, verwijder dan NIETS anders uit de vorige installatiemap. Als je de map “app” of de map “ApportConnect” in AppData/Local verwijdert, worden je ApportConnect-instellingen verwijderd.
- Je kunt nu een nieuwe versie van ApportConnect installeren.
Mac OSX
- Verwijder eenvoudig “Unifaun ApportConnect” uit je map Applications.
- Verwijder GEEN bestanden van ApportConnect in je thuismap.
- Je kunt nu een nieuwe versie van ApportConnect installeren.
Linux
- Zoek je installatie (waarschijnlijk in /opt/UnifaunApportConnect)
- Verwijder alle bestanden en mappen BEHALVE de map met de naam “app”. Als je de map “app” verwijdert, worden je ApportConnect-instellingen verwijderd.
- Je kunt nu een nieuwe versie van ApportConnect installeren.