AfAbmCreateByPath
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.
Beispiel:
tErr # 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.