Der Serviceprozess schreibt seine Log-Informationen in ein eigenes File.

Der Dateiname hat folgenden Aufbau:

JJJJMMDD_Service.log

• JJJJMMDD, Jahr Monat Tag

Beispiel:

• 20220702_ServiceLog.log
  Das Datum bezieht sich auf den Start des Dienstes.

Alte Logfiles werden automatisch entfernt, mehr dazu auf der Seite Generelle Datenbereinigung

Jeder Servicetask schreibt seine Informationen ebenfalls in ein eigenes File.

Die Dateinamen haben folgenden Aufbau:

JJJJMMDD_Tnnn_Name.log

• JJJJMMDD, Jahr Monat Tag
• Tnnn, Taskummer
  Entspricht der Reihenfolge der Tasks in der Konfiguration
• Name, Name aus der Konfiguration oder Klassenname

Beispiel:

• 20251101_T002_ANTRAS.Common.serviceTasks.TaskDbBackup.log
  Das Datum bezieht sich auf den Start des Dienstes.

Alle Tasks werden als einzelne Knoten unterhalb root/service eingetragen und weisen mindestens die folgenden Attribute auf:

• Sprechender Name des Tasks
• run-each-seconds
  Wiederholtes Ausführen der Aufgabe, Wartezeit bis zu nächsten Ausführung in Sekunden
• active
  yes | no
• fqcn
  Vollqualifizierter Name der ausführenden Klasse
• restricted-timerange
  Optionale Einschräkung innerhalb zur Ausführung. Im Nebenstehenden Beispiel wird die Aufgabe nur zwischen 00:00 Uhr und 22:00 gestartet.
• guid
  Eindeutige ID. Diese kann beispielsweise unter https://www.guidgenerator.com/ erstellt werden. Diese ist nur zwingend notwendig, wenn mehrere Konfiguration des selben Types verwendet werden
• delay-on-service-start
  Damit nicht alle Aufgabe gleichzeitig starten und eine hohe Last verursachen, kann eine Startverzögerung in Sekunden definiert werden.

Nach einer Änderung der Konfiguration muss der Dienst neu gestartet werden.

Log Files

Für den Service und jeden Task wird ein eigenes Logfile geführt.

Führt Wartungsaufgaben in der Datenbank durch. Backups sind nur möglich, wenn die Datenbank auf dem Applikationsserver betrieben wird. Andernfalls erstellen Sie bitte einen entsprechenden Wartungsplan auf dem SQL-Server.

Pro Kalendertag wird nur ein Backup erstellt und anschliessend allenfalls die Verkleinerung ausgeführt, die Indizes werden bei jedem Start gepflegt.

Backup

• execute-backup
  yes | no. Nur möglich, wenn die Datenbank auf dem Applikationsserver betrieben wird.
• storebackups-in-path
  Speicherort der Backupdateien. Die Daten werden in einer ZIP-Datei gespeichert
• delete-old-files-after-days
  Löschen bestehender Backupdateien nach n Tagen

Index Pflege

Reorg oder Rebuild wird nur für Indizes ausgeführt, welche einen PageCount>= 100 (Datenbankseiten ) aufweisen.

• rebuild-and-reorg-indices
  yes | no
• reorg-threshold
  Reorganisert Indizes falls dieser Fragmentierungsschwellwert überschritten wurde
• rebuild-threshold
  Erstellt die Indizes neu, falls dieser Fragmentierungsschwellwert überschritten wurde

Verkleinern der Datenbank

• shrink-database
  yes | no
• shrink-target-percent-left
  Lässt am Ende der Daten einen entsprechenden Anteil Platz frei

Gibt Benutzerkonten automatisch frei, nachdem eine Anfrage zur Freigabe eines gesperrten Kontos über das Onlineformular erfolgt ist.

Detailierte Informationen zum Ablauf und der Konfiguration dieser Funktion finden Sie unter «Selfservice» Anfrage zur Freigabe gesperrter Konten.

Dieser Task wird ohne explizite Konfiguration gestartet und muss daher nicht konfiguriert werden.

