AfArcFileShowByScript: Unterschied zwischen den Versionen
Jens (Diskussion | Beiträge) K Jens verschob die Seite AFArcFileShowByScript nach AfArcFileShowByScript, ohne dabei eine Weiterleitung anzulegen |
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfArcFileShowByScript(alpha1, alpha2, alpha3, alpha4) : 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_SymbolARC.gif|alt=Ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolNoScriptAPI.gif|alt=Nicht 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_SymbolARC.gif|alt=Ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolNoScriptAPI.gif|alt=Nicht ausführbar von der Script-API|link=Befehle der Schnittstellen]] | ||
| Zeile 91: | Zeile 91: | ||
<font class=source>/user=admin /password=troja /action=open_dialog /fnc=AFArcFileShowByScript /script=ShowArcFile /doctype= /docnr= /docid= /RsltPath=c:\temp\AFAPIRES.TXT</font></p> | <font class=source>/user=admin /password=troja /action=open_dialog /fnc=AFArcFileShowByScript /script=ShowArcFile /doctype= /docnr= /docid= /RsltPath=c:\temp\AFAPIRES.TXT</font></p> | ||
<p>Die übergebenen Werte in <font class=source>doctype</font>, <font class=source>docnr</font> und <font class=source>docid</font> können im Skript über die Variablen <font class=source> | <p>Die übergebenen Werte in <font class=source>doctype</font>, <font class=source>docnr</font> und <font class=source>docid</font> können im Skript über die Variablen <font class=source>gAfRmtCtrlDocType</font>, <font class=source>gAfRmtCtrlDocNo</font> und <font class=source>gAfRmtCtrlId</font> ausgelesen werden.</p> | ||
<p>Um ein Dokument anzuzeigen, muss innerhalb des Skripts die Variablen <font class=source>gAfArcNr</font> und <font class=source>gAfArcFileNr</font> gesetzt werden. Ist das Archiv mehreren Arbeitsmappen zugewiesen, kann zusätzlich die Arbeitsmappe in <font class=source>gAfAbmId</font> definiert werden. Existiert das angegebene Archiv nicht, wird auf das Archiv mit der nächst höheren Archivnummer positioniert, es erfolgt aber keine Anzeige der Anhangdatei.</p> | <p>Um ein Dokument anzuzeigen, muss innerhalb des Skripts die Variablen <font class=source>gAfArcNr</font> und <font class=source>gAfArcFileNr</font> gesetzt werden. Ist das Archiv mehreren Arbeitsmappen zugewiesen, kann zusätzlich die Arbeitsmappe in <font class=source>gAfAbmId</font> definiert werden. Existiert das angegebene Archiv nicht, wird auf das Archiv mit der nächst höheren Archivnummer positioniert, es erfolgt aber keine Anzeige der Anhangdatei.</p> | ||
| Zeile 103: | Zeile 103: | ||
<p>Das Skript wird mit folgenden Parametern aufgerufen:</p> | <p>Das Skript wird mit folgenden Parametern aufgerufen:</p> | ||
<p><font class=source>/user=admin /password=troja /action=open_dialog /fnc= | <p><font class=source>/user=admin /password=troja /action=open_dialog /fnc=AfArcFileShowByScript /script=ShowArcFile /doctype=4321 /docnr=2017.0000123 /docid=1 /RsltPath=c:\temp\AFAPIRES.TXT</font></p> | ||
<pre class=source> | <pre class=source> | ||
Aktuelle Version vom 22. Oktober 2024, 15:19 Uhr
 |
|||||||||||||||||||||||||
| AfArcFileShowByScript(alpha1, alpha2, alpha3, alpha4) : int |
|
||||||||||||||||||||||||
| Archivdatei via Skript anzeigen | |||||||||||||||||||||||||
|
|||||||||||||||||||||||||
Mit dieser Funktion wird in ArFlow eine bestimmte Archivdatei angezeigt. Das Archiv wird über das in (alpha1) angegebene Skript bestimmt. Dem Skript können drei weitere Parameter (alpha2) bis (alpha4) übergeben werden.
Die Funktion kann nur mit der Application Remote Control verwendet werden. Die Parameter werden mit folgenden Namen übergeben:
| /script | Name des Skripts |
| /doctype | Dokumenttyp (gAfRmtCtrlDocType) |
| /docnr | Dokumentnummer (gAfRmtCtrlDocNo) |
| /docid | Dokument-Id (gAfRmtCtrlId) |
| /RsltPath | Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird. |
Zum Beispiel:
/user=admin /password=troja /action=open_dialog /fnc=AFArcFileShowByScript /script=ShowArcFile /doctype= /docnr= /docid= /RsltPath=c:\temp\AFAPIRES.TXT
Die übergebenen Werte in doctype, docnr und docid können im Skript über die Variablen gAfRmtCtrlDocType, gAfRmtCtrlDocNo und gAfRmtCtrlId ausgelesen werden.
Um ein Dokument anzuzeigen, muss innerhalb des Skripts die Variablen gAfArcNr und gAfArcFileNr gesetzt werden. Ist das Archiv mehreren Arbeitsmappen zugewiesen, kann zusätzlich die Arbeitsmappe in gAfAbmId definiert werden. Existiert das angegebene Archiv nicht, wird auf das Archiv mit der nächst höheren Archivnummer positioniert, es erfolgt aber keine Anzeige der Anhangdatei.
Ist die Variable gAfArcNr leer und die Variable gAfAbmId mit einer gültigen Arbeitsmappenid gefüllt, wird auf die entsprechende Arbeitsmappe positioniert.
Beispiel:
Das Skript wird mit folgenden Parametern aufgerufen:
/user=admin /password=troja /action=open_dialog /fnc=AfArcFileShowByScript /script=ShowArcFile /doctype=4321 /docnr=2017.0000123 /docid=1 /RsltPath=c:\temp\AFAPIRES.TXT
// Display of attachment file 1 of archive 2017.0000123 gAfArcNr # gAfRmtCtrlDocNo; gAfArcFileNr # gAfRmtDocId; gAfAbmId # 0; gAfAbmParentId # 0; return(true); // Positioning at the archive gAfArcNr # gAFRmtCtrlDocNo; gAfArcFileNr # 0; gAfAbmId # 0; gAfAbmParentId # 0; return(true); // Positioning at the workfolder gAfArcNr # 0; gAfArcFileNr # 0; gAfAbmId # gAfRmtCtrlDocType; gAfAbmParentId # 0; return(true);
In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.
Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| _ErrOk | 0 | ok - kein Fehler aufgetreten |
| sAfErrArcFileNotExists | -20031 | Die Anhangdatei ist nicht vorhanden. |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
