af_rmtcontrol.exe /user=admin /password=troja /action=fnc /fnc=AfArctextRead /ArcNr=2008.0000012 /Page=1 /RsltPath=c:\temp\AFAPIRES.TXTIn 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.
AfArcTextRead: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Jens (Diskussion | Beiträge) KKeine Bearbeitungszusammenfassung |
Jens (Diskussion | Beiträge) K Stand 4.1.13 Beispiel geändert, Helptip Ausführung angepasst |
||
| (3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfArcTextRead(alpha1, int2, int3[,alpha4]) : int</td> | ||
<td class="platforms"> | <td class="platforms"> | ||
[[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolDLL.gif|alt=Ausführbar von der Programmierschnittstelle|link=Befehle der Schnittstellen]][[file:DE_SymbolARC.gif|alt=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_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen|Ausführbar von der API]][[file:DE_SymbolDLL.gif|alt=Ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen|Ausführbar von der Programmierschnittstelle (DLL)]][[file:DE_SymbolARC.gif|alt=Ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen|Ausführbar mit der Application Remote Control]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen|Ausführbar von der Script-API]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 51: | Zeile 51: | ||
<td width="15%" class=Left>Siehe</td> | <td width="15%" class=Left>Siehe</td> | ||
<td width="85%" class=Right colspan="3"> | <td width="85%" class=Right colspan="3"> | ||
[[Befehle für Archive | [[:Category:Befehle für Archive|Verwandte Befehle]], | ||
[[ | [[AfArcTextEdit#|AfArcTextEdit()]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 64: | Zeile 64: | ||
<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><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 [[ | <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>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.</p> | <p>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.</p> | ||
| Zeile 93: | Zeile 93: | ||
</table> | </table> | ||
== Beispiel == | |||
<tabber> | |||
|-|ArcFlowRemoteControl= | |||
<pre class=source> | |||
af_rmtcontrol.exe /user=admin /password=troja /action=fnc /fnc=AfArctextRead /ArcNr=2008.0000012 /Page=1 /RsltPath=c:\temp\AFAPIRES.TXT | |||
</pre> | |||
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. | |||
</tabber> | |||
<p> | <p> | ||
<table class=lang> | <table class=lang> | ||
<tr> | <tr> | ||
| Zeile 152: | Zeile 153: | ||
</translate> | </translate> | ||
[[Category:Befehle für Archive]] | [[Category:Befehle für Archive]] | ||
Aktuelle Version vom 4. Februar 2026, 10:38 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. |
Beispiel
| 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.
