{"id":12347,"date":"2024-11-25T09:58:32","date_gmt":"2024-11-25T08:58:32","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/?post_type=ht_kb&#038;p=12347"},"modified":"2024-11-25T09:58:41","modified_gmt":"2024-11-25T08:58:41","slug":"wstepna-konwersja-obiektow-biznesowych-prlcnv","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/wstepna-konwersja-obiektow-biznesowych-prlcnv\/","title":{"rendered":"Wst\u0119pna konwersja obiekt\u00f3w biznesowych (prlcnv)"},"content":{"rendered":"<h3 id=\"wprowadzenie\" id=\"wprowadzenie\" >Wprowadzenie<\/h3>\n<p>Zmiany schematu tabeli w Business Objects mog\u0105 znacznie wyd\u0142u\u017cy\u0107 czas aktualizacji do nowej wersji. Narz\u0119dzie <em>prlcnv<\/em> jest dostarczane w celu zminimalizowania przestoj\u00f3w systemu produkcyjnego wymaganych do aktualizacji wersji. Korzystanie z tego narz\u0119dzia zmienia proces aktualizacji wydania: czasoch\u0142onne zmiany schematu tabeli mo\u017cna przeprowadzi\u0107 przed faktyczn\u0105 aktualizacj\u0105 wydania. Jest to konwersja wst\u0119pna.<\/p>\n<h3 id=\"grupa-docelowa\" id=\"grupa-docelowa\" >Grupa docelowa<\/h3>\n<ul>\n<li>Administratorzy systemu<\/li>\n<\/ul>\n<h3 id=\"opis\" id=\"opis\" >Opis<\/h3>\n<p>Narz\u0119dzie <em>prlcnv<\/em> s\u0142u\u017cy do tworzenia tabel tymczasowych (tabel QC) dla wybranych obiekt\u00f3w biznesowych w systemie docelowym, kt\u00f3rych schematy s\u0105 pobierane z tabel systemu \u017ar\u00f3d\u0142owego. Dane z systemu docelowego s\u0105 nast\u0119pnie konwertowane do tych tabel tymczasowych. Je\u015bli zmiana schematu tabeli zostanie nast\u0119pnie przeprowadzona w systemie docelowym, np. podczas zmiany wersji, dane w tabelach tymczasowych s\u0105 uznane za ju\u017c przekonwertowane. Tylko rekordy danych, kt\u00f3re zosta\u0142y zmienione od czasu wst\u0119pnej konwersji, s\u0105 ponownie konwertowane.<\/p>\n<p>Zmniejszona liczba rekord\u00f3w danych do konwersji mo\u017ce skr\u00f3ci\u0107 czas wymagany do aktualizacji wydania w systemie produkcyjnym.<\/p>\n<p>Zalecanym jest u\u017cycie narz\u0119dzia <em>prlcnv<\/em> w testowym systemie produkcyjnym przed aktualizacj\u0105 wersji. W razie potrzeby narz\u0119dzie mo\u017ce by\u0107 r\u00f3wnie\u017c u\u017cywane do indywidualnej instalacji aktualizacji oprogramowania.<\/p>\n<h4 id=\"wymagania-i-ograniczenia-techniczne\" >Wymagania i ograniczenia techniczne<\/h4>\n<h5 id=\"wymagania-techniczne\" >Wymagania techniczne<\/h5>\n<p>Aktualizacja wersji musi zosta\u0107 przeprowadzona na innym systemie testowym, zanim zostanie przeprowadzona na systemie produkcyjnym. System ten jest kopi\u0105 systemu produkcyjnego, zwykle testowy system produkcyjny.<\/p>\n<p>System ten musi spe\u0142nia\u0107 nast\u0119puj\u0105ce wymagania, aby mo\u017cna by\u0142o u\u017cy\u0107 narz\u0119dzia <em>prlcnv<\/em> do wst\u0119pnej konwersji:<\/p>\n<ul>\n<li>dane musz\u0105 odpowiada\u0107 danym z systemu produkcyjnego. Podczas zmiany przed wydaniem mierzone s\u0105 czasy wykonania zmiany wydania, kt\u00f3re powinny odpowiada\u0107 w przybli\u017ceniu oczekiwanym czasom wykonania w systemie produkcyjnym.<\/li>\n<li>system musi by\u0107 skonfigurowany w tej samej bazie konfiguracyjnej, co system produkcyjny.<\/li>\n<li>po\u0142\u0105czenie z systemem produkcyjnym musi by\u0107 mo\u017cliwe, tj. na przyk\u0142ad nie mo\u017ce istnie\u0107 zapora uniemo\u017cliwiaj\u0105ca po\u0142\u0105czenie.<\/li>\n<\/ul>\n<h5 id=\"ograniczenia-techniczne\" >Ograniczenia techniczne<\/h5>\n<p>Instrukcje aktualizacji, usuwania i wstawiania uniemo\u017cliwiaj\u0105 korzystanie z wcze\u015bniej przekonwertowanych danych z przyczyn technicznych. Instrukcje te maj\u0105 bezpo\u015bredni wp\u0142yw na baz\u0119 danych i dlatego uniemo\u017cliwiaj\u0105 rejestrowanie zmienionych rekord\u00f3w danych na li\u015bcie transfer\u00f3w. Dlatego w takim przypadku ca\u0142a wst\u0119pna konwersja dla tego obiektu biznesowego musi zosta\u0107 uznana za niewa\u017cn\u0105.<\/p>\n<p>Zalecanym jest uruchomienie narz\u0119dzia <em>prlcnv<\/em> z opcj\u0105 <em>check<\/em> przed zmian\u0105 wersji systemu produkcyjnego. Sprawdzana jest m.in. liczba obiekt\u00f3w w aktywnej tabeli z liczb\u0105 wpis\u00f3w na li\u015bcie transfer\u00f3w. U\u017cycie wst\u0119pnie przekonwertowanych danych ma zastosowanie tylko wtedy, gdy liczba wpis\u00f3w na li\u015bcie transferowej jest znacznie ni\u017csza ni\u017c liczba obiekt\u00f3w w aktywnej tabeli.<\/p>\n<h5 id=\"wymagania-organizacyjne\" >Wymagania organizacyjne<\/h5>\n<p>Po wst\u0119pnej konwersji danych wszystkie zmiany w tych danych, kt\u00f3re wyst\u0119puj\u0105 podczas bie\u017c\u0105cej pracy systemu produkcyjnego, s\u0105 rejestrowane na li\u015bcie transferu. Tylko dane, kt\u00f3rych dotycz\u0105 te zmiany, musz\u0105 zosta\u0107 przekonwertowane podczas aktualizacji systemu produkcyjnego, co mo\u017ce ostatecznie skr\u00f3ci\u0107 czas aktualizacji.<\/p>\n<p>Zakres, w jakim czas ten jest faktycznie skr\u00f3cony, zale\u017cy od ilo\u015bci danych zmienionych po konwersji wst\u0119pnej. Dlatego zalecanym jest, aby aktualizacja wydania systemu produkcyjnego nie by\u0142a przeprowadzana p\u00f3\u017aniej ni\u017c 1 do 2 tygodni po wst\u0119pnej konwersji danych i aby w tym okresie nie przeprowadzano obszernego transferu danych ani aktualizacji danych.<\/p>\n<h4 id=\"polecenie\" id=\"polecenie\" >Polecenie<\/h4>\n<p>Poni\u017cej znajduje si\u0119 polecenie wraz ze wszystkimi mo\u017cliwymi parametrami.<\/p>\n<table style=\"border-collapse: collapse; width: 100%; height: 23px;\">\n<tbody>\n<tr style=\"height: 23px;\">\n<td style=\"width: 50%; height: 23px; border-style: outset;\">prlcnv<\/td>\n<td style=\"width: 50%; height: 23px; border-style: outset;\">[-prepare][-generate][-convert]<\/p>\n<p>[-deactivate]<\/p>\n<p>[-cleanUp]<\/p>\n<p>[-check]<\/p>\n<p>[-o:&lt;str&gt;]<\/p>\n<p>[-db:&lt;id&gt;]<\/p>\n<p>[-system:&lt;id&gt;]<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4 id=\"parametry\" >Parametry<\/h4>\n<p>Parametry polecenia zosta\u0142y wyja\u015bnione w poni\u017cszej tabeli. Nie wszystkie parametry mog\u0105 by\u0107 wymienione wi\u0119cej ni\u017c jeden raz. Tylko te z nast\u0119puj\u0105cym dodatkiem do zmiennych parametr\u00f3w s\u0105 dozwolone do wielokrotnego nazywania: <em>&lt;str-1&gt;&#8230;&lt;str-n&gt;<\/em>.<\/p>\n<table style=\"border-collapse: collapse; width: 100%; height: 1360px;\">\n<tbody>\n<tr style=\"height: 23px;\">\n<td style=\"width: 50%; height: 23px; border-style: outset;\"><strong>Parametr<\/strong><\/td>\n<td style=\"width: 50%; height: 23px; border-style: outset;\"><strong>Opis<\/strong><\/td>\n<\/tr>\n<tr style=\"height: 163px;\">\n<td style=\"width: 50%; height: 163px; border-style: outset;\">[-prepare]<\/td>\n<td style=\"width: 50%; height: 163px; border-style: outset;\">Tworzy wpis dla obiektu biznesowego w docelowej bazie danych, i oznacza obiekt biznesowy do wst\u0119pnej konwersji. Przy ponownym uruchomieniu systemu docelowego uruchamiany jest kontroler TransferListController. Od tego momentu zmiany w okre\u015blonym obiekcie biznesowym s\u0105 zapisywane na li\u015bcie transferu.<\/td>\n<\/tr>\n<tr style=\"height: 309px;\">\n<td style=\"width: 50%; height: 309px; border-style: outset;\" width=\"180\">[-generate]<\/td>\n<td style=\"width: 50%; height: 309px; border-style: outset;\">Generuje tabele tymczasowe do konwersji w systemie docelowym, je\u015bli odpowiedni obiekt biznesowy jest oznaczony do wst\u0119pnej konwersji w systemie docelowym.Schematy tabel s\u0105 pobierane z odpowiednich schemat\u00f3w systemu \u017ar\u00f3d\u0142owego.Gdy tylko tabele tymczasowe zostan\u0105 utworzone w systemie docelowym, mo\u017cna rozpocz\u0105\u0107 faktyczn\u0105 konwersj\u0119 wst\u0119pn\u0105.<\/td>\n<\/tr>\n<tr style=\"height: 116px;\">\n<td style=\"width: 50%; height: 116px; border-style: outset;\" width=\"180\">[-convert]<\/td>\n<td style=\"width: 50%; height: 116px; border-style: outset;\">Konwertuje dane okre\u015blonych obiekt\u00f3w biznesowych do wcze\u015bniej utworzonych tabel tymczasowych. Po zako\u0144czeniu konwersji dla odpowiedniego obiektu biznesowego ustawiany jest status.<\/td>\n<\/tr>\n<tr style=\"height: 280px;\">\n<td style=\"width: 50%; height: 280px; border-style: outset;\" width=\"180\">[-deactivate]<\/td>\n<td style=\"width: 50%; height: 280px; border-style: outset;\">Dezaktywuje wst\u0119pn\u0105 konwersj\u0119 dla obiektu biznesowego, kt\u00f3ry zosta\u0142 ju\u017c oznaczony do wst\u0119pnej konwersji.<section class=\"document-alert-box warning\"><div class=\"document-alert-title\">Uwaga<\/div><div class=\"document-alert-content\">Dezaktywacji nie mo\u017cna anulowa\u0107. Je\u015bli obiekt biznesowy ma zosta\u0107 przekonwertowany, nale\u017cy ponownie wykona\u0107 parametr <em>-prepare<\/em>, okre\u015blaj\u0105c ten obiekt biznesowy.<\/div><\/section><\/td>\n<\/tr>\n<tr style=\"height: 23px;\">\n<td style=\"width: 50%; height: 23px; border-style: outset;\" width=\"180\">[-cleanUp]<\/td>\n<td style=\"width: 50%; height: 23px; border-style: outset;\">Usuwa wszystkie dane z systemu docelowego, kt\u00f3re zosta\u0142y utworzone w ramach przygotowa\u0144 do konwersji wst\u0119pnej. Wykonywane automatycznie po pomy\u015blnym zako\u0144czeniu konwersji.<\/td>\n<\/tr>\n<tr style=\"height: 377px;\">\n<td style=\"width: 50%; height: 377px; border-style: outset;\" width=\"180\">[-check]<\/td>\n<td style=\"width: 50%; height: 377px; border-style: outset;\">Sprawdza dla okre\u015blonych obiekt\u00f3w biznesowych, czy konwersja zosta\u0142a pomy\u015blnie wykonana i czy operacje seryjne, np. aktualizacje danych, zosta\u0142y wykonane dla tych obiekt\u00f3w biznesowych.Dla ka\u017cdego obiektu biznesowego wy\u015bwietlana jest liczba rekord\u00f3w danych w aktywnej tabeli oraz liczba rekord\u00f3w, kt\u00f3re nale\u017cy ponownie przekonwertowa\u0107 w ramach zmiany wersji (liczba wpis\u00f3w na li\u015bcie transferu) w warto\u015bciach bezwzgl\u0119dnych i procentowych.<\/td>\n<\/tr>\n<tr style=\"height: 23px;\">\n<td style=\"width: 50%; height: 23px; border-style: outset;\">[-o:&lt;str&gt;]<\/td>\n<td style=\"width: 50%; height: 23px; border-style: outset;\">Parametr s\u0142u\u017cy do wyboru obiektu wed\u0142ug jego w pe\u0142ni kwalifikowanej nazwy (w tym przestrzeni nazw).<\/td>\n<\/tr>\n<tr style=\"height: 23px;\">\n<td style=\"width: 50%; height: 23px; border-style: outset;\">[-db:&lt;id&gt;]<\/td>\n<td style=\"width: 50%; height: 23px; border-style: outset;\">Nazwa docelowej bazy danych.<\/td>\n<\/tr>\n<tr style=\"height: 23px;\">\n<td style=\"width: 50%; height: 23px; border-style: outset;\">[-system:&lt;id&gt;]<\/td>\n<td style=\"width: 50%; height: 23px; border-style: outset;\">Nazwa systemu docelowego.Musi to by\u0107 kopia systemu produkcyjnego, zwykle testowego systemu produkcyjnego.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"procedura\" >Procedura<\/h3>\n<ol>\n<li>W pierwszej kolejno\u015bci nale\u017cy przeprowadzi\u0107 aktualizacj\u0119 w produkcyjnym systemie testowym (systemie \u017ar\u00f3d\u0142owym). Czas wymagany do konwersji schemat\u00f3w tabel poszczeg\u00f3lnych obiekt\u00f3w biznesowych jest rejestrowany w pliku. Plik znajduje si\u0119 w katalogu <em>log<\/em> serwera i jest nazwany zgodnie z nast\u0119puj\u0105cym wzorem: Convert&lt;nazwa bazy danych&gt;_&lt;timestamp&gt;.csv<\/li>\n<li>Na podstawie zarejestrowanych czas\u00f3w konwersji, nale\u017cy zdecydowa\u0107, dla kt\u00f3rych obiekt\u00f3w biznesowych konwersja wst\u0119pna powinna by\u0107 wykonana.<\/li>\n<li>Wykona\u0107 polecenie <em>prlcnv<\/em> z parametrem <em>prepare<\/em> na produkcyjnym systemie testowym (system \u017ar\u00f3d\u0142owy), okre\u015blaj\u0105c te obiekty biznesowe. Wskazane obiekty biznesowe s\u0105 przygotowywane do wst\u0119pnej konwersji w okre\u015blonej bazie danych systemu produkcyjnego (systemu docelowego).<\/li>\n<li>Uruchomi\u0107 ponownie system produkcyjny (system docelowy). Rejestrowanie zmian jest aktywowane: je\u015bli instancje okre\u015blonych obiekt\u00f3w biznesowych zostan\u0105 zmienione, ich klucze podstawowe zostan\u0105 zapisane na li\u015bcie transferu.<\/li>\n<\/ol>\n<section class=\"document-alert-box warning\"><div class=\"document-alert-title\">Uwaga<\/div><div class=\"document-alert-content\">Zmiany wprowadzone za pomoc\u0105 instrukcji update, delete i insert nie s\u0105 zapisywane na li\u015bcie transferu.<\/div><\/section>\n<p>5. Wykona\u0107 polecenie <em>prlcnv<\/em> z parametrem <em>generate<\/em> w produkcyjnym systemie testowym (system \u017ar\u00f3d\u0142owy), ponownie okre\u015blaj\u0105c odpowiednie obiekty biznesowe. Tabele tymczasowe (tabele QC) s\u0105 generowane dla okre\u015blonych obiekt\u00f3w biznesowych w systemie produkcyjnym (systemie docelowym). Tabele te s\u0105 generowane z nowym schematem tabeli z produkcyjnego systemu testowego (systemu \u017ar\u00f3d\u0142owego).<\/p>\n<section class=\"document-alert-box warning\"><div class=\"document-alert-title\">Uwaga<\/div><div class=\"document-alert-content\">W przeciwie\u0144stwie do narz\u0119dzia <a href=\"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/tworzenie-obiektu-biznesowego-crtbo\/\"><em>crtbo<\/em><\/a>, nie ma to wp\u0142ywu na aktywne tabele. W bazie danych tworzone s\u0105 tylko nowe, puste tabele o odpowiedniej nazwie. Nie ogranicza to dzia\u0142ania systemu produkcyjnego.<\/div><\/section>\n<ol start=\"6\">\n<li>Wykona\u0107 polecenie <em>prlcnv<\/em> z parametrem <em>convert<\/em> w produkcyjnym systemie testowym (system \u017ar\u00f3d\u0142owy), ponownie okre\u015blaj\u0105c odpowiednie obiekty biznesowe. Wykonywana jest rzeczywista konwersja danych. Dane w systemie produkcyjnym s\u0105 konwertowane do tabel tymczasowych przy u\u017cyciu logiki z produkcyjnego systemu testowego.<\/li>\n<\/ol>\n<ol start=\"7\">\n<li>W razie potrzeby wykona\u0107 polecenie <em>prlcnv<\/em> z parametrem <em>check<\/em> w testowym systemie produkcyjnym (system \u017ar\u00f3d\u0142owy), okre\u015blaj\u0105c odpowiednie obiekty biznesowe. Wy\u015bwietlona zostanie \u0142\u0105czna liczba instancji obiekt\u00f3w biznesowych oraz liczba instancji, kt\u00f3re wymagaj\u0105 ponownej konwersji. Pokazuje r\u00f3wnie\u017c, czy wyst\u0105pi\u0142o zdarzenie, kt\u00f3re uniewa\u017cnia wst\u0119pn\u0105 konwersj\u0119, np. aktualizacja danych.<\/li>\n<\/ol>\n<ol start=\"8\">\n<li>Przeprowadzi\u0107 aktualizacj\u0119 w systemie produkcyjnym (systemie docelowym). Na etapie konwersji uaktualnienia wydania tylko instancje odpowiednich obiekt\u00f3w biznesowych, kt\u00f3re uleg\u0142y zmianie od czasu wst\u0119pnej konwersji, s\u0105 konwertowane do nowego schematu tabeli.<\/li>\n<li>Uruchomi\u0107 ponownie system produkcyjny. Rejestrowanie zmian danych na li\u015bcie transferu jest wy\u0142\u0105czone.<\/li>\n<\/ol>\n<ol start=\"10\">\n<li>Zako\u0144czy\u0107 aktualizacj\u0119.<\/li>\n<\/ol>\n","protected":false},"author":18,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-12347","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-baza-danych"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/12347","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/users\/18"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/comments?post=12347"}],"version-history":[{"count":7,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/12347\/revisions"}],"predecessor-version":[{"id":20342,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/12347\/revisions\/20342"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/media?parent=12347"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}