Eksport i import obiektów deweloperskich

Niniejszy artykuł opisuje procedury eksportowania i importowania obiektów deweloperskich. Wymieniono w nim ogólne kroki, które są niezbędne do eksportu lub importu. Opisuje również specjalne funkcje, które różnią się od ogólnych procedur eksportowania i importowania danych w Comarch ERP Enterprise.

Wymagania wstępne

Znajomość obiektów deweloperskich (więcej informacji znajduje się w artykule Obiekty deweloperskie) i zadań deweloperskich (więcej informacji znajduje się w artykule Zadania deweloperskie), a także importu danych (więcej informacji znajduje się w artykule Import danych) i eksportu danych (więcej informacji znajduje się w artykule Eksport danych) jest warunkiem wstępnym lepszego zrozumienia tego artykułu.

Eksport i import obiektów deweloperskich

Opcje eksportu i importu

Dzięki eksportowi i importowi możliwa jest wymiana obiektów deweloperskich między dwoma systemami deweloperskimi bez korzystania z logistyki oprogramowania. Wystarczy określić liczbę obiektów deweloperskich, które mają zostać wyeksportowane z systemu źródłowego i wyeksportować je. Następnie należy zaimportować obiekty deweloperskie do systemu docelowego (więcej informacji znajduje się w rozdziale Wymiana obiektów rozwojowych między dwoma systemami deweloperskimi).

Podczas importu istnieje możliwość zamiany oryginalnego prefiksu deweloperskiego na bieżący prefiks deweloperski. W tym celu należy określić prefiks deweloperski, który ma zostać zastąpiony, oraz prefiks deweloperski, który ma zostać wstawiony podczas importu. Prefiks deweloperski zostanie następnie automatycznie zastąpiony. Istnieje również możliwość zastąpienia prefiksu deweloperskiego w klasach Java (więcej informacji na ten temat można znaleźć w rozdziale Refaktoryzacja w imporcie).

Można porównywać różne wersje obiektu deweloperskiego. W tym celu należy wyeksportować obiekty deweloperskie za pośrednictwem aplikacji Zadania deweloperskie z opcją zapisania wersji do porównania. Odpowiednia wersja porównawcza jest również eksportowana (więcej informacji można znaleźć w rozdziale Eksport w aplikacji Zadania deweloperskie). Wyeksportowane obiekty deweloperskie można następnie porównać za pomocą narzędzi porównawczych (np. WinMerge, Win-Diff lub podobnych). Ułatwia to rozpoznanie zmian wprowadzonych w zadaniu deweloperskim.

Uwaga
Opcja ta jest szczególnie przydatna w przypadku rozbudowanych zadań konfliktowych. Ułatwia to rozpoznanie zmian w standardzie i dostosowanie modyfikacji.
Dostarczanie poprawek

Możliwe jest przesyłanie ulepszeń i poprawek błędów do standardu z systemu QAS do niższego systemu programowania z wyprzedzeniem za pomocą importu i eksportu obiektów programowania, jeśli transfer nie może odbyć się na czas za pośrednictwem normalnej trasy transportu.

Do tego wariantu mają zastosowanie następujące opcje i ograniczenia:

Wszystkie obiekty deweloperskie, które są eksportowane z systemu źródłowego, muszą być możliwe do edycji w systemie docelowym w aplikacji obiektów deweloperskich. Prowadzi to również do rozgałęzienia w systemie docelowym dla obiektów deweloperskich przeniesionych w ten sposób. Jeśli te obiekty deweloperskie zostaną później zainstalowane za pośrednictwem standardowej ścieżki transportu przy użyciu aktualizacji oprogramowania, obiekt deweloperski zostanie uwzględniony w zadaniu konfliktu. W razie potrzeby można ponownie usunąć adaptację za pomocą funkcji Usuń gałąź.

W ten sposób można przenosić tylko obiekty deweloperskie, które można dostosować w systemie docelowym. Ponadto nie można importować obiektów deweloperskich zawierających zmiany, które nie są możliwe w systemie docelowym.

Nie można importować nowych systemów, które nie znajdują się w obszarze nazw rozwoju systemu docelowego.

