ALARMS – Hromadná definice alarmů

Symbol blokuPotřebná licence: STANDARD

Popis funkce
Blok se umisťuje do hlavního souboru projektu a slouží pro hromadnou definici alarmů. Tyto alarmy se pak aktivují pomocí bloku ALM nebo ALMI. Alarmy se definují pomocí externího souboru ve formátu .csv. Název tohoto souboru je v parametru afile. Alarmy lze aktivovat také pomocí bloků ALB, ALBI, ALN, ALNI, ty ale mají všechny parametry ve svém bloku a nepoužívají hromadnou definici pomocí tohoto bloku ALARMS.

Soubor má následující sloupce:

id	…	Identifikátor alarmu, přes který se odkazuje blok ALM i záznamy v archivu.
level	…	Položka level v archivu (pokud je ukládání do archivu povoleno).
archives	…	Bitové pole, kde každý bit značí, zda se do archivu s tímto číslem ukládají události spojené s alarmem (jeho začátek, konec, potvrzení). Např. 0=do archivu se neukládá, 1=ukládá se do 1. archivu, 2=ukládá se do 2. archivu, 4=ukládá se do 3. archivu, 3=ukládá se do 1. a 2. archivu, apod.
group	…	Rezervováno pro budoucí použití. Jedná se o další hodnotu (nebo bitové pole) kterou lze použít k filtraci alarmů ve vizualizaci.
name	…	Název alarmu; může být použit jako identifikátor, proto by měl být jednoznačný.
description	…	Obsahuje textový popis alarmu. Do textu je možné vkládat formátovací znaky pro vícejazyčné texty a pro vložení hodnoty spojené s alarmem (associated values), viz níže.

Vícejazyčný popis
Popis alarmu musí být ve tvaru:

<ID_jazyk1>:<popis jazyk1>|<ID_jazyk2>:<popis jazyk2>|<ID_jazyk3>:<popis jazyk3>

Počet jazyků není omezen, ale celková délka textu je maximálně 32765 bajtů. Pokud uživatel nastaví neznámý jazyk, použije se jazyk1 (tj. první možnost podle pořadí zadání). Pokud uživatel nastaví prázdný jazyk (tj. ""), zobrazí se celý text, tj. všechny jazyky včetně formátovacích značek. Příklad: pro popis en:High voltage alarm|cz:Přepětí Uživatel, který si nastaví jazyk "en"uvidí popis alarmu "High voltage alarm", uživatel, který si nastaví jazyk "cz"uvidí "Přepětí". Ve všech ostatních případech (např. jazyk "de", ale také "eng", "CZ", "en-us", apod.) se zobrazí "High voltage alarm"(ne proto, že by se preferovala angličnina, ale proto, že tato jazyková verze je uvedena první).

Associated values
Do textu (popisu alarmu), kam se má vložit hodnota asociované proměnné, se musí vložit formátovací text. Ten má tvar:

%<číslo proměnné>[<formát>][:<počet cifer>[:<přesnost>]],

přičemž formát je jeden znak s významem:

b, B	…	binární hodnota (zobrazuje se jako on, off)
d, D	…	celočíselná hodnota (zobrazuje se jako dekadické číslo), implicitní formát pro celočíselné typy
x, X	…	celočíselná hodnota (zobrazuje se jako hexadecimální číslo)
f, F	…	desetinné číslo v obvyklém tvaru, pokud je uvedena přesnost, je to počet desetinných míst
e, E	…	desetinné číslo v exponenciálním tvaru, pokud je uvedena přesnost, je to počet desetinných míst
g, G	…	desetinné číslo, podle hodnoty se automaticky zvolí formát F nebo E, implicitní formát pro reálnočíselné typy
s, S	…	textový řetězec

Pokud formát neodpovídá typu, je ignorován a použije se implicitní formát pro daný typ. Pokud je počet znaků ve formátu příliš malý na zobrazení hodnoty, tak se použije více znaků, aby se hodnota zobrazila správně.

Příklady formátů:

%2	…	hodnota 2. proměnné (av2 u bloku ALM nebo ALMI)
%1:8:2	…	hodnota 1. proměnné (av1 u bloku ALM nebo ALMI) na 2 desetinná místa, doplněná na 8 znaků mezerami zleva
%1e	…	hodnota 1. proměnné (av1 u bloku ALM nebo ALMI) v exponencialním tvaru

Bloky ALB, ALBI associated values nepoužívají. Pro blok ALN a ALNI jsou čísla associated values přiřazena takto:

1	…	hodnota vstupu u
2	…	hodnota parametru h
3	…	hodnota parametru hh
4	…	hodnota parametru l
5	…	hodnota parametru ll
6	…	hodnota parametru tout

Poznámky:

Soubor .csv může mít jako oddělovač čárku i středník. První řádka s názvy sloupců je nepovinná.
Řádky v souboru musí být uspořádany podle sloupce id vzestupně.
Při překladu se kontroluje, jestli id jsou unikátní a to i proti ostatním blokům zapisujícím do archivu (TRND, ALB, ALN, ...)
Blok má speciální editor (tlačítko Configure v parametrickém dialogu). Toto tlačítko má funkci, že pokud soubor neexistuje, tak se vytvoří s příkladem ve správném formátu. Toto je vhodné využít poprvé pro zjištění správného formátu, i když později je možné soubor vytvářet jinak.
Hodnoty spojené s alarmem se vyhodnocují při vzniku alarmu. Pokud se hodnota během trvání alarmu změní, v alarmovém okně se to nijak neprojeví.
V komponentě na prohlížení alarmů je ještě sloupec jméno. To je název alarmového bloku (bez typového prefixu, který se často používá), který alarm generuje.

Parametry

afile	Název .csv souboru s daty	String

[Na začátek] [Výše] [Další]