AfAbmCreateByPath: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
← Zum vorherigen Versionsunterschied
K Stand 4.1.09
K Stand 4.1.18 Ausführung und Beispiel ergänzt
 
(2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 8: Zeile 8:
     <td class="title">&nbsp;AfAbmCreateByPath(alpha1, var int2[, int3]) : int</td>
     <td class="title">&nbsp;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]][[file:SymbolNext.gif|alt=Ausführbar von ArcFlow.NEXT|link=Befehle der Schnittstellen|Ausführbar von ArcFlow.NEXT]]
     </td>
     </td>
   </tr>
   </tr>
Zeile 21: Zeile 21:
   <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 57: Zeile 56:
</table>
</table>
<div class="BigLang">
<div class="BigLang">
<p><p>Die Funktion legt eine neue Arbeitsmappe mit dem in (alpha1) angegebenen Pfad und Namen an. Die Arbeitsmappen des Pfades müssen mit <font class=source>&#92;</font> 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.</p>
Die Funktion legt eine neue Arbeitsmappe mit dem in (alpha1) angegebenen Pfad und Namen an. Die Arbeitsmappen des Pfades müssen mit <font class=source>&#92;</font> 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.


<p>Bei den angelegten Arbeitsmappen ist nur der Mappenname gesetzt. Weitere Informationen (Beschreibung, automatische Unterteilung usw.) müssen mit der Anweisung [[AfAbmEdit#|AfAbmEdit()]] gesetzt werden.</p>
Bei den angelegten Arbeitsmappen ist nur der Mappenname gesetzt. Weitere Informationen (Beschreibung, automatische Unterteilung usw.) müssen mit der Anweisung [[AfAbmEdit#|AfAbmEdit()]] gesetzt werden.


<p>In (int3) kann angegeben werden, ob eine Vorlagemappe oder eine normale Arbeitsmappe erzeugt werden soll.</p>
In (int3) kann angegeben werden, ob eine Vorlagemappe oder eine normale Arbeitsmappe erzeugt werden soll.


<table class=lang>
<table class=lang>
Zeile 90: Zeile 89:
</table>
</table>


<p>Weitere Eigenschaften der erzeugten Arbeitsmappen können mit der Anweisung [[AFAbmEdit#|AFAbmEdit()]] definiert werden.</p>
Weitere Eigenschaften der erzeugten Arbeitsmappen können mit der Anweisung [[AfAbmEdit#|AfAbmEdit()]] definiert werden.


<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>
Ist der angegebene Pfad bereits vorhanden, wird keine Arbeitsmappe erzeugt und die Anweisung gibt <font class=source>_ErrOk</font> (0) zurück.


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


<tabber>
|-|ScriptAPI=
<pre class=source>
<pre class=source>
tErr # AfAbmCreateByPath('Mandator&#92;Contractor&#92;A&#92;ArcFlow', var tAbmNew);
tErr # AfAbmCreateByPath('Mandator&#92;Contractor&#92;A&#92;ArcFlow', var tAbmNew);
</pre></p>
</pre>
|-|ArcFlowAPI=
<pre class=source>
tErr # AF.API:AfAbmCreateByPath('Mandator&#92;Contractor&#92;A&#92;ArcFlow', var tAbmNew);
</pre>
|-|ArcFlow.NEXT=
<pre class=source>
af.next.AfAbmCreateByPath('\\Lieferanten\\ArcFlow', af.next.constants.AbmTypeNormal).then(result => {
  if (result.code == af.next.constants.AFErrOk) {
    ...
  }
  else {
    af.next.AfGetErrorAlpha(result.code).then(resultError => {
      alert(result.code+' / '+result.webcode+' / '+resultError.returnValues.afError);
    });
  }
});
</pre>
</tabber>
 
Neben den [[Allgemeine Fehlercodes#|allgemeinen Fehlerwerten]] können folgende Werte zurückgegeben werden:


<p>
Neben den [[Allgemeine Fehlercodes#|allgemeinen Fehlerwerten]]
können folgende Werte zurückgegeben werden:
</p><p>
   <table class=lang>
   <table class=lang>
     <tr>
     <tr>
Zeile 116: Zeile 132:
       <td>ok - kein Fehler aufgetreten</td>
       <td>ok - kein Fehler aufgetreten</td>
     </tr>
     </tr>
     <tr class="ProcErrorItem">
     <tr class="ProcErrorItem">
       <td class=source valign=top>sAfErrAbmNoPath</td>
       <td class=source valign=top>sAfErrAbmNoPath</td>
Zeile 123: Zeile 137:
       <td>In (alpha1) wurde eine leere Zeichenkette übergeben.</td>
       <td>In (alpha1) wurde eine leere Zeichenkette übergeben.</td>
     </tr>
     </tr>
     <tr class="ProcErrorItem">
     <tr class="ProcErrorItem">
       <td class=source valign=top>sAfErrStringTo0Long</td>
       <td class=source valign=top>sAfErrStringTo0Long</td>
Zeile 130: Zeile 142:
       <td>Die übergebene Zeichenkette ist länger als 4096 Zeichen.</td>
       <td>Die übergebene Zeichenkette ist länger als 4096 Zeichen.</td>
     </tr>
     </tr>
     <tr class="ProcErrorItem">
     <tr class="ProcErrorItem">
       <td class=source valign=top>sAfErrInvalidAbmType</td>
       <td class=source valign=top>sAfErrInvalidAbmType</td>
Zeile 137: Zeile 147:
       <td>Der in (int3) angegebene Arbeitsmappentyp ist ungültig.</td>
       <td>Der in (int3) angegebene Arbeitsmappentyp ist ungültig.</td>
     </tr>
     </tr>
  </table>


Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.


  </table>
</p><p>
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die
aktuelle CONZEPT 16-Hilfe.
</p>
</div>
</div>
</translate>
</translate>
[[Category:Befehle für Arbeitsmappen]]
[[Category:Befehle für Arbeitsmappen]]

Aktuelle Version vom 12. Mai 2026, 09:52 Uhr

 AfAbmCreateByPath(alpha1, var int2[, int3]) : int

Ausführbar von der APINicht ausführbar von der Programmierschnittstelle (DLL)Nicht ausführbar mit der Application Remote ControlAusführbar von der Script-APIAusführbar von ArcFlow.NEXT

Arbeitsmappe über einen Pfad erstellen
alpha1 Pfad und Name der Arbeitsmappe
int2 Nummer der neu angelegten Arbeitsmappe
int3 Mappentyp (optional)
Resultat int Fehlerwert
Siehe

Verwandte Befehle, AfAbmCreateByTemplate(), AfAbmCreate()

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 # AfAbmCreateByPath('Mandator\Contractor\A\ArcFlow', var tAbmNew);


tErr # AF.API:AfAbmCreateByPath('Mandator\Contractor\A\ArcFlow', var tAbmNew);


af.next.AfAbmCreateByPath('\\Lieferanten\\ArcFlow', af.next.constants.AbmTypeNormal).then(result => {
  if (result.code == af.next.constants.AFErrOk) {
    ...
  }
  else {
    af.next.AfGetErrorAlpha(result.code).then(resultError => {
      alert(result.code+' / '+result.webcode+' / '+resultError.returnValues.afError);
    });
  }
});

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.

Abgerufen von „https://wiki.arcflow.net/index.php?title=AfAbmCreateByPath&oldid=8157“