Versand von Benutzern manuell erstellten Formulare wie Kontaktanfragen, oder automatisch erstellter Formulare wie beispielsweise Auftragsbestätigungen per E-Mail.

• form-def-ids
  Optionals Einschränke auf Formulare dieser Formulardefinitionen. Erwartet Komma separierte IDs

Bereinigung von Daten, welche aus Platz- oder datenschutzrechtlichen Gründen regelmässig entfernt werden müssen:

• Informationen zu Adresssperrungen
• Anträge und Informationen zur Freigabe gesperrter Benutzerkonten
• Daten von Benutzersitzungen
• Systemüberwachungsinformationen
• Batschjob Artefakte
• Logdateien der Applikation und des Webservers
• Obsolete Stammdaten von Adressbereichen
• Temporäre Dateien
• Druckaufträge
• Exportdateien
• Serverseitiger Cachefiles

Dieser Task wird ohne explizite Konfiguration gestartet und muss daher nicht konfiguriert werden. Sämtliche Einstellungen sind über die Benutzeroberfläche erreichbar.

Details zur konfiguration finden Sie auf der Seite Generelle Datenbereinigung.

Die Aktualisierung von Stamdaten, beispielsweise aktualisierten MwSt. Sätzen oder standardisierten Formulardefinitionen, wird durch drei Tasks erledigt.

Weitere Informationen zum Thema finden Sie auf der Seite Autom. Update zentraler Stammdaten.

 

TaskDeployMasterDataCheck

Prüft, ob unter license.antras.ch neue oder aktualisierte Stammdaten verfügbar sind.

 

TaskDeployMasterDataDownload

Lädt neue oder aktualisierte Stammdaten auf das System herunter.

 

TaskDeployMasterDataInstall

Installiert die heruntergeladenen Daten in Abhängigkeit der Voreinstellung.

 

---

Diese Tasks werden ohne explizite Konfigurationen gestartet und müssen daher nicht konfiguriert werden.

Gibt gesperrte IP Adressen wieder frei.

Die zur Sperrung und Freigabe angewandten Regeln finden Sie auf der Seite zur Konfiguration der Betrugsabwehr.

Ruft im konfigurierten Zeitabstand die Webadresse der Applikation auf. Damit kann ohne zusätzliche Konfiguration im Webserver verhindert werden, dass die Applikation nach längerer Nichtbenutzung beendet wird und dadurch beim nächsten Zugriff wieder gestartet werden muss, was eine etwas längere Wartezeit bedeutet.

Im nebenstehenden Beispiel wird zudem eine E-Mail versandt, sollte die Applikation nicht erreichbar sein. Ausserdem lässt man es zu, dass die Applikation zwischen 23:00 und 05:00 beendet werden kann. In diesem Zeitraum wird auch keine E-Mail versandt.

• url
  Die Webadresse der Applikation oder weiitere durch Kommata getrennte Webadressen
• send-alert-email
  yes | no
• alert-email-receipient
  Eine oder mehrere durch Kommata getrennte E-Mail Adressen
• http-statuscode-successlist
  Eine oder mehrere durch Kommata getrennte HTTP Statuscode, welche einen Erfolg indizieren

Dieser Task wird ohne explizite Konfiguration gestartet und muss daher nicht konfiguriert werden.

Holt E-Mails eines IMAP Postfaches regelmässig ab und speichert diese wahlweise als standardisierte EML- oder XML Datei ab. Attachments lassen sich abtrennen und ebenfalls speichern.

• mark-mails-as-deleted
  yes | no. Markiert heruntergeladene E-Mails als gelöscht in der IMAP Mailbox
• mark-mails-as-read
  yes | no. Markiert heruntergeladene E-Mails als gelesen in der IMAP Mailbox
• fetch-mails-marked-as-read
  yes | no. Legt fest, ob als bereits als gelesene markierte E-Mails heruntergeladen werden sollen.
  Als gelöscht markierte E-Mails werden nie heruntergeladen
• remove-marked-as-deleted-on-servicestart
  yes | no. Legt fest, ob jeweils nach dem Start des Services als gelöscht markierte E-Mails gelöscht werden sollen

