1.7.2. Konfigurationsdateien editieren auf Dateiebene

1.7.2.1. Übersetzung der "Kurzinformation"

	Wichtig
Einstellungen der Konfigurationsdateien (CFG, DEF, etc.) sollten vorzugsweise in PARTadmin vorgenommen werden. Editieren auf Dateiebene sollte nur von CADENAS (Entwicklung, Consulting) vorgenommen werden. Dies kann z.B. sinnvoll sein bei der Neuanlage von Dateien oder dem Setzen spezieller Auszeichnungen für die Steuerung der Anzeige in PARTadmin. Für diese Fälle empfehlen wir die Verwendung von Windows Notepad oder bei höheren Ansprüchen an den Editor Notepad++. Verwenden Sie bitte in keinem Fall PSPad, da Fehler bei der Kodierung mit UTF8 auftreten, wodurch Dateien für PARTsolutions unlesbar werden.

Wichtig

Einstellungen der Konfigurationsdateien (CFG, DEF, etc.) sollten vorzugsweise in PARTadmin vorgenommen werden.

Editieren auf Dateiebene sollte nur von CADENAS (Entwicklung, Consulting) vorgenommen werden.

Dies kann z.B. sinnvoll sein bei der Neuanlage von Dateien oder dem Setzen spezieller Auszeichnungen für die Steuerung der Anzeige in PARTadmin.

Für diese Fälle empfehlen wir die Verwendung von Windows Notepad oder bei höheren Ansprüchen an den Editor Notepad++. Verwenden Sie bitte in keinem Fall PSPad, da Fehler bei der Kodierung mit UTF8 auftreten, wodurch Dateien für PARTsolutions unlesbar werden.

Allgemeine Syntax der Tags

Es gibt verschiedene Typen von Auszeichnungen für Schlüssel wie Kurzinformation, Wertetypdefinitionen, Aktivierung/Deaktivierung und Steuerungselemente für die Benutzeroberfläche. Kurzbeschreibung und Steuerungselemente für die Benutzeroberfläche können auch für Blöcke eingesetzt werden.

Alle Tags beginnen mit “#:”, gefolgt vom Schlüsselwort des Tags und enden mit einem Semikolon.

	Hinweis
	TAGs sollten zwar zur Verbesserung der Usability verwendet werden, sind aber technisch nicht zwingend.

Die folgende Auflistung beschreibt TAGs zur Platzierung von Hilfetexten

HELP - Kurzinformation zu Schlüsseln und Blöcken

#:HELP;

Im Dialogbereich Kurzinformation [Short description] werden (sofern hinterlegt) Informationen zu Schlüsseln oder Blöcken angezeigt.

Beispiel:

#:HELP;Skizzen werden fixiert erzeugt und können nicht geändert werden.

Die Kurzbeschreibung [Short description] wird an dieser Stelle nur für die Default-Sprache angelegt.

	Hinweis
	Mit V11 wurde das Übersetzungsmanagement der Konfigurationsdateien jetzt durchgängig an den üblichen Standard angeglichen. Übersetzungen für alle von PARTsolutions unterstützten Sprachen können in def-Dateien hinterlegt werden. Details hierzu finden Sie unter Abschnitt 1.7.2.1, „Übersetzung der "Kurzinformation" “. Die Anzeige in PARTadmin erfolgt entsprechend der eingestellten $CADENAS_LANGUAGE. Aus Kompatibilitätsgründen wurde die sprachabhängige Eingabemöglichkeit innerhalb der Konfigurationsdatei belassen. Diese Angaben werden aber vom V11 ConfigEditor nicht ausgewertet. #:HELP;default;Hello #:HELP;german;Hallo #:HELP;english;Hello #:HELP;spanish;Ola

