Zarządzanie klasami

Modyfikowanie i tworzenie klas w szablonie jest proste. Po wybraniu żądanego szablonu z panelu drzewa szablonów, dostępny jest widok edycji szablonu, w którym można zarządzać klasami. Klasy pojawiają się pod wybranym szablonem w kolejności, w jakiej są wyświetlane na kartach danych, początkowo zgodnie z kolejnością dodania. Kolejność tę można dostosować w widoku edycji szablonu.

Aby uporządkować klasy w szablonie, należy przypisać każdej klasie numer sekwencyjny. Konkretne numery nie są kluczowe, ale zastosowanie logicznej sekwencji ułatwia wstawianie nowych klas bez konieczności znaczącej zmiany istniejących numerów sekwencyjnych. Na przykład, użycie systemu dziesiętnego (10, 20, 30 itd.) upraszcza umieszczanie nowej klasy pomiędzy istniejącymi.

Domyślnie wszystkie klasy są rozwinięte, ale można je ustawić tak, aby wyświetlały się w szablonie jako zwinięte, zaznaczając odpowiednie pole wyboru w kolumnie „Zwinięte”. Atrybuty zwiniętych klas nie będą widoczne w widokach kart danych ani trybach edycji, dopóki użytkownik nie zdecyduje się ich rozwinąć.

Klasy umożliwiają również organizację atrybutów, w tym ustawianie atrybutów jako unikalnych lub obowiązkowych oraz definiowanie ich domyślnej widoczności w wynikach wyszukiwania.

Zarządzanie atrybutami

Atrybuty, podstawowe jednostki modelu danych ESM, określają poszczególne pola na kartach danych oraz zawierają reguły i właściwości służące do wyświetlania informacji. Atrybuty mogą być statyczne lub dynamiczne, jedno- lub wielowartościowe, a administratorzy mają swobodę ich tworzenia i modyfikowania. Atrybuty to metoda przechowywania pojedynczej wartości na kartach danych. Poszczególne atrybuty można dodawać i modyfikować bez przerywania działania usługi. Atrybuty można traktować jak pola formularza, w których przechowywane są szczegóły poszczególnych instancji danych (kart danych).

Kluczowym pojęciem jest atrybut podstawowy, który nadaje nazwy kartom danych na podstawie szablonu. Szablon bez atrybutu podstawowego jest oznaczony wykrzyknikiem, co oznacza, że jest niezidentyfikowany. W takich przypadkach karty danych czerpią swoje nazwy od pierwszego dostępnego atrybutu.

Każdy atrybut składa się co najmniej z nazwy i typu danych. Dostępne są następujące typy danych:

• Ciąg znaków o maksymalnej długości 450 znaków.
• Tekst
• Liczba całkowita. Może być liczbą składającą się maksymalnie z 10 cyfr.
  • Na przykład nie można zapisać liczby „10000000001”, bo ma 11 cyfr.
• Dziesiętny
  • Wzór wyjściowy można skonfigurować w ustawieniach platformy decimal.output.pattern.
• Data
  • Wzór wejścia i wyjścia można skonfigurować w ustawieniach platformy date.input.pattern i date.output.pattern.
• Data i godzina (datetime)
  • Schemat wejścia i wyjścia można skonfigurować w ustawieniach platformy datetime.input.pattern i datetime.output.pattern.
• Odniesienie (wartość atrybutu jest relacją do innej karty danych, na przykład Zespołu przypisanego do Zgłoszenia. W tym przypadku Zgłoszenie odnosi się do Zespołu)
• Odwołanie wsteczne (wartość atrybutu jest relacją do innej karty danych, tworząc parę z kartą danych referencyjną. Wartość można zmienić w odniesieniu lub odwołaniu wstecznym, ale sparowane wartości na obu kartach danych są zawsze zsynchronizowane. Odwołanie następuje do karty danych z wartością odwołania wstecznego)
• Odniesienie zewnętrzne (link do strony internetowej lub pliku na serwerze plików)

Wartości dziesiętne, daty i godziny mają określone ustawienia platformy wyjściowej.

Atrybut można skonfigurować tak, aby zawierał tylko jedną lub wiele wartości. Możliwe jest zdefiniowanie stałego zestawu wybieralnych wartości dla atrybutu.

Atrybuty można włączać tylko w określonych warunkach, tworząc dynamiczną zawartość modelu danych. Na przykład, atrybut można włączyć tylko wtedy, gdy inny atrybut ma określoną wartość statyczną. Atrybuty warunkowe muszą być atrybutami typu string o wartościach statycznych.

