Przejdź do treści

Placeholdery i grupy

W poprzednim rozdziale przedstawione zostały podstawowe informacje dotyczące placeholderów oraz grup placeholderów i tagów. Mechanizmy te odgrywają kluczową rolę podczas tworzenia uniwersalnych ekranów i szablonów, które mogą być dynamicznie powiązywane z rzeczywistymi tagami w czasie działania aplikacji.

W tym rozdziale omówiony zostanie sposób zarządzania placeholderami oraz grupami z poziomu modułu zarządzania systemem. Pokażemy, jak tworzyć placeholdery, definiować grupy podstawień oraz przypisywać do nich odpowiednie tagi.

Warto pamiętać, że DataPortal umożliwia również tworzenie i zarządzanie placeholderami oraz grupami bezpośrednio z poziomu modułu Designer, podczas projektowania ekranów synoptycznych. Więcej informacji na ten temat znajdziesz w rozdziale dotyczącym modułu DataPortal Designer: Projektowanie ekranów → Tagi → Placeholdery.


Zarządzanie placeholderami

Placeholderami można zarządzać z poziomu modułu Zasoby, w sekcji Tagi, na zakładce PLACEHOLDERY. Lista placeholderów zawiera wszystkie placeholdery dostępne w systemie wraz z informacją o ich formacie oraz projekcie, do którego należą.

Kliknięcie wybranego placeholdera otwiera okno jego szczegółów. W oknie tym wyświetlane są podstawowe informacje, takie jak:

  • nazwa placeholdera,
  • format placeholdera,
  • projekt, do którego należy placeholder.

Z poziomu szczegółów możliwa jest również edycja lub usunięcie placeholdera.


Tworzenie i edycja placeholdera

Tworzenie nowego placeholdera (przycisk w prawym górnym rogu ekranu) oraz edycja istniejącego odbywa się z wykorzystaniem formularza konfiguracji. Podczas definiowania placeholdera należy podać jego nazwę oraz format.

Format placeholdera określa typ danych, z jakim placeholder będzie mógł zostać powiązany. Mechanizm ten służy do weryfikacji zgodności placeholdera z docelowym tagiem podczas przypisywania go w grupach placeholderów i tagów. Dzięki temu system kontroluje poprawność podstawianych tagów i zapobiega przypisaniu tagu o niezgodnym typie danych.


Zarządzanie grupami placeholderów i tagów

Grupami placeholderów i tagów można zarządzać z poziomu modułu Zasoby, w sekcji Tagi, na zakładce GRUPY. Lista grup zawiera wszystkie zdefiniowane grupy wraz z informacją o przypisanych placeholderach, tagach oraz projekcie, do którego dana grupa należy.

Kliknięcie wybranej grupy otwiera okno jej szczegółów. W oknie tym wyświetlana jest lista wszystkich powiązań placeholderów z rzeczywistymi tagami. Każde powiązanie określa, jaki tag zostanie podstawiony w miejsce konkretnego placeholdera podczas wywołania skryptu odpowiedzialnego za podstawianie tagów.

Tworzenie nowej grupy (przycisk w prawym górnym rogu ekranu) oraz edycja istniejącej odbywa się z wykorzystaniem formularza konfiguracji grupy. Formularz umożliwia definiowanie i edytowanie poszczególnych powiązań pomiędzy placeholderami a tagami.

Podczas dodawania nowego powiązania należy najpierw wybrać placeholder. Następnie w polu wyboru tagu wyświetlana jest lista tagów zgodnych z formatem wybranego placeholdera. Mechanizm ten zapewnia poprawność konfiguracji i uniemożliwia przypisanie tagu o niezgodnym typie danych.

Przycisk w nagłówku tabeli z powiązaniami umożliwia dodanie kolejnego powiązania.

Przycisk usuwania znajdujący się przy danym wpisie usuwa całe powiązanie placeholdera z tagiem.