Poniżej wymienione zostały specjalne funkcje występujące podczas importowania poszczególnych typów obiektów deweloperskich.

  • Logiczny typ danych/Obiekt biznesowy/Część/Rozszerzenie — te obiekty deweloperskie nie mogą zostać przeniesione
  • Aplikacja/Zdarzenie/Wyszukiwanie OQL/Stringtable/Valueset/OQL View — te obiekty deweloperskie można zaimportować w całości tylko wtedy, gdy żadne elementy tych obiektów deweloperskich nie zostały dodane ani usunięte. W przeciwnym razie te obiekty deweloperskie muszą zostać przerobione ręcznie. W takim przypadku opracowanie nie może zostać zaimportowane w całości.
  • Klasa Java — podczas importowania programu aktualizacji obiektu biznesowego gałąź nie może zostać usunięta z przyczyn technicznych

Funkcje specjalne podczas eksportu obiektów deweloperskich

Eksport obiektów deweloperskich opartych na plikach

Pliki są zawsze reprezentowane jako relacja (plik) w eksportowanym modelu danych. Podczas eksportowania obiektów deweloperskich opartych na plikach, powiązane pliki są przechowywane w oddzielnym katalogu. Plik eksportu zawiera łącza do odpowiednich plików. Pliki są przechowywane w folderze, który ma taką samą nazwę jak plik eksportu i do którego dołączany jest postfiks .files. W tym folderze pliki są tworzone w podfolderach, które odpowiadają obszarom nazw powiązanych obiektów deweloperskich.

Uwaga
Eksportowane są również nazwy plików obiektów deweloperskich klas Java, plików i obiektów pomocy. Są one wymagane do importu i nie wolno ich zmieniać. Zmiana nazw plików spowoduje, że pliki nie zostaną znalezione i nie zostaną zapisane w archiwum.
Eksport obiektu opracowania tekstu

Teksty zawsze należą do obiektu deweloperskiego i dlatego są wyświetlane jako relacja podczas eksportu powiązanego obiektu deweloperskiego.

Obiekt deweloperski typu Tekst nie może być eksportowany osobno.

Eksport obiektu deweloperskiego Terminus

Eksport obiektu deweloperskiego typu Terminus nie jest możliwe.

Eksport obiektu deweloperskiego klasy Java

W przypadku obiektu deweloperskiego klasy Java eksportowany jest tylko plik źródłowy. Pliki klas nie są uwzględniane w eksporcie. Po zaimportowaniu klas Java należy przeprowadzić odprawę. Jest to jedyny sposób, aby upewnić się, że pliki klas są poprawne.

Eksport obiektów deweloperskich

Istnieją trzy różne sposoby eksportowania obiektów deweloperskich. Opcje te i ich specjalne cechy zostały opisane poniżej.

Eksport w aplikacji Obiekty deweloperskie

W aplikacji Obiekty deweloperskie można wyeksportować aktualnie wyświetlaną wersję obiektu deweloperskiego. W związku z tym możliwe jest również eksportowanie starszych wersji obiektu deweloperskiego. Utworzone dane eksportu są wielojęzyczne i zawierają wszystkie atrybuty wymagane do importu.

Folder i nazwa pliku są sugerowane w oknie dialogowym eksportu. W razie potrzeby można je zmienić (więcej informacji można znaleźć w rozdziale Okno dialogowe eksportu).

Uwaga
W przypadku wybrania opcji System plików eksport odbywa się tylko do folderu roboczego. W oknie dialogowym eksportu ścieżka, do której ma zostać wykonany eksport, jest wyświetlana w polu Folder główny. Nazwę pliku docelowego należy wprowadzić w polu Plik docelowy. Możliwe jest również poprzedzenie nazwy pliku innymi folderami. Ścieżka eksportu składa się z folderu głównego i pliku docelowego.
Eksport w aplikacji Zadania deweloperskie

W aplikacji Zadania deweloperskie można wyeksportować wszystkie wersje obiektów deweloperskich, które są przypisane do aktualnie otwartego zadania deweloperskiego. Eksport jest również możliwy dla zadań deweloperskich, które zostały już aktywowane. Tworzony jest eksport wielojęzyczny, który zawiera wszystkie atrybuty wymagane do importu.