Do atrybutów można przypisać specjalne procedury obsługi, aby dodać funkcjonalności, takie jak obliczenia lub kombinacje wartości. Więcej informacji na temat korzystania ze specjalnych procedur obsługi uid znaleźć w Przewodniku po procedurach obsługi atrybutów dostępnym w sekcji Administracja > Szablony.

Każdy szablon powinien mieć atrybut podstawowy, ponieważ karty danych oparte na tym szablonie są nazywane na podstawie atrybutu podstawowego. Szablon bez atrybutu podstawowego jest szablonem niezidentyfikowanym i jest wyświetlany w drzewie szablonów z ikoną wykrzyknika. Jeśli szablon nie ma atrybutu podstawowego, karty danych oparte na tym szablonie otrzymują nazwę z pierwszego atrybutu widocznego dla użytkownika.

Tworzenie atrybutów

Utworzenie nowego atrybutu polega na wybraniu klasy w szablonie, a następnie wybraniu opcji „Nowy atrybut” z menu wyświetlania. Widok „Nowy atrybut” umożliwia wprowadzenie podstawowych informacji, właściwości i ustawień wyglądu atrybutu:

Podstawowe informacje obejmują nazwę atrybutu, opcjonalny opis i tekst pomocy, który może zawierać znaczniki HTML służące do formatowania.

Podstawowe właściwości obejmują obsługę atrybutu, typ danych i wartość domyślną. Warto zauważyć, że typ danych jest ustalany w momencie utworzenia i nie można go później zmienić. Wartości domyślne są szczególnie wszechstronne i obsługują makra i odwołania do dat, w tym kartę danych bieżącego użytkownika.

Ustawienia wyglądu określają widoczność atrybutu na kartach danych, oferują opcje trybów wyświetlania i/lub edycji, a także mogą obejmować teksty nagłówka i stopki zapewniające dodatkowy kontekst.

Typy danych atrybutów

Typy danych definiują formę i typ danych, jakie może przechowywać atrybut, od ciągów znaków i liczb po daty, odniesienia i inne. Każdy typ danych ma określone cechy i ograniczenia:

Atrybuty referencyjne

Po początkowym zapisaniu atrybutu z typem danych referencyjnych dostępne stają się ustawienia określające cel referencyjny. Obejmują one wybór możliwych szablonów referencyjnych i konfigurację sposobu wyświetlania kart danych referencyjnych.

W przypadku atrybutów referencyjnych wskazujących na szablon „użytkownika” ESM (który może mieć inną nazwę, ale jest identyfikowany kodem szablonu „admin”), możliwe jest ustawienie karty użytkownika ESM bieżącego użytkownika jako wartości domyślnej. Można to zrobić za pomocą makra #user# lub $USER$, aby uzyskać bezpośrednie odwołanie do szablonu „użytkownika”. Ta funkcja automatycznie łączy atrybut z kartą danych aktywnego użytkownika w systemie.

Jeśli bieżący użytkownik nie posiada odpowiadającej mu karty danych „użytkownika” ESM, co może mieć miejsce w przypadku użytkownika root, odwołanie nie zostanie ustanowione. Co więcej, można rozszerzyć tę wartość domyślną, aby odnosiła się do innych szablonów powiązanych z szablonem „użytkownika” ESM, określając ścieżkę, taką jak #user:attribute_code#.

Przykład:

W przypadku karty danych „Incydent” z polem „Osoba kontaktowa”, ustawienie wartości domyślnej #user# tworzy link do karty danych „użytkownik” bieżącego użytkownika w ESM. Jeśli szablon „użytkownik” w ESM zawiera odwołanie do innego szablonu, na przykład szablonu „Osoba” z kodem atrybutu „osoba”, można użyć #user:person#, aby domyślnie użyć tego konkretnego odwołania.

Ta metoda umożliwia zarówno odwołania bezpośrednie, jak i wsteczne w ścieżkach referencyjnych, ułatwiając tworzenie złożonych łańcuchów referencyjnych, takich jak #user:code1:code2#. Konieczne jest jednak, aby każdy atrybut w ścieżce był jednowartościowym atrybutem referencyjnym, aby zapewnić integralność ścieżki referencyjnej. Atrybut końcowy w każdej ścieżce referencyjnej musi być zgodny z szablonami docelowymi konfigurowanego atrybutu, zachowując spójność w całym łańcuchu.

Kluczowe punkty:

• Makro #user# lub $USER$ może definiować wartości domyślne dla atrybutów referencyjnych odnoszących się do szablonu „użytkownika” ESM.
• Wartości domyślne automatycznie łączą się z kartą danych użytkownika ESM bieżącego użytkownika, co ułatwia personalizację konfiguracji karty danych.
• Rozszerzone ścieżki referencyjne umożliwiają linkowanie do większej liczby szablonów za pośrednictwem szablonu „użytkownika” ESM, co rozszerza zakres wartości domyślnych.
• Wszystkie atrybuty w ścieżce referencyjnej muszą być atrybutami referencyjnymi o pojedynczej wartości, aby działały prawidłowo, zapewniając jasne i bezpośrednie powiązanie z zamierzonymi szablonami docelowymi.

Atrybuty statyczne

Atrybuty statyczne wykorzystują predefiniowane wartości, spośród których użytkownicy mogą wybierać. Tworzenie wartości statycznych dla tych atrybutów to proces, który należy przeprowadzać ostrożnie, aby uniknąć wpływu na istniejące karty danych.

Dodając wartości do atrybutów w systemie, ważne jest, aby zrozumieć różnicę między atrybutami statycznymi i dynamicznymi.

Dodawanie wartości statycznej: Wartości statyczne można przypisywać tylko do atrybutów statycznych. Podczas tworzenia atrybutu należy zaznaczyć pole wyboru „Statyczny”. Po wykonaniu tej czynności będzie można zdefiniować wartości dla tego atrybutu statycznego.

Korzystanie z istniejących atrybutów statycznych: Wybór użycia już zdefiniowanego atrybutu statycznego oznacza dziedziczenie wszystkich powiązanych z nim wartości statycznych. Należy zachować ostrożność: zmiana wartości atrybutu statycznego powoduje aktualizację tej wartości we wszystkich szablonach, które go zawierają. Ta zmiana kaskadowo modyfikuje wartości we wszystkich kartach danych powiązanych z tymi szablonami. Aby uniknąć niezamierzonych zmian danych, rozważ utworzenie nowego atrybutu statycznego, gdy jego obecne wartości nie odpowiadają Twoim potrzebom.

Tworzenie atrybutu statycznego: System automatycznie generuje wpis wartości statycznej o tej samej nazwie co odpowiadający mu atrybut statyczny w momencie utworzenia. Ta funkcja ułatwia identyfikację powiązanych wartości statycznych z atrybutami.

Edycja atrybutów statycznych: Aby edytować atrybut statyczny, znajdź go w panelu drzewa szablonów, co spowoduje wyświetlenie widoku „Edytuj atrybut”. Aby dodać lub zmodyfikować wartości statyczne, przejdź do opcji „Wartości menu” w menu wyświetlania, co doprowadzi Cię do widoku „Wartości statyczne”. W tym miejscu możesz wprowadzić nowe wartości statyczne, które będą dostępne podczas tworzenia karty danych.

Atrybuty warunkowe

Atrybuty warunkowe są wyświetlane tylko wtedy, gdy spełnione są określone warunki, co umożliwia dynamiczną zawartość szablonów.

Tworzenie dynamicznej zawartości szablonu za pomocą atrybutów warunkowych pozwala na bardziej interaktywne i responsywne korzystanie z interfejsu. Funkcja ta umożliwia wyświetlanie lub aktywowanie atrybutów w szablonach w zależności od określonych warunków, takich jak wartość innego atrybutu. Oto jak efektywnie wykorzystać atrybuty warunkowe:

Tworzenie atrybutu warunkowego:

1. Początkowe tworzenie : Zacznij od utworzenia nowego atrybutu, wybierz typ danych odpowiadający Twoim potrzebom, a następnie zapisz go. To początkowe zapisanie jest kluczowe dla zachowania wybranego typu danych.
2. Warunki ustawień : Po zapisaniu znajdź pole „Włącz jeśli”, które zawiera listę statycznych atrybutów ciągu. Wybierz atrybut, który będzie wyzwalaczem włączenia nowego atrybutu.
3. Ponowne wczytanie interfejsu użytkownika : po ustawieniu warunku interfejs użytkownika (UI) zostanie automatycznie odświeżony, a użytkownikowi zostaną przedstawione opcje wartości aktywujących atrybut warunkowy.

Wskazówki dotyczące konfiguracji:

• Wybieranie wartości : Możesz wybrać jedną lub wiele wartości statycznych jako kryteria aktywacji atrybutu warunkowego. Atrybut staje się aktywny po spełnieniu któregokolwiek z tych określonych warunków.
• Łańcuchowanie atrybutów : Atrybuty warunkowe można łączyć w łańcuchy, w których widoczność jednego atrybutu zależy od wartości innego itd. Łańcuch ten może rozciągać się na wiele poziomów, tworząc złożone scenariusze widoczności i aktywacji oparte na wielu warunkach.
• Pola obowiązkowe : Jeśli atrybut warunkowy jest ustawiony jako obowiązkowy, wymóg jego wypełnienia jest egzekwowany tylko wtedy, gdy atrybut jest widoczny, co oznacza, że jego warunki zostały spełnione.

Ważne uwagi:

Podczas przetwarzania danych należy pamiętać, że jeśli warunki atrybutu warunkowego przestaną być spełnione, jego wartość zostanie usunięta z bazy danych. Jeśli warunki zostaną spełnione ponownie później, konieczne będzie ponowne wprowadzenie danych atrybutu.

Wykorzystanie atrybutów warunkowych pozwala na tworzenie szablonów, które dostosowują się do wprowadzanych danych, zwiększając użyteczność i wydajność formularzy oraz procesów wprowadzania danych. To dynamiczne podejście gwarantuje, że użytkownikom prezentowane są tylko odpowiednie pola na podstawie ich konkretnych danych, usprawniając proces wprowadzania danych.

Edycja atrybutów

Aby edytować właściwości atrybutu w klasie, wybierz klasę pod żądanym szablonem. Widok „Edytuj atrybuty klasy” umożliwia między innymi dostosowanie nazw, kolejności, kodów i ustawień widoczności.

Aby dostosować właściwości atrybutów w ramach określonej klasy szablonu, wykonaj następujące kroki:

1. Dostęp do Pro atrybutów : Przejdź do szablonu, nad którym pracujesz i wybierz klasę zawierającą atrybut, który chcesz zmodyfikować. Ta czynność otwiera widok „Edytuj atrybuty klasy”, który zapewnia szczegółowy przegląd ustawień atrybutów specyficznych dla wybranej klasy.
2. Zakres zmian : Zmiany wprowadzone w widoku „Edytuj atrybuty klasy” dotyczą tylko atrybutów w wybranej klasie. Na przykład, zmiany w atrybucie „Wyświetlacze” w klasie „Informacje o stacji roboczej” nie wpłyną na żadną inną klasę, do której ten atrybut może należeć. Jednak właściwości klasy, takie jak wymagania dotyczące atrybutów i widoczność, mają zastosowanie uniwersalne do wszystkich szablonów, które ją zawierają.
3. Kontrola przed edycją : Przed wprowadzeniem zmian sprawdź, czy klasa jest używana w wielu szablonach. Dzięki temu będziesz świadomy szerszego wpływu, jaki mogą mieć wprowadzone zmiany ze względu na zastosowanie ustawień atrybutów w całej klasie.

Edycja podstawowych informacji o atrybucie:

• Nazwa **: Definiuje etykietę atrybutu. Kliknięcie nazwy atrybutu otwiera widok „Edytuj atrybut”, umożliwiający bardziej szczegółowe modyfikacje.
• Kolejność : Kontroluje kolejność, w jakiej atrybuty pojawiają się w klasie. Użyj logicznych inkrementów (np. 10, 20, 30), aby ułatwić dodawanie nowych atrybutów później, bez konieczności zmiany istniejącej kolejności.
• Kod : Służy jako unikalny identyfikator atrybutu, mający kluczowe znaczenie w procesach importu danych oraz przy stosowaniu określonych procedur obsługi do atrybutów.
  • Uwaga: Przypisanie kodu do każdego atrybutu jest konieczne.
• Wymagane : Zapewnia, że karty danych nie mogą zostać zapisane, jeśli nie zostanie wprowadzona wartość dla tego atrybutu, wymuszając w ten sposób kompletność danych.
• Unikalność : gwarantuje, że wartość atrybutu pozostanie unikalna we wszystkich kartach danych współdzielących daną klasę. System sprawdza unikalność zarówno podczas tworzenia karty danych, jak i importu danych. Unikalność może być ograniczona do zakresu widoczności użytkownika edytującego lub globalnie w całym systemie, a konkretny tryb można dostosować w ustawieniach platformy.
• Wybrane : Określa, czy atrybut jest widoczny domyślnie, np. na listach wyników wyszukiwania, co poprawia komfort użytkownika poprzez nadanie priorytetu ważnym informacjom.

Pamiętaj, że konfigurując atrybuty, musisz wziąć pod uwagę szersze konsekwencje zmian, aby zapewnić spójność i integralność całej struktury danych Twojego systemu.