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 übergebene 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

ScriptAPI

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.

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler, E-Mail wurde versendet
	8	kein Empfänger bekannt
	9	Absender fehlt
	11	keine Verbindung zum Mailserver
	12	Verbindungsabbruch beim Übertragen
	13	Datentyp unzulässig
	14	Datei nicht vorhanden
	16	Format unzulässig
	19	interner Fehler
	23	Service nicht verfügbar
	27	sonstiger SMTP Fehler beim Verbindungsaufbau
	31	Syntaxfehler bei der Authentifizierung
	32	Befehl oder Parameter unbekannt
	33	Service nicht verfügbar
	37	Sonstiger Fehler bei der Authentifizierung
	38	Fehler bei der Authentifizierung
	41	Syntaxfehler bei der Empfangsadresse
	42	Befehl oder Parameter unbekannt
	43	Service nicht verfügbar
	44	Zu viele Daten
	45	interner Verarbeitungsfehler
	46	Empfänger unzulässig
	47	sonstiger Fehler
	51	Syntaxfehler bei der Absendeadresse
	53	Service nicht verfügbar
	54	zu viele Daten
	55	interner Verarbeitungsfehler
	57	sonstiger Fehler
	58	Fehler bei der Authentifizierung, Mailserver erzwingt Verschlüsselung
	61	Syntaxfehler bei der Datenübergabe
	63	Service nicht verfügbar
	64	zu viele Daten
	65	interner Verarbeitungsfehler
	66	Anhänge zu groß oder Absenderadresse aus fremder Domain ohne Relay
	67	sonstiger Fehler
	71	Syntaxfehler beim Verbindungsabbau
	77	sonstige Fehler
_rNoRec	5	Das angegebene Archiv existiert nicht
_ErrFsiNoFile	-20	Die angegebene externe Datei existiert nicht
_ErrFsiNoPath	-21	Der Pfad zu der angegebenen externen Datei existiert nicht
_ErrFsiAccessDenied	-23	Der Zugriff auf die externe Datei wurde verweigert
_ErrBinNoPath	-1502	Der Pfad in der BLOB-Datenbank ist nicht vorhanden
_ErrBinNoFile	-1503	Datei in der BLOB-Datenbank ist nicht vorhanden
_ErrBinNoData	-1504	Datei in der BLOB-Datenbank ist leer
_ErrBin	-1506	Datei in der BLOB-Datenbank ist von einem anderen Benutzer gesperrt
sAfErrNoRights	-20029	Die Berechtigungen sind nicht ausreichend
sAfErrArcFileNotExists	-20031	Die Anhangdatei zu dem Archiv existiert nicht