Folder i nazwa pliku są sugerowane w oknie dialogowym eksportu. Można je jednak zmienić w razie potrzeby (więcej informacji można znaleźć w rozdziale Okno dialogowe eksportu).

Uwaga
W przypadku wybrania opcji System plików eksport odbywa się tylko w folderze roboczym. W oknie dialogowym eksportu ścieżka, do której odbywa się eksport, jest wyświetlana w polu Folder główny. Należy wprowadzić plik docelowy lub folder docelowy (w zależności od wariantu eksportu). Ścieżka eksportu składa się z folderu głównego i docelowego pliku lub folderu.

Do wyboru są trzy różne warianty eksportu:

  • Wszystkie obiekty deweloperskie są eksportowane do jednego pliku
  • Każdy obiekt deweloperski jest eksportowany do osobnego pliku. W przypadku tego eksportu nazwa pliku eksportu jest automatycznie określana na podstawie nazwy obiektu deweloperskiego i typu obiektu deweloperskiego. Struktura folderów, w których przechowywane są wyeksportowane pliki, wynika z obszaru nazw obiektów deweloperskich.
  • Każdy obiekt deweloperski jest eksportowany do osobnego pliku. Ponadto jedna lub dwie wersje są przechowywane równolegle w innych folderach w celu porównania, w zależności od rodzaju zadania. Mogą to być aktywna lub zaimportowana wersja.
Eksport w aplikacji Eksport danych

Obiekty deweloperskie można również eksportować za pomocą aplikacji Eksport danych. Więcej informacji na ten temat można znaleźć w artykule Eksport danych.

Uwaga
Jeśli użytkownik chce ponownie zaimportować wyeksportowane obiekty deweloperskie, zawsze powinien wybrać wszystkie atrybuty obiektów deweloperskich, które mają zostać wyeksportowane. Brak atrybutów może oznaczać, że obiekty deweloperskie nie będą mogły zostać zaimportowane lub że po zaimportowaniu konieczne będzie ręczne zachowanie tych atrybutów.

Podczas ograniczania eksportu dostępne są następujące wyszukiwania:

  • Aktywne obiekty deweloperskie — liczba obiektów deweloperskich do wyeksportowania może być ograniczona do określonych właściwości obiektu deweloperskiego. Eksportowana jest zawsze aktywna wersja obiektu deweloperskiego.
  • Obiekty deweloperskie dla zadań deweloperskich lub zleceń deweloperskich — eksportowane są wszystkie obiekty deweloperskie przypisane do określonego zadania deweloperskiego lub zlecenia deweloperskiego. Musi to być ograniczone do co najmniej jednego zadania deweloperskiego lub zlecenia deweloperskiego. W przeciwnym razie żadne obiekty deweloperskie nie zostaną wyeksportowane.
  • Obiekty deweloperskie dla aktualizacji oprogramowania — eksportowane są wszystkie obiekty deweloperskie przypisane do określonej aktualizacji oprogramowania. Co najmniej jedna aktualizacja oprogramowania musi być ograniczona. W przeciwnym razie żadne obiekty deweloperskie nie zostaną wyeksportowane.
Uwaga
Zlecenia deweloperskie i aktualizacje oprogramowania mogą zawierać więcej niż jedną wersję obiektu deweloperskiego. Podczas eksportu eksportowana jest tylko najnowsza wersja danego obiektu deweloperskiego.

Import obiektów deweloperskich

Obiekty deweloperskie można importować wyłącznie w aplikacji Zadania deweloperskie. Podczas importowania obiekty deweloperskie są przypisywane do zadania deweloperskiego. W tym momencie zadanie deweloperskie musi mieć status zadania Otwarte.

Podczas importu pierwszym krokiem jest sprawdzenie, czy obiekt deweloperski, który ma zostać zaimportowany, może zostać zablokowany w otwartym zadaniu deweloperskim. Jeśli jest to możliwe, obiekt deweloperski jest blokowany lokalnie. Jeśli obiekt deweloperski jeszcze nie istnieje, tworzony jest nowy. Jeśli obiekt deweloperski nie może zostać zablokowany, odpowiedni błąd jest wymieniony w pliku błędu, który jest generowany w przypadku wystąpienia błędu.

