{"id":8519,"date":"2024-07-11T13:16:33","date_gmt":"2024-07-11T11:16:33","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/640\/?post_type=ht_kb&#038;p=8519"},"modified":"2025-04-15T11:12:20","modified_gmt":"2025-04-15T09:12:20","slug":"obiekt-deweloperski-external-object","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/obiekt-deweloperski-external-object\/","title":{"rendered":"Obiekt deweloperski: External object"},"content":{"rendered":"<h3 id=\"wprowadzenie\" id=\"wprowadzenie\" >Wprowadzenie<\/h3>\n<p>Aplikacja<em>\u00a0<a href=\"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/obiekty-deweloperskie\/\">Obiekty deweloperskie<\/a><\/em> pozwala na rejestrowanie i przegl\u0105danie obiekt\u00f3w deweloperskich r\u00f3\u017cnych typ\u00f3w. W niniejszym artykule opisany zosta\u0142 obiekt o typie <em>External object.<\/em><\/p>\n<h3 id=\"opis\" id=\"opis\" ><span id=\"Opis\" class=\"ez-toc-section\"><\/span><span id=\"Opis\" class=\"ez-toc-section\"><\/span>Opis<\/h3>\n<p>Obiekt zewn\u0119trzny (<em>External object<\/em>) zapewnia techniczn\u0105 definicj\u0119 jednostki biznesowej. Obiekt zewn\u0119trzny jest zasadniczo kontenerem danych bez logiki biznesowej. Konkretne dane nale\u017c\u0105 do przywo\u0142ywanych obiekt\u00f3w biznesowych i s\u0105 r\u00f3wnie\u017c odczytywane i zapisywane z tabel bazy danych. Definicje atrybut\u00f3w obiekt\u00f3w zewn\u0119trznych zawsze odnosz\u0105 si\u0119 do atrybut\u00f3w przywo\u0142ywanych obiekt\u00f3w biznesowych.<\/p>\n<p>Obiekty zewn\u0119trzne s\u0142u\u017c\u0105 przede wszystkim jako interfejs dla danych zewn\u0119trznych. Atrybut zewn\u0119trzny odpowiada kolumnie bazy danych obiektu biznesowego, ale mo\u017ce mie\u0107 zupe\u0142nie inn\u0105 nazw\u0119.<\/p>\n<p>Klucze biznesowe s\u0105 preferowane jako atrybuty interfejsu; klucze techniczne s\u0105 wprowadzane do obiekt\u00f3w biznesowych jako klucze obce. W tym celu mo\u017cliwe jest rozwi\u0105zanie kluczy obcych w obiektach zewn\u0119trznych.<\/p>\n<p>Podczas generowania obiektu zewn\u0119trznego tworzona jest klasa Java, kt\u00f3ra umo\u017cliwia dost\u0119p do danych.<\/p>\n<p>W zak\u0142adce <em>Edytor<\/em> dost\u0119pne s\u0105 nast\u0119puj\u0105ce pola:<\/p>\n<p><em>Jednostka biznesowa<\/em> &#8211; w tym polu nale\u017cy wprowadzi\u0107 obiekt biznesowy, do kt\u00f3rego powinien odnosi\u0107 si\u0119 obiekt zewn\u0119trzny<\/p>\n<p><em>Oznaczenie<\/em> &#8211; nazwa obiektu zewn\u0119trznego<\/p>\n<h4 id=\"zakladka-kolumny-zewnetrzne\" >Zak\u0142adka <em>Kolumny zewn\u0119trzne<\/em><\/h4>\n<p>Na zak\u0142adce Kolumny zewn\u0119trzne dost\u0119pna jest tabela nast\u0119puj\u0105cymi kolumnami:<\/p>\n<p><em>Nazwa<\/em> &#8211; nazwa obiektu biznesowego, z kt\u00f3rego pochodzi atrybut at. W wi\u0119kszo\u015bci przypadk\u00f3w jest to nazwa wybranej jednostki biznesowej. Je\u015bli jednak atrybut pochodzi z rozwi\u0105zanego klucza obcego, jest to nazwa obiektu biznesowego, do kt\u00f3rego odnosi si\u0119 odpowiednie odniesienie.<\/p>\n<p><em>\u015acie\u017cka atrybutu<\/em> &#8211; nazwa atrybutu lub kolumny z obiektu biznesowego.<\/p>\n<p><em>Pierwotny typ danych<\/em> &#8211; wy\u015bwietla typ danych atrybutu.<\/p>\n<p><em>Wybrano<\/em> (pole wyboru) &#8211; opcje nale\u017cy zaznaczy\u0107, aby wybra\u0107 atrybut lub kolumn\u0119 obiektu biznesowego jako cz\u0119\u015b\u0107 obiektu zewn\u0119trznego.<\/p>\n<p><em>Nazwa zewn\u0119trzna<\/em> &#8211; pole aktywne, po zaznaczeniu opcji w kolumnie <em>Wybrano<\/em>. W tym polu nale\u017cy wprowadzi\u0107 nazw\u0119 atrybutu zewn\u0119trznego lub inn\u0105 nazw\u0119 zewn\u0119trzn\u0105. Jest to r\u00f3wnie\u017c nazwa atrybutu, za pomoc\u0105 kt\u00f3rej mo\u017cna go zaadresowa\u0107 programowo za po\u015brednictwem wygenerowanej klasy Java.<\/p>\n<p><em>Rozpoznane przez<\/em> &#8211; je\u015bli atrybut klucza obcego zosta\u0142 wybrany i rozwi\u0105zany, w tym polu wy\u015bwietlana jest nazwa rozwi\u0105zania klucza.<\/p>\n<p><em>Utworzony przez &#8211; <\/em>po rozwi\u0105zaniu atrybutu klucza obcego tworzone s\u0105 nowe atrybuty. Zazwyczaj odnosz\u0105 si\u0119 one do innego obiektu biznesowego. W tym polu wy\u015bwietlana jest nazwa programu rozpoznaj\u0105cego klucze, kt\u00f3ry utworzy\u0142 ten atrybut.<\/p>\n<p>Komentarz &#8211; komentarz do atrybutu. Wpis jest ograniczony do 1000 znak\u00f3w. Opisu nie mo\u017cna przet\u0142umaczy\u0107. Komentarze s\u0105 przenoszone do wygenerowanych \u017ar\u00f3de\u0142 Java. Umo\u017cliwia to na przyk\u0142ad oznaczenie atrybutu jako <em>@deprecated<\/em>.<\/p>\n<p>Nad tabel\u0105 dost\u0119pne s\u0105 przyciski:<\/p>\n<p>[<strong>Edycja] <\/strong>&#8211; je\u015bli na li\u015bcie atrybut\u00f3w wybrano wiersz, dla kt\u00f3rego zdefiniowano relacj\u0119, przycisk ten otwiera okno dialogowe w kt\u00f3rym\u00a0mo\u017cliwa jest na przyk\u0142ad konwersja do klucza biznesowego obiektu docelowego.<\/p>\n<p>Je\u015bli atrybut w wybranym wierszu jest u\u017cywany w relacji otwarte zostaje okno dialogowe.<\/p>\n<p>Dost\u0119pne pola w oknie dialogowym:<\/p>\n<p><em>Obiekt \u017ar\u00f3d\u0142owy<\/em> &#8211; nazwa obiektu biznesowego, kt\u00f3ry reprezentuje \u017ar\u00f3d\u0142o relacji.<\/p>\n<p><em>Relacja<\/em> &#8211; zazwyczaj relacja jest jednoznacznie definiowana przez wybrany atrybut \u017ar\u00f3d\u0142owego obiektu biznesowego. Istniej\u0105 jednak wyj\u0105tki, w kt\u00f3rych atrybut jest u\u017cywany dla kilku relacji.<\/p>\n<p><em>Obiekt docelowy &#8211; n<\/em>azwa obiektu biznesowego, kt\u00f3ry reprezentuje cel relacji.<\/p>\n<p><em>Indeks obiektu docelowego<\/em> &#8211; unikalne klucze obiektu docelowego. Zalecanym wyborem jest klucz, kt\u00f3ry jest \u0142atwiejszy do odczytania, zazwyczaj klucz biznesowy. Atrybuty indeksu wybranego w ten spos\u00f3b s\u0105 zawarte jako kolumny w obiekcie zewn\u0119trznym.<\/p>\n<p>Program do rozpoznawania kluczy &#8211; nazwa, pod kt\u00f3r\u0105 znany jest klucz. Nazwa jest sugerowana nazw\u0105 relacji i nazw\u0105 wybranego indeksu obiektu docelowego.<\/p>\n<p><em>Atrybut<\/em> &#8211; wy\u015bwietla atrybuty zgodnie z wybranym indeksem obiektu docelowego.<\/p>\n<p>Pole filtra atrybut\u00f3w umo\u017cliwia ograniczenie liczby wy\u015bwietlanych atrybut\u00f3w. Aby to zrobi\u0107, wprowad\u017a nazw\u0119 atrybutu w polu. Mo\u017cna u\u017cy\u0107 symboli zast\u0119pczych.<\/p>\n<p>Filtr zostanie zastosowany po aktywowaniu przycisku [<strong>Zastosuj\/usu\u0144 filtr<\/strong>]. Je\u015bli filtr zostanie zastosowany, na li\u015bcie zostan\u0105 wy\u015bwietlone tylko te atrybuty, kt\u00f3re odpowiadaj\u0105 wprowadzonemu wyra\u017ceniu filtra. Filtr mo\u017cna usun\u0105\u0107, dezaktywuj\u0105c przycisk [<strong>Zastosuj\/usu\u0144 filtr<\/strong>].<\/p>\n<p>[<strong>Szczeg\u00f3\u0142y<\/strong>] &#8211; wy\u015bwietla wszystkie atrybuty okre\u015blonego obiektu biznesowego s\u0105 oferowane na li\u015bcie atrybut\u00f3w. Mo\u017ce to jednak obejmowa\u0107 na przyk\u0142ad atrybuty Part. Po wybraniu przycisku przycisk [<strong>Szczeg\u00f3\u0142y<\/strong>], wszystkie atrybuty zostan\u0105 wy\u015bwietlone szczeg\u00f3\u0142owo, tzn. mo\u017cna r\u00f3wnie\u017c wybra\u0107 kolumny z Part.<\/p>\n<p>[<strong>U\u017cywane<\/strong>] &#8211; przycisk pozwala ograniczy\u0107 wy\u015bwietlanie do atrybut\u00f3w, kt\u00f3re zosta\u0142y ju\u017c u\u017cyte.<\/p>\n<h4 id=\"zakladka-klucz-obcy\" >Zak\u0142adka <em>Klucz obcy<\/em><\/h4>\n<p>Klucz obcy \u0142\u0105czy jeden obiekt biznesowy z innym poprzez relacj\u0119. Zazwyczaj atrybuty klucza obcego maj\u0105 charakter techniczny i reprezentuj\u0105 klucz podstawowy docelowego obiektu biznesowego. Je\u015bli docelowy obiekt biznesowy ma r\u00f3wnie\u017c czytelne klucze, zazwyczaj klucz biznesowy, w\u00f3wczas te atrybuty w interfejsach s\u0105 lepszym rozwi\u0105zaniem do przesy\u0142ania danych. U\u017cywane klucze obcych s\u0105 prezentowane na tej li\u015bcie.<\/p>\n<p>Na zak\u0142adce <em>Klucz oby<\/em> dost\u0119pna jest tabela nast\u0119puj\u0105cymi kolumnami:<\/p>\n<p><span style=\"font-size: revert; color: initial;\"><em>Program do rozpoznawania kluczy<\/em> &#8211; n<\/span><span style=\"font-size: revert; color: initial;\">azwa wyszukiwarki kluczy. Podczas generowania nazwa jest proponowana wraz z nazw\u0105 relacji i nazw\u0105 u\u017cywanego indeksu docelowego.<\/span><\/p>\n<p><em>Obiekt \u017ar\u00f3d\u0142owy &#8211; n<\/em>azwa obiektu biznesowego, kt\u00f3ry reprezentuje \u017ar\u00f3d\u0142o relacji.<\/p>\n<p>Obiekt docelowy &#8211; nazwa obiektu biznesowego, kt\u00f3ry reprezentuje cel relacji.<\/p>\n<p><em>Atrybut \u017ar\u00f3d\u0142owy &#8211; n<\/em>azwa atrybutu w \u017ar\u00f3d\u0142owym obiekcie biznesowym relacji. Relacja jest opisana przez jedn\u0105 lub wi\u0119cej kombinacji atrybut\u00f3w \u017ar\u00f3d\u0142owych i docelowych.<\/p>\n<p><em>Atrybut docelowy<\/em> &#8211; nazwa atrybutu w docelowym obiekcie biznesowym relacji, do kt\u00f3rego odnosi si\u0119 atrybut \u017ar\u00f3d\u0142owy.<\/p>\n<p><em>Atrybut rozpoznaj\u0105cy<\/em> &#8211; rozpoznanie klucza obcego jest wykorzystywane, je\u015bli w docelowym obiekcie biznesowym istnieje bardziej odpowiedni, unikalny klucz dla transferu danych, np. klucz biznesowy. Atrybut lub atrybuty klucza rozpoznaj\u0105cego w ten spos\u00f3b s\u0105 wy\u015bwietlane w tej kolumnie.<\/p>\n<p><em>U\u017cywany program do rozpoznawania<\/em> &#8211; klucze obce mog\u0105 by\u0107 rozpoznawane kilka razy. Je\u015bli na przyk\u0142ad klucz rozpoznany w pierwszym kroku zawiera atrybut klucza obcego, atrybut ten mo\u017ce r\u00f3wnie\u017c zosta\u0107 rozwi\u0105zany. Wymaga to innego rozpoznania kluczy obcych, kt\u00f3rego nazwa jest wy\u015bwietlana w tej kolumnie.<\/p>\n","protected":false},"author":29,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-8519","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-typy-obiektow-deweloperskich"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/8519","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\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/comments?post=8519"}],"version-history":[{"count":4,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/8519\/revisions"}],"predecessor-version":[{"id":28557,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/8519\/revisions\/28557"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/media?parent=8519"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}