powered by CADENAS

Manual

Manual

3.1.4. Aufruf

Die eigentlichen Aktionen laufen innerhalb einer dll-Datei ab. Diese wird per vbb-Skript geladen und so die entsprechenden Funktionen gestartet. Um die Datei classimport.vbb zu starten, wird die Datei dem CADENAS-Scripthost übergeben.

Der Aufruf erfolgt über Kommandozeile.

Dem Aufruf können spezielle Parameter mitgegeben werden. Entweder ebenfalls über Kommandozeile oder über Deklaration in der Konfigurationsdatei unter $CADENAS_SETUP/classimport.cfg.

Obligatorische Aufrufparameter über die Kommandozeile sind folgende:

  1. classimport.vbb

    %cadenas_setup%/scripts/common/classimport.vbb

  2. -mode

    Dieser Parameter kann folgende Werte annehmen:

    • new: Alle Tabellen werden neu aufgebaut.

    • update: Sie können Merkmale, Klassen und Zeilen hinzufügen, modifizieren oder löschen.

    • images: Bitmaps und STL's werden eingelesen/aktualisiert.

    • geoindex: Der komplette Geo-Index wird neu aufgebaut.

    • checkgeoindex: Es wird lediglich überprüft, ob der "geoindex" ok ist.

    • fastsearch: Der Index für Variablen- und Textsuche wird aktualisiert.

    • updateindex: Es wird eine Aktualisierung des kompletten Index durchgeführt.

Einen beispielhaften Aufruf per Kommandozeile sehen Sie im Folgenden:

%CADENAS%\bin\x86\32\cscripthost.exe 
%cadenas_setup%\scripts\common\classimport.vbb 
-mode new 
-logfile c:\import\logfile.txt 
-user erpuser 
-pwd erpuser

Allgemeine Hinweise

  • Die Reihenfolge der Parameterangaben ist unerheblich.

  • Die Angabe des Aufrufparameters -logfile ist meist hilfreich.

  • Alle Daten können per batch-Skript zyklisch aktualisiert werden.

  • Einige Parameter können sowohl über Kommandozeile, als auch per Konfigurationsdatei aufgerufen werden.

    Die folgende Tabelle enthält eine Aufstellung aller möglichen Aufrufparameter, bzw. der Schlüssel in der Konfigurationsdatei classimport.cfg.

Basisdaten

Aufruf über Kommandozeile Aufruf über Konfigurationsdatei classimport.cfg  
 

[CLASSIMPORT]
NATIVETYPE=STLFILE

Sollte in der Regel nicht geändert werden.

CAD-Kennung für die zu erzeugenden nativen Teile

-categoryname cat

[CLASSIMPORT]
CATEGORYNAME=cat

Wertebereich: "cat" oder "nat"

Default: cat

[Achtung] Achtung

Falls "nat" gewählt wird, so muss der CLASSNAME "nativeparts" lauten! Ansonsten wird die Fehlermeldung "Catalog name in category nat must be nativeparts" in classimport.err ausgegeben.

Name der Kategorie

Bei "cat" wird erscheint der Katalog unter "Kataloge". Bei "nat" unter "Eigene Teile".[a]

[Hinweis] Hinweis

Bei "nat" ist der Import-Modus "new" nicht möglich! Verwenden Sie statt dessen "update".

-classname example

[CLASSIMPORT]
CLASSNAME=example

Interner Katalogname

(nur Kleinbuchstaben sind erlaubt)

-classdesc "Own Parts"

[Hinweis] Hinweis

Wenn im Beschreibungstext Leerzeichen vorkommen, dann sind Anführungszeichen zu benutzen.

[CLASSIMPORT]
CLASSDESC=Own Parts

Katalogbeschreibung

(alle Zeichen sind erlaubt)

Für „“nativeparts“ in Kategorie "nat" wird der Wert ignoriert.

-classbmp c:\import\catalog.bmp

[CLASSIMPORT]
CLASSBMP=C:\import\catalog.bmp

Pfad zum Katalogbild

Für „“nativeparts“ in Kategorie "nat" wird der Wert ignoriert.

 

[CLASSIMPORT]
UNIT=mm

Wertebereich: mm / INCH

Default: mm

Für die importierten STLs kann jetzt angeben werden, welche Einheit sie haben.[b]