Uwaga
Podczas importowania należy upewnić się, że importowane obiekty deweloperskie mogą być tworzone lub zmieniane w systemie docelowym. Przykładowo, nie jest możliwe utworzenie obiektu deweloperskiego z obszaru nazw cisag w partnerskim systemie deweloperskim. Dotyczy to również obiektów deweloperskich, które nie mogą być zmieniane w systemie docelowym. W takim przypadku obiekty deweloperskie, których to dotyczy, są ignorowane podczas importu, a odpowiednie komunikaty o błędach są zapisywane w pliku błędów.

Drugi krok sprawdza, czy zaimportowane dane obiektu deweloperskiego są wystarczająco prawidłowe, aby mogły zostać rozpoznane. Jeśli tak nie jest, zmiany nie są importowane. Obiekt deweloperski pozostaje w zadaniu deweloperskim z lokalną blokadą. Błędy są wymienione w pliku błędów. Należy poprawić te błędy. Tylko wtedy import jest możliwy. Import można powtarzać tak często, jak jest to wymagane.

Uwaga
Obiekty deweloperskie, które zostały już zablokowane w zadaniu deweloperskim przed importem i znajdują się w pliku importu, zostaną nadpisane zawartością pliku importu. Zmiany, które zostały już wprowadzone, można cofnąć podczas importu.

Jeśli zaimportowany obiekt deweloperski został pomyślnie zapamiętany, system sprawdza, czy obiekt deweloperski może zostać zapisany i zwolniony. Jeśli kontrola zakończy się pomyślnie, obiekt deweloperski zostanie zapisany i zwolniony. W przeciwnym razie pozostanie on w lokalnej blokadzie i trzeba będzie go przerobić ręcznie. W takim przypadku nie jest generowany plik błędu. Dlatego po zaimportowaniu należy przynajmniej edytować obiekty deweloperskie, które mają blokadę lokalną. W przypadku obiektów deweloperskich z wpisami n-elementowymi, np. aplikacji, rozszerzeń lub zestawów wartości, obiekt deweloperski jest również rozpoznawany tylko wtedy, gdy import spowodowałby usunięcie jednej lub więcej zależności. W rezultacie zależności te są opatrzone znacznikiem usunięcia, który można ponownie usunąć.

Przykład
Zestaw wartości zawiera wpisy A, B i C. Wpisy C i D istnieją dla tego zestawu wartości w pliku importu. Po zaimportowaniu zapamiętany zestaw wartości zawiera wpisy A, B, C i D. Wpisy A i B są oznaczone jako usunięte.
Uwaga
Po zwolnieniu zadania deweloperskiego system sprawdza, czy wszystkie obiekty deweloperskie mają blokadę globalną. Jeśli użytkownik chce aktywować zadanie deweloperskie bezpośrednio po imporcie, nie musi ręcznie sprawdzać stanu blokady obiektów deweloperskich. Odpowiednie komunikaty o błędach są wyświetlane po zwolnieniu zadania deweloperskiego.

Kontrole przeprowadzane podczas importu odpowiadają kontrolom, które są również stosowane w przypadku edycji obiektu deweloperskiego bezpośrednio w aplikacji Obiekty deweloperskie.

Obiekty deweloperskie typu Report i klasa Java są zawsze w lokalnej blokadzie po imporcie. Ponieważ dla klas Java importowana jest tylko część źródłowa, odprawa musi zostać przeprowadzona po imporcie.

Refaktoryzacja podczas importu

Jeśli obiekty deweloperskie są wymieniane między dwoma systemami deweloperskimi, prefiks deweloperski musi zwykle zostać zastąpiony w obszarach nazw obiektów deweloperskich oraz w elementach (np. elementach wartości) dostosowanych obiektów deweloperskich. W tym celu dostępna jest refaktoryzacja, którą można wykonać podczas importu. Aby to zrobić, należy określić prefiks deweloperski systemu źródłowego (ten prefiks deweloperski zostanie zastąpiony) i prefiks deweloperski systemu docelowego (ten prefiks deweloperski zostanie wstawiony).

