In der Datei festo.cfg, die Sie im Verzeichnis ..\<Versionsnummer>\cfg finden, legen Sie fest, welche Festo-Artikeleigenschaften importiert werden. Hier wird auch die Zuordnung der Festo-Artikel zu EPLAN-Makros oder -Symbolen vorgenommen. Zusätzlich können Sie eigene Zuordnungen für die Eigenschaften festlegen.
Die Konfigurationsdatei ist in verschiedene Abschnitte aufgeteilt: Im Abschnitt "Festo-Settings" legen Sie die Eigenschaftszuordnungen fest. So können Sie z.B. konfigurieren, wie die Artikelnummern aufgebaut werden. Im Abschnitt "Festo-MacroMapping" wird die Zuordnung der Makros zu den Festo-Artikeln festgelegt.
Für die Bearbeitung der Konfigurationsdatei gelten folgende Regeln:
- Die Datei darf eine maximale Größe von 400000 Byte haben (inklusive Kommentare).
- Das Ende einer Datenzeile wird mit \r\n (Zeilenumbruch) abgeschlossen.
- In einer Datenzeile können maximal 255 Operationen verarbeitet werden (+ | - | * | /).
- Die Daten werden in dem Format berechnet, das die Zuweisungseigenschaft (d.h. die Eigenschaft, der die Werte zugewiesen werden) unterstützt (String, Double, Long, Boole).
- Bei einer IF-Bedingung kann nur ein Paar von Eigenschaften verglichen werden.
- In einer IF-Bedingung können folgende Vergleichsoperatoren verwendet werden: (==; !=; <; >; <=; >=).
- Bei der Überprüfung der IF-Bedingung wird die Groß- / Kleinschreibung berücksichtigt.
- Es gibt keinen ELSE-Zweig. Die Konfigurationsdatei wird der Reihe nach abgearbeitet.
- Ein Boolescher Wert ist folgendermaßen definiert: 0 = FALSE, >0 = TRUE.
- Kommentarzeilen werden mit "; " (; und Leerzeichen) gekennzeichnet.
- Eine Zeichenkette wird durch "..." definiert.
- Platzhalter für Eigenschaften werden durch [#<Eigenschaftsname>] definiert.
- Es ist möglich, über den Index auf indizierte Eigenschaften zuzugreifen.
- Variablen werden durch [$<Variablenname>] definiert
- Die Anzeigesprache von EPLAN zum Zeitpunkt des Imports lässt sich abfragen.
Importmodus
Im Abschnitt "DataImportSetting" der Konfigurationsdatei legen Sie den Importmodus gemäß folgender Syntax fest:
ImportMode=<Nummer>
Der Importmodus bestimmt, ob Artikel beim Import in die interne Artikelverwaltung von EPLAN überschrieben oder angehängt werden. Folgende Importmodi sind möglich:
- 0 = Nur neue Datensätze anhängen: Dies ist das Standardverhalten. Vorhandene Artikel bleiben unverändert. Es werden nur neue, noch nicht vorhandene Artikel importiert.
- 1 = Nur bestehende Datensätze aktualisieren: Vorhandene Artikel werden mit den neuen Werten überschrieben. Neue Artikel werden nicht importiert.
- 2 = Bestehende Datensätze aktualisieren und neue erzeugen: Vorhandene Artikel werden mit den neuen Werten überschrieben. Zusätzlich werden neue Artikel importiert.
Zuordnung von Eigenschaften
Die Zuordnung von Eigenschaften erfolgt im Abschnitt "Festo-Settings" der Konfigurationsdatei gemäß folgender Syntax:
<Eigenschaftsnummer> = "<Wert>"
Achtung:
Sie sollten die vorgegebenen Eigenschaften im Abschnitt "Festo-Settings" nicht ändern, da diese dafür sorgen, dass nach dem Import ein in EPLAN funktionsfähiger Artikel entsteht.
22007 = "FESTO"
22008 = "FESTO"
22132 = 1
22135 = 1
22022 = 1
22138 = 2
22041 = 30
22023 = 1
Damit werden folgende Eigenschaften festgelegt:
Nummer |
Name |
Typ |
Wert |
---|---|---|---|
22007 |
Hersteller |
String |
FESTO |
22008 |
Lieferant |
String |
FESTO |
22132 |
Gewerk Fluid |
Boole |
1, d.h. Kontrollkästchen aktiviert |
22135 |
Gewerk Pneumatik |
Boole |
1, d.h. Kontrollkästchen aktiviert |
22022 |
Montageort |
Long |
1, d.h. Montageplatte |
22138 |
Produktobergruppe |
Long |
2, d.h. Fluid |
22041 |
Produktgruppe |
Long |
30, d.h. Aggregate / Anlagen |
22023 |
Datensatztyp |
Long |
1, d.h. Einzelteil |
Sie können zusätzliche Eigenschaften entsprechend der oben angegebenen Regeln festlegen. Da die Konfigurationsdatei der Reihe nach abgearbeitet wird empfehlen wir, Ihre eigenen Definitionen am Ende des Abschnitts zu ergänzen.
Festlegen der zu importierenden Festo-Eigenschaften
Die zu importierenden Festo-Artikeleigenschaften werden mit dem xDKI–Klarnamen angeben (dies ist der sprachunabhängige Name der Festo-Eigenschaft), dabei wird die Groß- / Kleinschreibung berücksichtigt.
Folgende Festo-Artikeldaten lassen sich importieren:
-
Benennung -
Typ -
VPE -
ME -
KTN -
XHUB -
XHUBMin -
XHUBMax -
PRICE -
TOTALPRICE -
Text -
Prod_Txt -
REMARKS -
Menge -
Teilenummer -
SymbolId.
Platzhalter für Eigenschaften werden durch das vorangestellte Zeichen "#'" gekennzeichnet.
Syntax: [#<Eigenschaftsname>]
Für Festo-Eigenschaften: [#<xDKI-Klarname>]
Der folgende Eintrag importiert den Inhalt des Bemerkungsfeldes (Festo-Eigenschaft "REMARKS") in die EPLAN-Eigenschaft Beschreibung <22009>:
Das Feld Typ von Festo
soll in das Feld Artikelnummer von EPLAN importiert
werden, wobei die Artikelnummer mit dem Text "FESTO_" beginnen
soll.
Das Feld Typ soll ebenfalls in das Feld Bestellnummer
von EPLAN importiert werden, jedoch ohne zusätzlichen Text.
Dazu ist folgender Eintrag in der Datei festo.cfg erforderlich:
22003 = [#Typ]
Hinweis:
Sollten in neuen Festo-Produktkatalogen zukünftig weitere Festo-Eigenschaften hinzukommen, so lassen sich auch diese importieren, indem Sie den entsprechenden xDKI-Klarnamen angeben.
Indizierte Eigenschaften
Es ist möglich, auf indizierte Eigenschaften zuzugreifen (z.B. auf die "Freien Eigenschaften").
Syntax: <EPLAN-Eigenschaftsnummer>.<Index>
Der folgende Eintrag importiert den Inhalt des Bemerkungsfeldes (Festo-Eigenschaft "REMARKS") in die EPLAN-Eigenschaft Freie Eigenschaften: Beschreibung <22146> mit Index "1":
Weitere Anpassungen
Sie können in der Konfigurationsdatei eigene Anpassungen für den Import vornehmen. Zu diesem Zweck lassen sich unter anderem die nachfolgend aufgeführten Befehle und Elemente nutzen. Beachten Sie auch die am Anfang der Konfigurationsdatei aufgeführten Regeln.
IF-Bedingungen
Innerhalb der Zuordnungsdatei können IF-Bedingungen verwendet werden. In einer IF-Bedingung kann nur ein Paar von Eigenschaften verglichen werden. Bei der Überprüfung der IF-Bedingung wird die Groß- / Kleinschreibung berücksichtigt. Folgende Vergleichsoperatoren sind möglich:
- == (gleich)
- != (ungleich)
- < (kleiner als)
- > (größer als)
- <= (kleiner oder gleich)
- >= (größer oder gleich).
Hyperlinks
Über Hyperlinks in den Artikeldaten ist ein Zugriff auf die Festo-Webseite möglich, auf der eine aktuelle Dokumentation und die technischen Daten des Artikels hinterlegt sind. Die Hyperlinks werden beim Import automatisch in das Feld Datei / Hyperlink 1 in der Registerkarte Dokumente der Artikelverwaltung eingetragen.
Anzeigesprache
Um Eigenschaften in einer bestimmten Sprache anzuzeigen, haben Sie die Möglichkeit, den Platzhalter #EPLAN.Lng zu verwenden. Dieser Platzhalter wird während des Imports mit der aktuellen Anzeigesprache gefüllt.
Syntax: lang=[#EPLAN.Lng]
Achtung:
Die Anzeigesprache, die zum Zeitpunkt des Imports eingestellt ist, wird fest in die Eigenschaften eingetragen und beim Umstellen der Anzeigesprache nicht aktualisiert. Die Sprache lässt sich nur durch einen erneuten Import der Artikel mit geänderter Anzeigesprache ändern. Dabei müssen die alten Artikel vorher gelöscht werden.
Über den Eintrag lang=<Sprache> (z.B. lang="en_US") ist es auch möglich, direkt eine bestimmte Sprache festzulegen.
Variablen
Um innerhalb der Konfiguration Werte temporär zwischen zu speichern (ohne dabei EPLAN-Eigenschaften zweckentfremden zu müssen), stehen 10 Variablen vom Typ "Zeichenkette" zur Verfügung. Variablen werden durch das vorangestellte Zeichen "$" gekennzeichnet.
Syntax: [$EPLAN.Str0] … [$EPLAN.Str9]
Die Wertzuweisung der Variablen steht nur temporär zum Zeitpunkt des Imports zur Verfügung und verändert keinen Wert der zu übernehmenden Eigenschaften eines Festo-Artikels.
In der Konfigurationsdatei wird die Variable EPLAN.Str0 verwendet, um einer Anzeigesprache, die nicht von der Festo-Webseite bereitgestellt wird, eine alternative Anzeigesprache zuzuordnen.
if ([$EPLAN.Str0] == "da_DK") [$EPLAN.Str0] = "en_US"
Der erste Eintrag speichert die aktuelle EPLAN-Anzeigesprache in der Variablen EPLAN.Str0. Ist die aktuelle Anzeigesprache Dänisch, so wird sie für den Import auf Englisch umgestellt.
In diesem Beispiel wird der Verkaufspreis abhängig vom Einkaufspreis berechnet. Da in den Variablen nur Zeichenketten verarbeitet werden, muss für die Berechnung eine geeignete EPLAN-Eigenschaft "zweckentfremdet" werden. Die Variable $EPLAN.Str1 wird verwendet, um den Inhalt dieser Eigenschaft zwischen zu speichern und der Eigenschaft nach der Berechnung wieder zuzuweisen. So gehen keine Daten verloren.
[$EPLAN.Str1] = 22110
if (22109 > "0") 22110 = 22109 / 100 * 25 + 22109
if (22109 >= "50") 22110 = 22109 / 100 * 15 + 22109
if (22109 >= "100") 22110 = 22109 / 100 * 10 + 22109
22107 = 22110
22110 = [$EPLAN.Str1]
Zeile 1: Der Inhalt der Festo-Eigenschaft
"PRICE" wird in der EPLAN-Eigenschaft Einkaufspreis/Preiseinheit
Währung 1 <22109> gespeichert.
Zeile 2: Der Wert der Eigenschaft Einkaufspreis/Preiseinheit
Währung 2 <22110> wird in der Variablen $EPLAN.Str1
gespeichert.
Zeile 3 bis 5: Der Wert der Eigenschaft Einkaufspreis/Preiseinheit
Währung 1 <22109> wird verglichen und –
je nach Betrag –
um 25%, 15% oder 10% erhöht. Der neue Wert wird in der Eigenschaft Einkaufspreis/Preiseinheit Währung 2 <22110> gespeichert.
Zeile 6: Der Wert der Eigenschaft Einkaufspreis/Preiseinheit
Währung 2 <22110> wird in die Eigenschaft Verkaufspreis
Währung 1 <22107> übertragen.
Zeile 7: Der in der Variablen $EPLAN.Str1
gespeicherte Wert wird zurück in die Eigenschaft Einkaufspreis/Preiseinheit
Währung 2 <22110> übertragen.
Zuordnung von Makros oder Symbolen
Die Zuordnung von Makros oder Symbolen zu den Festo-Artikeln erfolgt im Abschnitt "Festo-MacroMapping" der Konfigurationsdatei gemäß folgender Syntax:
Für Makros:
if ([#SymbolId] == "<Bestellnummer>") 22145 = "<Unterverzeichnis>\<Makroname>.EMA"
oder
if ([#SymbolId] == "<Bestellnummer>") 22145 = "<Unterverzeichnis>\<Makroname>.EMS"
Für Symbole:
if ([#SymbolId] == "<Bestellnummer>") 22146 = "<Unterverzeichnis>\<Symbolname>.ESY"
if ([#SymbolId] == "00991001") 22145 = "FESTO\P_V_0100.EMS"
if ([#SymbolId] == "00991002") 22145 = "FESTO\P_V_0101.EMS"
...
Dabei wird die Festo-Eigenschaft "SymbolId" der EPLAN-Eigenschaft Bestellnummer <22003> zugeordnet; <22145> ist die EPLAN-Eigenschaft Makro.
Siehe auch