In dieser Dokumentation werden die Vorgehensweisen für den Umgang mit der Anwendung „Daten importieren“ bezogen auf Nummernkreise beschrieben. Diese Vorgehensweise enthält allgemeine Anleitungsschritte und Sie werden außerdem über mögliche Voraussetzungen und Auswirkungen informiert.
Die Beschreibung der Anwendung „Daten importieren“, die unter anderem auch Feld- und Button-Beschreibungen enthält, finden Sie in der Dokumentation „Daten importieren“.
1 Begriffsbestimmungen
Nummernkreis
Im Nummernkreis wird die Nummernvergabe für Belege definiert. Die Belegnummer und die Belegart identifizieren einen Beleg eindeutig. Die Nummernkreise definieren neben der Vergabe der Belegnummer auch die Vergabe der Beleg-Positionsnummer.
2 Vorgehensweisen
Dieser Abschnitt beschreibt die Vorgehensweisen beim Import von Nummernkreisen.
2.1 Daten importieren
- Öffnen Sie die Anwendung „Daten importieren“.
- Lassen Sie sich den bzw. einen Filter für das Business Entity cisag.app.general.obj.NumberRange anzeigen.
- Der Filter für den Import der Daten wird angezeigt.
- Die ausgewählten Attribute des Filters sind bereits markiert. Bei Bedarf können Sie die Attribute noch anpassen.
- Drücken Sie in der Standard-Symbolleiste den Button „Daten importieren“.
- Das Dialog-Fenster „Daten importieren“ wird geöffnet.
- In diesem Fenster können Sie Einstellungen für die Importdatei vornehmen. Eine ausführliche Beschreibung der Felder finden Sie in der Dokumentation „Daten importieren“ im gleichnamigen Abschnitt.
- Durch Drücken des Buttons „Im Hintergrund“ oder „Sofort“ können Sie den Import durchführen.
Hinweis:
Beim Import von Daten ist die Option „Verarbeitung im Hintergrund“ nur für voneinander unabhängige Daten empfohlen.
2.2 Neuanlage
Für die Neuanlage eines Nummernkreises müssen sowohl das Identifikationsattribut als auch alle Pflichtfelder aufgeführt werden.
Ohne das Identifikationsattribut kann kein Nummernkreis importiert werden. Sind die Daten fehlerhaft, wird in dem Fall, dass im Dialog-Fenster „Daten importieren“ die Auswahl „Mit Korrektur-Anwendung korrigieren“ getroffen wurde, die Anwendung „Nummernkreise“ gestartet.
Hinweis:
Wir die Anwendung „Nummernkreise“ im Korrekturmodus geöffnet, so sind einige Felder, z.B. die Checkbox „Interne Nummer“, editierbar, die normalerweise nicht editierbar sind. Änderungen sind nur möglich, wenn keine Prüfung dies verhindert.
Die Pflichtfelder und das Identifikationsattribut sind in der folgenden Tabelle aufgeführt.
| Attributpfad | Bezeichnung | Bemerkung |
| code | Identifikation | |
| description | Bezeichnung | |
| type | Typ | |
| length | Nummernlänge | |
| startValue | Start (Zählung) | |
| increment | Erhöhung (Zählung) | |
| endValue | Ende (Zählung) | |
| detailStartValue | Start (Positionszählung) | Nur Pflichtfeld, falls der Typ des Nummernkreises einen Beleg bezeichnet, der eine Positionsnummerierung verlangt. |
| detailIncrement | Erhöhung (Positionszählung) | |
| detailEndValue | Ende (Positionszählung) |
Hinweis:
Das Feld „Nummernlänge“ und die Felder der Zählung und Positionszählung werden, wenn diese nicht angegeben sind, mit Vorschlagswerten belegt. Die Vorschlagswerte sind bei den Feldbeschreibungen in der Dokumentation „Nummernkreise“ beschrieben.
Außerdem müssen für jeden Bestandteil des Nummernkreises folgende Daten vorhanden sein.
| Attributpfad | Bezeichnung | Bemerkung |
| format.function | Funktion (nur für Altdaten) | Verwenden Sie diese Pflichtfelder nur für Importe, die auf Exportdateien basieren, in denen diese Attribute noch vorhanden waren. |
| format.startPosition | von Nummernposition (nur für Altdaten) | |
| format.endPosition | bis Nummernposition (nur für Altdaten) | |
| format.constant | Konstante | |
| format.length | Länge des Nummernbestandteils | |
| format.display | Anzeige | |
| format.newCounter | Neuer Zähler | |
| format.formatLdtPath | Format | |
| format.parameterLdtPath | Herkunft |
Falls bereits Nummern des Nummernkreises erzeugt wurden, müssen Sie die folgenden Attribute angeben, damit das System die nächsten zu erzeugenden Nummern korrekt ermitteln kann.
| Attributpfad | Bezeichnung | Bemerkung | |
| lastNumber | Letzte erzeugte Nummer | Verwenden Sie dieses Pflichtfeld für Nummernkreise, deren Bestandteile keinen neuen Zähler erzeugen. Dieses Attribut wird ignoriert, wenn Sie das Attribut SubNumberRanges.lastNumber angegeben haben. | |
| SubNumberRanges.id | Subnummernkreis-ID | Muster der letzten erzeugten Nummer | |
| SubNumberRanges.lastNumber | Letzte erzeugte Nummer | ||
Beispiel:
Eine minimale XML-Importdatei für einen Nummernkreis vom Typ „Vertriebsaufträge“ mit einer Zählung bis 999 und zwei Bestandteilen hat z. B. folgenden Inhalt:
<?xml version=”1.0″ encoding=”UTF-8″?>
<semiramis xmlns=”com.cisag.app.general.obj.NumberRange” xsi:schemaLocation=”com.cisag.app.general.obj.NumberRange NumberRange.xsd” created=”2010-07-13T18:11:07.462Z” locale=”en-US-XMLSchemaCompliant” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<NumberRange xmlns=”com.cisag.app.general.obj.NumberRange”>
<code>VANK</code>
<description>Nummernkreis Vertriebsauftrag</description>
<type>SALES_ORDER</type>
<subType/>
<length>5</length>
<endValue>999</endValue>
<format index=”0″>
<function/>
<constant>VA</constant>
<length>2</length>
<display>true</display>
<newCounter>false</newCounter>
<formatLdtPath/>
<parameterLdtPath>com.cisag.pgm.base.numberrange:
ConstantParameter.lt</parameterLdtPath>
</format>
<format index=”1″>
<function/>
<constant/>
<length>3</length>
<display>true</display>
<newCounter>false</newCounter>
<formatLdtPath>com.cisag.pgm.base.numberrange:
LeadingZeroesNumberFormat.lt</formatLdtPath>
<parameterLdtPath>com.cisag.pgm.base.numberrange:
NumberingParameter.lt</parameterLdtPath>
</format>
</NumberRange>
</semiramis>
Für den Startwert der Zählung, die Erhöhung der Zählung und für die Positionszählung werden die Vorschlagswerte vom System verwendet.
2.2.1 Veraltete Attribute
Das System unterstützt folgende veraltete Attribute. Sie können diese importieren, wenn Sie z. B. die Importdatei auf Basis einer Exportdatei erstellt haben, die veraltete Attribute enthält.
| Attributpfad | Bezeichnung | Bemerkung |
| format.function | Funktion (nur für Altdaten) | Verwenden Sie diese Pflichtfelder nur für Importe, die auf Exportdateien basieren, in denen diese Attribute noch vorhanden waren. |
| format.startPosition | von Nummernposition (nur für Altdaten) | |
| format.endPosition | bis Nummernposition (nur für Altdaten) |
Hinweis:
Falls in der Importdatei in einem Bestandteil eine Funktion und eine Konstante angegeben sind, so wird die Funktion ignoriert und nur die Konstante wird importiert.
Wenn Sie die Importdatei neu erstellen, verwenden Sie die im Abschnitt Neuanlage beschriebenen Attribute.
2.3 Besonderheiten bei der Bearbeitung eines vorhandenen Nummernkreises
Das Feld „Letzte erzeugte Nummer“ (Attribut lastNumber) kann durch einen Import nicht überschrieben werden. Das Attribut lastNumber kann also nur importiert werden, wenn der Nummernkreis komplett neu angelegt wird oder dem Feld „Letzte erzeugte Nummer“ bisher kein Wert zugewiesen wurde. Ansonsten wird das Attribut lastNumber beim Import ignoriert.
Um eine Bestandteilsdefinition zu löschen, muss in der Importdatei ein leerer Bestandteil aufgeführt werden. In dem leeren Bestandteil muss dem Feld „Länge“ der Wert 0 zugewiesen werden und die Felder „Funktion“, „Konstante“, „Herkunft“, „Format“ müssen leer sein. Den Feldern „Anzeige“ und „Neuer Zähler“ muss der Wert false zugewiesen werden. Für den Import von Altdaten müssen die Felder „von Nummernposition“ und „bis Nummernposition“ leer sein.
Wird ein Bestandteil gelöscht, müssen häufig auch andere Bestandteile oder Attribute des Nummernkreises geändert werden. Deswegen wird empfohlen in der Importdatei zuerst alle verbliebenen Bestandteile aufzuführen und dann für jeden gelöschten Bestandteil einen leeren Bestandteil anzugeben.
Wird ein Bestandteil geändert, muss der Index dieses Bestandteils gleich der Zeilennummer des zu ändernden Bestandteils sein. Die Nummerierung der Bestandteile beginnt mit Null.
Beispiel:
Der oben neu angelegte Nummernkreis soll so geändert werden, dass er nur noch einen Bestandteil enthält.
<?xml version=”1.0″ encoding=”UTF-8″?>
…
<NumberRange xmlns=”com.cisag.app.general.obj.NumberRange”>
<code>VANK</code>
<length>5</length>
<endValue>99999</endValue>
<format index=”0″>
<function/>
<constant/>
<length>5</length>
<display>true</display>
<newCounter>false</newCounter>
<formatLdtPath>com.cisag.pgm.base.numberrange:
LeadingZeroesNumberFormat.lt</formatLdtPath>
<parameterLdtPath>com.cisag.pgm.base.numberrange:
NumberingParameter.lt</parameterLdtPath>
</format>
<format index=”1″>
<function/>
<constant/>
<length>0</length>
<display></display>
<newCounter></newCounter>
<formatLdtPath></formatLdtPath>
<parameterLdtPath></parameterLdtPath>
</format>
</NumberRange>
</semiramis>
Da der Zähler nun über alle fünf Stellen geht, muss auch der Endwert der Zählung von „999“ auf „99999“ und die Länge des Bestandteils von „3“ auf „5“ geändert werden.
Hinweis:
Wird die Anwendung „Nummernkreise“ im Korrekturmodus geöffnet, so sind einige Felder, z.B. die Checkbox „Interne Nummer“, editierbar, die normalerweise nicht editierbar sind. Änderungen sind nur möglich, wenn keine Prüfung dies verhindert.