AfArcTextRead: Unterschied zwischen den Versionen
Die Seite wurde neu angelegt: „<languages /> <translate> <table class=head> <tr> <td class="BigTitle" colspan="2" align="center">file:DE_Schriftzug.gif</td> </tr> <tr clas…“ |
Jens (Diskussion | Beiträge) KKeine Bearbeitungszusammenfassung |
||
| Zeile 25: | Zeile 25: | ||
<tr class="ProcParameterItem"> | <tr class="ProcParameterItem"> | ||
<td valign=top width="15%" class=Left>int2</td> | <td valign=top width="15%" class=Left>int2</td> | ||
<td colspan="3" width="85%" class=Right> | <td colspan="3" width="85%" class=Right>Nummer der Anhangdatei</td> | ||
</tr> | </tr> | ||
| Zeile 62: | Zeile 62: | ||
</table> | </table> | ||
<div class="BigLang"> | <div class="BigLang"> | ||
<p><p>Die Funktion liest den Archiv-Text einer | <p><p>Die Funktion liest den Archiv-Text einer Anhangdatei des Archivs (alpha1). Welche Anhangdatei gelesen werden soll, wird über den Parameter (int2) definiert.</p> | ||
<p>Im dritten Parameter muss der Deskriptor eines leeren Text-Puffers übergeben werden, der vor dem Aufruf der Funktion über den Befehl [[AFTextOpen#|AfTextOpen()]] angelegt wurde. Nach dem Aufruf der Funktion ist der Archiv-Text im Textpuffer abgelegt.</p> | <p>Im dritten Parameter muss der Deskriptor eines leeren Text-Puffers übergeben werden, der vor dem Aufruf der Funktion über den Befehl [[AFTextOpen#|AfTextOpen()]] angelegt wurde. Nach dem Aufruf der Funktion ist der Archiv-Text im Textpuffer abgelegt.</p> | ||
| Zeile 81: | Zeile 81: | ||
<tr> | <tr> | ||
<td valign=top><font class=source>/Page</font></td> | <td valign=top><font class=source>/Page</font></td> | ||
<td valign=top>zu lesende | <td valign=top>zu lesende Anhangdatei</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Version vom 1. November 2023, 10:07 Uhr
 |
|||||||||||||||||||||||||
| AFArcTextRead(alpha1, int2, int3[,alpha4]) : int |
|
||||||||||||||||||||||||
| Textseite eines Archivs lesen | |||||||||||||||||||||||||
|
|||||||||||||||||||||||||
Die Funktion liest den Archiv-Text einer Anhangdatei des Archivs (alpha1). Welche Anhangdatei gelesen werden soll, wird über den Parameter (int2) definiert.
Im dritten Parameter muss der Deskriptor eines leeren Text-Puffers übergeben werden, der vor dem Aufruf der Funktion über den Befehl AfTextOpen() angelegt wurde. Nach dem Aufruf der Funktion ist der Archiv-Text im Textpuffer abgelegt.
Der Archivtext wird von ArcFlow zwischenzeitlich in einem temporären Verzeichnis abgelegt und von dort von der API gelesen. Standardmäßig wird das im System eingestellte Temp-Verzeichnis verwendet. Über (alpha4) kann aber optional auch ein anderes Verzeichnis angegeben werden.
|
Der Benutzer muss in diesem Verzeichnis Schreibrechte besitzen. |
Bei der Verwendung mit der Application Remote Control werden die Parameter mit folgenden Namen übergeben:
| /ArcNr | Nummer des Archivs |
| /Page | zu lesende Anhangdatei |
| /Path | temporärer Pfad |
| /RsltPath | Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird. |
Zum Beispiel: /user=admin /password=troja /action=fnc /fnc=AFArctextRead /ArcNr=2008.0000012 /Page=1 /RsltPath=c:\temp\AFAPIRES.TXT
In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert. In der folgenden Zeile wird der Pfad und der Name der externen Datei angegeben, in dem der Text steht.
| Konstante | Wert | Bedeutung |
| _ErrOk | 0 | ok - kein Fehler aufgetreten |
| _rNoRec | 5 | Das übergebene Archiv wurde nicht gefunden |
| sAfErrNoRecArcTxt | -20018 | Zu dem angegebenen Archiv existiert kein Archivtext |
| sAfErrNoRights | -20029 | Die Berechtigungen reichen nicht aus |
| sAfErrArcTxtPageNotExists | -20033 | Die in (int2) übergebene Textseite existiert nicht |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
