Aufzählung

• Beschreibung
• Funktionalität
• Verwandte Themen
• Technische Dokumentation

Beschreibung

In diesem Modul kann man transiente Aufzählungen, d.h. Aufzählungen die beim Hochfahren des ClassiX^®-Systems aus den *.INI- oder *.NUM-Dateien geladen werden, persistent machen, d.h. in der Datenbank speichern.

Dies sollte man aber nur mit kundenspezifischen Aufzählungen machen, d.h. Aufzählungen aus einer PROJEKT.NUM-Datei, nicht mit den ClassiX^®-System eigenen Aufzählungen aus der Datei CLASSIX.NUM.

Wenn eine transiente Aufzählung persistent gemacht wird, so wird dies beim erneuten Hochfahren des ClassiX^®-Systems überprüft und die persistente Aufzählung hat Vorrang. Sie wird nie von ihrer anfänglichen transienten Aufzählung überschrieben.
Nachdem man eine Aufzählung persistent gemacht kann man sie auch direkt im Eingabefenster pflegen, dies ist bei transienten Aufzählungen nicht möglich da sie beim nächsten Hochfahren des ClassiX^®-System neu aus den *.NUM-Dateien geladen werden. Änderungen an persistenten Aufzählungen werden nur in der Datenbank gespeichert. Falls diese Aufzählung anfänglich aus einer *.NUM-Datei kam, so wird diese neue persistente Änderung nicht in der *.NUM-Datei gespeichert. Dort verbleiben die originalen Daten.
Wenn man eine persistente Aufzählung, welche anfänglich transient war, löscht oder etwa ihren Namen ändert, so wird beim nächsten Hochfahren des ClassiX^®-Systems die transiente Aufzählung geladen, da keine persistente Aufzählung mit dem gleichen Namen existiert. Der für das ClassiX^®-System gültige Name ist der komplette in der ersten Spalte des Listenfensters angezeigt Name, also z.B. "classix.num~countryCode".

Mehr Information über die Benutzung von Aufzählungen bei Sachmerkmalen bekommen Sie im Topic Sachmerkmale.

Funktionalität

• Eingabefenster
• Listenfenster
• Selektionsfenster
• Prüfen Aufzählung auf doppelte Einträge

Eingabefenster

Dieses Fenster dient der Pflege von persistenten Aufzählungen. Transiente Aufzählungen kann man nur visualisieren. Wenn Sie das Listenfenster aufrufen wollen, dann können Sie den Menüpunkt "Suchen" auswählen. Zur Erstellung einer neuen persistenten Aufzählung muss man zuerst ihren Namen eingeben, dann durch Drücken des OK-Knopfes bestätigen. Dieser Name muss eindeutig innerhalb aller persistenten Aufzählungen sein. Falls schon eine transiente Aufzählung mit dem gleichen Namen existiert, so wird jetzt die neue persistente Aufzählung gültig.
Als nächsten Schritt kann man die einzelnen Einträge eingeben bzw. editieren. Dazu drückt man einfach den Knopf Einfügen, dann wird ein neuer Eintrag schon in die Aufzählung eingefügt und man muss nur noch einen Wert eingeben, den deutschen und englischen Text und die binäre Maske. Sowohl der Wert als auch die beiden Texte müssen eindeutig sein. Auch mehrere leere Texte bei verschiedenen Einträgen für die gleiche Sprache sind nicht erlaubt, da eine evtl. Auswahl nicht mehr eindeutig wäre. Im Zweifelsfall würde der am weitesten oben eingeordnete Eintrag ausgegeben bzw. gespeichert werden.
Standardmäßig kriegt man als ersten Wert eine 1 und ihre Folgewerte werden einfach automatisch hochgezählt bei den nächsten Einträgen. Man kann aber natürlich auch eigene beliebige Werte eingeben, aber auch diese müssen eindeutig sein. Die Anzeige dieser Aufzählungseinträge bei späterer Benutzung wird weder über diese Werte noch über die Texte sortiert, sondern über die auch hier angezeigte Reihenfolge der Einträge innerhalb der Aufzählung, d.h. die visuelle Anordnung im Fenster.

Menü

Menüpunkt	Beschreibung
Bearbeiten	-
: Neue Aufzählung anlegen	Neue Aufzählung anlegen
: Aufzählung speichern	Die Änderungen in der geöffneten Aufzählung werden gespeichert.
: Aufzählung löschen	Die geöffnete Aufzählung wird ohne Nachfrage gelöscht.
: Notizen	Für die geöffnete Aufzählung wird das Bearbeitungsfenster für Notizen geöffnet
: Schließen	Fenster schließen
Suchen	Listenfenster aufrufen

Toolbar

Symbol	Beschreibung
	Neue Aufzählung anlegen
	Änderungen speichern
	Aufzählung löschen
	Notizen anlegen/bearbeiten

Felder

Feld	Beschreibung
Name	Name der Aufzählung
Einträge	Auflistung der möglichen Werte

Knöpfe