[a] Bisher konnten Teile nur in die Kategorie „Kataloge“ importiert werden. Mit V9 ist es auch möglich, in die Kategorie „Eigene Teile“ zu importieren.

[b] ab V9.02

Importdateien

Aufruf über Kommandozeile Aufruf über Konfigurationsdatei classimport.cfg Beschreibung

-klvkn c:\import\
 classstruct.txt

[CSV_ClassStructure]
FILE=c:\import\
 classstruct.txt
SEP=;
QUOTE="
COLWIDTH=

Die Datei classstruct.txt enthält die Daten für den Aufbau der Klassenstruktur (Tree).

-klast c:\import\classdef.txt

[CSV_ClassDefinition]
FILE=c:\import\classdef.txt
SEP=;
QUOTE="
COLWIDTH=
Die Datei classdef.txt enthält die Klassennamen in den verschiedenen Sprachen.

-auspr c:\import\
 attributedata.txt

[CSV_AttributeData]
FILE=c:\import\
 attributedata.txt
SEP=;
QUOTE="
COLWIDTH=

Die Datei attributedata.txt enthält die Merkmalswerte.

-merkst c:\import\
 attributedef.txt

[CSV_AttributeDefinition]
FILE=c:\import\
 attributedef.txt
SEP=;
QUOTE="
COLWIDTH=

Die Datei attributedef.txt wird für den Aufbau der Tabellen in PARTsolutions benutzt. Hier müssen alle Merkmale beschrieben sein.

-matnr c:\import\erpdata.txt

[CSV_ErpData]
FILE=c:\import\erpdata.txt
SEP=;
QUOTE="
COLWIDTH=

Die Datei erpdata.txt enthält die Artikel- oder Materialstammdaten.

-delmat c:\import\delmat.txt

[CSV_DELMAT]
FILE=c:\import\delmat.txt
SEP=;
QUOTE="

Einzelne Zeilen löschen

-prjtable c:\import\
 prjtable.txt

[CSV_PrjTable]
FILE=C:\import\prjtable.txt
SEP=;
QUOTE="
COLWIDTH=

Die Datei prjtable.txt enthält die Sortierreihenfolge der Spalten in den PARTsolutions-Tabellen.

-imagelist c:\import\
 filelist.txt

[CSV_ImageImport]
FILE=C:\import\filelist.txt
SEP=;
QUOTE="

Die Datei filelist.txt verwenden Sie, um STL-Dateien, Vorschaubilder (Index) und technische Ansichten zu importieren.

Siehe hierzu Abschnitt 3.1.5.6, „Bilderimport - filelist.txt“.

Beim Import mittels Kommandozeile beachten Sie bitte auch die Hinweise in der Konfigurationsdatei unter $CADENAS_SETUP/ classimport.cfg.

Weitere Parameter

Aufruf über Kommandozeile Aufruf über Konfigurationsdatei classimport.cfg Beschreibung

-logfile c:\import\logfile.txt

Die Ausgabe einer Logdatei hilft, mögliche Problemfälle zu untersuchen.

Es werden Status- und Fehlermeldungen ausgegeben.

-errfile c:\import\
 errorfile.txt

Es werden nur Fehlermeldungen ausgegeben.

-user erpuser

Bei LinkDB-Kopplung benötigt, um Daten in die Datenbank einzutragen.

Name des Datenbankbenutzers.

In der Standardinstallation wäre dies "erpuser".

-pwd erpuser

Bei LinkDB-Kopplung benötigt, um Daten in die Datenbank einzutragen.

Passwort des Datenbankbenutzers.

In der Standardinstallation wäre dies "erpuser".

Ausreichende Rechte müssen vorhanden sein.

-languages german,english

[CLASSIMPORT]
LANGUAGES=german,english

Wenn LANGUAGES gesetzt sind, dann müssen in den Textdateien die sprachabhängigen Spalten entsprechend vorhanden sein.

(KLBEZ_german, KLBEZ_english, etc. Siehe Abschnitt 3.1.5.3, „Sichtbarer Klassenname - classdef.txt“)

-languagesforvalues 
 german,english

[CLASSIMPORT]
LANGUAGESFORVALUES=
 german,english

Sprachen für Attributwerte:

Wenn LANGUAGESFORVALUES gesetzt sind, dann müssen in der Textdatei attributedata.txt die sprachabhängigen Spalten entsprechend vorhanden sein.

