AfMailSend

AfMailSend(alpha1, alpha2[, int3[, alpha4[, alpha5[, alpha6[, int7[, int8[, logic9[, int10[,handle11[, alpha12]]]]]]]]]]) : int
E-Mail senden
alpha1 Empfänger der E-Mail alpha2 Betreff der E-Mail int3 Deskriptor des E-Mail-Textes (optional) alpha4 CC Empfänger der E-Mail (optional) alpha5 BCC Empfänger der E-Mail (optional) alpha6 Absende-Adresse (optional) int7 Priorität der E-Mail (1-5) (optional) int8 Liste mit Anhangdateien logic9 Schreiben der Archivverteilung int10 Anhänge als Links versenden (optional) handle11 Liste mit Arbeitsmappen für Laufwerksverknüpfungen (optional) alpha12 Basis-URL für ArcFlow.Next-Verknüpfungen (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfSendNotificationHtmlMail()

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.

Die weiteren Parameter (int10), (handle11) und (alpha12) bestimmen, in welcher Form die Anhänge in der Mail versendet werden. In (int10) können folgende Konstanten (auch Kombinationen daraus) angegeben werden:

Konstante	Wert	Beschreibung
	0	Versenden als Anhangdateien (Standard)
sAfSendAsLinks	1	Versenden als Links
sAfSendAsDrvLinks	2	Versenden als Verknüpfungen in ein ArcFlow-Drive
sAfSendAsAfnLinks	4	Versenden als Verknüpfungen in ArcFlow.Next

Werden die Anhänge als Links versendet (sAfSendAsLinks), wird anstelle einer Anhangdatei an die Mail ein Link am Ende des Mailtextes eingebettet, mit dem ArcFlow gestartet und auf die Anhangdatei positioniert wird. Für den Aufruf müssen die Archiv Links (siehe Einrichtung) installiert sein.

Beim Versenden als Links zum ArcFlow-Drive (sAfSendAsDrvLinks), wird anstelle einer Anhangdatei an die Mail ein Link am Ende des Mailtextes eingebettet, der auf die entsprechende Datei im ArcFlow-Drive verweist. Über den Link kann die Datei direkt aus dem angegebenen Verzeichnis geöffnet werden. Der Link wird nur dann angezeigt, wenn in (handle11) eine Liste mit Arbeitsmappen übergeben wurde. Die Liste muss wie folgt aufgebaut sein:

• Name: Archivnummer
• Id: Nummer der Arbeitsmappe
• Custom:

Für jedes übergebe Archiv in (handle8) muss ein Eintrag in dieser Liste mit einer Arbeitsmappe vorhanden sein, in der das Dokument im ArcFlow-Drive aufgerufen werden kann.

Beim Versenden als Links zum ArcFlow.NEXT (sAfSendAsAfnLinks), wird anstelle einer Anhangdatei an die Mail ein Link am Ende des Mailtextes eingebettet, der auf die entsprechende Datei im ArcFlow.NEXT verweist. Über den Link kann die Datei direkt im Browser angezeigt werden. Der Link wird nur dann angezeigt, wenn in (alpha12) die Basis-URL der ArcFlow.NEXT-Anwendung übergeben wurde.

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.