AfMailSend
 |
|||||||||||||||||||||||||||||||||||||||||||||
| AFMailSend(alpha1, alpha2[, int3[, alpha4[, alpha5[, alpha6[, int7[, int8[, logic9]]]]]]]) : int |
|
||||||||||||||||||||||||||||||||||||||||||||
| E-Mail senden | |||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||
Mit dieser Funktion wird eine E-Mail an einen oder mehrere Empfänger versendet. Die Liste der Empfänger wird in (alpha1) übergeben. Sollen mehrere Empfänger angegeben werden, müssen diese durch Semikolon getrennt werden. Die Länge der Zeichenkette ist auf 250 Zeichen begrenzt.
Der Betreff der E-Mail wird in (alpha2) übergeben. Der Betreff darf nicht länger als 250 Zeichen sein. Alle weiteren Parameter sind optional.
In (int3) wird der Deskriptor eines Textpuffers übergeben, der den Nachrichtentext enthält. In (alpha4) und (alpha5) kann eine Liste von weiteren Empfängern bzw. versteckten Empfängern angegeben werden. Alle Empfänger müssen durch Semikolon getrennt sein. Die Länge beider Zeichenketten ist auf 250 Zeichen begrenzt. (alpha6) kann eine Absender-Adresse beinhalten. Diese Adresse wird verwendet, wenn der Empfänger die E-Mail beantwortet (Reply). Ist keine Absende-Adresse angegeben, wird die E-Mail-Adresse des angemeldeten Benutzers verwendet.
In (int7) wird die Priorität der E-Mail übergeben. 1 ist dabei die höchste Priorität.
Im Parameter (int8) kann eine Liste mit Anhangdateien übergeben werden. Dabei können sowohl externe Dateien, als auch Anhangdateien von Archiven angegeben werden. Zuvor muss mit der Anweisung AfCteOpen() eine leere CTE-Liste erzeugt werden. Folgende Informationen müssen in den Elementen der Liste vorhanden sein:
- Versenden einer Archiv-Anhangdatei
In den Elementen der Liste müssen folgende Eigenschaften gesetzt werden:
- Name: Archivnummer
- Id: sAfAttachmentTypeArcFile
- Custom: Nummer der Anhangdatei des Archivs
- Versenden einer externen Datei
In den Elementen der Liste müssen folgende Eigenschaften gesetzt werden:
- Name: Pfad und Name der externen Datei
- Id: sAfAttachmentTypeFilePath
- Custom: wird nicht ausgewertet
Im Falle von externen Dateien müssen die Dateien bereitgestellt und anschließend auch wieder gelöscht werden.
Im Parameter (logic9) kann angegeben werden, ob der Versand der E-Mail unter den Stammdaten des Archivs auf der Seite Dokumentverteilung eingetragen werden soll. Der Parameter wird nur berücksichtigt, wenn auch Archive versendet werden.
Beispiel:
tAttachmentList # AfCteOpen(_CteList);
// Anhangdatei eines Archivs
tAttachmentList->CteInsertItem('2013.0000106', sAfAttachmentTypeArcFile, '7');
// externe Datei
tAttachmentList->CteInsertItem('C:\temp\picture.jpg', sAfAttachmentTypeFilePath, '');
tErr # AFMailSend('support@arcflow.net', 'Reklamation, Rechnung und Mangel im Anhang', 0, '', '', 'support@arcflow.net', 3, tAttachmentList, true);
if (tErr != _rOk)
WinDialogBox(gAFActParentDlg, 'AfMailSend', CnvAI(tErr), 0, 0, 0);
tAttachmentList->AFCteCloseAll();
Als Fehlercodes werden die Rückgabewerte der CONZEPT 16 Befehle MailData() und MailClose() und der Anweisung AfArcFileGet() zurückgegeben.
