FUNKCJE OPCJONALNE

W tej części CMDB możesz edytować istniejące właściwości i tworzyć nowe. Można je następnie wykorzystać do zarejestrowania wszelkich dodatkowych danych w postaci różnych elementów systemu CDESK, takich jak:

• Książka telefoniczna (firmy, kontakty)
• Wnioski (Wnioski ogólne, Katalog wniosków)
• Zamówienia
• CMDB (typy CI, rekordy CI)

Ten artykuł opisuje rejestrację i tworzenie właściwości opcjonalnych oraz ich komponentów. Praca z właściwościami opcjonalnymi i przypisywanie ich do poszczególnych formularzy i obiektów jest opisane bardziej szczegółowo w artykule Funkcje ogólne->Właściwości opcjonalne.

Hierarchia właściwości opcjonalnych

• Właściwości — lub również właściwości opcjonalne — to zestaw jednej lub więcej właściwości podstawowych. Umożliwiają rejestrację dodatkowych danych w formularzach CDESK. Jeśli właściwość zawiera więcej niż jedną właściwość podstawową, jest właściwością złożoną
  •  Podstawowe właściwości — określają typ wartości, którą rejestruje właściwość — na przykład tekst, liczba, data, pole wyboru, dane bazy danych lub niestandardowe możliwości wyboru
    •  Własne listy – zestaw zdefiniowanych przez użytkownika wartości, które są dostępne do wyboru we właściwości za pomocą podstawowej właściwości możliwości wyboru

Podstawowe cechy

W tej sekcji zdefiniowano podstawowe właściwości i ich typy. Każda czysta instalacja CDESK zawiera już zestaw powszechnie używanych podstawowych funkcji, których szczegóły można wyświetlić, wybierając opcję z menu kontekstowego  Szczegóły . Tych wstępnie zdefiniowanych właściwości nie można edytować. Jeśli wstępnie zdefiniowane właściwości podstawowe nie są wystarczające do Twoich celów, możesz dodać własne, używając przycisku + Dodaj właściwość podstawową . Otworzy się formularz z opcjami:

Typ podstawowy – wybierz typ danych, które chcesz zapisać we właściwościach opcjonalnych:

• Checkbox (true/false) – pole wyboru
• Licznik – pole do wpisania wartości liczbowej dla wybranej daty
• Custom Enum – pole umożliwiające wybór z predefiniowanego zestawu wartości z listy możliwości zdefiniowanych przez użytkownika
• Data – pole wyboru daty
• Datetime – pole do wyboru daty i godziny
• DB relation – pole służące do wyboru wartości przechowywanych w bazie danych
• Przesyłanie plików – pole umożliwiające dołączenie pliku
• IP – pole przeznaczone do zapisu adresu IP
• Long text (65535 chars) – pole do wprowadzania długiego tekstu o długości do 65535 znaków
• Number (decimal) – pole do wpisania liczby z kropką dziesiętną
• Number (whole number -2mld .. +2mld) – pole do wpisania liczby całkowitej
• String (255 znaków) – pole do wpisania tekstu do 256 znaków
• Time – pole wyboru czasu
• Tri-state checkbox (true/false/maybe) – przełącznik z rejestracją trzech możliwych stanów

• W zależności od wybranego typu bazy dostępne będą dodatkowe pola formularza:
• Custom Enum – dostępne po wybraniu typu Custom Enum – wybór spośród zdefiniowanych przez użytkownika listach wyboru. Więcej o niestandardowych listach wyboru można przeczytać w osobnym akapicie poniżej.
• Ścieżka API – podaj ścieżkę do bazy danych, z której mają być odczytane wartości, są dwie opcje:

• Predefiniowane – wybierz spośród zdefiniowanych ścieżek do wykorzystywanych list możlliwości w bazie danych CDESK (np. lista zamówień, komputerów, jednostek, krajów…)
• Niestandardowy – pozwala na wykorzystanie ścieżki do innych części bazy CDESK, zgodnie z dokumentacją API (np. do listy obiektów należących do grupy CI Main / CI Type, użyj Slug zamiast ID). Umożliwia również pobieranie wartości z zewnętrznej bazy danych

• Query parameter – kliknij + Dodaj query parameter  , aby dodać linię do wypełnienia parametru i wartości – listę parametrów znajdziesz w dokumentacji API CDESK

Nazwa – wpisz nazwę właściwości podstawowej, będzie ona wyświetlana w polu formularza jako tekst zastępczy (zamiast pustego pola)

Typ właściwości – wybierz dla jakich danych tworzysz właściwość podstawową. W API, zgodnie z wybranym typem, możliwe jest wyszukiwanie danych, które są zarejestrowane pod inną nazwą (np. wybierając typ telefonu, można wyszukać wszystkie numery telefonów, nawet jeśli będą one zarejestrowane w bazie raz pod nazwą Kontakt telefoniczny, drugi raz jako stacjonarny)

Slug (alias) – alias dla ID – pozwala na pracę z podstawowymi właściwościami w API CDESK, bez konieczności znajomości ich ID w bazie danych. Używaj wyrażeń bez znaków diakrytycznych i spacji – zamiast spacji używaj myślników. Slug powinien być unikalny, tzn. może być użyty w ramach właściwości podstawowych najwyżej raz

Aby utworzyć właściwość podstawową lub zastosować zmiany, kliknij przycisk Zapisz.

Właściwości