Refaktoryzacja jest wykonywana na kopii pliku importu. Z tego powodu należy określić plik docelowy. Zmodyfikowane obiekty deweloperskie są przechowywane w tym pliku. Pliki obiektów deweloperskich opartych na plikach są również kopiowane. Obiekty deweloperskie są importowane z tej kopii. Oryginalny plik importu pozostaje niezmieniony. Ma to tę zaletę, że może być ponownie użyty w przypadku błędu.

Istnieje również możliwość zastosowania refaktoryzacji do istniejących klas Java. W takim przypadku wszystkie istniejące prefiksy deweloperskie są zastępowane w klasach Java.

Następujące typy prefiksów deweloperskich są zastępowane podczas refaktoryzacji (xxxxx – prefiks deweloperski, * – dowolny znak):

  • *XXXXX_*
  • *XXXXX_*
  • *xxxxx_*
  • *xxxxx_*
  • *Xxxxx_*
  • *Xxxxx_*
Uwaga
Podczas zastępowania prefiksu deweloperskiego zastępowane są wszystkie prefiksy wymienione powyżej. W przypadku klas Java może to prowadzić do zmiany nazw metod lub zmiennych zawierających ten ciąg znaków. Konieczne może być ich ręczne dostosowanie po zaimportowaniu.

Instrukcje

Eksport i import można przeprowadzić przy użyciu następujących procedur:

  • Eksport za pomocą aplikacji Obiekty deweloperskie
  • Eksport za pomocą aplikacji Zadania deweloperskie
  • Eksport za pomocą aplikacji Eksport danych
  • Import obiektów deweloperskich
  • Import obiektów deweloperskich i wykonywanie refaktoryzacji
  • Wymiana obiektów deweloperskich między dwoma systemami deweloperskimi

Eksport za pomocą aplikacji Obiekty deweloperskie

Aby wyeksportować obiekty za pomocą aplikacji Obiekty deweloperskie należy:

  1. Otworzyć aplikację Obiekty deweloperskie.
  2. Otworzyć obiekt deweloperski, który ma zostać wyeksportowany.
  3. Jeśli wyświetlana wersja nie ma zostać wyeksportowana, otworzyć żądaną wersję obiektu deweloperskiego, która ma zostać wyeksportowana.
  4. Wybrać przycisk [Eksportuj wyświetloną wersję obiektu deweloperskiego] na standardowym pasku narzędzi. Otwarte zostanie okno dialogowe Eksportuj obiekt deweloperski.
  5. Zdefiniować, czy plik eksportu ma zostać wyeksportowany do systemu plików, czy do Knowledge Store.
  6. Jeśli to wymagane, zmienić automatycznie wyświetlane foldery i nazwy plików.
  7. Wykonać eksport, wybierając przycisk [W tle].

Eksport za pomocą aplikacji Zadania deweloperskie

Aby wyeksportować obiekty za pomocą aplikacji Zadania deweloperskie należy:

  1. Otworzyć aplikację Zadania deweloperskie.
  2. Otworzyć zadanie deweloperskie, dla którego moją zostać wyeksportowane obiekty deweloperskie.
  3. Wybrać przycisk [Eksportuj obiekty deweloperskie zadania deweloperskiego] na standardowym pasku narzędzi. Otwarte zostanie okno dialogowe Eksport obiektów deweloperskich.
  4. Wybrać jedną z wartości, dostępnych w polu Akcja: Obiekty deweloperskie wyeksportowano do pliku, Na każdy obiekt deweloperski należy eksportować jeden plik, Eksport obiektu deweloperskiego i wersji porównania każdy do jednego pliku.
  5. Jeśli to wymagane, zmienić automatycznie wyświetlane foldery i nazwy plików.
  6. Wykonać eksport, wybierając przycisk [W tle].

Eksport za pomocą aplikacji Eksport danych