Um eine mehrzeilige Kurzinformation einzufügen, setzen Sie am Beginn der Folgezeilen das Raute-Symbol (#).

Beispiel:

#:HELP;This is the text of the first line.
# This is the next line,
# another line
# etc.

	Hinweis
	Zeilen, die beispielsweise mit einem Semikolon beginnen oder ohne gültigen Steuerungstag werden nicht in PARTadmin angezeigt.

CFGHELP - Kurzinformation zur Konfigurationsdatei

#:CFGHELP;

Hinweis

Setzen Sie diesen Tag am Ende der Konfigurationsdatei (wie auch #:VISFGUICFG falls vorhanden).

Welcher der beiden TAGs zuerst steht, ist egal. Wichtig ist nur, dass nach diesen Tags keine Blöcke oder Keys mehr folgen.

Beispiel:

#:CFGHELP;Hello

Um mehrzeilige Beschreibungstexte einzufügen, setzen Sie am Beginn der Folgezeilen das Raute-Symbol (#).

Beispiel:

#:CFGHELP;This is the text of the first line.
#This is the next line,
#another line,
#etc.

	Hinweis
	Zeilen, die beispielsweise mit einem Semikolon beginnen oder ohne gültigen Steuerungstag werden nicht in PARTadmin angezeigt.

	Hinweis
	Das Übersetzungsmanagement erfolgt analog wie oben unter CFGHELP beschrieben.

Die folgende Auflistung erläutert TAGs zur Spezifizierung von Wertebereichen

	Hinweis
	Wenn Wertebereiche nicht näher spezifiziert sind (also kein "VALS_" gesetzt wurde), wird intern "VALS_S" angenommen.

VALS_S - Alphanumerischer Schlüsselwert
- Keine Angabe von Werten
```
#:VALS_S;
```
  Erfolgt keine Angabe von Werten, dann ist freie Eingabe möglich.
- Einzelner Wert
```
#:VALS_S;<String>
```
- Liste von Werten
```
#:VALS_S;<String list> 
```
  Bei Verwendung von mehreren Werten, geben Sie diese separiert mit einem Komma an.
  Beispiel:
```
#:VALS_S;"YES","NO"
TOP_SEARCHPATH_SELECTION_CURRENT=YES
```
  Sind Werte vorgegeben, dann wird in der Benutzeroberfläche unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] ein Listenfeld angezeigt.
VALS_SE - Alphanumerischer Schlüsselwert mit Wertevorgabe + freier Eingabe
```
#:VALS_SE;
```
Verwenden Sie diesen Tag, wenn Sie unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] Werte vorgeben und zusätzlich die freie Eingabe von Werten erlauben möchten.
Beispiel:
```
VALS_SE;„eins“,“zwei“,“drei“
```
Der Benutzer kann nun auch beispielsweise „vier“ eingeben. Beim Tag "VALS_S" wäre dies nicht möglich.
VALS_N - Numerischer Schlüsselwert
- Keine Angabe von Werten
```
#:VALS_N;<numeric value>
```
  Erfolgt keine Angabe von Werten, dann ist unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] freie Eingabe möglich.
- Einzelner Wert
```
#:VALS_N;<String>
```
- Liste von Werten
```
#:VALS_N;<list of numeric values>
```
  Bei Verwendung von mehreren Werten, geben Sie diese separiert mit einem Komma an.
  Beispiel:
```
#:VALS_N;0,1,2
```
  Sind Werte vorgegeben, dann wird unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] ein Listenfeld angezeigt.
