Zähler

Zähler

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

Beschreibung

Über Zähler werden alle im System verwendeten Nummernkreise (Zählwerke) gepflegt. Zählwerke werden für Stammdaten (Kunden, Sachkonten, Teile, usw.) und Belege (Rechnungen, Aufträge, Bestellungen, usw.) benötigt, um eine fortlaufende Nummerierung vorzugeben. Die Formatierung der Nummer (z.B. ob mit oder ohne führende Nullen) wird im Zähler ebenfalls bestimmt.

Im Regelfall ist der Name des Zählers gleich dem Klassennamen des zu nummerierenden Objekts (z.B. CX_CUSTOMER für den Kundennummern Zähler).

Das Zählwerk eines Zähler kann auf das Zählwerk eines anderen Zählers delegiert werden. Dieses wird z.B. dann eingesetzt, wenn der Nummernkreis für Ausgangsrechnungen wie auch Ausgangsgutschriften derselbe sein soll. In diesem Fall wird der Zähler für Ausgangsgutschriften (CX_CREDIT_NOTE) auf den Zähler für Ausgangsrechnungen (CX_INVOICE) delegiert. Über eine bedingte Tabelle kann man ein Zählwerk auch auf mehrere andere Zähler verteilen, z.B. wenn bei Aufträgen der Nummernkreis in Abhängigkeit der Auftragsart verschieden sein soll.

Sollen zu Beginn eines Geschäftsjahres die Zähler für z.B. Ausgangsrechnungen zurückgesetzt werden, kann man - gesteuert über die Gültigkeit - für jedes Geschäftsjahr einen eigenen Zähler anlegen (kopieren). So wäre dann z.B. der Zähler "CX_INVOICE" für Ausgangsrechnungen mehrfach vorhanden, jeweils versehen mit einer auf das Geschäftsjahr bezogenen Gültigkeit. Zu beachten ist hierbei, dass die Zählnummer das Jahr des Geschäftsjahres mit beinhalten sollte, um doppelte Nummern zu vermeiden.

Funktionalität

• Eingabefenster
• Listenfenster
• Selektionsfenster
• Formatierung Testen
• Nummernbereich durchsuchen
• Nummernbereich manuell bearbeiten

Eingabefenster

Dieses Fenster dient der Pflege von Zählern. Sie können einen Zähler auswählen, in dem Sie im Feld Name den gewünschten Zählernamen eingeben und mit RETURN bestätigen. Wenn Sie das Listenfenster aufrufen wollen, dann können Sie den Menüpunkt "Suchen" auswählen.

Es können per ´Delegation´ auch mehrere Nummernkreise zusammengefasst werden. Ferner kann die Anzeige Ihrer Nummernkreise auch mit einer Formatangabe erfolgen, um zum Beispiel führende Nullen oder ähnliches festzulegen. Dadurch können ggf. zukünftig erforderliche Umstellungen des Formats zentral und daher mit nur geringem Aufwand erfolgen. Im Feld ´Steuerzeichen´ geben Sie die Formatierung des jeweiligen Nummernkreises vor (im Beispiel: sechs numerische Stellen) und im Feld ´Fester Text´ wird geregelt, wie die Nummer in den Eingabefeldern angezeigt wird (im Beispiel: sechsstellig, numerisch mit führenden Nullen).

Menü

Menüpunkt	Beschreibung
Bearbeiten	-
: Zähler kopieren	Der im Eingabefenster angezeigte Zähler wird kopiert. Werden mehrere Zähler mit gleichem Namen (bei unterschiedlicher Gültigkeit!) angelegt, so muss darauf geachtet werden, dass ein eventuell angelegter Index CX_COUNTER::uniqueID Duplikate zulässt. Delegiert der zu kopierende Zähler sein Zählwerk, so wird auch diese Information kopiert und muss eventuell angepasst werden
: Formatierung testen	Formatierung des Zählers testen: diese Auswahl kann nur dann getroffen werden, wenn die Formatierung des Zählers aktiviert ist
: Nummernbereich durchsuchen	Für einen eingegebenen Nummernbereich kann man feststellen lassen, ob Objekte mit dieser Nummer im System gespeichert sind
: Delegierung
: : Bedingte Delegierung erstellen	Die Delegierung an einen anderen Zähler wird umgestellt auf eine bedingte Tabelle
: : Bedingte Tabelle
: : : Zähler einfügen	Es können Zähler selektiert werden, die in die bedingte Tabelle übertragen werden. Anschließend müssen die Bedingungen gepflegt werden, unter der jeder Zähler gelten soll
: : : Zähler entfernen	Die selektierten Einträge der bedingten Tabelle werden entfernt
: : : Bearbeiten Spalten	Die Spalten der bedingten Tabelle können bearbeitet werden
: : Bedingte Delegierung entfernen	Die Tabelle mit den bedingten Zählern wird entfernt
: Schließen	Fenster schließen
Suchen	Listenfenster aufrufen

 