Knopf	Beschreibung
Einträge
Einfügen	Ein neuer leerer Eintrag wird eingefügt. Dieser Button ist nicht vorhanden, wenn es neben der persistenten Aufzählung auch eine transiente Aufzählung mit dem selben Namen gibt.
Löschen	Selektierter Eintrag wird gelöscht
Aktion
Zurück	Das Fenster wird geschlossen, ohne Änderungen zu speichern. Wenn Sie die Änderungen sichern wollen, so müssen Sie den Knopf "Speichern" drücken.
Löschen	Die angezeigte Aufzählung wird gelöscht.
Neu	Das Eingabefenster wird geleert.
Speichern	Änderungen an der Aufzählung werden gespeichert. Wenn keine Änderungen getätigt wurden ist der Knopf gesperrt.

 

Listenfenster

Dient der Auflistung der Aufzählungen.

Menü

Menüpunkt	Beschreibung
Bearbeiten	-
: Suchen	-
: : Mehrfach Suche ausführen	Mehrfachsuche ausführen: Alle blau markierten Felder werden bei dieser Suche berücksichtigt. Mit der Mehrfachsuche ist es möglich nach mehreren Kriterien gleichzeitig zu suchen.
: : Liste zurücksetzen	Aufzählungsliste zurücksetzen
: Neue Aufzählung anlegen	Neue Aufzählung anlegen. Wenn eine transiente Aufzählung in der Liste ausgewählt ist und es existiert dafür noch keine Aufzählung in der Datenbank, fragt das System nach, ob Sie die Daten der Aufzählung übernehmen wollen. Dadurch ist das Erstellen einer Kopie in der Datenbank vereinfacht möglich.
: Aufzählung bearbeiten	Die ausgewählte Aufzählung wird im Eingabefenster geöffnet.
: Aufzählung löschen	Ein oder mehrere selektierte Aufzählungen werden ohne Nachfrage gelöscht.
: Aufzählung drucken	Öffnet das Druckerauswahlfenster
: Aufzählungen anzeigen	-
: : interne Aufzählungen anzeigen, transiente & persistente	Die momentanen System-Aufzählungen werden transient angezeigt. Sie können nicht editiert werden.
: : externe Aufzählungen anzeigen, transiente	Eine Datei mit dem üblichen *.NUM-Dateiformat kann eingelesen werden und ihre transienten Aufzählungen können angezeigt werden.
: Prüfen Aufzählungen auf doppelte Einträge	Doppelte Einträge anzeigen
: Notizen	Für die selektierte Aufzählung wird das Bearbeitungsfenster für Notizen geöffnet
: Schließen	Fenster schließen

Toolbar

Symbol	Beschreibung
	Mehrfachsuche ausführen: Alle blau markierten Felder werden bei dieser Suche berücksichtigt. Mit der Mehrfachsuche ist es möglich nach mehreren Kriterien gleichzeitig zu suchen.
	Aufzählungsliste zurücksetzen
	siehe Menü.
	Aufzählung bearbeiten
	Aufzählung löschen
	Aufzählung drucken
	Notizen anlegen/bearbeiten

Suchfelder

Feld	Beschreibung
Name	Eingabe des Namens der zu suchenden Aufzählung

Knöpfe

Knopf	Beschreibung
Filter
Suchen	Mehrfachsuche ausführen: Alle blau markierten Felder werden bei dieser Suche berücksichtigt. Mit der Mehrfachsuche ist es möglich nach mehreren Kriterien gleichzeitig zu suchen.
Liste
Erweiterte Suche	Erweiterte Suche aufrufen
Aktion
Zurück	Das Fenster wird geschlossen.
Löschen	Die ausgewählte Aufzählung wird gelöscht.
Neu	Ein leeres Eingabefenster wird geöffnet.
Bearbeiten	Die aktuelle Aufzählung wird im Eingabefenster angezeigt.

 

Selektionsfenster

Dieses Fenster dient der Selektion einer Aufzählung.

Menü

Menüpunkt	Beschreibung
Bearbeiten	-
: Suchen	-
: : Mehrfach Suche ausführen	Mehrfachsuche ausführen: Alle blau markierten Felder werden bei dieser Suche berücksichtigt. Mit der Mehrfachsuche ist es möglich nach mehreren Kriterien gleichzeitig zu suchen.
: : Liste zurücksetzen	Aufzählungsliste zurücksetzen
: Schließen	Fenster schließen

Toolbar

Symbol	Beschreibung
	Mehrfachsuche ausführen: Alle blau markierten Felder werden bei dieser Suche berücksichtigt. Mit der Mehrfachsuche ist es möglich nach mehreren Kriterien gleichzeitig zu suchen.
	Aufzählungsliste zurücksetzen

Suchfelder

Feld	Beschreibung
Name	Eingabe des Namens der zu suchenden Aufzählung

Knöpfe

