Element "E-Mail Formular"

<< Click to Display Table of Contents >>

Navigation:  Konfigurierung Webinterface > Individuelles Maskenlayout > Elemente im individuellen Maskenlayout >

Element "E-Mail Formular"

Diese Komponente steht für ein Frontend-E-Mail-Formular. Über Funktionen und Ereignissen können die Attribute sowohl nach der Initiierung als auch vor dem Versand gesteuert werden. Zusätzliche Aktionen nach dem Versand sind ebenso möglich.

 

Hinweis: Wenn als Inhalt sowohl Text als auch HTML erlaubt ist, wird beim Wechsel von Plain-Text auf  HTML gefragt, ob Plain-Text übernommen werden soll und umgekehrt.

 

 

Attribute

 

andere

In den ankommenden Masken wird das E-Mail-Formular vorkonfiguriert, d.h. der Empfänger, Betreff, Inhalt, usw.

 

 

Funktionen

 

copyAddressBookToBCCText

Kopiert alle Kontakte von der Kontaktliste in das BCC-Textfeld.

 

copyAddressBookToCCText

Kopiert alle Kontakte von der Kontaktliste in das CC-Textfeld.

 

copyAddressBookToRcptText()

Kopiert alle Kontakte von der Kontaktliste in das Empfänger-Textfeld.

 

getAddressBook()

Gibt die Adressliste als Array zurück.

 

Beispiel:

 

var RU=rimacon._userform;

RU.EmailForm1.openDialog(false);

var i, ab=RU.EmailForm1.getAddressBook();

for (i=0; i<ab.length; i++) alert(ab[i]['name'] + ' ' + ab[i]['mail']);

 

 

getBCCEnabled()

Gibt zurück, ob das BCC-Textfeld gesperrt oder nicht gesperrt ist.

 

getBCCParsed()

Gibt die Empfänger aus der BCC-Textbox als Array zurück.. Siehe getRcptParsed.

 

getBCCText()

Gibt den Inhalt der BCC-Textbox zurück.

 

getCCEnabled()

Gibt zurück, ob das CC-Textfeld gesperrt oder nicht gesperrt ist.

 

getCCParsed()

Gibt die Empfänger aus der CC-Textbox als Array zurück.. Siehe getRcptParsed.

 

getCCText()

Gibt den Inhalt der CC-Textbox zurück.

 

getContent()

Gibt den Inhalt zurück.

 

getContentEnabled()

Gibt zurück, ob der Inhalt gesperrt oder nicht gesperrt ist.

 

getHTMLContent()

Gibt den HTML-Inhalt zurück.

 

getHTMLContentEnabled()

Gibt zurück, ob der HTML-Inhalt gesperrt oder nicht gesperrt ist.

 

getRcptEnabled()

Gibt zurück, ob der Empfänger gesperrt oder nicht gesperrt ist.

 

getRcptParsed()

Gibt die Empfänger aus der Empfänger-Textbox als Array zurück.

 

Beispiel: Ereignis EmailForm1.customValidator

 

var RU=rimacon._userform;

var i, rcpt=RU.EmailForm1.getRcptParsed();

for (i=0; i<rcpt.length; i++) alert(rcpt[i]['name'] + ' ' + rcpt[i]['mail']);

 

 

getRcptText()

Gibt den Inhalt der Empfänger-Textbox zurück.

 

getSendIndividual()

Gibt zurück, ob „Versand mit Anzeige nur des jeweiligen Empfängernamens“ angekreuzt ist.

 

getSendIndividualEnabled()

Gibt zurück, ob „Versand mit Anzeige nur des jeweiligen Empfängernamens“ nicht gesperrt ist.

 

getSentEmailID()

Gibt die ID (EMAIL.EMAIL_ID) der gesendeten E-Mail zurück. Die Methode kann nur im Ereignis JSAfterSend genutzt werden.

 

getSubject()

Gibt den Betreff zurück.

 

getSubjectEnabled()

Gibt zurück, ob der Betreff gesperrt oder nicht gesperrt ist.

 

hide()

Versteckt die E-Mail-Formularmaske.

 

makeResponse(emailid,bNoRcpt)

