Automatische Status-E-Mails an Antragssteller
Beim Wechsel des Projektstatus werden für bestimmte Statuswerte E-Mails mit eine Information über den Projektfortschritt an den Anschlussnehmer bzw. den Anlagenbetreiber zum Projekt gesendet.
Empfänger
Am Projekt vorhandene Projektrollen | Empfänger der Status-E-Mail |
|---|---|
ANSCHLUSSNEHMER | Anschlussnehmer |
ANSCHLUSSNEHMER und ANLAGENBETREIBER (ist in diesem Fall der Anmeldende) | Anlagenbetreiber |
ANSCHLUSSNEHMER (tritt hier auch als Betreiber auf) und AUFTRAGGEBER (Solarteur) | Anschlussnehmer und Auftraggeber |
ANSCHLUSSNEHMER und ANLAGENBETREIBER & AUFTRAGGEBER | Anlagenbetreiber und Auftraggeber |
Voraussetzungen für die Verwendung
Das Modul "Standard-Funktionen für Netz-Module und -Prozesse" (C14TINA_BASIS) muss aktiv und lizensiert sein.
Technische Dokumentation
Komponentenübersicht
Prozesse
Projektstatus-Behandlung und Statusmails (C14ProjectHandleStatusAndSendStatusMail)
Beim Einspielen des Moduls werden die Prozesse automatisch veröffentlicht, wenn zu diesem Zeitpunkt die Modullizenz aktiv war.
Skriptbibliothek
SC14ProjectUtils
Globale Variablen
Variablenname | Funktion | Standardwert |
|---|---|---|
C12PortalUrl | Möglichkeit zur Hinterlegung der URL zum Kundenportal | |
C14MailConfigProjectStatusMail | Name der Mailkonfiguration, die für den Versand von Statusmails verwendet werden soll. Die Mails werden versendet wenn sich der Projektstatus (ProjectStatusKey.Project) ändert. | <leer> |
C14MailTemplateProjectStatusMail | Steuert welche Mailvorlage für den Versand von Status-Mails der Projekte verwendet wird. | <leer> |
Sprachvariablen
Zur Gestaltung der beim Statuswechsel versendeten E-Mails stehen pro Status 10, 20, 30, 40, 50, 60, 80, 90, 100, 110, 120 130, 140 150, 99 eine Sprachvariable für die Überschrift und den E-Mail-Text zur Verfügung
C12ProjectStatus<Projektstatus-Schlüssel>_Text
Der E-Mail-Text enthält Platzhalter für die URL zum Kundenportal. Sie wird aus der Globalen Variable C12PortalUrl befüllt
C12ProjectStatus<ProjectStatus-Schlüssel>_Subject
Der Betreff enthält Platzhalter für die Anschlussobjektnummer sowie die Projektnummer
Die im Standard verwendeten Texte können dort nach Bedarf angepasst werden
Es werden Texte für die Sprachen Deutsch und Englisch ausgeliefert. Weitere Sprachen können auf Anfrage im Kundenprojekt realisiert werden.
Übersteuerungsmöglichkeiten
Grundsätzlich können die mit dem Modul bereitgestellten Komponenten wie BPM-Prozesse, -teilprozesse, Suchen und Skriptbibliotheksmethoden übersteuert werden, um diese an individuelle Anforderungen und Bedürfnisse anzupassen.
Skriptklasse SC14ProjectUtils
Methodenname | Funktionalität |
|---|---|
createStatusMailActivities | Erstellt eine Liste von IContainern, welche die Aktivitäten-Container aus createStatusMailActivity enthalten |
createStatusMailActivity | Bereitet den Aktivitäten-Container vor, der die Basis für die Status-E-Mail bildet |
shouldStartStatusMailProject | Prüft, ob eine Status-E-Mail versendet werden soll.
|
getBlackListPksForShouldStartStatusMailProject | Bietet die Möglichkeit, Projektstatus-Schlüssel zu hinterlegen, für die keine E-Mail versendet werden soll Im Standard ist hier der Schlüssel 10 (10 - Auftrag eingegangen) hinterlegt |
Ablauf
Beim Speichern eines Projektes mit Änderung des Projektstatus wird die Methode SC14ProjectUtils.createStatusMailActivities aufgerufen
Hier wird geprüft, ob für den Status eine E-Mail versendet werden soll
Handelt es sich um einen Statuswert, für den die E-Mail versendet werden soll, so wird anhand der für den Status passenden Sprachvariable eine Aktivität erzeugt und die vorbereitete E-Mail im E-Mail-Dialog in TINA angezeigt
Bei fehlerhaftem E-Mail-Versand erhält die ADMIN-Gruppe eine entsprechende Benachrichtigung, welche - sofern ermittelbar - die Fehlerursache enthält
Mögliche Ursachen:
Keine oder unvollständige E-Mail-Konfiguration
Die E-Mail-Adresse des Empfängers (Anlagenbetreiber und/oder Anschlussnehmer) ist nicht gepflegt
Es ist kein Geschäftspartner mit der Rolle Anlagenbetreiber oder Anschlussnehmer mit dem Projekt verknüpft
Fehlermeldung im Mailversand: Die E-Mail-Adresse des Empfängers ist nicht gepflegt
Desweiteren wird vor Versand einer Status-E-Mail geprüft, ob das Anschlussobjekt zum Projekt eindeutig vorhanden ist. Ist hier kein oder mehr als ein Anschlussobjekt vorhanden, erzeugt das System automatisch eine Protokollaktivität zum Projekt.