W tej sekcji zdefiniowano właściwości służące do rejestrowania dodatkowych danych w formularzach. Istnieje możliwość przypisania ich do formularzy takich jak firmy, kontakty, zamówienia, wnioski czy obiekty. Każda instalacja CDESK zawiera już zestaw właściwości, których szczegóły można wyświetlić, wybierając opcję z menu kontekstowego Szczegóły . Tych wstępnie zdefiniowanych właściwości nie można edytować ani usuwać. Możesz także dodać niestandardowe właściwości za pomocą przycisku + Dodaj właściwość . Otworzy się formularz z opcjami:

Nazwa – wpisz nazwę właściwości, będzie ona wyświetlana w formularzu jako nazwa pola lub zestaw pól w przypadku właściwości złożonej

Opis – możesz podać krótki opis właściwości (np. przyporządkowane podstawowe właściwości w przypadku właściwości złożonej)

Grupa – Ogólna/Techniczna/Inna – wybierz, do której grupy należy właściwość. Nie ma to wpływu na funkcjonalność właściwości, rozróżnienie według grupy pomaga w wizualnym sortowaniu właściwości na liście właściwości.

Typ właściwości — wybierz, dla jakich danych tworzysz właściwość. W API, w zależności od wybranego typu, możliwe jest wyszukanie danych, które są zarejestrowane pod inną nazwą (np. wybierając typ telefonu, wyszukasz wszystkie numery telefonów, nawet jeśli są one zarejestrowane jednorazowo jako Telefon kontakt, jednorazowo jako Telefon stacjonarny)

Slug (alias) – alias dla ID – pozwala na pracę z właściwościami w API CDESK, bez konieczności znajomości ich ID w bazie danych. Używaj wyrażeń bez akcentów i spacji – zamiast spacji używaj myślników. Slug powinien być unikalny, tzn. może być użyty w obrębie właściwości najwyżej raz

Właściwości podstawowe – kliknięcie Dodaj właściwość podstawową otwiera okno wyboru właściwości podstawowych posortowanych według typów właściwości podstawowych zdefiniowanych w CMDB->Właściwości opcjonalne->Właściwości podstawowe. Kliknij <, aby dodać właściwość podstawową. Wybierając kilka podstawowych właściwości można stworzyć tzw właściwości złożone (na przykład właściwość Adres może składać się z podstawowych właściwości Ulica, Numer, Kod pocztowy, Kraj)

Kliknij Zapisz , aby utworzyć usługę lub zastosować zmiany.

Niestandardowe listy

W tym rozdziale definiuje się listy z ich własnymi zestawami wartości. Można je następnie wybrać dla właściwości opcjonalnych za pomocą listy wartości wybranych.

Aby dodać nową listę kodów, naciśnij + Dodaj wartości listy.

Nazwa – wpisz nazwę listy wartości, będzie ona wyświetlana w polu formularza jako tekst zastępczy (zamiast pustego pola)

Opis – możesz podać krótki opis listy wartości

Tlačidlom  +Pridať  pridáte nový riadok pre zadanie hodnoty číselníka. Kliknutím na  ×  riadok odstránite – odstránenie je možné len pred uložením. Po uložení číselníka je možné nepoužívané hodnoty vypnúť prepnutím prepínača do stavu vypnutý . Poradie hodnôt číselníka upravíte potiahnutím za ikonu  .

Za pomocą przycisku +Dodaj  można dodać nowy wiersz do wprowadzenia wartości wybierania. Kliknij  × , aby usunąć wiersz – usunięcie jest możliwe tylko przed zapisaniem. Po zapisaniu wartości, nieużywane wartości można wyłączyć przełączając przełącznik do stanu wyłączenia . Aby zmienić kolejność wartości wyboru, przeciągnij ikonę .

Aby utworzyć własne wartości wybierania lub zastosować zmiany, należy kliknąć przycisk Zapisz>.

Przykład tworzenia właściwości złożonej

Przyjmijmy, że właściwość złożona będzie miała za zadanie rejestrować dane o stanie urządzenia przekazywanego do usługi.

W celu zarejestrowania informacji o stanie urządzenia zapiszemy czy urządzenie jest jeszcze na gwarancji, datę sprzedaży, ślady uszkodzeń, dostarczone akcesoria. Zalecamy rozpoczęcie od najniższego poziomu jak w poniższej procedurze:

1. 1. utwórz niestandardowe wartości wyboru o nazwie Typy uszkodzeń z opcjami opisującymi poziom uszkodzeń:
   • Brak widocznych śladów uszkodzeń
   • Drobne zarysowania
   • Pęknięcia lub wgniecenia
   • Uszkodzone lub brakujące części
2. Utwórz podstawowe właściwości, które definiują typ wartości
   • W gwarancji – rejestrowane będą tylko dwa statusy, dlatego możemy użyć typu pola Checkbox (true/false) – pole wyboru
   • Data sprzedaży – pole typu Data – wybór daty
   • Oznaczenia uszkodzeń – zostaną wybrane z predefiniowanych wartości – pole Custom Enum – z listą rodzajów uszkodzeń utworzoną w pierwszym kroku
   • Przekazane akcesoria – tworzona właściwość będzie miała zastosowanie do urządzeń różnych typów, z których każde może zawierać inne akcesoria. Dlatego też, dla uniwersalności, odpowiednia będzie tablica typu String (255 znaków) – krótki tekst do 255 znaków
3.  Utwórz właściwość o nazwie Stan urządzenia
   • Przypisz podstawowe właściwości utworzone w drugim kroku

Tworzy to właściwość Stan urządzenia i może być na przykład przypisane do wniosku. Dzięki swojej uniwersalności może być stosowany do urządzeń różnego typu. Przypisanie właściwości opcjonalnej do formularza zgłoszeniowego szerzej opisaliśmy w artykule Funkcje ogólne-> Właściwości opcjonalne.