TSE Agent: Unterschied zwischen den Versionen

Aus FAKTURA-X Wiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „FAKTURA-X TSE Agent ist eine kleine Anwendung, welche die Bontabelle in regelmäßigen, einstellbaren Intervallen auf neue Kassenvorgänge untersucht. Findet d…“)
 
Zeile 13: Zeile 13:
Alle Einstellungen werden als INI-Datei im Verzeichnis C:\Users\<Benutzername>\AppData\Roaming\TSEAgent\ des aktuellen Benutzers abgelegt.
Alle Einstellungen werden als INI-Datei im Verzeichnis C:\Users\<Benutzername>\AppData\Roaming\TSEAgent\ des aktuellen Benutzers abgelegt.
Die Zugangsdaten für den SMTP-Server werden in der INI-Datei im Klartext gespeichert. Eine Verschlüsselung ist derzeit noch nicht enthalten. Daher sollte die INI-Datei entfernt werden, wenn der Computer oder das Programm nicht mehr benötigt wird.
Die Zugangsdaten für den SMTP-Server werden in der INI-Datei im Klartext gespeichert. Eine Verschlüsselung ist derzeit noch nicht enthalten. Daher sollte die INI-Datei entfernt werden, wenn der Computer oder das Programm nicht mehr benötigt wird.
{{Achtung|Die Zugangsdaten für den SMTP-Server werden in der INI-Datei im Klartext gespeichert. Eine Verschlüsselung ist derzeit noch nicht enthalten. Daher sollte die INI-Datei entfernt werden, wenn der Computer oder das Programm nicht mehr benötigt wird.}}
==E-Mail Setup==
Für den Versand von E-Mails muss ein SMTP-Server angesprochen werden. In den Feldern der Gruppe „E-Mail Kommunikation" kann ein beliebiger SMTP-Server eingestellt werden, so dass das interne Mailsystem über diesen E-Mails versendet. Die Angabe eines Kopieempfängers ist optional.
{{Popup|konfig_admin_email.png|link{{=}}|gerahmt{{!}}ohne{{!}}Die Gruppe '''E-Mail Einstellungen'''|158|102|173|117|[[File:konfig_admin_email_popup.png|gerahmt|ohne|link=]]}}
===Hinweise zur E-Mailkonfiguration===
* Die Anwendung versendet E-Mails direkt an den eingestellten SMTP-Server.
{{Hinweis|Es besteht keinerlei Abhängigkeit von einer eventuell installierten E-Mail Anwendung wie ''Outlook'' oder ''Thunderbird''. Der E-Mailversand wird ausschließlich von der Anwendung selbst organisiert.}}
* Die Serverdaten müssen absolut korrekt sein. Das betrifft sowohl den Namen des SMTP-Servers, die Zugangsdaten (Benutzername und Passwort).
{{Hinweis|Beachten Sie bei der Eingabe der Zugangsdaten auch Groß- und Kleinschreibung. Die Angaben zur korrekten SMTP-Konfiguration erhalten Sie ausschließlich von Ihrem E-Mailanbieter.}}
* Übliche Portkonfiguration für SMTP sind 25 (unverschlüsselt), 465 (SMTP over SSL), 587 (Message Submission Agent mit oder ohne SSL) oder 995 (TLS/SSL)
{{Hinweis|Die Angaben zur korrekten SSL- und Portkonfiguration erhalten Sie ausschließlich von Ihrem E-Mailanbieter.}}
* Die E-Mailadresse des Absenders muss angegeben werden.
{{Hinweis|Die Absenderadresse muss vom SMTP-Server akzeptiert werden (üblicherweise mit der SMTP-Adresse übereinstimmen), ansonsten scheitert der Versand von E-Mails!}}
* Die Angabe des Kopieempfängers ist optional.
* Wenn gewünscht, kann ein Betreff und ein kurzer Infotext angegeben werden.
==Datenbanküberwachung==
Der Ordner der Datenbank wird regelmäßig auf neue Vorgänge geprüft. Findet die Anwendung dort einen oder mehrere Vorgänge, speichert sie diese sofort in der TSE-Einheit.
Nach dem Speichern wird ein Protokolleintrag erstellt, der das erfolgreiche Schreiben dokumentiert oder Fehler registriert.
Werden zu viele Fehler registriert, wird über den E-Mailclient eine Nachricht an den eingetragenen Empfänger gesendet, damit dieser die Probleme des TSE Agenten beseitigen kann.

Version vom 28. September 2020, 21:30 Uhr