VALS_NE - Numerischer Schlüsselwert mit Wertevorgabe + freier Eingabe
```
#:VALS_NE;
```
Verwenden Sie diesen Tag, wenn Sie unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] Werte vorgeben und zusätzlich die freie Eingabe von Werten erlauben möchten.
Beispiel:
```
VALS_NE;1,2,3
```
Der Benutzer kann nun auch beispielsweise „4“ eingeben. Beim Tag "VALS_N" ist dies nicht möglich.
VALS_L - Listenfeldauswahl mit Auswahlkästchen
```
#:VALS_L;
```
Verwenden Sie diesen Tag, wenn Sie unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] eine Listenfeldauswahl mit Auswahlkästchen anzeigen möchten.
Beispiel:
```
#:VALS_L;1,2,3,4
```
oder
```
#:VALS_L;a,b,c,d
```
VALS_LE - Listenfeldauswahl mit Auswahlkästchen + freie Eingabe
```
#:VALS_LE;
```
Verwenden Sie diesen Tag, wenn Sie unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] eine Listenfeldauswahl mit Auswahlkästchen anzeigen und zusätzlich eine freie Eingabe ermöglichen möchten.
Beispiel:
```
#:VALS_LE;a,b,c
Key=a,b,c, extra_value
```
Der Benutzer kann mit dem Cursor ins Eingabefeld klicken und dort einen eigenen Eintrag setzen.
VALS_M - Gemappte Schlüsselwerte
Mit diesem Tag können Sie einen Wert oder eine Wertemenge auf einen anderen Wert oder eine andere Wertemenge mappen.
Unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] wird der gemappte Wert angezeigt. Der Anwender sieht so beispielsweise einen "sprechenden" Wert, intern wird mit numerischen Werten gearbeitet.
- Einzelner Wert gemappt
```
#:VALS_M;<value>;<mapped value>
```
- Wertemenge gemappt
```
#:VALS_M;<value>,<value>;<mapped value>,<mapped value>
```
Die Mapping-Partner werden durch Semikolon getrennt, einzelne Werte durch Komma.
Beispiel:
```
#:VALS_M;"0","1";"Load as part","Load as geometry" 
keyname2=0
```
Unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] erscheint eine Listenfeldauswahl.
VALS_R - Wertebereichsangabe
```
#:VALS_R;<from value> - <up to value>
```
Die Wertebereichsgrenzen sind getrennt mit einem Bindestrich “-“.
Bei diesem Typ ist eine Auflistung von einzelnen Werten nicht möglich.
Beispiel:
```
#:VALS_R; 0-10
DEBUGMODE=
```
Bei der Eingabe in PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] erfolgt eine Prüfung. Werteingaben außerhalb des Definitionsbereichs werden nicht zugelassen.
VALS_C - Korrekte Anzeige von Code-Phrasen
```
#:VALS_C;<code phrase>
```
Mit Hilfe dieses TAGs können Sie Code-Phrasen als Vorschlag einblenden in PARTadmin.
Bei den weiteren Zeilen ab der ersten stellen Sie "#" voran.
Die Vorschläge werden in einem Listenfeld angezeigt.
Beispiel:
```
#:VALS_C;0
#1
#any_vb_expression
CADOPTION=
```

Die folgende Auflistung erläutert TAGs zur allgemeinen Steuerung

INACTIVE - Schlüssel deaktivieren
```
#:INACTIVE;<name of key>
```
Wenn ein Schlüssel aktuell von Applikationen nicht ausgewertet werden soll, dann verwenden Sie diese Auszeichnung.
Stellen Sie dem Schlüssel den String #:INACTIVE; voran.
Beispiel:
```
#:INACTIVE;ShowInTable =no
```
Ist ein Schlüssel auf diese Weise ausgezeichnet, dann wird er unter PARTadmin -> Kategorie Konfigurationsdateien [Configuration files] als "inaktiv" angezeigt. Außerdem ist der Befehl Schlüssel aktivieren bzw. Schlüssel deaktivieren im Kontextmenü vorhanden, sodass der Status jederzeit umgeschaltet werden kann.
VISFGUI - Sichtbarkeit von Schlüsseln und Blöcken steuern
```
#:VISFGUI;<bool>
```
Mit diesem Tag steuern Sie die Sichtbarkeit von Schlüsseln oder Blöcken in der Benutzeroberfläche von PARTadmin:
Platzieren Sie den TAG in einer Zeile vor dem gewünschten Block oder Schlüssel.
- Sichtbar (Default)
```
#:VISFGUI;1
```
  Hinweis
  Soll der Defaultwert verwendet werden, dann muss diese Auszeichnung nicht explizit gesetzt werden.
- Nicht sichtbar
```
#:VISFGUI;0
```

VISFGUICFG - Sichtbarkeit von Konfigurationsdateien steuern

#:VISFGUICFG;<bool>

Mit diesem Tag steuern Sie die Sichtbarkeit einer Konfigurationsdatei in PARTadmin:

Hinweis

