W niniejszym artykule szczegółowo opisano sposób wykorzystania etykiet w systemie Comarch ERP Enterprise.
Definicje terminów
- Wydanie — wydanie oznaczane jest za pomocą ciągu w formacie V.R.M: Version, Release i Modification-Level. Nowe wersje są udostępniane w odstępach około 2–3 lat. Nowe wydania tworzone są mniej więcej raz w roku. Poziom modyfikacji zwiększany jest wówczas, gdy do już udostępnionego wydania dodawane są istotne nowości.
- Aktualizacja oprogramowania — logiczna jednostka, która służy do przenoszenia wersji obiektów deweloperskich pomiędzy systemami. Każda aktualizacja oprogramowania składa się z dwóch plików: Code-Refresh (rozszerzenie .cr) i Source-Refresh (rozszerzenie .sr). Każdą aktualizację można jednoznacznie zidentyfikować na podstawie wydania, identyfikatora (ID) i repozytorium źródłowego (prefiks eksportu, np. babel). Partnerzy mogą tworzyć aktualizacje oprogramowania w celu dostarczenia zmian specyficznych dla klienta lub własnych rozszerzeń standardowych. Aktualizacje oprogramowania zawierają poprawki błędów i rozszerzenia przygotowane dla określonego wydania. Dla jednego wydania można utworzyć dowolną liczbę aktualizacji. Rozróżnia się dwa typy aktualizacji:
- System-Code (SYS) – obejmuje obiekty deweloperskie z obszaru nazw com.cisag.pgm i com.cisag.sys, a także z powiązanych podobszarów com.cisag.archive, com.cisag.dbu i com.cisag.nls
- Application-Code (APP) – obejmuje wszystkie pozostałe obiekty deweloperskie, czyli te, które nie zostały utworzone przez firmę C.I.S. AG. W przeciwieństwie do aktualizacji APP, aktualizacje SYS nie zawierają obiektów deweloperskich typu klasa Java, ponieważ są one już zawarte w silniku systemowym.
Opis
Wersje obiektów deweloperskich mogą być oznaczane jedną lub wieloma etykietami (labels).
Etykiety służą do oznaczania stanu wydania lub powiązania obiektów deweloperskich z aktualizacją oprogramowania.
Rozróżnia się trzy typy etykiet:
- Etykieta wydania (Release label)— służy wyłącznie do oznaczania stanu wydania
- Etykieta eksportu (Export label) — wiąże wersję z aktualizacją typu eksport. Etykiety eksportowe są automatycznie przypisywane przez system Comarch ERP Enterprise.
- Etykieta importu (Import label) — wiąże wersję z aktualizacją typu import. Etykiety importowe są również automatycznie przypisywane przez system.
Przed udostępnieniem wydania obiekty deweloperskie należy oznaczyć etykietą typu Release. W ten sposób utrwalany jest stan, który zostanie odtworzony po nowej instalacji systemu standardowego u partnera lub klienta. Wszystkie późniejsze poprawki błędów opierają się na tym oznaczonym stanie.
Etykieta Export tworzy powiązanie między aktualizacją oprogramowania a zawartymi w niej obiektami deweloperskimi. Podczas generowania plików Code-Refresh i Source-Refresh uwzględniane są wszystkie obiekty oznaczone etykietami.
Podczas instalacji aktualizacji oprogramowania wszystkie zaimportowane do archiwum obiekty deweloperskie są oznaczane etykietą Import. Dzięki temu powstaje powiązanie między zainstalowanymi aktualizacjami a odpowiadającymi im obiektami.
W aplikacji Obiekty deweloperskie dostępny jest widok, w którym można zobaczyć etykiety przypisane do załadowanego obiektu we wszystkich jego wersjach. Dzięki typizacji etykiet można łatwo rozpoznać, która wersja została dostarczona lub zainstalowana z którą aktualizacją oprogramowania.
Etykiety wydań (Release Labels)
Wydanie służy do etykietowania obiektów deweloperskich oraz jako punkt odniesienia dla aktualizacji oprogramowania.
Aktywne wersje wszystkich obiektów deweloperskich mogą być oznaczone etykietą typu Release. W przypadku prawdziwych wydań (V.R.M) zawsze utrwalany jest stan deweloperski sprzed zamknięcia wydania. Oprócz tego można oznaczać dowolne inne stany – na przykład przed rozdzieleniem systemu deweloperskiego lub utworzeniem systemu dostawczego.
Obecnie etykiety wydań mają jedynie charakter informacyjny.
Zawsze etykietowana jest aktywna, a nie bieżąca wersja obiektu deweloperskiego. Jeśli obiekt jest aktualnie w edycji, system wyświetla ostrzeżenie, a etykieta zostaje przypisana do wersji aktywnej. Usunięte obiekty deweloperskie również są etykietowane.
Po zakończeniu etykietowania należy zatwierdzić wydanie. Wydanie, które zostało zatwierdzone, nie może być ani usunięte, ani zmienione — oznacza to, że stan deweloperski został w ten sposób utrwalony. Prawdziwe wydanie (V.R.M) zostaje ponadto aktywowane. Ponieważ może istnieć tylko jedno aktywne wydanie, status poprzedniego aktywnego wydania zostaje zmieniony na Zatwierdzone.
Procedura tworzenia etykiety wydania:
W aplikacji wrkreldef definiuje się wydanie (więcej informacji znajduje się w artykule Praca z definicjami wydań). Następnie wszystkie aktywne wersje obiektów deweloperskich są etykietowane.
Podczas etykietowania nie powinny być otwarte żadne zadania deweloperskie, ponieważ etykietowane są wersje aktywne, a nie zablokowane w ramach zadań.
Etykietowanie wersji aktywnych odbywa się za pomocą narzędzia wrkrellbl. Następnie przy użyciu wrkreldef wydanie zostaje zatwierdzone lub aktywowane.