Knopf	Beschreibung
Filter
Suchen	Mehrfachsuche ausführen: Alle blau markierten Felder werden bei dieser Suche berücksichtigt. Mit der Mehrfachsuche ist es möglich nach mehreren Kriterien gleichzeitig zu suchen.
Liste
Erweiterte Suche	Erweiterte Suche aufrufen
Aktion
Zurück	Die Selektion wird abgebrochen.
Auswählen	Die selektierte Aufzählung wird übernommen.

 

Prüfen Aufzählungen auf doppelte Einträge

Felder

Feld	Beschreibung
Liste	Auflistung der Aufzählungen mit doppelten Einträgen
Liste	Auflistung der Einträge der selektierten Aufzählung

 

Verwandte Themen

• Index

 

---

Technische Dokumentation

• Implementation
• Qualitätssicherung
• Aufzählung Providermodul
  • Aufzählung Editier-App
  • Aufzählung Listen-App
  • Aufzählung Selektions-App

Aufzählung Providermodul

Modulname

cxEnumTable.mod

Klassen

CX_ENUM_TABLE

Security

Neben der Beschränkung der Zugriffsrechte über die Klasse und deren Datenfelder kann das Modul über einige der empfangenen Messages in seiner Nutzung beschränkt werden.

Empfangene Messages

Message	Parameter	Funktion	Security
ENUM_TABLE_CHANGED	Aufzählungs-Objekt	Aufzählung wurde geändert
ENUM_TABLE_CREATED	Aufzählungs-Objekt	Aufzählung wurde erzeugt
ENUM_TABLE_DELETED	Aufzählungs-Objekt	Aufzählung wurde gelöscht

 

Gesendete Messages

Message	Parameter	Funktion	Empfangs-Modul
EDIT_ENUM_TABLE	NULL oder Aufzählungs-Objekt	Eingabefenster für Aufzählung aufrufen	Aufzählung-Editier-App

 

Aufzählung Editier-App

Modulname

enumTableEdit.app

Klassen

CX_ENUM_TABLE
CX_ENUM_ENTRY

Empfangene Messages

Message	Parameter	Funktion	Security
ENUM_TABLE_CHANGED	Aufzählungs-Objekt	Aufzählung wurde geändert
ENUM_TABLE_CREATED	Aufzählungs-Objekt	Aufzählung wurde erzeugt
ENUM_TABLE_DELETED	Aufzählungs-Objekt	Aufzählung wurde gelöscht
EDIT_ENUM_TABLE	NULL oder Aufzählungs-Objekt	Eingabefenster für Aufzählung aufrufen
LOAD_ENUM_TABLE		Aufzählung importieren
EDIT_COMBO_TABLE	Aufzählungs-Objekt, siehe attrsedt.mod	Eingabefenster für Aufzählung aufrufen

 

Gesendete Messages

Message	Parameter	Funktion	Empfangs-Modul
ENUM_TABLE_CHANGED	Aufzählungs-Objekt	Aufzählung wurde verändert
ENUM_TABLE_CREATED	Aufzählungs-Objekt	Aufzählung wurde erzeugt
ENUM_TABLE_DELETED	Aufzählungs-Objekt	Aufzählung wurde gelöscht
EDIT_COMMENT	[Fenstertitel], Objekt	Eingabefenster für Kommentar aufrufen	Kommentar-Editiermodul
EDIT_ENUM_TABLE	NULL oder Aufzählungs-Objekt	Eingabefenster für Aufzählung aufrufen	Aufzählungs-Editier-App
LIST_ENUM_TABLE		Listenfenster für Aufzählung aufrufen	Aufzählungs-Listen-App
SHOW_PREVIEW		Druckvorschau

 

Aufzählung Listen-App

Modulname

enumTableList.app

Klassen

CX_ENUM_TABLE

Security

Neben der Beschränkung der Zugriffsrechte über die Klasse und deren Datenfelder kann das Modul über einige der empfangenen Messages in seiner Nutzung beschränkt werden.

Empfangene Messages

Message	Parameter	Funktion	Security
LIST_ENUM_TABLE	Collection Aufzählungs-Objekte oder NULL	Listenfenster für Aufzählung aufrufen

 

Gesendete Messages

Message	Parameter	Funktion	Empfangs-Modul
EDIT_ENUM_TABLE	NULL oder Aufzählungs-Objekt	Eingabefenster für Aufzählung aufrufen	Aufzählungs-Editier-App

 

Aufzählung Selektions-App

Modulname

enumTableSelect.app

Klassen

CX_ENUM_TABLE

Security

Neben der Beschränkung der Zugriffsrechte über die Klasse und deren Datenfelder kann das Modul über einige der empfangenen Messages in seiner Nutzung beschränkt werden.

Empfangene Messages

Message	Parameter	Funktion	Security
SELECT_ENUM_TABLE	Collection Aufzählungs-Objekte oder NULL, Empfänger der Antwort	Selektionsfenster für Aufzählung aufrufen

 

Gesendete Messages

Message	Parameter	Funktion	Empfangs-Modul
ENUM_TABLE_SELECTED	Aufzählungs-Objekt, Empfänger	Aufzählung wurde selektiert