Beschreibung
Öffnet einen Mail Dialog um aus SharePoint heraus Mails zu versenden. Inkl. Vorlagen und Anlagen aus Dokumentenbibliotheken.
Voraussetzungen / Prerequisites
- Das koellisch toolkit Feature muss auf der Webseite aktiviert sein.
- Diese JavaScript Methode wird aus einer Bearbeitungs- bzw. Anzeige-Maske aufgerufen.
- Die Liste Teamkontakte muss vorhanden sein. Diese wird automatisch erstellt, wenn ein Personenauswahlfeld aus dem toolkit erstellt wird.
- Die Liste Konfiguration mit folgendem Eintrag muss vorhanden sein:
- Einstellung: AbsenderEmailAdresse,
- Wert: Ihre E-Mail-Adresse
- Die Liste E-Mail-Verlauf muss mit folgenden Spalten angelegt sein
- Die Liste für E-Mail-Vorlagen mit folgenden Feldern anlegen (Wenn die Spalte dox42-Template einen Wert besitzt wird der Inhalt nicht verwendet)
- Die Liste für E-Mail-Verteiler mit folgenden Feldern anlegen:
Parameter
Pflicht-Parameter
CurrentListName
Der Name der Liste aus dem die Mail versendet wurde. Wird benötigt um die Mail im E-Mail-Verlauf zuordnen zu können.
FieldNameOfThisElementInEMailHistory
Der interne Feldname des Nachschlagefeldes in der E-Mail-Verlauf Liste
Optionale-Parameter
CurrentItemId
Falls die Zuordnung im E-Mail-Verlauf eine andere sein soll, kann hier eine andere ID übergeben werden.
DocumentFieldName
Zeigt eine Auswahl der Dokumente an, welche mit der E-Mail als Anhang versendet werden.
Der Display-Feldname (aus der aufrufenden Liste) eines der folgenden Felder:
Nachschlagefeld (koellisch-tk)
Listentabelle (koellisch-tk)
Es ist auch möglich mehrere Felder anzugeben. Trennen Sie die Feldnamen mit einem Semikolon (;)
ShowTaskField
Wenn aus demE-Mail-Dialog eine Aufgabe erstellt werden soll, kann dieser Wert auf true gesetzt werden.
NameOfTaskList
Name der Aufgabenliste.
NewFormUrlOfTaskList
Standardmäßig wird die NewForm.aspx Seite aufgerufen. Kann über diesen Parameter geändert werden.
DraftListName
Verweis auf die E-Mail-Vorlagen Liste, anzugeben ist der Listenname.
Standardwert: E-Mail-Vorlagen’.
MailHistoryListName
Verweis auf die E-Mail-Verlauf Liste, anzugeben ist der Listenname.
Standardwert: ‘E-Mail-Verlauf’.
MailDistributionListName
Verweis auf die E-Mail-Verteiler Liste, anzugeben ist der Listenname.
Standardwert: 'E-Mail-Verteiler’.
UseSiteUserProposal
Wenn die Suche auch über die Benutzer der Seite gehen soll, muss dieser Wert auf true gesetzt werden.
Standardwert: false
UseTeamProposal
Wenn Ihre Teamkontakte als Empfänger vorgeschlagen werden sollen, setzten Sie diesen Wert auf true.
Standardwert: false
FieldNamesOfUserProposal
Zeigt eine Auswahl der Kontakte an, welche als Empfänger vorgeschlagen werden. Die darunter liegende Liste muss eine Kontakte-Liste sein.
Der Display-Feldname (aus der aufrufenden Liste) eines der folgenden Felder:
Nachschlagefeld (koellisch-tk) (Mehrere Werte auswählen muss aktiv sein)
Listentabelle (koellisch-tk)
Es können auch Feldnamen angegeben werden, getrennt durch ein ‘;’. Vertriebskontakte;Teamkontakte
SearchContactsInLists
Durchsucht zusätzliche weitere Kontaktlisten, getrennt durch ein ‘;’.
AfterMailSendFunction
Übergeben Sie eine Funktion die nach dem Absenden ausgeführt werden soll.
Standardwert:
function () { if (result == ‘1’ | result == ‘OK’) { $().SharePointStatusBenachrichtigung({ text: ‘E - Mail erfolgreich versendet’ }); erstelleEmailVerlaufListe(); } else if (result == ‘2’) { $().SharePointStatusBenachrichtigung({ text: ‘Fehler beim Versenden: ‘+value, color: ‘red’ }); } }
Parameter | Type | Default | Beschreibung |
CurrentItemId | Int | $t().GetItemId() | |
CurrentlistName | String | ||
DocumentFieldName | String | ||
FieldNameOfThisElementInEMailHistory | String | ||
ShowTaskField | Boolean | false | |
NameOfTaskList | String | ||
NewFormUrlOfTaskList | String | NewForm | |
DraftlistName | String | 'E-Mail Vorlagen' | |
DraftListQuery | String | ||
StandardDraftListItemId | Int | ||
MailHistorylistName | String | E-Mail Vorlagen' | |
MailDistributionListName | String | E-Mail Verteiler' | |
MailDistributionlistName | String | E-Mail Verteiler' | |
UseTeamProposal | Boolean | False | |
UseSiteUserProposal | Boolean | Flase |
SearchContactsInLists | Funktion | ||
FieldNamesOfUserProposal | Funktion | ||
AfterMailSendFunction | Funktion | ||
NewsletterModus | Boolean | False | |
PageTitle | String |
Syntax / Source Code
$().OpenMailDialog({ CurrentListName: '', FieldNameOfThisElementInEMailHistory: '' });
Rückgabewert / Return Value
kein
Beispiele / Examples
Mail mit Ribbon – Button und anderen Listennamen
$(document).ready(function () { var buttonsMail = []; var button = new Object(); button.left = "left: -448px;"; button.top = "top: -128px;"; button.text = 'E-Mail senden'; button.func = function () { $().OpenMailDialog({ CurrentListName: 'MailExample1', FieldNameOfThisElementInEMailHistory: 'LookupToMailExample1', MailDistributionListName: 'Verteiler', MailHistoryListName: 'Verlauf', DraftListName: 'Vorlagen', AfterMailSendFunction: function (result, value) { if (result == '1' | result == 'OK') { $().SharePointStatusBenachrichtigung({ text: 'E-Mail erfolgreich versendet' }); } else if (result == '2') { $().SharePointStatusBenachrichtigung({ text: 'Fehler beim Versenden: ' + value, color: 'red' }); } } }); } buttonsMail.push(button); $().AddRibbonGroup({ buttons: buttonsMail, groupDescription: 'E-Mail Aktionen' }); });