Aby wyeksportować obiekty za pomocą aplikacji Eksport danych należy:

  1. Otworzyć aplikację Eksport danych.
  2. Wyświetlić filtr dla obiektu biznesowego com.cisag.sys.repository.internal.obj.ObjectDirEntry. Wyświetlony zostanie filtr eksportu obiektów deweloperskich.
  3. Atrybuty filtra do wyeksportowania są podświetlone. Wybór można zmienić.
  4. W wyszukiwaniu aktywnych obiektów deweloperskich należy ograniczyć liczbę obiektów deweloperskich do wyeksportowania. Jeśli ograniczenie nie zostanie wprowadzone, wyeksportowane zostaną wszystkie aktywne obiekty deweloperskie w systemie. W przypadku wyszukiwania zleceń deweloperskich, zadań deweloperskich i aktualizacji oprogramowania należy wprowadzić co najmniej jedno z tych kryteriów, w przeciwnym razie nie zostaną wyeksportowane żadne obiekty deweloperskie.
  5. Wybrać przycisk [Eksportuj dane] na standardowym pasku narzędzi. Otwarte zostanie okno dialogowe Eksport danych.
  6. W tym oknie dialogowym można dokonać ustawień pliku eksportu. Szczegółowy opis pól można znaleźć w artykule Eksport danych.
  7. Wykonać eksport, wybierając przycisk [W tle].

Import obiektów deweloperskich

Aby zaimportować obiekty deweloperskie należy:

  1. Otworzyć aplikację Zadania deweloperskie.
  2. Otworzyć zadanie deweloperskie, do którego mają zostać zaimportowane obiekty deweloperskie.
  3. Wybrać przycisk [Importuj obiekty deweloperskie z pliku] na standardowym pasku narzędzi. Otwarte zostanie okno dialogowe Importuj obiekty deweloperskie.
  4. Wprowadzić plik, z którego ma nastąpić import.
  5. Wykonać import, wybierając przycisk [W tle].

Import obiektów deweloperskich i refaktoryzacja

Aby zaimportować obiekty deweloperskie należy:

  1. Otworzyć aplikację Zadania deweloperskie.
  2. Otworzyć zadanie deweloperskie, do którego mają zostać zaimportowane obiekty deweloperskie.
  3. Wybrać przycisk [Importuj obiekty deweloperskie z pliku] na standardowym pasku narzędzi. Otwarte zostanie okno dialogowe Importuj obiekty deweloperskie.
  4. Wprowadzić plik, z którego ma nastąpić import.
  5. Określić typ refaktoryzacji: Refactoring bez klas Java lub Refactoring z klasami Java.
  6. Wprowadzić prefiks deweloperski systemu źródłowego. Ten prefiks zostanie zastąpiony.
  7. Wprowadzić prefiks deweloperski systemu docelowego, jeśli szablon nie ma zastosowania. Ten prefiks deweloperski zostanie wstawiony.
  8. Określić plik (względem określonego folderu pliku źródłowego), w którym ma zostać wykonana refaktoryzacja.
  9. Wykonać import, wybierając przycisk [W tle].

Wymiana obiektów deweloperskich między dwoma systemami deweloperskimi

Aby dokonać wymiany obiektów deweloperskich między dwoma systemami deweloperskimi należy:

  1. Wyeksportować żądane obiekty deweloperskie z systemu źródłowego). W tym celu można wyeksportować obiekty deweloperskie za pomocą aplikacji Eksport danych. Należy również ograniczyć wyszukiwanie do niegenerowanych obiektów deweloperskich. Nie można importować wygenerowanych obiektów deweloperskich do systemu docelowego. Eksport należy przeprowadzić w dwóch krokach. W pierwszym kroku wyeksportować wszystkie dostosowane obiekty deweloperskie, z wyłączeniem obiektów deweloperskich typu Jednostka biznesowa. W drugim kroku wyeksportować wszystkie obiekty deweloperskie, które zostały utworzone w tym systemie. Ta procedura gwarantuje, że pliki eksportu nie zawierają żadnych obiektów deweloperskich, których zasadniczo nie można zaimportować.
  2. Zaimportować obiekty deweloperskie do systemu docelowego (więcej informacji można znaleźć w rozdziale Import obiektów deweloperskich lub Import obiektów deweloperskich i refaktoryzacja).

Transporty między systemami o różnych poziomach wersjonowania

Podczas transportu między systemami o różnych poziomach wersjonowania należy postępować z jednym ograniczeniem, jak opisano w rozdziale Wymiana obiektów deweloperskich między dwoma systemami deweloperskimi.

Ponieważ nowe elementy dla dostosowanych zestawów wartości mają identyfikator (więcej informacji można znaleźć w artykule Obiekty deweloperskie), który znajduje się w obszarze zależnym od systemu deweloperskiego, należy najpierw ręcznie zmienić plik, z którym ma nastąpić import. Odpowiednim elementom należy przypisać nowe ID.

