Guide for setting up the account and users
1. Einführung
AFAS Version 7 ist in die Transsmart APIv2 integriert. Frühere Versionen waren in APIv1 integriert.
Beim Austausch von Nachrichten mit APIv2 muss sich AFAS authentifizieren. Dies geschieht mit dem Benutzernamen und dem Passwort dessen, was in diesem Dokument als integration user bezeichnet wird. Diese Zugangsdaten müssen in AFAS konfiguriert werden und werden standardmäßig für alle Interaktionen mit der Transsmart Plattform verwendet.
Der Druck erfolgt durch das Senden einer Druckanforderung an Transsmart. Die Plattform bereitet dann den Druckauftrag vor und sendet ihn an den innerhalb des Netzwerks des Kunden installierten SmartPrint Client. SmartPrint sendet ihn dann über QZ Tray an den richtigen Drucker.
2. Standardkonfiguration
Für den Fall, dass für den Druck nur ein einzelner SmartPrint und ein einzelner Drucker benötigt werden, ist es ausreichend, die Druckdetails nur für den integration user zu konfigurieren. Sobald SmartPrint ausgeführt wird, gehen Sie zu printing tab für diesen Benutzer und wählen Sie die entsprechende SmartPrint Verbindung aus und konfigurieren dann den richtigen ZPL/PDF-Drucker.
Die konfigurierte SmartPrint Verbindung und die Drucker werden immer verwendet, unabhängig von dem tatsächlichen AFAS Benutzer, der die Druckaktion auslöst.
3. Mehrere Drucker
In einigen Fällen kann es notwendig sein, auf mehreren Druckern zu drucken und/oder mehrere SmartPrint clients zu verwenden, abhängig von dem AFAS Benutzer, der die Druckaktion auslöst. In einem solchen Fall ist es notwendig, zusätzliche Benutzer unter dem Konto zu konfigurieren.
Wir haben uns auf eine eindeutige Methode geeinigt, um den richtigen Drucker settings zu identifizieren, der für die Verarbeitung des Druckauftrags verwendet werden soll.
Die Druckanforderung von AFAS enthält einen bestimmten Parameter für den Benutzernamen, dessen Drucker settings verwendet werden sollen. Der Benutzername in dieser Anforderung wird immer wie unten formatiert sein:
[AFAS Benutzer-ID]@[AFAS Kontonummer], zum Beispiel stevenluyckx@31010
Der Transsmart APIv2 berücksichtigt diesen Parameter und verhält sich entsprechend:
a. Benutzername gefunden: Drucken mit dem für diesen Benutzer konfigurierten settings
b. Benutzername gefunden, hat kein Druck-settings : einen Fehler zurückgeben
c. Benutzername nicht gefunden: Drucken mit dem settings des integration user-Kontos (Fallback)
d. Benutzername leer: Drucken mit dem settings des integration user-Kontos (Fallback)
4. Kunden-Onboarding-Prozess
Alle Kunden mit einem einzelnen Drucker drucken immer mit dem Drucker-settings des integration user. Sie benötigen nichts Weiteres.
Kunden, die mit einer Umgebung mit mehreren Druckern arbeiten, müssen zwei Dinge tun:
1. wie bei einer Standardkonfiguration das Drucker-settings auf dem integration user konfigurieren
2. für jeden AFAS-Benutzer, der auf einen nicht standardmäßigen Drucker drucken möchte, muss in MyTranssmart ein entsprechendes Benutzerkonto mit dem alternativen Drucker-settings erstellt werden
Der Benutzername muss wie folgt formatiert sein: [AFAS-Benutzer-ID]@[AFAS-Kontonummer]
5. Beispiel-Anwendungsfall
Angenommen, der Kunde hat die AFAS-Kontonummer „12345“.
Angenommen, Drucker X ist mit SmartPrint1 verknüpft und Drucker Y ist mit SmartPrint2 verknüpft.
AFAS-Benutzerliste
userA
userB
userC
Transsmart-Benutzerliste
integration user-Konto konfiguriert zum Drucken mit SmartPrint1 auf Drucker X
userC@12345 konfiguriert zum Drucken mit SmartPrint2 auf Drucker Y
Beispielanforderungen
1. für userA
Druckbenutzer-Parameter userA@12345
Transsmart findet kein passendes Benutzerkonto, der Druck wird mit dem settings des integration user ausgeführt --) Druckauftrag wird über SmartPrint1 an Drucker X gesendet
2. für userB
Druckbenutzer-Parameter userB@12345 idem dito
3. für userC
Druckbenutzerparameter userC@12345 Transsmart findet einen passenden Benutzer und der Benutzer hat Druckeinstellungen konfiguriert, der Druck wird mit diesen settings ausgeführt --) Druckauftrag wird über SmartPrint2 an Drucker Y gesendet