AfLogFileWrite: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
K Stand 4.1.09
K Stand 4.1.13 Helptip Ausfürbar geändert
 
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 8: Zeile 8:
     <td class="title">&nbsp;AfLogFileWrite(alpha1, alpha2)</td>
     <td class="title">&nbsp;AfLogFileWrite(alpha1, alpha2)</td>
     <td class="platforms">
     <td class="platforms">
[[file:DE_SymbolAPI.gif|alt=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_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen|Ausführbar von der API]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen|Nicht ausführbar von der Programmierschnittstelle (DLL)]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen|Nicht ausführbar mit der Application Remote Control]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der ScriptAPI|link=Befehle der Schnittstellen|Ausführbar von der ScriptAPI]]
     </td>
     </td>
   </tr>
   </tr>
Zeile 43: Zeile 43:
</table>
</table>
<div class="BigLang">
<div class="BigLang">
<p><p>Mit dieser Anweisung kann eine externe Protokolldatei erzeugt bzw. erweitert werden. Der Name der externen Datei wird in (alpha1) angegeben. Existiert die angegebene Datei nicht, wird sie durch die Anweisung angelegt. Eine bestehende Datei wird erweitert.</p>
Mit dieser Anweisung kann eine externe Protokolldatei erzeugt bzw. erweitert werden. Der Name der externen Datei wird in (alpha1) angegeben. Existiert die angegebene Datei nicht, wird sie durch die Anweisung angelegt. Eine bestehende Datei wird erweitert.


<p>Im Parameter (alpha2) wird eine Zeile mit beliebigem Text übergeben, der in die Datei geschrieben wird. Der Zeile wird dabei automatisch das aktuelle Datum und die aktuelle Uhrzeit vorangestellt. In (alpha2) können maximal 1024 Zeichen angegeben werden.</p>
Im Parameter (alpha2) wird eine Zeile mit beliebigem Text übergeben, der in die Datei geschrieben wird. Der Zeile wird dabei automatisch das aktuelle Datum und die aktuelle Uhrzeit vorangestellt. In (alpha2) können maximal 1024 Zeichen angegeben werden.


<p>Die Anweisung liefert keinen Rückgabewert.</p>
Die Anweisung liefert keinen Rückgabewert.


<b>Beispiel:</b>{{Marker}}
== Beispiele ==
</p><p>


<tabber>
|-|ScriptAPI=
<pre class=source>
<pre class=source>
AfLogFileClear('c:\temp\myscriptlog.txt'); // Protokolldatei leeren / vorhergehende Einträge löschen
AfLogFileClear('c:\temp\myscriptlogging.txt');
AfLogFileWrite('c:\temp\myscriptlog.txt','Skript gestartet. USER='+gAfUserName);
AfLogFileWrite('c:\temp\myscriptlogging.txt','Skript gestartet.');
...
...
AfLogFileWrite('c:\temp\myscriptlog.txt','Skript beendet');
AfLogFileWrite('c:\temp\myscriptlogging.txt','Skript beendet.');
</pre>
</pre>
|-|ArcFlowAPI=
<pre class=source>
AF.API:AfLogFileClear('c:\temp\myscriptlogging.txt');
AF.API:AfLogFileWrite('c:\temp\myscriptlogging.txt','Skript gestartet.');
...
AF.API:AfLogFileWrite('c:\temp\myscriptlogging.txt','Skript beendet.');
</pre>
</tabber>


<p>Das Beispiel erzeugt eine Protokolldatei mit folgendem Inhalt:</p>
Das Beispiel erzeugt eine Protokolldatei mit folgendem Inhalt:


<pre class=source>
<pre class=source>
2016-09-13 13:58:51:02 - Skript gestartet. USER=admin
2016-09-13 13:58:51:02 - Skript gestartet.
2016-09-13 13:58:53:12 - Skript beendet.
2016-09-13 13:58:53:12 - Skript beendet.
</pre></p>
</pre>


</div>
</div>
</translate>
</translate>
[[Category:Allgemeine Befehle der API]]
[[Category:Allgemeine Befehle der API]]

Aktuelle Version vom 2. Dezember 2025, 07:28 Uhr

 AfLogFileWrite(alpha1, alpha2)

Ausführbar von der APINicht ausführbar von der Programmierschnittstelle (DLL)Nicht ausführbar mit der Application Remote ControlAusführbar von der ScriptAPI

Eintrag in eine externe Protokolldatei schreiben
alpha1 Pfad- und Dateiname der Protokolldatei
alpha2 Protokoll-Text
Siehe

Verwandte Befehle, AfLogFileClear()

Mit dieser Anweisung kann eine externe Protokolldatei erzeugt bzw. erweitert werden. Der Name der externen Datei wird in (alpha1) angegeben. Existiert die angegebene Datei nicht, wird sie durch die Anweisung angelegt. Eine bestehende Datei wird erweitert.

Im Parameter (alpha2) wird eine Zeile mit beliebigem Text übergeben, der in die Datei geschrieben wird. Der Zeile wird dabei automatisch das aktuelle Datum und die aktuelle Uhrzeit vorangestellt. In (alpha2) können maximal 1024 Zeichen angegeben werden.

Die Anweisung liefert keinen Rückgabewert.

Beispiele

AfLogFileClear('c:\temp\myscriptlogging.txt');
AfLogFileWrite('c:\temp\myscriptlogging.txt','Skript gestartet.');
...
AfLogFileWrite('c:\temp\myscriptlogging.txt','Skript beendet.');

AF.API:AfLogFileClear('c:\temp\myscriptlogging.txt');
AF.API:AfLogFileWrite('c:\temp\myscriptlogging.txt','Skript gestartet.');
...
AF.API:AfLogFileWrite('c:\temp\myscriptlogging.txt','Skript beendet.');

Das Beispiel erzeugt eine Protokolldatei mit folgendem Inhalt:

2016-09-13 13:58:51:02 - Skript gestartet.
2016-09-13 13:58:53:12 - Skript beendet.