{"id":10545,"date":"2024-06-20T09:46:49","date_gmt":"2024-06-20T07:46:49","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/640\/?post_type=ht_kb&#038;p=10545"},"modified":"2024-06-20T09:46:51","modified_gmt":"2024-06-20T07:46:51","slug":"praca-z-klasami-update","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/praca-z-klasami-update\/","title":{"rendered":"Praca z klasami Update"},"content":{"rendered":"<h3 id=\"przeglad-tematu\" >Przegl\u0105d tematu<\/h3>\n<p>Klasy aktualizacji stanowi\u0105 podstaw\u0119 implementacji zmian w modelu danych. Narz\u0119dzie <em>wrkupdcls<\/em> wspiera rozw\u00f3j klas aktualizacji z dodatkowymi informacjami i operacjami.<\/p>\n<h3 id=\"grupa-docelowa\" >Grupa docelowa<\/h3>\n<ul>\n<li>Programista aplikacji<\/li>\n<li>Administratorzy systemu<\/li>\n<\/ul>\n<h3 id=\"opis\" >Opis<\/h3>\n<p>Narz\u0119dzie <em>wrkupdcls<\/em> wspiera deweloper\u00f3w w tworzeniu zmian w modelu danych. Mo\u017cna u\u017cy\u0107 opcji &#8211;<em>addChangeValue<\/em>, aby doda\u0107 metod\u0119 <em>ChangeValue<\/em> do klasy <em>UpdateLogic<\/em>. Klasa <em>UpdateLogic<\/em> musi by\u0107 zablokowana lokalnie przez u\u017cytkownika.<\/p>\n<section class=\"document-alert-box example\"><div class=\"document-alert-title\">Przyk\u0142ad<\/div><div class=\"document-alert-content\">wrkupdcls -addChangeValue -name:XYZ001234 -path:description<\/p>\n<p>-o:com.cisag.app.general.obj.Item<\/div><\/section>\n<p>Mo\u017cna u\u017cy\u0107 opcji &#8211;<em>printChangeValue<\/em>, aby utworzy\u0107 metod\u0119 <em>ChangeValue<\/em> i wy\u015bwietli\u0107 j\u0105 w pow\u0142oce narz\u0119dzia.<\/p>\n<section class=\"document-alert-box example\"><div class=\"document-alert-title\">Przyk\u0142ad<\/div><div class=\"document-alert-content\">wrkupdcls -printChangeValue -name:XYZ001234 -path:description<\/p>\n<p>-o:com.cisag.app.general.obj.Item<\/div><\/section>\n<p>Za pomoc\u0105 opcji &#8211;<em>printUpgrade<\/em> mo\u017cna wy\u015bwietli\u0107 zmiany modelu danych wywo\u0142ane w sekwencji wywo\u0142a\u0144 w pow\u0142oce narz\u0119dzia. Opcji tej mo\u017cna u\u017cy\u0107 na przyk\u0142ad do analizy importu zmiany modelu danych do systemu produkcyjnego.<\/p>\n<section class=\"document-alert-box example\"><div class=\"document-alert-title\">Przyk\u0142ad<\/div><div class=\"document-alert-content\">wrkupdcls -printUpgrade<\/p>\n<p>-sourceVersion:23.0:5.0.0 -targetVersion:30.0.1:5.0.0<\/p>\n<p>-o:com.cisag.app.general.obj.Item<\/div><\/section>\n<h4 id=\"polecenie\" >Polecenie<\/h4>\n<p>Poni\u017cej znajduje si\u0119 polecenie zawieraj\u0105ce wszystkie mo\u017cliwe parametry.<\/p>\n<table>\n<tbody>\n<tr>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff;\" width=\"123\">wrkupdcls<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff;\" width=\"416\">[-o:&lt;str-1&gt; &#8230; -o:&lt;str-n&gt;] [-addChangeValue] [-printChangeValue] [-name:&lt;str&gt;] [-path:&lt;str&gt;] [-printUpgrade] [-sourceVersion:&lt;str&gt;] [-targetVersion:&lt;str&gt;] [-printHistory]<\/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. Parametry w nawiasach kwadratowych s\u0105 opcjonalne, podczas gdy pozosta\u0142e s\u0105 obowi\u0105zkowe. Gwiazdka (*) mo\u017ce by\u0107 okre\u015blona jako symbol zast\u0119pczy dla niekt\u00f3rych parametr\u00f3w, aby m\u00f3c wy\u015bwietli\u0107 wszystkie mo\u017cliwe warto\u015bci. Nie wszystkie parametry mog\u0105 by\u0107 okre\u015blone wi\u0119cej ni\u017c jeden raz; tylko te z nast\u0119puj\u0105cym dodatkiem do zmiennych parametr\u00f3w s\u0105 dozwolone do wielokrotnego okre\u015blenia: &#8222;&lt;str-1&gt; &#8230;. &lt;str-n&gt;&#8221;.<\/p>\n<p>Parametr musi by\u0107 kompletny, np. -f&lt;str&gt;, i wymieniony zgodnie z kolejno\u015bci\u0105 u\u017cycia w poleceniu.<\/p>\n<table style=\"width: 100%; height: 1336px;\">\n<thead>\n<tr style=\"height: 23px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 23px;\" width=\"188\"><strong>Parametry<\/strong><\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 23px;\" width=\"350\"><strong>Wyja\u015bnienie<\/strong><\/td>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 23px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 23px;\" width=\"188\">[-o:&lt;str-1&gt; &#8230; -o:&lt;str-n&gt;].<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 23px;\" width=\"350\">Wyb\u00f3r obiektu biznesowego wed\u0142ug nazwy.<\/td>\n<\/tr>\n<tr style=\"height: 383px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 383px;\" width=\"188\">[-addChangeValue].<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 383px;\" width=\"350\">Mo\u017cna u\u017cy\u0107 parametru -addChangeValue, aby doda\u0107 metod\u0119 ChangeValue do klasy UpdateLogic. Aby m\u00f3c utworzy\u0107 metod\u0119 ChangeValue, nale\u017cy okre\u015bli\u0107 parametry -o, -path i -name.Okre\u015blony obiekt biznesowy, dla kt\u00f3rego generowana jest metoda zmiany warto\u015bci, oraz klasa UpdateLogic, kt\u00f3ra ma zosta\u0107 rozszerzona, musz\u0105 zosta\u0107 zablokowane przez u\u017cytkownika w zadaniu programistycznym.<\/p>\n<p>Metoda ChangeValue jest do\u0142\u0105czana do odpowiedniej klasy UpdateLogic. Je\u015bli metoda ChangeValue ju\u017c istnieje, nowa metoda ChangeValue jest dodawana jako komentarz. Przenie\u015b adnotacj\u0119 historii z nowej metody do istniej\u0105cej i usu\u0144 komentarz.<\/td>\n<\/tr>\n<tr style=\"height: 70px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 70px;\" width=\"188\">[-printChangeValue]<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 70px;\" width=\"350\">Mo\u017cna u\u017cy\u0107 parametru -printChangeValue, aby wy\u015bwietli\u0107 sygnatur\u0119 metody ChangeValue. Aby wy\u015bwietli\u0107 metod\u0119 ChangeValue, nale\u017cy okre\u015bli\u0107 parametry -o, -path i -name.<\/td>\n<\/tr>\n<tr style=\"height: 241px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 241px;\" width=\"188\">[-name:&lt;str&gt;]<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 241px;\" width=\"350\">Nazwa do generowania metody ChangeValue z -addChangeValue lub -printChangeValue. Nazwa powinna by\u0107 unikalna we wszystkich wydaniach. Je\u015bli u\u017cywany jest system zg\u0142osze\u0144 rozwojowych, zalecana jest nazwa zg\u0142oszenia rozwojowego. W przypadku przetwarzania konfliktu z r\u00f3wnoleg\u0142\u0105 konserwacj\u0105, nazwa musi pochodzi\u0107 ze starszej wersji.Nazwa powinna zawiera\u0107 tylko litery i cyfry, ale bez znak\u00f3w specjalnych.<\/td>\n<\/tr>\n<tr style=\"height: 46px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 46px;\" width=\"188\">[-path:&lt;str&gt;]<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 46px;\" width=\"350\">\u015acie\u017cka atrybutu kolumny do generowania metody ChangeValue z -addChangeValue lub -printChangeValue.<\/td>\n<\/tr>\n<tr style=\"height: 116px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 116px;\" width=\"188\">[-printUpgrade]<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 116px;\" width=\"350\">Wy\u015bwietla wszystkie metody klas aktualizacji wymagane do zmiany modelu danych. Metody s\u0105 wyprowadzane w kolejno\u015bci, w jakiej s\u0105 wywo\u0142ywane. Parametry -sourceVersion i -targetVersion mog\u0105 by\u0107 u\u017cyte do okre\u015blenia wersji \u017ar\u00f3d\u0142owej i docelowej zmiany modelu danych.<\/td>\n<\/tr>\n<tr style=\"height: 194px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 194px;\" width=\"188\">[-sourceVersion:&lt;str&gt;]<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 194px;\" width=\"350\">Wersja \u017ar\u00f3d\u0142owa obiektu biznesowego dla zmiany modelu danych. Parametr -sourceVersion jest wymagany dla parametru -printUpgrade. Je\u015bli ten parametr nie zostanie okre\u015blony, aktywna wersja obiektu biznesowego jest warto\u015bci\u0105 domy\u015bln\u0105.Wersja jest okre\u015blana dok\u0142adnie tak, jak jest wy\u015bwietlana na przyk\u0142ad w aplikacji <em>Obiekty deweloperskie<\/em>. NP. &#8222;3.1:5.0.0&#8221;<\/td>\n<\/tr>\n<tr style=\"height: 217px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 217px;\" width=\"188\">[-targetVersion:&lt;str&gt;]<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 217px;\" width=\"350\">Docelowa wersja obiektu biznesowego dla zmiany modelu danych. Parametr -targetVersion jest wymagany dla parametru -printUpgrade. Je\u015bli ten parametr nie zostanie okre\u015blony, aktywna lub zablokowana wersja obiektu biznesowego jest warto\u015bci\u0105 domy\u015bln\u0105.Wersja jest okre\u015blana dok\u0142adnie tak, jak jest wy\u015bwietlana na przyk\u0142ad w aplikacji <em>Obiekty deweloperskie<\/em>. NP. &#8222;3.1:5.0.0&#8221;<\/td>\n<\/tr>\n<tr style=\"height: 23px;\">\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 23px;\" width=\"188\">[-printHistory]<\/td>\n<td style=\"border-style: outset; border-color: #000000; background-color: #ffffff; height: 23px;\" width=\"350\">Wy\u015bwietla ca\u0142\u0105 histori\u0119 zmian kolumn obiektu biznesowego.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n","protected":false},"author":27,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-10545","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-zadania-programistyczne"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/10545","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/users\/27"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/comments?post=10545"}],"version-history":[{"count":2,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/10545\/revisions"}],"predecessor-version":[{"id":14504,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/10545\/revisions\/14504"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/media?parent=10545"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}