AfMailOpen: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
K Stand 4.1.08
K Stand 4.1.09
 
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 6: Zeile 6:
   </tr>
   </tr>
   <tr class="ProcSyntax">
   <tr class="ProcSyntax">
     <td class="title">&nbsp;AFMailOpen(alpha1) : int</td>
     <td class="title">&nbsp;AfMailOpen(alpha1) : int</td>
     <td class="platforms">
     <td class="platforms">
[[file:DE_SymbolNoAPI.gif|alt=Nicht ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]]
[[file:DE_SymbolNoAPI.gif|alt=Nicht ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]]
Zeile 101: Zeile 101:
   <td width="85%" class=Right colspan="3">
   <td width="85%" class=Right colspan="3">
[[:Category:Befehle für E-Mails|Verwandte Befehle]],
[[:Category:Befehle für E-Mails|Verwandte Befehle]],
[[AFMailDataAttachmentGet#|AFMailDataAttachmentGet()]],
[[AfMailDataAttachmentGet#|AfMailDataAttachmentGet()]],
[[AFMailClose#|AFMailClose()]]
[[AfMailClose#|AfMailClose()]]
   </td>
   </td>
</tr>
</tr>
Zeile 129: Zeile 129:


<li><b><font class=source>gAfMailAttCnt</font></b>
<li><b><font class=source>gAfMailAttCnt</font></b>
<p>Hier wird die Anzahl der Anhänge der E-Mail abgelegt. Der Zähler wird benötigt, um weitere Informationen über die Anhangdatei zu ermitteln (siehe [[AFMailDataAttachmentGet#|AFMailDataAttachmentGet()]]).</p>
<p>Hier wird die Anzahl der Anhänge der E-Mail abgelegt. Der Zähler wird benötigt, um weitere Informationen über die Anhangdatei zu ermitteln (siehe [[AfMailDataAttachmentGet#|AfMailDataAttachmentGet()]]).</p>
</li>
</li>


Zeile 158: Zeile 158:
</ul></p>
</ul></p>


<p><p>Werden die Informationen nicht mehr benötigt, müssen die allokierten Speicherbereiche mit der Anweisung [[AFMailClose#|AFMailClose()]] wieder entfernt werden.</p>
<p><p>Werden die Informationen nicht mehr benötigt, müssen die allokierten Speicherbereiche mit der Anweisung [[AfMailClose#|AfMailClose()]] wieder entfernt werden.</p>


<p>Konnte die E-Mail nicht geöffnet werden, wird ein entsprechender Fehlercode zurückgegeben. Tritt bei der Analyse der E-Mail ein Fehler auf, werden die Feldpuffer nicht gesetzt. In den Variablen <font class=source>gAfMailProcessError</font> und <font class=source>gAfMailProcessErrorText</font> kann die Fehlernummer und der Fehlertext abgefragt werden.</p></p>
<p>Konnte die E-Mail nicht geöffnet werden, wird ein entsprechender Fehlercode zurückgegeben. Tritt bei der Analyse der E-Mail ein Fehler auf, werden die Feldpuffer nicht gesetzt. In den Variablen <font class=source>gAfMailProcessError</font> und <font class=source>gAfMailProcessErrorText</font> kann die Fehlernummer und der Fehlertext abgefragt werden.</p></p>

Aktuelle Version vom 1. November 2024, 12:42 Uhr

 AfMailOpen(alpha1) : int

Nicht ausführbar von der APINicht ausführbar von der Programmierschnittstelle (DLL)Nicht ausführbar mit der Application Remote ControlAusführbar von der Script-API

Externe E-Mail-Datei (.eml) öffnen und analysieren
alpha1 Pfad und Name der Datei
Feldpuffer
gAfMailAttCteList handle Liste der E-Mail-Anhänge
gAfMailDataId alpha(250) Message Id der Mail
gAfMailAttCnt int Anzahl der E-Mail-Anhänge
gAfMailDataReceiveDate date Empfangsdatum
gAfMailDataReceiveTime time Empfangszeit
gAfMailDataPriority int Priorität
gAfMailDataSenderMailAdr alpha(250) E-Mail-Adresse des Absenders
gAfMailDataSenderName alpha(250) Name des Absenders
gAfMailDataReceiverLst handle Cte-Liste der Empfänger
gAfMailDataReceiverCCLst handle Cte-Liste der CC Empfänger
gAfMailDataSubject alpha(250) Betreff
gAfMailSize bigint Größe der E-Mail in Bytes
Resultat int Fehlercode
Siehe

Verwandte Befehle, AfMailDataAttachmentGet(), AfMailClose()

Mit dieser Funktion kann eine als externe Datei vorliegende E-Mail analysiert werden. Die Ergebnisse werden in den globalen Variablen gespeichert und können nach dem Aufruf der Funktion ausgewertet werden.

Der Pfad und der Dateiname der externen Datei müssen im Parameter (alpha1) übergeben werden. Die Pfadangabe kann absolut oder relativ zum ArcFlow-Client-Verzeichnis angegeben werden.

In den globalen Variablen werden folgende Informationen gesetzt:

  • gAfMailAttCteList

    In dieser Variablen wird der Deskriptor (handle) einer Cte-Liste gespeichert. In den Elementen der Liste ist in der Eigenschaft Id die Nummer und in Name der Name der Anhangdatei gespeichert.

  • gAfMailDataId

    In dieser Variablen wird die Message Id der E-Mail abgelegt.

  • gAfMailAttCnt

    Hier wird die Anzahl der Anhänge der E-Mail abgelegt. Der Zähler wird benötigt, um weitere Informationen über die Anhangdatei zu ermitteln (siehe AfMailDataAttachmentGet()).

  • gAfMailDataReceiveDate und gAfMailDataReceiveTime

    Das Empfangsdatum und die Empfangszeit der E-Mail

  • gAfMailDataPriority

    Die Priorität der E-Mail. Die Priorität liegt im Bereich 1 bis 5, wobei 1 die höchste Priorität ist.

  • gAfMailDataSenderMailAdr und gAfMailDataSenderName

    Dies ist die Absender-Adresse und der Name des Absenders.

  • gAfMailDataReceiverLst und gAfMailDataReceiverCCLst

    In diesen Variablen sind Deskriptoren (handle) auf zwei Cte-Listen mit den Empfängern und den CC Empfängern gespeichert. In den Elementen der Liste ist in der Eigenschaft Name die E-Mail-Adresse und in Custom der Name des Empfängers abgelegt.

  • gAfMailDataSubject

    Der Betreff der E-Mail.

  • gAfMailSize

    Die Größe der gesamten E-Mail einschließlich aller Anhänge in Bytes.

Werden die Informationen nicht mehr benötigt, müssen die allokierten Speicherbereiche mit der Anweisung AfMailClose() wieder entfernt werden.

Konnte die E-Mail nicht geöffnet werden, wird ein entsprechender Fehlercode zurückgegeben. Tritt bei der Analyse der E-Mail ein Fehler auf, werden die Feldpuffer nicht gesetzt. In den Variablen gAfMailProcessError und gAfMailProcessErrorText kann die Fehlernummer und der Fehlertext abgefragt werden.