tErr # AfAbmCreateByPath('Mandator\Contractor\A\ArcFlow', var tAbmNew);
AfAbmCreateByPath: Unterschied zwischen den Versionen
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
Jens (Diskussion | Beiträge) K Stand 4.1.13 Beispiel geändert, Helptip Ausführung angepasst |
||
| Zeile 8: | Zeile 8: | ||
<td class="title"> AfAbmCreateByPath(alpha1, var int2[, int3]) : int</td> | <td class="title"> AfAbmCreateByPath(alpha1, var int2[, int3]) : int</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 Script-API|link=Befehle der Schnittstellen|Ausführbar von der Script-API]] | |||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 21: | Zeile 24: | ||
<td colspan="3" width="85%" class=Right>Pfad und Name der Arbeitsmappe</td> | <td colspan="3" width="85%" class=Right>Pfad und Name der Arbeitsmappe</td> | ||
</tr> | </tr> | ||
<tr class="ProcParameterItem"> | <tr class="ProcParameterItem"> | ||
| Zeile 94: | Zeile 96: | ||
<p>Ist der angegebene Pfad bereits vorhanden, wird keine Arbeitsmappe erzeugt und die Anweisung gibt <font class=source>_ErrOk</font> (0) zurück.</p></p> | <p>Ist der angegebene Pfad bereits vorhanden, wird keine Arbeitsmappe erzeugt und die Anweisung gibt <font class=source>_ErrOk</font> (0) zurück.</p></p> | ||
== Beispiele == | |||
<tabber> | |||
|-|ScriptAPI= | |||
<pre class=source> | <pre class=source> | ||
tErr # AfAbmCreateByPath('Mandator\Contractor\A\ArcFlow', var tAbmNew); | tErr # AfAbmCreateByPath('Mandator\Contractor\A\ArcFlow', var tAbmNew); | ||
</pre></ | </pre> | ||
|-|ArcFlowAPI= | |||
<pre class=source> | |||
tErr # AF.API:AfAbmCreateByPath('Mandator\Contractor\A\ArcFlow', var tAbmNew); | |||
</pre> | |||
</tabber> | |||
<p> | <p> | ||
Version vom 5. Dezember 2025, 15:05 Uhr
Die Funktion legt eine neue Arbeitsmappe mit dem in (alpha1) angegebenen Pfad und Namen an. Die Arbeitsmappen des Pfades müssen mit \ getrennt angegeben werden. Die Funktion legt alle Arbeitsmappen des Pfades an, sofern sie noch nicht vorhanden sind. In (int2) muss eine Variable übergeben werden. Nach dem Aufruf der Funktion steht in dieser Variablen die Nummer der zuletzt erzeugten Arbeitsmappe.
Bei den angelegten Arbeitsmappen ist nur der Mappenname gesetzt. Weitere Informationen (Beschreibung, automatische Unterteilung usw.) müssen mit der Anweisung AfAbmEdit() gesetzt werden.
In (int3) kann angegeben werden, ob eine Vorlagemappe oder eine normale Arbeitsmappe erzeugt werden soll.
| Konstante | Wert | Bedeutung |
| sAfAbmTypeNormal | 0 | Normale Arbeitsmappe |
| sAfAbmTypeTemplate | 1 | Vorlagemappe |
Weitere Eigenschaften der erzeugten Arbeitsmappen können mit der Anweisung AFAbmEdit() definiert werden.
Ist der angegebene Pfad bereits vorhanden, wird keine Arbeitsmappe erzeugt und die Anweisung gibt _ErrOk (0) zurück.
Beispiele
tErr # AF.API:AfAbmCreateByPath('Mandator\Contractor\A\ArcFlow', var tAbmNew);
Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| _ErrOk | 0 | ok - kein Fehler aufgetreten |
| sAfErrAbmNoPath | -20083 | In (alpha1) wurde eine leere Zeichenkette übergeben. |
| sAfErrStringTo0Long | -20010 | Die übergebene Zeichenkette ist länger als 4096 Zeichen. |
| sAfErrInvalidAbmType | -20041 | Der in (int3) angegebene Arbeitsmappentyp ist ungültig. |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