Łączenie kilku opracowań partnerskich

Podczas scalania kilku programów partnerskich może pojawić się problem z refaktoryzacją klas komunikatów. Jeśli, przykładowo, klasa komunikatów P1_GEN została utworzona w jednym systemie, a klasa komunikatów P2_GEN w innym systemie, podczas scalania pojawi się następujący problem:

W nowym systemie obie klasy są zmieniane na P3_GEN, na przykład podczas refaktoryzacji. W rezultacie komunikaty nie są już unikalne w systemie docelowym i powstaje niespójny stan. Można uniknąć tego problemu poprzez ręczną zmianę pliku XML i źródeł Java. Należy zastąpić jedną z klas komunikatów, aby refaktoryzacja prowadziła do jednoznacznych wyników. Problemu można uniknąć, używając klas komunikatów w systemach deweloperskich, które są unikatowe bez prefiksu deweloperskiego.

Opis okien dialogowych eksportu i importu

Okno dialogowe eksportu

Okna dialogowe eksportu w aplikacji Obiekty deweloperskie i aplikacji Zadania deweloperskie mają identyczną strukturę podstawową. W oknie dialogowym eksportu aplikacji Zadania deweloperskie można również wybrać typ eksportu (więcej informacji można znaleźć w rozdziale Eksport w aplikacji Zadania deweloperskie).

  • Akcja — pole w aplikacji Zadania deweloperskie, umożliwiające wybór typu eksportu.
    • Obiekty deweloperskie wyeksportowano do pliku — wszystkie obiekty deweloperskie zadania deweloperskiego są eksportowane do pliku.
    • Na każdy obiekt deweloperski należy eksportować jeden plik — każdy obiekt deweloperski zadania deweloperskiego jest eksportowany do osobnego pliku. Obszar nazw obiektu deweloperskiego tworzy strukturę folderów, w której przechowywany jest plik eksportu. Nazwa pliku składa się z typu obiektu deweloperskiego i nazwy obiektu deweloperskiego.
    • Eksport obiektu deweloperskiego i wersji porównania każdy do jednego pliku — tutaj również tworzony jest plik dla każdego obiektu deweloperskiego. Wersje porównawcze są również przechowywane w dodatkowych folderach; więcej informacji można znaleźć w sekcji Eksport w aplikacji Zadania deweloperskie.
  • System plików — funkcja dostępna w aplikacjach Obiekty deweloperskie i Zadania deweloperskie. Jeśli wybrano tę opcję, pliki eksportu są przechowywane w folderze roboczym.
    • Główny folder — to pole uwzględniane tylko po wybraniu opcji System plików. Wskazuje ono folder, w którym przechowywany jest plik eksportu. Eksport odbywa się zawsze w folderze roboczym. W aplikacji Obiekty deweloperskie eksport odbywa się do folderu bieżącego użytkownika (…/work/usrXXX/export). W aplikacji Zadania deweloperskie, folder eksportu zależy od statusu zadania. Jeśli zadanie deweloperskie jest otwarte, eksport odbywa się do folderu zadania deweloperskiego i bieżącego użytkownika (…/work/jobXXXXX/usrXXX/export). Jeśli zadanie deweloperskie jest aktywne, eksport odbywa się do folderu bieżącego użytkownika (…/work/usrXXX/jobXXXXX/export).
  • Folder docelowy — funkcja dostępna w aplikacjach Obiekty deweloperskie i Zadania deweloperskie. To pole jest uwzględniane tylko po wybraniu opcji System plików. W tym miejscu można określić dodatkowe foldery, które zostaną utworzone względem folderu głównego. Eksport odbywa się do określonego folderu. Jeśli nie zostanie określony żaden folder, eksport zostanie wykonany do folderu głównego. W przypadku eksportu wersji porównawczych wymagana struktura folderów jest automatycznie tworzona w tym folderze.
  • Plik docelowy — funkcja dostępna w aplikacji Zadania deweloperskie. To pole jest uwzględniane tylko w przypadku wybrania opcji System plików i akcji Obiekty deweloperskie wyeksportowano do pliku. W tym miejscu należy wprowadzić nazwę pliku, do którego mają zostać wyeksportowane obiekty deweloperskie. Ścieżka do pliku składa się z folderu głównego i pliku docelowego. Opcjonalnie można wprowadzić folder przed nazwą pliku.
  • Knowledge Store funkcja dostępna w aplikacjach Obiekty deweloperskie i Zadania deweloperskie. Jeśli wybrano tę opcję, eksportowane pliki są przechowywane w Knowledge Store.
  • Folder docelowyfunkcja dostępna w aplikacjach Obiekty deweloperskie i Zadania deweloperskie. To pole jest uwzględniane tylko po wybraniu opcji Knowledge Store. W tym miejscu należy wprowadzić folder, do którego ma zostać wykonany eksport. Jeśli użytkownik eksportuje wersje porównawcze, wymagana struktura folderów jest automatycznie tworzona w tym folderze.
  • Plik docelowyfunkcja dostępna w aplikacji Zadania deweloperskie. To pole jest uwzględniane tylko w przypadku wybrania opcji Knowledge Store i akcji Obiekty deweloperskie wyeksportowano do pliku. W tym miejscu należy wprowadzić folder i nazwę pliku, do którego mają zostać wyeksportowane obiekty deweloperskie.