• save-eml-dir
  Ordner im Dateisystem. Wenn gesetzt, wird die Mail im standardisierten EML Format gespeichert
• save-xml-dir
• Ordner im Dateisystem. Wenn gesetzt, wird die Mail im XML Format gespeichert
• save-attachments-dir
  Ordner im Dateisystem. Wenn gesetzt, wird alle Attachments gespeichert

Falls Sie diese Funktion für Ihre Prozesse benötigen und auf Ihrer Mail Infrastrukur keinen IMAP Zugriff bereitstellen können oder wollen, stellen wir Ihnen gerne ein entsprechendes Postfach bei uns zur Verfügung, beispielsweise customer.purpose@antras.ch.

Holt E-Mails regelmässig via POP3 ab und speichert diese wahlweise als standardisierte EML- oder XML Datei ab. Attachments lassen sich abtrennen und ebenfalls speichern.

• remove-mails-from-pop
  yes | no. Entfernen bezogener E-Mails vom Mailserver
• save-eml-dir
  Ordner im Dateisystem. Wenn gesetzt, wird die Mail im standardisierten EML Format gespeichert
• save-xml-dir
  Ordner im Dateisystem. Wenn gesetzt, wird die Mail im XML Format gespeichert
• save-attachments-dir
  Ordner im Dateisystem. Wenn gesetzt, wird alle Attachments gespeichert

Falls Sie diese Funktion für Ihre Prozesse benötigen und auf Ihrer Mail Infrastrukur keinen POP3 Zugriff bereitstellen können oder wollen, stellen wir Ihnen gerne ein entsprechendes Postfach bei uns zur Verfügung, beispielsweise customer.purpose@antras.ch.

Für den Fall, dass einer Ihrer Partner Daten auf einem FTP Server empfangen möchte, steht der Task TaskFtpSendFiles zur Verfügung.

Dabei wird ein Verzeichnis regelmässig auf neue Dateien überprüft, diese werden per FTP transferiert und anschliessend verschoben.

Steuerung des Prozesses

• behaviour-when-file-exists
  Overwrite | Skip | Append, Überschreiben der bestehenden Datei, Überspringen, Daten an dies bestehende Datei anfügen
• watch-dir
  Verzeichnis mit zu transferierenden Dateien
• search-pattern
  Optional zur Filterung zu übertragender Dateien
• processed-dir
  Verzeichnis zur Ablage der Dateien nach erfolgreichem Transfer
• failed-dir
  Verzeichnis zur Ablage der Dateien nach fehlgeschlagenem Transfer

FTP Konfiguration

• ftp-server
• ftp-port
• ftp-user
• ftp-password

• ftp-autodiscover
  yes | no. Wenn aktiviert, wird versucht, eine Verbindung aufzubauen. Die nachfolgenden Settings sind dann wirkungslos
• data-connection-type
  AutoPassive | EPSV | PASV | PASVEX, AutoPassive wird empfohlen
• ftp-encryption-mode
  Implicit (Port 990) | Explicit (Plain => FTPS) | Auto, Auto wird empfohlen

Prüft in regelmässigen Abständen, ob für die Installation eine aktualisierte Lizenz vorhanden ist, führt einen Download durch und installiert die neue Lizenz auf dem System.

Das Lizenzfile wird im Konfigurationsverzeichnis der Applikation im Unterverzeichnis /License abgelegt.
Ein bestehendes Lizenzfile wird in das Unterverzeichnis /License/Archive verschoben.

Die Installation eines Lizenzfiles wird auf license.antras.ch bestätigt. Dabei werden aktuelle Telemetriedaten übermittelt, siehe dazu auch detaillierte Informationen auf der Seite Telemetrie.

Der Dateinamen eines Lizenzfiles folgt folgendem Schema:
DATUMTZeit_SPRACHE_Id_KundeZweck_Lizenznummer.Lizenzart.license

Beispiel
20210304T134645_DE_25105_ANTRAS_GmbH_GmbH_Website_484.486.25105.Productive.license