W tym przypadku potrzebny jest nast\u0119puj\u0105cy Hook Contract. Nale\u017cy\u00a0 zast\u0105pi\u0107 <development prefix> prefiksem deweloperskim swojego systemu.<\/div>\n
\n
<?xml version=\"1.0\" encoding=\"UTF-16\"?>\n<HookContract xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"HookXMLSchema.xsd\">\n\n<!\u2013 Don\u2019t change this line and the lines above! \u2013>\n\n<HOOK_IMPLEMENTATION>\n<contract>\n<hook>\n<interface>\ncom.cisag.app.general.item.hook.log.ItemApplyDefaultsHook\n<\/interface>\n<implementation>\ncom.<development prefix>.app.general.ItemHookImpl\n<\/implementation>.\n<\/hook>\n<hook>\n<interface>\ncom.cisag.app.general.item.hook.log.hook.ItemValidateHook\n<\/interface>\n<implementation>\ncom.<development prefix>.app.general.ItemHookImpl\n<\/implementation>.\n<\/hook>.\n<\/kontrakt>\n<\/HOOK_IMPLEMENTATION>\n<\/HookContract><\/pre>\napplyDefaults<\/span><\/strong><\/p>\n<\/div>\nPoni\u017cej znajduje si\u0119 przyk\u0142adowa implementacja hooka applyDefaults<\/em>.<\/p>\nimport com.cisag.pgm.base.Path;\n\npublic class ItemHookImpl implements ItemApplyDefaultsHook<Item, ItemAccess.Full>{\n\npublic void applyDefaults(Full full, ItemView itemView){\n\nItemSupplement suppObj = ItemSupplement.newTransientInstance();\n\nsuppObj.setYourAttribute(...) \/\/ tw\u00f3j atrybut\n\nbyte[] org = Company.getCompanyGuid();\n\nCisObjectInitialiser.getInstance(ItemSupplement.class).init(suppObj, org);\n\nItemSupplementDataObject itemSupplementDataObject =\n\n\u00a0 \u00a0 \u00a0 \u00a0 new ItemSupplementDataObject(suppObj, itemView);\n\nCisDataViewManager dvm = CisEnviron-ment.getInstance().getDataViewManager();\n\nItemSupplementAccess access = dvm.create(ItemSupplementView.class, itemSupplementDataObject);\n\nPath suppPath = Path.getSupplementInstance(ItemView.class, ItemSupple-mentView.class);\n\nfull.setValue(suppPath, access);\n\n}\n\n}<\/pre>\nvalidate<\/strong><\/p>\nPoni\u017cej znajduje si\u0119 przyk\u0142adowa implementacja hooka validate<\/em>:<\/p>\nimport com.cisag.pgm.base.Path;\n\npublic class ItemHookImpl implements ItemValidateHook<Item, ItemAccess.Full>\n\npublic void validate(ItemView itemView){\n\nPath suppPath = Path.getSupplementInstance(ItemView.class, ItemSupple-mentView.class);\n\nPath append = supp-Path.append(ItemSupplementView.Attribute.$yourAttribute);\n\nItemSupplementView value = itemView.getValue(suppPath);\n\nCisMessageManager mm = CisEnvironment.getInstance().getMessageManager();\n\nmm.setProgramMessagePath(suppPath);\n\nif (value.getYourAttribute()!=null){\n\n\/\/ insert validation here\n\n}\n\n}<\/pre>\nInterfejs programistyczny<\/h3>\n\n
Je\u015bli zostan\u0105 zaimplementowane odpowiednie hooki, zazwyczaj nie ma potrzeby ingerencji programistycznej. Je\u015bli jednak np. aplikacja nie jest dostosowywalna lub dost\u0119pne hooki nie s\u0105 wystarczaj\u0105ce do okre\u015blonych cel\u00f3w, mo\u017cliwe jest bezpo\u015brednie uzyskanie dost\u0119pu do supplementu.<\/p>\n
Aby uzyska\u0107 dost\u0119p programistyczny, dost\u0119pne s\u0105 nast\u0119puj\u0105ce metody w\u00a0CisObject<\/code>:<\/p>\n\n- \n
get_Supplement(Supplement.class)<\/code> – umo\u017cliwia uzyskanie obiektu suplementu zapisanego w CisObject<\/code>, je\u015bli taki istnieje. Je\u015bli obiekt supplementu nie jest dost\u0119pny, zostanie zwr\u00f3cona warto\u015b\u0107 null<\/em>.<\/p>\n<\/li>\nset_Supplement(Supplement.instanz) <\/code>– umo\u017cliwia ustawienie instancji suplementu w CisObject<\/code>.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n
Trwa\u0142o\u015b\u0107 (Persistence)<\/h3>\n\n
Zaleca si\u0119 otwieranie i zapisywanie suplementu wy\u0142\u0105cznie za po\u015brednictwem Business Entity.<\/em> Na podstawie zapisanych metadanych w aplikacji Obiekty deweloperskie<\/em>, tj. relacji _businessObject,<\/em> rozpoznawane s\u0105 suplementy nale\u017c\u0105ce do Business Entity<\/em> (lub zale\u017cnych obiekt\u00f3w). Suplementy s\u0105 nast\u0119pnie automatycznie otwierane i dodawane do instancji Business Entity<\/em>. Mo\u017cna je nast\u0119pnie zapyta\u0107 za pomoc\u0105 nast\u0119puj\u0105cej metody:<\/p>\nget_Supplement(Supplement.class)<\/code><\/p>\nJe\u015bli do instancji Business Entity<\/em> nie nale\u017cy \u017cadna instancja suplementu, zwracana jest warto\u015b\u0107 null<\/em>.<\/p>\nPodobnie przy zapisywaniu: zapisuje si\u0119 Business Object<\/em>. W ramach tej operacji us\u0142uga persystencji sprawdza, czy do tej instancji nale\u017cy instancja suplementu. Je\u015bli tak, instancja suplementu zostaje r\u00f3wnie\u017c zapisana w ramach tej samej transakcji.<\/p>\n<\/div>\nSkutki<\/h3>\n
Je\u015bli zostanie zachowana konwencja nazewnictwa suplement\u00f3w, jak opisano powy\u017cej, suplement lub widok obiektu na nim oparty b\u0119dzie dost\u0119pny w trybie projektowania.<\/p>\n
Dost\u0119pne s\u0105 r\u00f3wnie\u017c nast\u0119puj\u0105ce funkcje automatyczne:<\/p>\n
\n- w aplikacjach Import danych<\/em> i Eksport danych<\/em> supplement jest automatycznie dost\u0119pny. Nie ma potrzeby rozszerzania kontrolera. Je\u015bli supplement zostanie nazwany zgodnie z przyk\u0142adem ItemSupplement<\/em> i b\u0119dzie nale\u017ca\u0142 do obiektu biznesowego Item<\/em>, w filtrze dla obiektu biznesowego Item<\/em> pojawi si\u0119 relacja do supplementu. Nazwa relacji to <Prefiks deweloperski>_ItemSupplement<\/em>, analogicznie do trybu projektowania. Tutaj <Prefiks deweloperski> to prefiks deweloperski systemu.<\/li>\n
- w ten sam spos\u00f3b supplement jest dost\u0119pny w konfigurowalnych wyszukiwaniach i aplikacjach typu lista.<\/li>\n
- mie jest wymagane r\u0119czne programowanie wsparcia dla j\u0119zyk\u00f3w (NLS). Je\u015bli w supplemencie znajduje si\u0119 atrybut obs\u0142uguj\u0105cy NLS, to dzi\u0119ki standardowej implementacji zostanie on automatycznie obs\u0142u\u017cony.<\/li>\n<\/ul>\n
Uwaga<\/div>
Supplement jest r\u00f3wnie\u017c obiektem biznesowym, tak jak ka\u017cdy inny. Celem supplementu jest rozszerzenie jednostki biznesowej. W tym celu dost\u0119pne s\u0105 r\u00f3\u017cne funkcje automatyczne, takie jak automatyczne otwieranie i zapisywanie, integracja z filtrem podczas importu danych itp. W przypadku znacznej ingerencji w automaty lub ca\u0142kowitego pomini\u0119cia supplmentu zaleca si\u0119 zastosowanie obiektu biznesowego typu Business Entity<\/em> zamiast supplementu.<\/div><\/section>\n","protected":false},"author":28,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-9703","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-podreczniki-referencji"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/9703","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\/28"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/comments?post=9703"}],"version-history":[{"count":12,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/9703\/revisions"}],"predecessor-version":[{"id":30388,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/9703\/revisions\/30388"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/media?parent=9703"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"\"](\"https:\/\/pomoc.comarch.pl\/cee\/wp-content\/uploads\/2025\/05\/image-6.png\")
<\/a>