Mailversand

Allgemein

Über die COGLAS Web WMS Lösung ist der Mailversand möglich.

Voraussetzung: Es ist die Einrichtung des Mailservers abgeschlossen worden.

Verwendungszweck: Mit dem Mailversand aus der COGLAS Web WMS Lösung heraus, können u.a. zum Eventcenter zu einer automatischen Reportanlage die Ergebnis Ausgaben nach Erstellung an einen Emailempfänger gesendet werden kann. Details siehe Eventcenter Beschreibung.


Menü Mailversand

  • Menü Aufruf = “System - Administration - Mailversand”

  • Siehe Bild - kann eine einfache Email zum Testen versendet werden.

    image-20250428-120640.png

Wichtig: Es muss die Einrichtung des Mailservers abgeschlossen sein.

Eingabefelder:

  • Empfänger = Email Adresse des Empfängers

  • Betreff = Betreff der Email Nachricht

  • Inhalt = Text Inhalt der Email Nachricht


Einrichtung Mailserver mit Basic AUTH

  • Der COGLAS Email Versandt benötigt die Einrichtung eines Mailservers.

  • Der Kunden stellt die Parameter zur Einrichtung bereit.

  • Zum Abschluss der Einrichtung ist der COGLAS Webservice einmal neu zu starten.

Liste der Parameter zum Mailserver:

  • Überprüfen Sie bitte die Liste der Parameter und teilen Sie die dazugehören Werte Ihrem COGLAS Ansprechpartner mit.

Felder

Beispiel

Beschreibung

Anmerkung

Hostname

outlook.office365.com

Der Name des Hosts, der zum Senden von E-Mails verwendet werden soll.

Notwendig

Username

mustermann@Kunde.de

Der Benutzername des Versenders, der zum Senden von E-Mails verwendet werden soll.

Benutzername für LOGIN und XOAUTH2 Credentials (Optional)

Domain

Kunde.de

Der Domain Name des Hosts, der zum Senden von E-Mails verwendet werden soll.

Für LOGIN Credentials (Optional)

Passwort

xxxxx

Das Passwort des Versenders, der zum Senden von E-Mails verwendet werden soll.

Passwort für LOGIN Credentials (Optional)

Sender

mustermann@Kunde.de

Die E-Mail des Senders, der zum Senden von E-Mails verwendet werden soll.

Absender Email Adresse (Pflicht)

noAuthentication

true/false

Anonyme Anmeldung via Basic AUTH.
Wenn benötigt dann Wert=true verwenden.

Optional


Einrichtung Mailserver mit OAuth2 Client Credential Flow

  • Der COGLAS Email Versandt benötigt die Einrichtung eines Mailservers.

  • Der Kunden stellt die Parameter zur Einrichtung bereit.

  • Zum Abschluss der Einrichtung ist der COGLAS Webservice einmal neu zu starten.

Liste der Parameter zum Mailserver:

  • Überprüfen Sie bitte die Liste der Parameter und teilen Sie die dazugehören Werte Ihrem COGLAS Ansprechpartner mit.

Felder

Beispiel

Beschreibung

Anmerkung

Hostname

outlook.office365.com

Der Name des SMTP Hosts, der zum Senden von E-Mails verwendet werden soll.

Notwendig

Username

mustermann@Kunde.de

Der Benutzername des Versenders, der zum Senden von E-Mails verwendet werden soll.

Benutzername für LOGIN und XOAUTH2 Credentials (Optional)

Domain

Kunde.de

Der Domain Name des Hosts, der zum Senden von E-Mails verwendet werden soll.

Für LOGIN Credentials (Optional)

Passwort


Das Passwort des Versenders, der zum Senden von E-Mails verwendet werden soll.

Passwort für LOGIN Credentials (Optional)

Sender

mustermann@Kunde.de

Die E-Mail des Senders, der zum Senden von E-Mails verwendet werden soll.

Absender Email Adresse (Pflicht)

oAuth2AuthorityUrl

Siehe “Beispiel Identity Provider Entra ID”

Beinhaltet die Tenant Id der Application

Pflicht

oAuth2ClientId

Client Id der Application

Pflicht

oAuth2ClientSecret

Client Secret der Application

Pflicht

oAuth2Scopes

Können auch mehrere Scopes sein, die durch ; getrennt sind.

Pflicht

Beispiel Identity Provider Entra ID:

Beschreibung am Beispiel “Entra ID”

Bild

1

Client ID

Tenant ID

image-20260820-133449.png

2

Umwandlung:

Tenant ID in AuthorityUrl

Beispiel Tenant ID = e65d9ba6-eff2-45d0-be6c-e21c484b185a

Beispiel AuthorityUrl = https://login.microsoftonline.com/e65d9ba6-eff2-45d0-be6c-e21c484b185a/oauth2/v2.0

3

Client Secret

image-20260820-133757.png

4

Scope

image-20260820-133331.png

Inbetriebnahme

Der Kunde stellt die Parameter zur Einrichtung des Mailservers bereit. Es wird ein gemeinsamer Termin abgestimmt, an dem die Einrichtung stattfindet.

Sobald der Webservice zu den Mailserver Daten erweitert wurde, muss dieser einmal neu gestartet werden.

Abschluss kann eine Test Email über das Menü “System - Mailversand” überprüft werden.


Warnmeldung

Warnmeldung

Beschreibung

Der Vorgang war leider nicht erfolgreich. Bitte probieren Sie es später noch einmal.

Überprüfen Sie die bereitgestellten Parameter zur Einrichtung des Mailservers. Prüfen Sie auf evtl. Kopier- und Tippfehler.

Überprüfen Sie die bereitgestellten Parameter u.a. mit einem Emailversand über beispielsweise Outlook.

Wurde der Webservice tatsächlich neu gestartet?


→ zurück zu COGLAS Prozessen
→ zurück zu COGLAS Menü