FAKTURA-X TSE Agent ist eine kleine Anwendung, welche die Bontabelle in regelmäßigen, einstellbaren Intervallen auf neue Kassenvorgänge untersucht. Findet die Anwendung neue Vorgänge, werden diese in der TSE-Einheit gespeichert.

Die Anwendung ist so konzipiert, dass sie auf einem Server die Kassiervorgänge einer Arbeitsgruppe aus mehreren Kassen verarbeitet. Dadurch kann eine einzige TSE für mehrere Kassen genutzt werden.

Die Anwendung wird nach dem Extrahieren des Archivs an den Installationsort automatisch gestartet, legt eine Verknüpfung im Autostartorder und eine Konfigurationsdatei im Ausführungsverzeichnis an. Dann wird der Konfigurationsdialog angezeigt.

Installation

Die Anwendung wird nach dem Extrahieren des Archivs an den Installationsort automatisch gestartet, legt eine Verknüpfung im Autostartorder und eine Konfigurationsdatei im Ausführungsverzeichnis an. Dann wird der Konfigurationsdialog angezeigt.

Der Autostart wird für den aktuellen Benutzer in der Windows-Registrierung gespeichert. Er gilt daher nicht für andere Benutzerprofile auf dem Computer.

Konfiguration

Alle Einstellungen werden als INI-Datei im Verzeichnis C:\Users\<Benutzername>\AppData\Roaming\TSEAgent\ des aktuellen Benutzers abgelegt. Die Zugangsdaten für den SMTP-Server werden in der INI-Datei im Klartext gespeichert. Eine Verschlüsselung ist derzeit noch nicht enthalten. Daher sollte die INI-Datei entfernt werden, wenn der Computer oder das Programm nicht mehr benötigt wird.

Die Zugangsdaten für den SMTP-Server werden in der INI-Datei im Klartext gespeichert. Eine Verschlüsselung ist derzeit noch nicht enthalten. Daher sollte die INI-Datei entfernt werden, wenn der Computer oder das Programm nicht mehr benötigt wird.

E-Mail Setup

Für den Versand von E-Mails muss ein SMTP-Server angesprochen werden. In den Feldern der Gruppe „E-Mail Kommunikation" kann ein beliebiger SMTP-Server eingestellt werden, so dass das interne Mailsystem über diesen E-Mails versendet. Die Angabe eines Kopieempfängers ist optional.

Die Gruppe E-Mail Einstellungen
Konfig admin email popup.png

Hinweise zur E-Mailkonfiguration

  • Die Anwendung versendet E-Mails direkt an den eingestellten SMTP-Server.
Es besteht keinerlei Abhängigkeit von einer eventuell installierten E-Mail Anwendung wie Outlook oder Thunderbird. Der E-Mailversand wird ausschließlich von der Anwendung selbst organisiert.
  • Die Serverdaten müssen absolut korrekt sein. Das betrifft sowohl den Namen des SMTP-Servers, die Zugangsdaten (Benutzername und Passwort).
Beachten Sie bei der Eingabe der Zugangsdaten auch Groß- und Kleinschreibung. Die Angaben zur korrekten SMTP-Konfiguration erhalten Sie ausschließlich von Ihrem E-Mailanbieter.
  • Übliche Portkonfiguration für SMTP sind 25 (unverschlüsselt), 465 (SMTP over SSL), 587 (Message Submission Agent mit oder ohne SSL) oder 995 (TLS/SSL)
Die Angaben zur korrekten SSL- und Portkonfiguration erhalten Sie ausschließlich von Ihrem E-Mailanbieter.
  • Die E-Mailadresse des Absenders muss angegeben werden.
Die Absenderadresse muss vom SMTP-Server akzeptiert werden (üblicherweise mit der SMTP-Adresse übereinstimmen), ansonsten scheitert der Versand von E-Mails!
  • Die Angabe des Kopieempfängers ist optional.
  • Wenn gewünscht, kann ein Betreff und ein kurzer Infotext angegeben werden.

Datenbanküberwachung

Der Ordner der Datenbank wird regelmäßig auf neue Vorgänge geprüft. Findet die Anwendung dort einen oder mehrere Vorgänge, speichert sie diese sofort in der TSE-Einheit.

Nach dem Speichern wird ein Protokolleintrag erstellt, der das erfolgreiche Schreiben dokumentiert oder Fehler registriert.

Werden zu viele Fehler registriert, wird über den E-Mailclient eine Nachricht an den eingetragenen Empfänger gesendet, damit dieser die Probleme des TSE Agenten beseitigen kann.