Bereitet eine Antwort auf eine vorhandene E-Mail (Tabelle EMAIL) vor.

Die E-Mail-ID ist EMAIL.EMAIL_ID.

Der Parameter bNoRcpt steuert, ob die Absenderadresse der vorhandenen E-Mail in das Empfängeradressfeld kopiert wird oder nicht.

Wert "true" bedeutet "nicht kopieren" , "false" bedeutet "kopieren".

 

openDialog(bNewWindow)

Öffnet die E-Mail-Formularmaske. Der Parameter ist ein Platzhalter und wird zukünftig genutzt.

 

reset()

Löscht die Inhalte aller E-Mail-Formularelemente.

 

sendDirect(from_mail, from_name, reply_to, subject, body, rcpt_mail_or_recipients, rcpt_name)

Sendet eine E-Mail direkt aus Javascript.

 

setAddressBook(ab)

Legt die Adressliste fest. Siehe Beispiel für getAddressBook.

 

setAddressBookEnabled(bEnabled)

Sperrt oder entsperrt die Adressliste.

 

setBCCEnabled(bEnabled)

Sperrt oder entsperrt den BCC-Empfänger.

 

setBCCText(text)

Legt den Inhalt der BCC-Textbox fest.

 

setCCEnabled(bEnabled)

Sperrt oder entsperrt den CC-Empfänger.

 

setCCText(text)

Legt den Inhalt der CC-Textbox fest.

 

setContent(sContent)

Legt den Inhalt fest.

 

setContentEnabled(bEnabled)

Sperrt oder entsperrt den Inhalt.

 

setContentModes(modes)

Legt fest, welche Inhalt-Mode erlaubt sind. Mögliche Werte:

„T“

Klar-Text ja, HTML nein

„H“

Klar-Text nein, HTML ja

„TH“

Klar-Text ja, HTML ja

 

setFromMail(mail)

Legt die Absender-Adresse fest.

 

setFromName(name)

Legt den Absender-Namen fest.

 

setHTMLContent(html)

Legt den HTML-Inhalt fest.

 

setHTMLContentEnabled(bEnabled)

Sperrt oder entsperrt den HTML-Inhalt.

 

setRcptEnabled(bEnabled)

Sperrt oder entsperrt den Empfänger.

 

setRcptText(text)

Legt den Inhalt der Empfänger-Textbox fest.

 

setReplyTo(mail)

Legt die Antwort-Adresse fest.

 

setSendIndividual(val)

Legt „Versand mit Anzeige nur des jeweiligen Empfängernamens“ fest.

 

setSendIndividualEnabled(bEnabled)

Sperrt oder entsperrt das „Versand mit Anzeige nur des jeweiligen Empfängernamens“-Element.

 

setSubject(sSubject)

Legt den Betreff fest.

 

setSubjectEnabled(bEnabled)

Sperrt oder entsperrt den Betreff.

 

showCustomButton(button_key,bShow)

Zeigt oder versteckt den Button.

 

toggleToHTMLMode()

Wechselt in HTML-Modus

 

toggleToTextMode()

Wechselt in Klar-Text-Modus

 

 

Ereignisse

 

onInit

Bei Aufruf des E-Mail-Formulars (nach openDialog). Hier besteht die Möglichkeit, die Felder nach spezifischen Regeln vorzubereiten.

 

customValidator

Prüfungen vor dem Absenden der E-Mail. Ergebnis (return) muss entweder false oder true sein.

false bedeutet "nicht senden"

true bedeutet "alles in Ordnung"

 

JSAfterClose

Tritt ein, wenn das E-Mail-Formular geschlossen wird. Beim Versand einer E-Mail tritt dieses Ereignis vor JSAfterSend ein.

 

JSAfterSend

Javascript-Anweisungen/Funktionen werden nach dem Absenden ausgeführt. Dies ermöglicht weitere Datenbankänderungen.

 

onCustomButtonPress

Ereignis bei Anklicken des benutzerdefiniertes Buttons

Kontextvariablen:

ctx.key: Eindeutiger Schlüssel des Buttons

ctx.e: Original Browser event-Objekt