Aplikacja Atrybuty niestandardowe służy do rejestrowania atrybutów (pól) zdefiniowanych przez użytkownika w systemie z poziomem wersjonowania 7 i do użytku jako produktywny system testowy lub system produktywny. Nie jest do tego wymagana wiedza z zakresu programowania.
W niniejszym artykule opisano sposób zapisywania atrybutów niestandardowych w systemie oraz budowę aplikacji Atrybuty niestandardowe. Przedstawiono również zależności między atrybutem niestandardowym a innymi aplikacjami oraz jednostkami biznesowymi.
Instrukcje dotyczące obsługi atrybutów niestandardowych, np. ich rejestrowania lub edycji, znajdują się w artykule Instrukcje: Atrybuty niestandardowe.
Ogólne informacje na temat aplikacji Obiekty deweloperskie można znaleźć w dokumentacji Obiekty deweloperskie. Więcej informacji na temat typu obiektu deweloperskiego Business Object można znaleźć w dokumentacji Obiekt deweloperski: Business Object.
Opis aplikacji
Atrybut niestandardowy jest zapisywany za pomocą Business Object, który jest sklasyfikowany jako Managed Supplement. Podczas rejestrowania atrybutów niestandardowych w aplikacji Atrybuty niestandardowe automatycznie tworzony jest Business Object typu Managed Supplement i zapisywany w zadaniu deweloperskim. Jeżeli obiekt już istnieje, zostaje automatycznie zablokowany do edycji w zadaniu deweloperskim. Utworzony Business Object otrzymuje ponadto automatycznie powiązanie z odpowiednim Business Entity, do którego należy.
Zapisanie atrybutów niestandardowych jako Business Object w zadaniu deweloperskim spełnia warunki transportu przy użyciu logistyki oprogramowania. Do transportu służy aplikacja Lista: Obiekty deweloperskie systemu produktywnego, w której za pomocą akcji aktywowane są zadania deweloperskie zawierające Business Objects (atrybuty niestandardowe). Aktywacja zadania deweloperskiego powoduje wykonanie przez system wszystkich niezbędnych kroków umożliwiających dalszy transport atrybutów niestandardowych. Następnie atrybuty niestandardowe mogą zostać przetransportowane do systemu docelowego przy użyciu akcji [Przenieś obiekty]. Po zakończeniu transportu należy zaplanować instalację. Dodatkowe informacje dotyczące transportu znajdują się w artykule: Lista: Obiekty deweloperskie systemu produkcyjnego.
W aplikacji Atrybuty niestandardowe możliwe jest rejestrowanie oraz edycja atrybutów niestandardowych dla Business Entity. Nie jest do tego wymagana znajomość z zakresu programowania. Po aktywacji zarejestrowane atrybuty niestandardowe mogą zostać dodane w aplikacjach konfigurowalnych w trybie projektowania interfejsu użytkownika. Zdefiniowane atrybuty niestandardowe są wyświetlane jako pola w aplikacji, w której dane Business Entity jest używane jako główny Business Object.
Aplikacja Atrybuty niestandardowe zawiera w standardowym pasku narzędzi dodatkowe pole. Ponadto składa się z obszaru identyfikacji i obszaru roboczego.
Standardowy pasek narzędzi
Zadanie deweloperskie — wyświetlane jest utworzone zadanie deweloperskie, w którym zawarte są atrybuty niestandardowe
Obszar identyfikacyjny
Obszar identyfikacji zawiera pola, które jednoznacznie identyfikują i opisują Business Entity typu Managed Supplement.
Dostępne pola:
Business Object — wyświetlana jest w pełni kwalifikowana nazwa Business Object, dla którego rejestrowane lub edytowane są atrybuty niestandardowe
Oznaczenie Business Object — wyświetlane jest oznaczenie Business Object, dla którego rejestrowane lub edytowane są atrybuty niestandardowe
Managed Supplement — wyświetlana jest w pełni kwalifikowana nazwa Managed Supplement zawierającego atrybuty niestandardowe
Oznaczenie Managed Supplement — oznaczenie Managed Supplement zawierającego atrybuty niestandardowe; oznaczenie jest dodatkową nazwą obiektu; ułatwiają wyszukiwanie obiektu; oznaczenie jest dowolne i może być niejednoznaczne, tj. kilka obiektów może mieć to samo oznaczenie; zalecane jest nadawanie różnych oznaczeń
Obszar roboczy
Obszar roboczy obejmuje zakładkę Atrybuty, pod którą umieszczona jest tabela z atrybutami niestandardowymi. Do tabeli mogą zostać dodane atrybuty przy użyciu powiązanego edytora pozycji. Atrybuty mogą zostać usunięte za pomocą przycisku usuwania na pasku narzędzi tabeli.
Tabela
Tabela nie jest edytowalna. Wyświetlane są dodane atrybuty niestandardowe. Atrybuty mogą zostać usunięte za pomocą przycisku usuń na pasku narzędzi tabeli.
Kolumny tabeli odzwierciedlają fragment danych zarejestrowanych przy użyciu edytora pozycji. Wyświetlane są następujące dane:
- Nazwa atrybutu
- Typ
- Etykieta
- Tooltip
Edytor pozycji
Edytor pozycji umożliwia dodanie atrybutów niestandardowych do tabeli.
Dostępne pola:
Nazwa atrybutu — w polu Nazwa atrybutu wprowadzana jest w pełni kwalifikowana nazwa atrybutu niestandardowego, który ma zostać dodany do Business Object typu Managed Supplement; w kolumnie tabeli Nazwa atrybutu wyświetlana jest w pełni kwalifikowana nazwa; po pierwszym zapisaniu nowego atrybutu niestandardowego nazwa atrybutu nie może zostać zmieniona
Typ — w polu Typ wybierany jest typ pola, które ma zostać dodane do Business Object; w kolumnie tabeli Typ wyświetlany jest typ; typ pola w istotny sposób określa właściwości i możliwe ograniczenia pola
Etykieta — w polu Etykieta wprowadzane jest oznaczenie atrybutu niestandardowego; w kolumnie tabeli Etykieta wyświetlane jest oznaczenie
Tooltip — w polu Tooltip wprowadzany jest tekst podpowiedzi dla atrybutu niestandardowego; w kolumnie tabeli Tooltip wyświetlany jest tekst podpowiedzi
Pole obowiązkowe – określane jest, czy atrybut niestandardowy ma być polem obowiązkowym; po włączeniu funkcji wymagane jest wypełnienie pola, aby możliwe było zapisanie powiązanego obiektu; niewypełnione pole jest oznaczane czerwonym narożnikiem; po wyłączeniu funkcji podczas zapisu nie jest sprawdzane, czy pole zawiera dane
Typ pola w istotny sposób określa właściwości i możliwe ograniczenia pola. Do wyboru dostępne są następujące typy pól:
-
Liczba dziesiętna
-
E-mail
-
Kwota
-
Cena
-
Ilość
-
String
-
Data
-
Data + godzina
-
Pole wyboru
Funkcja Pole obowiązkowe jest dostępna dla następujących typów pól:
-
E-mail
-
String
-
Data
-
Data + godzina
W zależności od typu pola dostępne są dodatkowe pola w sekcji Zawartość pola, które są wymienione poniżej dla każdego typu pola:
-
Zawartość pola dla typu pola Dziesiętne
-
Zawartość pola dla typu pola E-mail
-
Zawartość pola dla typu pola Kwota
-
Zawartość pola dla typu pola Cena
-
Zawartość pola dla typu pola Ilość
-
Zawartość pola dla typu pola String
-
Zawartość pola dla typu pola Data
-
Zawartość pola dla typu pola Data + godzina
-
Zawartość pola dla typu pola Pole wyboru
Zawartość pola dla typu pola Dziesiętne
Wartość domyślna — w razie potrzeby wprowadzana jest liczba dziesiętna jako wartość domyślna dla nowego atrybutu niestandardowego typu Dziesiętne; jeżeli zarejestrowano jeden lub więcej zakresów wartości, wartość domyślna musi mieścić się w zakresie wartości
Definiowanie zakresu wartości:
Operator relacyjny (dolna granica) — za pomocą kolumn Operator relacyjny (dolna granica) dla dolnej granicy oraz Operator relacyjny (górna granica) dla górnej granicy określany jest sposób oceniania dolnej i górnej granicy zakresu wartości przez system; dolna granica może być np. liczbą dziesiętną, która ma zostać wykluczona z wartości możliwych do wprowadzenia w polu atrybutu niestandardowego
Dolna granica — za pomocą kolumn Operator relacyjny (dolna granica) i Dolna granica oraz Operator relacyjny (górna granica) i Górna granica rejestrowany jest zakres wartości dla liczby dziesiętnej; w polu atrybutu niestandardowego można wprowadzić liczbę dziesiętną zgodnie z zakresem wartości; w kolumnie Dolna granica wprowadzana jest wartość dziesiętna, która zgodnie z ustawionym operatorem relacyjnym może zostać zarejestrowana jako dolna granica
Operator relacyjny (górna granica) — za pomocą kolumn Operator relacyjny (dolna granica) dla dolnej granicy oraz Operator relacyjny (górna granica) dla górnej granicy określany jest sposób oceniania dolnej i górnej granicy zakresu wartości przez system; górna granica może zostać zdefiniowana tylko wtedy, gdy dolna granica została ustawiona z użyciem operatora relacyjnego Większe lub Większe lub równe
Górna granica — za pomocą kolumn Operator relacyjny (dolna granica) i Dolna granica oraz Operator relacyjny (górna granica) i Górna granica rejestrowany jest zakres wartości dla liczby dziesiętnej; w polu atrybutu niestandardowego można wprowadzić liczbę dziesiętną zgodnie z zakresem wartości; w kolumnie Górna granica wprowadzana jest wartość dziesiętna, która zgodnie z ustawionym operatorem relacyjnym może zostać zarejestrowana jako górna granica
Relacyjne operatory dostępne dla wartości dolnej granicy:
-
Równe – umożliwiane jest wprowadzanie tylko jednej wartości; nie jest dostępne podanie górnej granicy
-
Różne – wykluczane jest wprowadzenie jednej wartości; nie jest dostępne podanie górnej granicy
-
Większe – wymagane jest wprowadzenie wartości większej niż wartość zdefiniowana w kolumnie Dolna granica; w razie potrzeby może zostać zdefiniowana górna granica
-
Większe lub równe – wymagane jest wprowadzenie wartości większej lub równej wartości zdefiniowanej w kolumnie Dolna granica; w razie potrzeby może zostać zdefiniowana górna granica
Relacyjne operatory dostępne dla wartości górnej granicy:
-
Mniejsze – wymagane jest wprowadzenie wartości mniejszej niż wartość zdefiniowana w kolumnie Górna granica
-
Mniejsze lub równe – wymagane jest wprowadzenie wartości mniejszej lub równej wartości zdefiniowanej w kolumnie Górna granica
Zawartość pola typu „Email”
- Wartość domyślna — W razie potrzeby wprowadź adres e-mail w tym polu jako wartość domyślną dla nowego atrybutu zdefiniowanego przez użytkownika typu „E-mail”. Zwróć uwagę na maksymalną długość określoną w polu „Maksymalna długość”.
- Maksymalna długość — Wprowadź maksymalną długość i ogranicz format wprowadzania adresu e-mail do określonej liczby znaków.
Zawartość pola dla typu pola Kwota
Wartość domyślna — w razie potrzeby wprowadzana jest kwota jako wartość domyślna dla nowego atrybutu niestandardowego typu Kwota; jeżeli zarejestrowano jeden lub więcej zakresów wartości, wartość domyślna musi mieścić się w zakresie wartości
Domyślna waluta — w polu Domyślna waluta może zostać określona waluta proponowana podczas użycia pola; wartości w polu wyboru wynikają z walut zarejestrowanych w aplikacji Waluty
Definiowanie zakresu wartości
Operator relacyjny (dolna granica) — za pomocą kolumn Operator relacyjny (dolna granica) dla dolnej granicy oraz Operator relacyjny (górna granica) dla górnej granicy określany jest sposób oceniania dolnej i górnej granicy zakresu wartości przez system; dolna granica może być np. liczbą dziesiętną, która ma zostać wykluczona z wartości możliwych do wprowadzenia
Dolna granica — za pomocą kolumn Operator relacyjny (dolna granica) i Dolna granica oraz Operator relacyjny (górna granica) i Górna granica rejestrowany jest zakres wartości dla liczby dziesiętnej; w kolumnie Dolna granica wprowadzana jest wartość dziesiętna zgodnie z wybranym operatorem relacyjnym
Operator relacyjny (górna granica) — górna granica może zostać określona tylko wtedy, gdy dolna granica została zdefiniowana z użyciem operatora relacyjnego Większe lub Większe lub równe
Górna granica — w kolumnieGórna granicawprowadzana jest wartość dziesiętna zgodnie z wybranym operatorem relacyjnym
Możliwe operatory relacyjne dla dolnej granicy:
-
Równe – umożliwiane jest wprowadzanie tylko jednej wartości; podanie górnej granicy jest wykluczone
-
Różne – wykluczane jest wprowadzenie jednej wartości; podanie górnej granicy jest wykluczone
-
Większe – wymagane jest wprowadzenie wartości większej niż wartość określona w kolumnie Dolna granica; w razie potrzeby może zostać określona górna granica
-
Większe lub równe – wymagane jest wprowadzenie wartości większej lub równej wartości określonej w kolumnie Dolna granica; w razie potrzeby może zostać określona górna granica
Możliwe operatory relacyjne dla górnej granicy:
-
Mniejsze – wymagane jest wprowadzenie wartości mniejszej niż wartość określona w kolumnie Górna granica
-
Mniejsze lub równe – wymagane jest wprowadzenie wartości mniejszej lub równej wartości określonej w kolumnie Górna granica
Zawartość pola typu Cena
- Wartość domyślna — w razie potrzeby wprowadzana jest cena jako wartość domyślna dla nowego atrybutu niestandardowego typu Cena; jeżeli zarejestrowano jeden lub więcej zakresów wartości, wartość domyślna musi mieścić się w zakresie wartości
- Domyślna waluta — w polu Domyślna waluta może zostać określona waluta proponowana podczas użycia pola; wartości w polu wyboru wynikają z walut zarejestrowanych w aplikacji Waluty
Definiowanie zakresu wartości:
Zakres wartości definiowany jest analogicznie jak dla typu pola Kwota.
Zawartość pola typu Ilość
Wartość domyślna — w razie potrzeby wprowadzana jest ilość jako wartość domyślna dla nowego atrybutu niestandardowego typu Ilość; jeżeli zarejestrowano jeden lub więcej zakresów wartości, wartość domyślna musi mieścić się w zakresie wartości
Domyślna jednostka — w polu Domyślna jednostka może zostać określona jednostka proponowana podczas użycia pola; wartości w polu wyboru wynikają z jednostek zarejestrowanych w aplikacji Jednostki
Definiowanie zakresu wartości:
Zakres wartości definiowany jest analogicznie jak dla typu pola Kwota.
Zawartość pola dla typu pola String
Wartość domyślna — w razie potrzeby wprowadzany jest ciąg znaków jako wartość domyślna dla nowego atrybutu niestandardowego typu String; należy uwzględnić maksymalną długość określoną w polu Maksymalna długość
Maksymalna długość – wprowadzana jest maksymalna długość, co ogranicza format wprowadzania do określonej liczby znaków
Zawartość pola dla typu pola Data
Wartość domyślna — w razie potrzeby wprowadzana jest data jako wartość domyślna dla atrybutu niestandardowego typu Data; jeżeli zarejestrowano jeden lub więcej zakresów wartości, wartość domyślna musi mieścić się w zakresie wartości
Definiowanie zakresu wartości:
Od — wprowadzana jest data początkowa, od której może zostać wprowadzona data
Do — wprowadzana jest data końcowa, do której może zostać wprowadzona data
Zawartość pola dla typu pola Data + godzina
Wartość domyślna — w razie potrzeby wprowadzana jest określona data jako wartość domyślna dla atrybutu niestandardowego typu Data + czas; jeżeli zarejestrowano jeden lub więcej zakresów wartości, wartość domyślna musi mieścić się w zakresie wartości
Definiowanie zakresu wartości:
Od — wprowadzana jest data początkowa, od której może zostać wprowadzona data
Do — wprowadzana jest data końcowa, do której może zostać wprowadzona data
Zawartość pola dla typu pola Pole wyboru
Wartość domyślna —w polu Wartość domyślna może zostać określona wartość proponowana podczas użycia pola; wartości w polu wyboru wynikają z wartości zarejestrowanych w powiązanej tabeli; obok pola znajduje się przycisk aktualizuj, który resetuje wybraną wartość, a następnie przenosi aktualne wartości z tabeli do pola wyboru
Definiowanie zakresu wartości:
Nazwa — wprowadzana jest nazwa identyfikująca wpis w polu wyboru; nazwa może składać się z cyfr, liter lub ich kombinacji i musi być unikalna w tabeli
Oznaczenie — wprowadzane jest oznaczenie wpisu w polu wyboru; oznaczenie może składać się z cyfr, liter lub ich kombinacji i jest wyświetlane w polu dla danego atrybutu niestandardowego
ID — określana jest kolejność wyświetlania wpisów w polu wyboru poprzez nadanie liczby; każda liczba może wystąpić tylko raz w obrębie wpisów jednego pola wyboru
Sprawdzanie zakresów wartości
Dla niektórych typów pól zdefiniowanie zakresu wartości jest zasadne. Przykładowo dla atrybutu niestandardowego Handlowa ilość wydania typu Ilość może zostać określona dolna i górna granica w celu wskazania zakresu wartości.
Możliwość zdefiniowania zakresu wartości zależy od referencjonowanego Business Object. Jeżeli implementacja referencjonowanego Business Object obejmuje kontrolę zakresów wartości oraz w odpowiednim wpisie Business Object Registry dla znacznika userDefinedAttributes ustawiono wartość =true, wówczas dla danego typu pola może zostać zdefiniowany zakres wartości.
Jeżeli warunki są spełnione, zakres wartości jest dostępny dla następujących typów:
-
Liczba dziesiętna
-
Kwota
-
Cena
-
Ilość
-
Data
-
Data + godzina
-
Pole wyboru
Konfiguracja
Aplikacja Atrybuty niestandardowe nie wymaga dodatkowych ustawień w aplikacji Konfiguracja.
Jednostki biznesowe
Dla tej aplikacji nie są istotne żadne jednostki biznesowe.
Uprawnienia
Uprawnienia specjalne
Dla aplikacji Atrybuty niestandardowe nie ma dostępnych uprawnień specjalnych.
Przyporządkowania organizacji
Dla aplikacji Atrybuty niestandardowe nie są wymagane przyporządkowania organizacji.
Funkcje specjalne
Dla aplikacji Atrybuty niestandardowe nie są dostępne funkcje specjalne.
Uprawnienia dla partnerów biznesowych
Aplikacja Atrybuty niestandardowe nie jest udostepniana partnerom biznesowym.
