Niniejszy artykuł przedstawia procedurę korzystania z aplikacji Import danych w odniesieniu do zasobów. Zawiera zarówno ogólne wskazówki, jak i opis specjalnych funkcji, które należy uwzględnić. Dodatkowo obejmuje informacje o możliwych warunkach wstępnych oraz konsekwencjach importu.
Szczegółowy opis aplikacji Import danych, obejmujący także charakterystykę pól i przycisków, znajduje się w artykule Import danych.
Formaty importu
Do importu wykorzystywane są następujące formaty:
- format XML
- format CSV
- format XLS
Format XML
Przy imporcie w formacie XML wszystkie potrzebne dane mogą zostać zaimportowane w ramach jednego procesu.
Formaty CSV i XLS
Import w formatach CSV i XLS podlega istotnym ograniczeniom technicznym. W jednym pliku nie można odwzorować równoległych relacji typu 1:n pomiędzy obiektami biznesowymi (np. parametry, teksty, informacje o zmianach). W efekcie dane te należy importować z kilku plików, korzystając z mechanizmu powiązań. Szczegółowy opis procedury znajduje się w artykułach Import danych oraz Wprowadzenie: Wymiana danych.
Eksport zasobów w formacie CSV/XLS wymaga przeprowadzenia go dwukrotnie: najpierw z wyłączonym obiektem biznesowym Texts, a następnie tylko z atrybutami code i Texts.
Instrukcje
Poniżej opisano wymagania wstępne dotyczące importu danych zasobów oraz sposób pracy z aplikacją Import danych:
Import danych
Podczas importu nowych zasobów do systemu należy wziąć pod uwagę następujące wymagania wstępne:
- W systemie docelowym nie istnieją jeszcze zasoby ani grupy zasobów o tym samym kluczu
- Dla obiektu biznesowego com.cisag.app.production.obj.Resource dostępny jest filtr zawierający atrybuty przeznaczone do importu
W celu zaimportowania zasobów należy wykonać następujące kroki:
- Otworzyć aplikację Import danych.
- Wyświetlić filtr dla obiektu biznesowego com.cisag.app.production.obj.Resource.
- Zostanie wyświetlony filtr umożliwiający import danych zasobów.
- Domyślne atrybuty filtra są już zaznaczone, w razie potrzeby można je dostosować.
- Na standardowym pasku narzędzi należy wybrać przycisk akcji [Import danych].
- Zostanie otwarte okno dialogowe Import danych.
- W oknie dialogowym można skonfigurować ustawienia pliku importu. Szczegółowy opis pól znajduje się w artykule Import danych.
- Import należy uruchomić przyciskiem [W tle].
Niezbędne atrybuty w przypadku importu z systemów źródłowych
Dla każdego obiektu biznesowego Zasoby należy podać co najmniej:
- Atrybuty identyfikacyjne (Business Key),
- Pola obowiązkowe.
Bez atrybutów identyfikacyjnych obiekt biznesowy Resource nie może zostać prawidłowo przypisany. Brak pól obowiązkowych zawsze powoduje konieczność ręcznej korekty.
Kolejność importu
Podczas importu danych powiązanych konieczne jest zachowanie odpowiedniej kolejności. Niezależne obiekty biznesowe, do których odwołują się zasoby, muszą znajdować się w bazie danych jeszcze przed importem samych zasobów. Dotyczy to w szczególności modeli czasu tygodniowego oraz grup zasobów.
Ponieważ grupy zasobów są odwzorowane w tym samym obiekcie biznesowym co zasoby, należy przyjąć następującą kolejność importu:
- Import zasobów z atrybutem resource = false.
- Import grupy zasobów.
- Import pozostałych zasoby z atrybutem resource = true.
- Eksport grup zasobów – w aplikacji Eksport danych należy otworzyć zakładkę Ograniczenie, rozwinąć sekcję wyboru i ustawić parametr wyszukiwania Typ zasobu na Nie. Następnie uruchomić akcję [Eksport danych].
- Eksport zasobów – w aplikacji Eksport danych należy otworzyć zakładkę Ograniczenie, rozwinąć sekcję wyboru i ustawić parametr wyszukiwania Typ zasobu na Tak. Następnie uruchom akcję [Eksport danych].
Dzięki takiemu podejściu dane będą od razu przygotowane do poprawnego importu zgodnie z wymaganą kolejnością.
Przegląd atrybutów
Atrybuty poszczególnych obiektów biznesowych, które są dostępne do importu, zostały wymienione poniżej. Pola identyfikacyjne i obowiązkowe mogą ulec zmianie i mogą zostać rozszerzone poprzez dostosowanie.
Atrybuty identyfikacyjne (atrybuty kluczowe) są oznaczone literą (K).
Dane podstawowe zasobu
| Atrybut | Wyjaśnienie |
| code (K) | Unikalna nazwa zasobu |
| capacityType | Typ zdolności produkcyjnej. Należy podać jedno ze słów kluczowych: • TIME_DEPENDENT – zasób zależny od czasu • INFINITE – zasób nieograniczony |
| description | Opis. Dodatkowa nazwa zasobu wspierająca wyszukiwanie. |
| timeModel | Odwołanie do modelu czasu tygodniowego. Pole obowiązkowe dla zasobów zależnych od czasu. Nie może być wypełnione dla zasobów nieograniczonych. |
| resource |
Zasób. Wartość musi być równa true. |
| schedulingMethod | Metoda harmonogramowania. Należy podać jedno ze słów kluczowych: • SHIFT_BASED – specyficzna dla danej zmiany • EXACT – precyzyjna |
| uom | Jednostka produkcji. Określa jednostkę, w której liczony jest zasób. Dla zasobów zależnych od czasu musi być to jednostka czasu. Jeżeli zasób należy do grupy zasobów, w której zdefiniowano atrybut uom, nie ma obowiązku ponownego podawania go w zasobie (może jednak zostać nadpisany). |
| resourceUom | Jednostka zasobów. Określa liczbę, w jakiej zliczane są zasoby jednorodne (np. w grupach zasobów i listach zasobów). Należy podać jednostkę handlową, np. Stk (sztuki) dla maszyn, MA (pracownicy) dla osób. Jeżeli zasób należy do grupy zasobów, w której zdefiniowano atrybut resourceUom, nie ma obowiązku podawania go ponownie w zasobie (może jednak zostać nadpisany). |
| costCentre |
Miejsce powstawania kosztów. Jeżeli w aplikacji Konfiguracja aktywowano funkcję Controlling, należy wskazać Centrum kosztów. Jeżeli w grupie zasobów zdefiniowano Centrum kosztów, w samym zasobie nie wolno podawać innego, ale pole może pozostać puste. |
| organizationalUnit | Lokalizacja (w przypadku środowiska wielofirmowego). Odwołanie do jednostki organizacyjnej, która określa lokalizację zasobu. Jeżeli zasób należy do grupy zasobów, lokalizacja zasobu musi być zgodna z lokalizacją grupy |
| performanceFactor | Stopień wydajności |
| resourceFactor | Liczba zasobów dostępnych podczas planowania w trybie Specyficzna dla danej zmiany. |
| capacityLimit | Stopień wykorzystania. Dla zasobów punktowych należy podać wartość 100. |
| planningLimit | Stopień planowania |
Dane dodatkowe
| Atrybut | Wyjaśnienie |
| resourceGroup | Odwołanie do grupy zasobów. Pole wymagane tylko wtedy, gdy zasób należy do grupy zasobów. |
| financialsOrganisation | Organizacja finansowa. Odwołanie do jednostki organizacyjnej (OE), która odpowiada za organizację finansową danej lokalizacji. |
| shiftInfoDefined | Wartość = true, jeśli dla zasobu istnieją rekordy ResourceShiftInfo. |
| validFrom | Data rozpoczęcia obowiązywania. Pole wymagane tylko w przypadku ograniczenia okresu obowiązywania. |
| validUntil | Data zakończenia obowiązywania. Pole wymagane tylko w przypadku ograniczenia okresu obowiązywania. |
Grupy zasobów
Jeżeli zasób jest elementem grupy zasobów, to jego atrybut resourceGroup musi odwoływać się do tej grupy zasobów.
Jeżeli w aplikacji Konfiguracja aktywowana jest funkcja Controlling, to centrum kosztów zasobów musi być podane albo w grupie, albo w samym zasobie.
Jeśli centra kosztów jest przypisane zarówno w grupie, jak i w zasobie, muszą być one takie same.
W środowisku wielofirmowym zasób i grupa zasobów muszą mieć tę samą lokalizację.
Pozostałe atrybuty grupy zasobów mogą zostać nadpisane przez zasób.
Zasoby, które są elementami grupy zasobów, mogą zostać zaimportowane dopiero wtedy, gdy grupa zasobów jest już dostępna w bazie danych.
Parametry
Dla zasobów dostępne są 4 typy parametrów, które można zaimportować:
- Parametry zmienne – grupa zasobów (GroupResourceParameter)
- Parametry zmienne w operacji – grupa zasobów (GroupResourceUseParameter)
- Parametry zmienne – zasoby (ResourceParameter)
- Parametry zmienne w operacji – zasoby (ResourceUseParameter)
Stałe parametry grup zasobów nie mogą zostać tutaj zaimportowane, ponieważ mogą być edytowane wyłącznie w aplikacji Grupy zasobów.
Parametry są zapisywane w obiekcie biznesowym EntityExtensions.
Opis pól identyfikacyjnych i obowiązkowych wymaganych do importu parametrów znajduje się w artykule Import/eksport pól zdefiniowanych przez użytkownika.
Informacje o zmianach
Dla zasobów z metodą harmonogramowania Specyficzna dla danej zmiany można określić:
- liczbę zasobów
- stopień planowania
- stopień wykorzystania
Dane te są zapisywane w obiekcie biznesowym com.cisag.app.production.obj.ShiftInfo i tworzą relację 1:n do zasobów.
Atrybuty kluczowe (K) i inne dane obiektu biznesowego ShiftInfo:
| Atrybut | Wyjaśnienie |
| header (K) | Odwołanie do zasobu |
| shift (K) | Odwołanie do zmiany |
| resourceFactor | Liczba anonimowych zasobów dostępnych przy terminowaniu dokładnym do zmiany |
| capacityLimit | Stopień obciążenia |
| planningLimit | Poziom planowania |