Toolbar

Symbol	Beschreibung
	Neuen Zähler anlegen
	Änderungen speichern
	Zähler löschen
	Zähler drucken
	Gültigkeit festlegen
	Formatierung des Zählers testen (dieser Knopf ist nur dann sichtbar, wenn die Formatierung des Zählers aktiviert ist)

 

Felder

Feld	Beschreibung
Name	Identifikation des Zählers
Beschreibung	Zusätzliche, beschreibende Informationen zum Zähler
Formatierung	-
: Deaktiviert	Ist dieses Feld ausgewählt, ist die Formatierung der Eingabe-/Suchfelder der zum Zählwerk zugehörigen Nummer generell ausgeschaltet und die weiteren Felder dieser Eingabegruppe sind ausgeblendet. Es findet dann nur eine Standard-Vorformatierung statt (meist "000000"). Ist das Zählwerk an einen anderen Zähler delegiert, so ist dennoch die Formatierung davon nicht betroffen
: Steuerzeichen	Das Steuerzeichen gibt an welche Zeichen aus der Eingabe in den Fenster Text übernommen werden; siehe auch FString
: Fester Text	Der Fenster Text bestimmt wie die übernommenen Zeichen im Ausgabefeld dargestellt werden; siehe auch FString
Zählwerk	-
: Deaktiviert	Ist dieses Feld ausgewählt, ist das Zählwerk generell ausgeschaltet und die weiteren Felder dieser Eingabegruppe sind ausgeblendet
: Delegiert an	Auswahl des Zählers, dessen Zählwerk mit verwendet werden soll. Sollen z.B. (Ausgangs-)Rechungen und Gutschriften über einen gemeinsamen Nummernkreis laufen, dann sollte der Zähler für Gutschriften (CX_CREDIT_NOTE) auf den Zähler der Rechnungen (CX_INVOICE) verweisen. Ist das Zählwerk an einen anderen Zähler delegiert, sind die Felder "Letzte Nummer" und "Schrittweite" ausgeblendet. Sind die Zähler im System Domänen übergreifend definiert, kann auch an einen Zähler einer anderen Domäne delegiert werden. Um einen Zähler einer anderen Domäne auswählen zu können, kann die Anzeige der Liste entsprechend eingestellt werden
: Letzte Nummer	Letzte vom Zählwerk vergebene Nummer
: Schrittweite	Schrittweite zum Hochzählen des Zählwerks

 

Knöpfe

Knopf	Beschreibung
OK	Änderungen am .Zähler werden gespeichert. Wenn keine Änderungen getätigt wurden ist der Knopf gesperrt.
Neu	Das Eingabefenster wird geleert.
Löschen	Der angezeigte Zähler wird gelöscht.
Schließen	Das Fenster wird geschlossen, ohne Änderungen zu speichern. Wenn Sie die Änderungen sichern wollen, so müssen Sie den Knopf "OK" drücken.

Listenfenster

Dient der Auflistung der Zähler.

Menü

Menüpunkt	Beschreibung
Bearbeiten	-
: Datenaustausch	-
: : Export	Zähler in Datei exportieren
: : Import	Zähler aus Datei importieren
: Zähler aller Domänen anzeigen	Sollten die Zähler nach Domänen getrennt definiert sein, können mit dieser Menüauswahl die Zähler aller Domänen angelistet werden. Dieses kann z.B. dann notwendig sein, wenn der Zähler aus einer Domäne in den Zähler einer anderen Domäne delegieren soll (Domänen übergreifende Zähler)
: Domänen übergreifende Anzeige zurücksetzen	Es werden nur noch die Zähler angezeigt, die in der gerade angemeldeten Domäne definiert sind
: Schließen	Fenster schließen

 