(VALDESC_german, VALDESC_english, etc. Siehe Abschnitt 3.1.5.5.3.1, „Übersetzbare Textattribute“)

-nofastsearch

Es wird kein Index für Variablen- und Textsuche generiert.

-nogeomsearch

Es wird kein geometrischer Index generiert

-noindexupdate

Es wird kein Indexupdate durchgeführt

[Hinweis] Hinweis

Bei Strukturveränderungen wird normalerweise der Index automatisch aktualisiert.

[CLASSIMPORT]
CLUSTERUPDATE=0/1

Default: 1

0: Bei Änderungen über die Classimporter-Symbolleiste wird kein Clusterupdate durchgeführt. Dadurch ist schnelleres Arbeiten möglich, aber die Clustersuche (komplexe, geometrische Suche) ist nicht mehr korrekt.[a]

[CLASSIMPORT]
TEMPMODE=0/1

Default: 1

Es wird bei Änderungen über die Classimporter Symbolleiste zuerst ein temporäres Verzeichnis angelegt. Wenn alle Änderungen erfolgreich waren, wird der Inhalt übernommen. Tritt währenddessen ein Fehler auf, werden keinerlei Änderungen übernommen und es bleibt der alte Zustand erhalten. Dies ist für Produktivumgebungen die empfohlene Vorgehensweise.

Wird der Wert auf '0' gesetzt, ist die Wartezeit zwischen einzelnen Änderungsschritten geringer.

 

[CLASSIMPORT]
CHECKFILES=1

Wertebereich 0/1

Default: 0

Dateien überprüfen

Die prj-, pol- und tab-Dateien können nach dem Import überprüft werden. Falls diese defekt oder nicht komplett sind, wird eine Fehlermeldung in die Log-Datei geschrieben: "File <...> is incomplete or corrupt."

 

[CLASSIMPORT]
DELETEPOOLFILES=0

Wertebereich 0/1/2/3

Default: 0

Pool-Dateien löschen

DELETEPOOLFILES greift bei Strukturveränderungen die Auswirkungen auf die Daten haben können, also z.B. beim Löschen einer Klasse.

Wird in der Import-Datei "classstruct.txt" die Spalte "MODE" mit dem Wert "del" verwendet, wird das entsprechende Verzeichnis aus dem 23dlibs-Verzeichnis gelöscht.

classstruct.txt - mit "MODE" = del

classstruct.txt - mit "MODE" = del

Wird zusätzlich DELETEPOOLFILES=1 gesetzt, dann werden auch die Pool-Dateien gelöscht.

Für weitere Hinweise sehen Sie bitte unter Abschnitt 3.1.5.2, „Klassenbaum - classstruct.txt“.

 

[CLASSIMPORT]
LICKEY=%basekey%*
CATALOGSADDITIONAL*%catname%

Lizenzschlüssel für Katalog:

%basekey% wird durch PSOLBASEKEY ersetzt

%catname% durch den Katalognamen in Großbuchstaben

-synconlyfolder klassenname
 

Das Einlesen der Daten kann auf einen bestimmten Zweig des Klassen- bzw. Verzeichnisbaumes beschränkt werden.

Geben Sie hierzu den gewünschten Klassennamen an.

Die Angabe muss in Kleinbuchstaben erfolgen.

(nur bei "-mode new")

 
[CLASSIMPORT]
NOTSYNCHFOLDER

Bei "- mode new" werden normalerweise alle evtl. vorhandenen Ordner des Katalogs gelöscht und neu aufgebaut.

Ausnahme sind diejenigen Ordner, welche unter NOTSYNCHFOLDER deklariert werden.

Trennzeichen für die Liste: ";"

 

[CLASSIMPORT]
USESHORTDIRNAME=1

Wertebereich 0/1

Default: 0

In manchen Fällen entsprechen die Klassennamen dem Verzeichnisaufbau (Pfaden).

In diesem Fall würden beim Import im 23dlibs-Verzeichnis sehr lange Verzeichnisnamen entstehen.

Um dies zu verhindern, ist es in diesem Fall sinnvoll, USESHORTDIRNAME zu aktivieren.

Siehe hierzu unter Abschnitt 3.1.5.2.1, „Sonderfall: Klassennamen entsprechen Verzeichnisstruktur“.

[a] Ab 9.02 hat dieser Parameter keine Auswirkung