Niniejszy dokument zawiera instrukcje dotyczące pracy z aplikacją Import danych w odniesieniu do schematów numeracji. Instrukcje te opisują między innymi kolejność, której należy przestrzegać podczas importu, a także informują o możliwych wymaganiach, skutkach oraz ograniczeniach dla procesu importu schematów numeracji. Import danych dotyczy zewnętrznych schematów numeracji.
Szczegółowe informacje dotyczące importu danych znajdują się w artykule Import danych.
Schematy numeracji służą do automatycznego przypisywania numeracji przez system w celu identyfikacji obiektów. Więcej informacji znajduje się w dokumentacji Schematy numeracji.
Importowanie danych
- Pierwszym krokiem jest uruchomienie aplikacji Import Danych
- W polu Filtr przy użyciu przycisku [Pomoc uzupełniania wartości], należy wybrać jednostkę biznesową: cisag.app.general.obj.NumberRange
- Wyświetli się filtr do importu danych
Aplikacja Import danych z użyciem filtra dla aplikacji Schematy numeracji - Wybrane atrybuty filtra są domyślnie zaznaczone. W razie potrzeby, na tym etapie istnieje możliwość edycji atrybutów.
- Następnie należy wybrać przycisk [Importuj dane], dostępny na standardowym pasku przycisków.
- Pojawia się okno dialogowe Import danych.
- W otwartym oknie dialogowym możliwe jest wprowadzenie ustawień dla pliku importu. Szczegółowy opis pól znajduje się w dokumentacji aplikacji Import danych.
- Użytkownik uruchamia import danych za pomocą przycisku [W tle].
Definiowanie schematów numeracji
Podczas tworzenia nowego schematu numeracji w aplikacji Schematy numeracji, należy podać atrybut identyfikacyjny oraz uzupełnić wszystkie pola obowiązkowe. Bez atrybutu identyfikacyjnego nie można zaimportować schematu numeracji. Jeśli dane są niepoprawne, aplikacja Schematy numeracji jest uruchamiana w oknie dialogowym Import danych w celu skorygowania danych.
Obowiązkowe pola i atrybut identyfikacyjny są wymienione w poniższej tabeli.
| Ścieżka atrybutu | Oznaczenie | Uwaga |
| code | Schemat numeracji | |
| description | Oznaczenie | |
| guid | Schemat numeracji | |
| type | Typ | |
| subType | Podtyp | |
| length | Długość numeru | |
| startValue | Cyfra początkowa | |
| endValue | Cyfra końcowa (long) | |
| Increment | Przyrost (long) | |
| detailStartValue | Cyfra początkowa | Pole obowiązkowe, jeśli typ schematu numeracji wskazuje dokument wymagający numeracji elementów. |
| detailIncrement | Przyrost | |
| detailEndValue | Cyfra końcowa |
Następujące dane muszą być dostępne dla każdego składnika schematu numeracji.
| Ścieżka atrybutu | Oznaczenie | Uwaga |
| format.function | Funkcja (tylko w przypadku starszych danych) | Pola obowiązkowe dla importu opartego na podstawie plików eksportu, w których atrybuty te nadal istnieją. |
| format.startPosition | Od pozycji numeru (tylko w przypadku starszych danych) | |
| format.endPosition | Do numeru pozycji (tylko w przypadku starszych danych) | |
| format.constant | Stała | |
| format.length | Długość elementu numeru | |
| format.display | Widok | |
| format.newCounter | Nowy licznik | |
| format.formatLdtPath | Format – ścieżka LDT | |
| format.parameterLdtPath | Pochodzenie – ścieżka LDT |
Jeśli numery schematu numeracji zostały już utworzone, należy określić następujące atrybuty, aby system mógł poprawnie określić kolejne liczby, które mają zostać wygenerowane.
| Ścieżka atrybutu | Oznaczenie | Uwaga |
| lastNumber | Ostatni utworzony numer | Pole obowiązkowe dla schematu numeracji, którego składniki nie generują nowego licznika.
Ten atrybut jest ignorowany, jeśli określono atrybut SubNumberRanges.lastNumber. |
| SubNumberRanges.id | Id podzakresu numerów | Wzór ostatnio utworzonego numeru |
Najmniejszy plik importu XML dla schematu numeracji typu Zamówienia sprzedaży z liczbą do 999 i dwoma składnikami ma następujące zawartości:
<?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>
System używa wartości domyślnych dla cyfry początkowej oraz przyrostu w sekcji Licznik i Licznik pozycji.
Nieaktualne atrybuty
System obsługuje następujące nieaktualne atrybuty. Można je zaimportować, jeśli plik importu został utworzony na podstawie pliku eksportu, wykorzystując nieaktualne atrybuty.
| Ścieżka atrybutu | Oznaczenie | Uwaga |
| format.function | Funkcja (tylko dla starych danych) | Pola obowiązkowe dla plików importu opartych na plikach eksportu, w których atrybuty te były nadal obecne. |
| format.startPosition | Od pozycji numeru (tylko dla starych danych) | |
| format.endPosition | Do numeru pozycji (tylko w przypadku starszych danych) |
Szczególne cechy przetwarzania istniejących komponentów schematów numeracji
Atrybutu Ostatni utworzony numer (lastNumber) nie podlega zastąpieniu pod czas procesu importu. Atrybut ten (lastNumber) można zaimportować tylko wtedy, gdy schemat numeracji jest tworzony od nowa, lub gdy pole wyboru Ostatni utworzony numer nie ma przypisanej żadnej wartości. W przeciwnym razie atrybut ten jest ignorowany podczas importowania.
Aby usunąć definicję komponentu w pliku importu, komponent musi być pusty. W takim komponencie kolumna Długość musi mieć przypisaną wartość 0. Kolumny Pochodzenie i Format muszą być puste. W kolumnach Widok oraz Nowy licznik należy przypisać wartość false. W przypadku importu starych plików atrybuty startPosition i endPosition muszą pozostać puste.
Jeśli komponent zostanie usunięty z pliku importu, należy również zmienić inne atrybuty schematu numeracji. Zalecane jest zatem wylistowanie wszystkich pozostałych komponentów w pliku importu, a następnie określenie pustego komponentu dla każdego usuniętego komponentu.
Jeśli komponent zostaje zmieniony, indeks tego komponentu musi być równy numerowi wiersza komponentu, który ma zostać zmieniony. Numeracja komponentów zaczyna się od zera.
Utworzony nowy schemat numeracji powinien zostać zmieniony tak, aby zawierał tylko jeden komponent.
<?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>
Ze względu na przekroczenie przez licznik pięciu cyfr, Cyfra końcowa zostaje zmieniona z 999 na 9999, a długość komponentu zostanie zmieniona z 3 do 5.