Toolbar

Symbol	Beschreibung
	Neuen Zähler anlegen
	Den in der Liste selektierten Zähler bearbeiten
	Den in der Liste selektierten Zähler löschen
	Den in der Liste selektierten Zähler drucken
	Gültigkeit für den in der Liste selektierten Zähler festlegen
	Alle Objekte der Liste in die Zwischenablage kopieren

 

Knöpfe

Knopf	Beschreibung
Bearbeiten	Der aktuelle Zähler wird im Eingabefenster angezeigt.
Neu	Ein leeres Eingabefenster wird geöffnet.
Löschen	Der ausgewählte Zähler wird gelöscht.
Schließen	Das Fenster wird geschlossen.

Selektionsfenster

Dieses Fenster dient der Selektion eines Zählers.

Knöpfe

Knopf	Beschreibung
OK	Der selektierte Zähler wird übernommen.
Schließen	Die Selektion wird abgebrochen.

Formatierung Testen

In diesem Fenster kann man die Formatierung eines Zählers testen.

Felder

Feld	Beschreibung
Steuerzeichen	s. FString Anweisung
Fester Text	s. FString Anweisung
Eingabefeld	Die hier eingegebenen Zeichen werden gemäß der in den Feldern "Steuerzeichen" und "Fester Text" gemachten Angaben formatiert angezeigt.
Ausgabedatum	Gemäß der Formatangaben des Zählers kann das Eingabefeld sich anders darstellen, als die Daten, die letztlich aus dem Eingabefeld intern gelesen werden.

 

Knöpfe

Knopf	Beschreibung
Speichern	Die Angaben aus den Feldern "Steuerzeichen" und "Fester Text" werden in die entsprechenden Formatierungsfelder des Zählers übernommen.

Nummernbereich durchsuchen

In diesem Fenster kann man mittels Eingabe eines Nummernbereichs sich die dazugehörigen Objekte anzeigen lassen. Man kann so sehr schnell feststellen, wie viele und welche Objekte sich in welchen Nummernkreisen befinden. Die Suche erstreckt sich über die im Feld "Klasse" angegebenen Stammliste der Objekte (REP collection) oder - falls dort nichts angegeben ist -  wird der Klassenname dem Namen des ausgewählten Zählers entnommen. Wird kein "Datenfeld" angegeben, wird das Feld "uniqueID" genommen. Insbesondere dient diese Suche auch dazu, sich eventuelle Lücken im angegebenen Nummernkreis anzeigen zu lassen.

Felder

Feld	Beschreibung
Klasse	Zuordnung des Zählers zur Stammliste der hier angegebenen Klasse. Wird keine Klasse angegeben, wird der Name der Klasse dem Namen des Zählers entnommen.
Datenfeld	Zuordnung des Zählers zu einem Datenfeld innerhalb der Stammliste der angegebenen Klasse. Wird kein Datenfeld angegeben, wird "uniqueID" als Datenfeld genommen.
Ab Nummer	Die Suche nach Objekten startet ab dieser eingegebenen Nummer (größer gleich).
Bis Nummer	Die Suche nach Objekten erstreckt sich bis zu dieser eingegebenen Nummer (kleiner gleich).

 

Knöpfe

Knopf	Beschreibung
Durchsuchen	Der angegebene Nummernbereich wird mittels des angebenene Datenfelds in der angegeben Klasse nach Lücken durchsucht. Eventuell gefundene Lücken im aufgerufenen Nummernkreis werden in der unteren Liste angezeigt. Auch kann man am Ende des Suchens sich alle  innerhalb des aufgerufenen Nummerkreises gefundenden Objekte anlisten lassen.

Nummernbereich manuell bearbeiten

