Dieser Artikel behandelt den häufigsten Anwendungsfall von nShift ApportConnect.
Abschnitte in diesem Artikel:
Integration mit TMS
Beim Konfigurieren des Benutzers (mehr lesen) geben Sie einen Überwachungspfad an, der nShift ApportConnect anweist, dieses Verzeichnis auf eingehende Integrationsdateien zu überwachen.
Wenn Sie zum ersten Mal den Überwachungspfad angeben, werden in diesem Verzeichnis fünf Ordner erstellt. Stellen Sie sicher, dass das Programm sowohl Lese- als auch Schreibberechtigungen für den angegebenen Pfad hat. Der Überwachungspfad ist einzigartig und kann nicht für mehrere Benutzer eingerichtet werden.
Hinweis! nShift ApportConnect erkennt jede Datei, die in diesen Ordner gelegt wird. Stellen Sie sicher, dass der Ordner frei von unerwünschten Dateien ist, bevor nShift ApportConnect ihn verwendet.
Beim Entdecken einer neuen Datei in diesem Ordner sendet nShift ApportConnect die Datei an TMS unter Verwendung der Domain, des Benutzernamens und des Passworts des Benutzers, der das Verzeichnis überwacht. Die Datei wird dann validiert, und bei Erfolg werden aus ihrem Inhalt ein oder mehrere Sendungen erstellt.
Wenn die Datei ungültig ist, gibt Apport einen oder mehrere Fehler zurück, die Ihnen mitteilen, was falsch ist.
Nachdem eine Integrationsdatei verarbeitet wurde, erscheint sie unter dem Abschnitt Historie > Integration, wo Sie den Status der Datei und die erstellten Sendungen einsehen können. Die Datei wird verschoben und mit einem Datumsstempel umbenannt und kann je nach Status im p_success oder p_error Verzeichnis gefunden werden.
Sie können die Datei einfach anzeigen, indem Sie auf die Schaltfläche Datei anzeigen klicken. Um Sendungsdetails zu sehen, klicken Sie auf Sendung anzeigen, und um ausgewählte Sendungen erneut zu drucken, klicken Sie auf Ausgewählte erneut drucken.
Automatisches Drucken
Das automatische Drucken finden Sie unter Settings > Benutzer verwalten > Dateiüberwachung.
Sie können wählen, automatisch Sendungen zu drucken, die während der Integration mit TMS erstellt wurden. Die Dokumente werden aus den Sendungen abgerufen, die aus der Integrationsdatei erstellt wurden. Das Etikett (und der Frachtbrief, falls zutreffend) wird mit dem/den für den Benutzer, der die Integration durchführt, konfigurierten Drucker(n) gedruckt.
Wenn diese Option nicht ausgewählt ist, können Sie die Dokumente jederzeit über die Registerkarte Historie > Integration drucken.
Antwortdatei
Wenn Ihre Integration mit TMS die Verwendung einer Antwortdatei ermöglicht hat, wird diese im Ordner namens p_responses gespeichert. Diese Datei enthält normalerweise Informationen über die erstellten Sendungen, Validierungsfehler, Preise und andere Daten.
Wenn Sie sich nicht sicher sind, ob Sie diese Option aktiviert haben oder wissen möchten, wie sie funktioniert, wenden Sie sich bitte an den nShift TMS Kundenservice.
Multi User /Redirecting Dokumente
Die settings für die Erlaubnis von Multi user finden Sie unter Settings > Benutzer verwalten > Dateiüberwachung.
nShift ApportConnect ist mit der Vision konzipiert, dass verschiedene Benutzer mit ihren eigenen Druckern eingerichtet werden. Diese Benutzer haben ihre eigenen Überwachungspfade und senden Dateien, die in ihren jeweiligen Ordnern gefunden werden, während sie mit ihren eigenen Druckern drucken.
Wenn Sie nicht in der Lage sind, Dateien in verschiedene Ordner/Überwachungspfade für verschiedene nShift ApportConnect-Benutzer auszugeben, gibt es eine Möglichkeit, die Sendungen und Dokumente einem anderen nShift ApportConnect-Benutzer zu "redirecten" oder den Besitzer zu ändern. Diese Funktion wird Multi User genannt.
Die Multi User Funktion funktioniert, indem zusätzliche Details in Ihre Integrationsdatei eingegeben werden (die an TMS gesendet werden soll). Um diese Funktion zu enable, richten Sie die Benutzer ein, die Sie verwenden möchten (zum Beispiel zwei Lagerbenutzer) und stellen Sie sicher, dass Sie sich an ihre nShift ApportConnect-Aliase erinnern. Der Integrationsbenutzer wurde mit einem Überwachungspfad eingerichtet, und Erlaube 'Multi User' ist aktiviert. Dies wird der einzige Benutzer mit einem Überwachungspfad und der aktivierten Multi User Funktion sein. Alle anderen Benutzer benötigen dies nicht.
Als nächstes müssen Sie einen benutzerdefinierten Verweis in Ihrer Integrationsdatei hinzufügen. Der Name/Typ des Verweises ist printr_user_alias und der Wert ist ein nShift ApportConnect-Alias.
Wenn Sie standardmäßiges XML zur Integration verwenden, könnte es so aussehen:
<?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>
Wenn diese Datei von dem Benutzer mit einem Überwachungspfad an TMS gesendet wird, wird die Sendung erstellt (vorausgesetzt, alle notwendigen Informationen sind vorhanden). Sobald die Antwort an nShift ApportConnect zurückgegeben wird, wechselt die Datei/Sendung den Besitzer zu dem im Verweis angegebenen Benutzer (z. B. "WAREHOUSE1" aus dem obigen Bild). Wenn der angegebene nShift ApportConnect-Alias nicht existiert, wird eine Nachricht protokolliert, und der Besitz bleibt beim ursprünglichen Benutzer, der die Datei gesendet hat. Wenn kein Verweis angegeben wird, während Multi User aktiviert ist, bleibt der Besitz unverändert.
Nachdem die Antwort zurückgegeben wurde und der Besitz gewechselt hat, gehört das Integrationshistorienelement dem neuen Benutzer. Wenn für den neuen Benutzer das automatische Drucken aktiviert ist, werden die Dokumente automatisch mit den Druckern des neuen Benutzers abgerufen und gedruckt.
Beispielworkflow:
Configuration:
- Zwei nShift ApportConnect-Benutzer sind eingerichtet: DemoUser und WAREHOUSE1.
-
DemoUser hat einen Überwachungspfad angegeben und die Multi User Funktion aktiviert, hat jedoch keine Drucker.
- Benutzer WAREHOUSE1 hat das automatische Drucken aktiviert und einige Drucker eingerichtet.
Workflow:
- Eine Integrationsdatei mit dem Referenztyp=“printr_user_alias” mit dem Wert=”WAREHOUSE1” wird in den Überwachungspfad von DemoUser gelegt.
- Die Datei wird mit den Integrationsanmeldeinformationen von DemoUser an TMS gesendet.
- Die Sendung wird erstellt und eine Antwort wird an nShift ApportConnect zurückgegeben.
- nShift ApportConnect ändert den Besitzer des Integrationsjobs zu Benutzer WAREHOUSE1
- Benutzer WAREHOUSE1 stellt eine Dokumentenanfrage (da der Benutzer “Automatic Print” aktiviert hat), mit den eigenen Integrationsanmeldeinformationen des Benutzers. (Im obigen Beispiel verwenden sowohl DemoUser als auch WAREHOUSE1 dieselben Integrationsanmeldeinformationen zur Integration.)
- Die zurückgegebenen Dokumente werden auf den Druckern von WAREHOUSE1 gedruckt