Platzieren Sie diesen Tag am Ende der Konfigurationsdatei (wie auch #:CFGHELP falls vorhanden).

Welcher der beiden TAGs zuerst steht, ist egal. Wichtig ist nur, dass nach diesen Tags keine Blöcke oder Keys mehr folgen.

Sichtbar (Default)
```
#:VISFGUICFG;1
```
Hinweis
Soll der Defaultwert verwendet werden, dann muss diese Auszeichnung nicht explizit gesetzt werden.
Nicht sichtbar
```
#:VISFGUICFG;0
```

SIMPLE - Wichtige Schlüssel auszeichnen zum Filtern
```
#:SIMPLE;<bool>
```
Mit diesem Tag sollten die Schlüssel ausgezeichnet werden, die in jedem Fall für einen ordnungsgemäßen Ablauf in PARTsolutions angepasst werden müssen.
In PARTadmin können so ausgezeichnete Schlüssel herausgefiltert werden.
Beispiel:
```
#:SIMPLE;1
poolpath(isCreaOptNotSet)=?_FORMAT_0("$CADENAS_DATA/pool/solidedge/<PREFIXLIST(/)>")....
```
Platzieren Sie den TAG in einer Zeile vor dem gewünschten Schlüssel.
- Standard-Sortierung in PARTadmin (Default)
```
#:SIMPLE;0
```
  Hinweis
  Soll der Defaultwert verwendet werden, dann muss diese Auszeichnung nicht explizit gesetzt werden.
- Filtern mit Option Nur wichtige Schlüssel [Only important keys] möglich in PARTadmin
```
#:SIMPLE;1
```

Ein paar Beispiele

#:VALS_S 
#:HELP;CheckOut Folder for Native Parts 
#:SIMPLE;1 
NativeCheckoutTargetFolder=?Application.ResolveEnv("%CADENAS_DATA%\\pool\\catia")

#:VALS_S 
#:HELP;Submenu - Tools - Activate the command that should be loaded at startup 
 and set the value on "Yes". 
If a key is disabled the code and command will not be available in CATIA. See manual.
#:INACTIVE;COMMAND_SHOW_PSOLNCScan=no

#:VALS_S 
#:VISFGUI;0 
#:INACTIVE;MetaObjectVersion=""

Ältere Tags

Es gibt noch ältere Tags in Konfigurationsdateien. Aus Gründen des Versionsmanagement verbleiben diese Tags. Bitte verwenden Sie diese aber nicht mehr für neue Auszeichnungen.

Ältere Auszeichnungen sind:

#:NAME;
#:LNAME;
#:DESC;
#:TOOLTIP;
#:SAMPLE;

Besondere Tags unter $CADENAS_DEFAULTUSER

TAG	Beschreibung
#!	Der Tag entspricht dem Kontextmenübefehl Immer überschreiben [Overwrite always] unter PARTadmin -> Konfigurationsdateien [Configuration files] auf Schlüsselebene: Gelbe Hintergrundfarbe Der Schlüsselwert in $CADENAS_USER wird bei jedem Laden der Anwendung erneut überschrieben. Der Tag entspricht dem Kontextmenübefehl Überschreiben [Overwrite] unter PARTadmin -> Konfigurationsdateien [Configuration files] auf Blockebene. Gleiche Blöcke aus $CADENAS_DEFAULTUSER und $CADENAS_USER werden komplett überschrieben.
#-	Der Tag entspricht dem Kontextmenübefehl Löschen [Delete] unter PARTadmin -> Konfigurationsdateien [Configuration files] auf Schlüsselebene: Rote Hintergrundfarbe
#~	Der Tag entspricht dem Kontextmenübefehl Nicht mergen [Do not merge] unter PARTadmin -> Konfigurationsdateien [Configuration files] auf Blockebene. Gleiche Blöcke aus $CADENAS_DEFAULTUSER und $CADENAS_USER werden nicht gemerged.

Zurück	Nach oben	Weiter
1.7.1.4.5. Zusatzfunktion bei aktiviertem $CADENAS_SITESETUP	Zum Anfang	1.7.2.1. Übersetzung der "Kurzinformation"