Wprowadzenie
Wszystkie tabele wirtualne są sklasyfikowane w podkatalogu VIRTUAL. Niniejszy artykuł opisuje tabelę wirtualną, która może być wykorzystana do zapytania o cechy artykułu dla jednego lub więcej artykułów.
Grupa docelowa
- Konsultanci
- Programiści
Cechy artykułu
Dzięki tej tabeli możliwe jest odczytanie cech artykułów dla jednego lub kilku artykułów.
Parametrami wejściowymi są kolumny in_classification oraz in_itemGuid_. Parametry wejściowe są opcjonalne, jednak wymagane jest podanie co najmniej jednego z nich. Tabela zwraca cechy artykułów wybranych na podstawie zadanych parametrów wejściowych. Każdy wiersz wyniku odpowiada jednej cesze artykułu.
Implementująca klasa Java to: com.cisag.app.general.item.log.ItemPropertyVirtualTable.
Tabela posiada następujące kolumny:
| app_general_ItemProperties | |
| Nazwa kolumny | Opis |
| in_classification | Parametr wejściowy, któremu można przypisać klasyfikację cechy artykułu. W rezultacie tabela zwraca wszystkie cechy artykułów należących do wskazanej klasyfikacji. |
| in_itemGuid_ | Parametr wejściowy, któremu można przypisać GUID artykułu. W rezultacie tabela zwraca wszystkie cechy tego artykułu. |
| attributeDatatype | Techniczny typ danych cechy artykułu. |
| attributeDescription | Opis cechy artykułu. |
| attributeName | Nazwa cechy artykułu. |
| itemDescription | Opis artykułu. |
| itemNumber | Identyfikator artykułu. |
| sequence | Pozycja cechy artykułu. |
| attributeValueStringRepresentation | Tekstowa wartość cechy artykułu. |
Pozostałe kolumny wyjściowe i szczegółowe informacje na temat uzyskiwania dostępu do zawartości dynamicznych obiektów biznesowych przy użyciu tabel wirtualnych można znaleźć w dokumentacji Wprowadzenie: Dostęp do dynamicznych obiektów biznesowych.
Wykorzystanie cech artykułów
Wirtualną tabelę można powiązać z atrybutem in_itemGuid_ poprzez przypisanie mu GUID artykułu. Możliwe jest także wyświetlanie cech artykułów według klasyfikacji cech artykułów. W takim przypadku należy powiązać atrybut path obiektu biznesowego app_general_ItemPropertyHierarchy z atrybutem in_classification wirtualnej tabeli. Ciąg path zawiera nazwy węzłów (kod) poziomów klasyfikacji cech artykułów, oddzielone myślnikiem (–).
W zależności od typu danych wartość cechy artykułu jest przekazywana w różnych atrybutach wirtualnej tabeli. Do wyświetlania wartości zaleca się użycie atrybutu attributeValueStringRepresentation. Atrybut ten przedstawia wartość cechy artykułu w postaci ciągu tekstowego. Jest to szczególnie zalecane w przypadku, gdy cechy artykułów mają być prezentowane w układzie poziomym, np. w formie tabeli krzyżowej.
Jeżeli cecha artykułu dopuszcza wiele wartości, do tabeli przekazywany jest tylko jeden wiersz na cechę. W atrybucie attributeValueStringRepresentation wartości są oddzielane przecinkiem (,). Tylko ten atrybut można wykorzystać do wyświetlania wartości; w takim przypadku atrybuty specyficzne dla typów danych, np. attributeValueDecimal, pozostają puste.
Jeżeli cechy artykułów zostaną posortowane za pomocą atrybutu sequence, wówczas będą wyświetlane w tej samej kolejności jak w systemie.