Ein Zähler Objekt dient - wie der Name auch sagt - zum automatischen Hochzählen von z.B. Auftrags-oder Rechnungsnummern. Auch kann über ein Zähler Objekt die Formattierung von Nummernfeldern vorgenommen. Es kommt häufig auch vor, dass man Nummernkreise manuell verwalten möchte, da diese extern vergeben und verabeitet werden (z.B. fremd vergebene Inventarnummern). Um sich auch über solche Nummernkreise einen Überblick verschaffen zu können, kann man diese "Reservierungen" hier verwalten.

Felder

Feld	Beschreibung
Ab Nummer	Nummer, ab der ein Bereich reserviert werden soll. Die höchste bereits reservierte Nummer kann man sich mittels des rechts neben diesem Feld befindlichen Knopfes holen.
Anzahl	Anzahl an zu reservierenden Nummern.
Bis Nummer	Aus der Eingabe im Feld "Ab Nummer" und der eingegebenen "Anzahl", wird  zu Kontrollzwecken die letzte zu reservierende Nummer ausgegeben.
Bemerkung	Freie Texteingabe zur Beschreibung der vorgenommenen Reservierung.

 

Knöpfe

Knopf	Beschreibung
Reservieren	Es wird ein weiterer Nummernkreis reserviert. Sollte sich diese neue Reservierung mit einer bereits vorhandenen Reservierung überlappen, wird der Vorgang mit einer Fehlermeldung abgebrochen.

Verwandte Themen

• Index

 

---

Technische Dokumentation

• Übersicht
• Implementation
• Qualitätssicherung

• Zähler Basismodul
  • Zähler Editiermodul
  • Zähler Selektionsmodul

Übersicht

 

Zähler Basismodul

Modulname

counter.mod

Klassen

CX_COUNTER

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
COUNTER_CHANGED	Zähler-Objekt	Zähler wurde geändert
COUNTER_CREATED	Zähler-Objekt	Zähler wurde erzeugt
COUNTER_DELETED	Zähler-Objekt	Zähler wurde gelöscht

 

 

Gesendete Messages

Message	Parameter	Funktion	Empfangs-Modul
EDIT_COUNTER	NULL oder Zähler-Objekt	Eingabefenster für Zähler aufrufen	Zähler-Editiermodul

 

Zähler Editiermodul

Modulname

countedt.mod

Klassen

CX_COUNTER

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
COUNTER_CHANGED	Zähler-Objekt	Zähler wurde geändert
COUNTER_CREATED	Zähler-Objekt	Zähler wurde erzeugt
COUNTER_DELETED	Zähler-Objekt	Zähler wurde gelöscht
EDIT_COUNTER	NULL oder Zähler-Objekt	Eingabefenster für Zähler aufrufen
LIST_COUNTER	Collection Zähler-Objekte oder NULL	Listenfenster für Zähler aufrufen
LOAD_COUNTER		Zähler importieren

 

 

Gesendete Messages

Message	Parameter	Funktion	Empfangs-Modul
COUNTER_CHANGED	Zähler-Objekt	Zähler wurde verändert
COUNTER_CREATED	Zähler-Objekt	Zähler wurde erzeugt
EDIT_COUNTER	NULL oder Zähler-Objekt	Eingabefenster für Zähler aufrufen	Zähler-Editiermodul
LIST_COUNTER		Listenfenster für Zähler aufrufen	Zähler-Editiermodul
SHOW_PREVIEW	Widget	Druckvorschau	Druckvorschau

 

Zähler Selektionsmodul

Modulname

countsel.mod

Klassen

CX_COUNTER

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
COUNTER_CHANGED	Zähler-Objekt	Zähler wurde geändert
COUNTER_CREATED	Zähler-Objekt	Zähler wurde erzeugt
COUNTER_DELETED	Zähler-Objekt	Zähler wurde gelöscht
SELECT_COUNTER	Collection Zähler-Objekte oder NULL, Empfänger der Antwort	Selektionsfenster für Zähler aufrufen

 

 

Gesendete Messages

Message	Parameter	Funktion	Empfangs-Modul
COUNTER_SELECTED	Zähler-Objekt, Empfänger	Zähler wurde selektiert
EDIT_COUNTER	NULL oder Zähler-Objekt	Eingabefenster für Zähler aufrufen	Zähler-Editiermodul