Okno dialogowe importu

Import odbywa się w aplikacji Zadania deweloperskie. Więcej informacji znajduje się w rozdziale Import obiektów deweloperskich.

  • System plików — po wybraniu tej opcji plik importu jest ładowany z folderu roboczego
  • Główny folder — to pole jest uwzględniane tylko po wybraniu opcji System plików. Import odbywa się z folderu roboczego bieżącego zadania deweloperskiego i bieżącego użytkownika (…/work/jobXXXXX/usrXXXXX/import).
  • Plik źródłowy — to pole jest uwzględniane tylko po wybraniu opcji System plików. W tym miejscu należy wprowadzić nazwę pliku, z którego mają zostać zaimportowane obiekty deweloperskie. Ścieżka do pliku składa się z folderu głównego i pliku źródłowego. Opcjonalnie można również wprowadzić foldery przed nazwami plików.
  • Knowledge Store — jeśli wybrano tę opcję, plik importu zostanie załadowany z Knowledge Store
  • Plik źródłowy — to pole jest uwzględniane tylko po wybraniu opcji Knowledge Store. W tym miejscu należy wprowadzić folder i nazwę pliku, z którego mają zostać zaimportowane obiekty deweloperskie.
  • Refakturowanie — w tym polu można określić, czy obiekty deweloperskie mają być refaktoryzowane podczas importu. Można zdecydować, czy klasy Java mają być brane pod uwagę podczas refaktoryzacji, czy nie.
  • Prefiks deweloperski systemu źródłowego — to pole jest brane pod uwagę tylko wtedy, gdy ma zostać przeprowadzona refaktoryzacja. W tym miejscu należy wprowadzić prefiks deweloperski, który ma zostać zastąpiony podczas importu. System docelowy prefiksu deweloperskiego i system źródłowy prefiksu deweloperskiego nie mogą być identyczne.
  • Prefiks deweloperski systemu docelowego — to pole jest brane pod uwagę tylko wtedy, gdy ma zostać przeprowadzona refaktoryzacja. W tym miejscu należy wprowadzić prefiks deweloperski, który ma zostać wstawiony podczas importu. Szablon jest prefiksem deweloperskim systemu. Prefiks deweloperski systemu docelowego i prefiks deweloperski systemu źródłowego nie mogą być identyczne.
  • Plik docelowy — to pole jest brane pod uwagę tylko wtedy, gdy ma zostać przeprowadzona refaktoryzacja. W tym polu należy wprowadzić plik docelowy. Plik docelowy jest tworzony względem folderu pliku źródłowego. Plik źródłowy jest kopiowany do określonego pliku docelowego. Refaktoryzacja jest przeprowadzana na tym pliku docelowym, a następnie plik docelowy jest importowany. Plik docelowy i plik źródłowy nie mogą być identyczne. Opcjonalnie można określić foldery przed plikiem docelowym.

Czy ten artykuł był pomocny?