Skip to content

app-label

Opis

Bloczek app-label służy do prezentowania do pięciu niezależnych etykiet tekstowych w aplikacji mobilnej oraz w interfejsie WWW. Każda etykieta może składać się z opcjonalnego prefiksu, bieżącej wartości pobranej z wejścia oznaczonego bloczkiem tag oraz opcjonalnego sufiksu.

Bloczek pełni funkcję prezentacyjną. Nie przetwarza danych dalej w logice i nie posiada wyjść logicznych. Po dodaniu go do projektu tworzona jest powiązana reprezentacja urządzenia wirtualnego, dzięki której etykiety są widoczne także poza samym schematem logiki.

Bloczek obsługuje maksymalnie pięć wejść oznaczanych za pomocą bloczka tag. Każde wejście działa niezależnie i odpowiada jednej linii prezentowanej użytkownikowi.

Parametry konfiguracyjne

Nazwa parametru Wartość
name Parametr opcjonalny. Określa nazwę widoczną dla użytkownika w aplikacji mobilnej i WWW. Brak tego parametru nie blokuje pracy bloczka.
prefix_tag1 ... prefix_tag5 Parametry opcjonalne. Określają tekst wyświetlany przed bieżącą wartością odpowiednio dla wejść tag1 do tag5. Parametry te można wykorzystać na przykład do dodania opisu pola, dwukropka albo jednostki zapisanej z przodu wartości.
suffix_tag1 ... suffix_tag5 Parametry opcjonalne. Określają tekst wyświetlany po bieżącej wartości odpowiednio dla wejść tag1 do tag5. Parametry te można wykorzystać na przykład do dopisania jednostki, takiej jak °C, % albo V.

Obsługa wejścia

Bloczek reaguje wyłącznie na wejścia oznaczone za pomocą bloczka tag. Co najmniej jedno z wejść tag1 do tag5 musi być podłączone. Jeśli żadne takie wejście nie jest podłączone, bloczek przechodzi w stan błędu Input disconnected..

Do każdego z wejść tag1 do tag5 może być podłączony najwyżej jeden bloczek tag. Większa liczba takich połączeń jest błędem konfiguracji.

Znaczenie poszczególnych wejść:

Numer i nazwa wejścia Opis działania
tag1: Etykieta 1. Wartość podana na wejście tag1 ustawia bieżącą treść pierwszej etykiety widocznej w aplikacji mobilnej i WWW.
tag2: Etykieta 2. Wartość podana na wejście tag2 ustawia bieżącą treść drugiej etykiety widocznej w aplikacji mobilnej i WWW.
tag3: Etykieta 3. Wartość podana na wejście tag3 ustawia bieżącą treść trzeciej etykiety widocznej w aplikacji mobilnej i WWW.
tag4: Etykieta 4. Wartość podana na wejście tag4 ustawia bieżącą treść czwartej etykiety widocznej w aplikacji mobilnej i WWW.
tag5: Etykieta 5. Wartość podana na wejście tag5 ustawia bieżącą treść piątej etykiety widocznej w aplikacji mobilnej i WWW.

Szczegółowe zasady działania:

  • wartości logiczne są prezentowane jako true albo false
  • wartości liczbowe są zamieniane na tekst bez automatycznego dopisywania jednostki
  • wartości tekstowe są prezentowane bez zmian
  • jeśli na dane wejście dotrze wartość null, bieżąca wartość odpowiadającej etykiety zostanie wyczyszczona
  • jeśli odebranej wartości nie da się bezpiecznie zamienić na tekst, odpowiadająca etykieta również zostanie wyczyszczona
  • prefiks i sufiks są stałe i wynikają z konfiguracji bloczka, natomiast sama wartość środkowa jest aktualizowana dynamicznie na podstawie zdarzeń wejściowych
  • po uruchomieniu projektu bloczek próbuje od razu odczytać ostatnie znane wartości z podłączonych wejść i pokazać je w aplikacji mobilnej oraz WWW

Bloczek nie dopisuje jednostek automatycznie. Jeśli użytkownik chce pokazać na przykład temperaturę albo procent, powinien dodać odpowiednią jednostkę w suffix_tagX albo prefix_tagX.

Wyjścia bloczka

Bloczek app-label nie posiada wyjść logicznych.

Jego zadaniem jest wyłącznie udostępnianie opisów i bieżących wartości do aplikacji mobilnej oraz interfejsu WWW. Nie służy do przekazywania danych do kolejnych bloczków.

Błędy zwracane przez bloczek

Bloczek może zwracać następujące błędy:

Kod błędu Opis błędu
Input disconnected. Żadne z wejść tag1 do tag5 nie jest podłączone. Aby bloczek działał poprawnie, należy podłączyć przynajmniej jedno wejście oznaczone bloczkiem tag.
Too many tagX blocks connected. Do jednego z wejść tag1 do tag5 podłączono więcej niż jeden bloczek tag. Na każdym z tych wejść dozwolone jest tylko jedno takie połączenie.

Przykłady działania

  • Jeśli prefix_tag1 = Temperatura:, suffix_tag1 = °C, a na wejście tag1 dotrze wartość 21.5, to użytkownik zobaczy etykietę Temperatura: 21.5 °C.
  • Jeśli prefix_tag2 = Ruch:, a na wejście tag2 dotrze wartość logiczna true, to użytkownik zobaczy etykietę Ruch: true.
  • Jeśli na wejście tag3 zostanie wysłana wartość null, poprzednio wyświetlana wartość trzeciej etykiety zostanie usunięta.
  • Jeśli na wejście tag4 dotrze wartość procentowa 55, a suffix_tag4 = %, to użytkownik zobaczy 55%. Bez ustawionego sufiksu jednostka nie zostanie dopisana automatycznie.