Mailversand - Einrichtung durch den Kunden

Allgemein

Dieser Beitrag befasst sich mit der Einrichtung des Mailversands in der COGLAS Web WMS Lösung.

Der Mailversand bietet die Möglichkeit Emails aus der COGLAS Web WMS Lösung heraus zu senden. Die Einrichtung übernimmt in der Regel der COGLAS Consultant und sein Team. Die Einrichtung kann jedoch auch der Kunde durchführen und anschließend das Ergebnis überprüfen.

Die Einrichtung des Mailversands erfordert den Zugriff auf die Webservice Konfiguration. Dieser Beitrag ist daher hauptsächlich an Kundenlösung mit einer On Premises Installation gerichtet.

Beispiel: Es soll das Sendmail via Basic Auth ohne Anmeldung erfolgen.

COGLAS Webservice Konfiguration

Gehen Sie auf den Server auf dem der IIS Manager und der COGLAS Webservice eingerichtet wurde.

IIS Manager:

• Öffnen Sie die “Sites” in der Navigation des IIS Managers.

• Klicken Sie mit der rechten Maustaste auf den Webservice Namen.

• Kontext Menü Auswahl: “Im Explorer öffnen” und anklicken

Webservice Verzeichnis im Explorer:

• Es öffnet sich der Windows Explorer im Verzeichnis .\client

• Wechseln Sie das Verzeichnis nach .\server

• Backupsicherung! Erstellen Sie eine Sicherungsdatei zu “.\server\Web.Config“ bevor Sie Fortfahren bzw. eine Änderung in der Datei vornehmen.

Webservice stoppen:

• Die Änderung an der Datei “.\server\Web.Config“ erfordert abschließend das Datei Abspeichern. Damit wird der Webservice neu gestartet. Den Neustart wollen wir aber manuell steuern.

• IIS Manager:

  • Navigation: Sites

    • Webservice Namen auswählen.

    • Rechte Maustaste

    • Auswahl: Website verwalten - beenden

  • Navigation: Anwendungspools

    • Anwendungspool Name auswählen.

    • Rechte Maustaste

    • Auswahl: Beenden

Webservice Konfiguration anpassen:

• Datei “.\server\Web.Config“ im Editor öffnen.

• Den Code 1 Abschnitt zum “SendMailService“ in der Web.Config suchen.

• Den Abschnitt in der Web.Config zu den einzelnen Parametern oder komplett ersetzen.

• Anmerkung:

  • Der Parameter “Port” wird defaultmäßig auf Port=”25” verwendet.

  • Wenn beispielsweise der “Port=”587” verwendet werden soll, dann ist dieser in der Parameter Liste zu ergänzen.

Webservice Konfiguration speichern und Webservice neu starten:

• Datei “.\server\Web.Config“ ist im Editor geöffnet.

• Einstellung speichern und Editor schließen.

• IIS Manager:

  • Navigation: Anwendungspools

    • Anwendungspool Name auswählen.

    • Rechte Maustaste

    • Auswahl: Starten

  • Navigation: Sites

    • Webservice Namen auswählen.

    • Rechte Maustaste

    • Auswahl: Website verwalten - Starten

Code 1

    <CoglasPro.Core.Services.SendMailService.Properties.Settings
      noAuthentication="true"
      hostname="Kunden_SMTP_Host_Adresse_erfassen"
      username="NoUsernameRequired"
      domain="DomainOptional"
      pass="NoPasswordRequired"
      sender="Sender_Address_Mandatory">
      <eventRecipients>
        <add eventName="CustomerOrder-WrongStatus" recipients=""/>
      </eventRecipients>
    </CoglasPro.Core.Services.SendMailService.Properties.Settings>

Mailversand Test

Event “Email senden”:

• Menü: System - Eventcenter

• Neues Event erstellen: “Eventcenter-Position hinzufügen”

  • Event Name = Beispiel Name erfassen

  • Event Trigger = Timer

    • Aktives Datum von: Start Zeitpunkt

    • Aktives Datum bis: Endet Zeitpunkt

    • Intervallwert = 5

    • Intervalleinheit = Minute

  • Event Aktion = Email senden

    • Konstanter Parameter: Empfänger

    • Konstanter Parameter: Betreff

    • Konstanter Parameter: Inhalt

  • Wert entsprechend erfassen und abschließend speichern.

• Event “Nächstes Datum des Events” prüfen

  • Wenn das Event korrekt erfasst und gespeichert wurde, dann sollte im Event Kopf die Information “Nächstes Datum des Events” eingetragen sein mit Datum und Uhrzeit.

  • Anschließend warten bis Zeitpunkt erreicht und den Email Eingang zur angegebenen Empfänger Email Adresse prüfen.

Event Protokollierung:

• COGLAS Webservice Verzeichnis .\server\logs\eventcenter

• Das Protokoll zum aktuellen Tagesdatum öffnen.

• Es wird die Event Anlage mit dem Speichern und die Ausführung protokolliert.

• Suche nach dem Event Namen.

Sendmail Protokollierung:

• COGLAS Webservice Verzeichnis .\server\logs\SendMail

• Das Protokoll zum aktuellen Tagesdatum öffnen.

• Es wird nur der Sendmail Anteil zur Event Ausführung protokolliert.

• Wenn das Event nicht ausgeführt wurde, dann gibt es auch keine Sendmail Protokollierung.

Sonderfall - SA Benutzer Option:

• Der SA Benutzer ist der COGLAS interne Super-Administrator. Dieser steht dem Kunden nicht zur Verfügung. Die Menü Option möchten wir hier dennoch aufnehmen.

• Für den SA Benutzer steht das Menü: “System - Mailversand” zur Verfügung.

• Damit kann über die Eingabe der Felder Empfänger, Betreff und Inhalt der Mailversand schnell und direkt geprüft werden.

• Nach dem Absenden erscheint eine Grüne oder Rote Fußnachricht.

• Zur Roten Fußnachricht liegt eine Situation vor und der Mailversand ist zu überprüfen.

Warnmeldung

FAQ

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