Documentation
Table of Contents
15 Zwykły tekst
Opis
Te parametry i możliwe wartości właściwości dla odpowiednich obiektów pola widżetu pulpitu pozwalają skonfigurować widżet Zwykły tekst w metodach dashboard.create i dashboard.update.
Właściwości widżetu fields nie są walidowane podczas tworzenia lub aktualizacji pulpitu. Pozwala to użytkownikom modyfikować wbudowane widżety i tworzyć niestandardowe widżety, ale wprowadza również ryzyko nieprawidłowego tworzenia lub aktualizacji widżetów. Aby zapewnić pomyślne utworzenie lub aktualizację widżetu Zwykły tekst, należy odwołać się do wymagań dotyczących parametrów przedstawionych w poniższych tabelach.
Parametry
Poniższe parametry są obsługiwane dla widżetu Zwykły tekst.
| Parametr | typ | nazwa | wartość |
|---|---|---|---|
| Odświeżanie | 0 | rf_rate | 0 - Bez odświeżania; 10 - 10 sekund; 30 - 30 sekund; 60 - (domyślne) 1 minuta; 120 - 2 minuty; 600 - 10 minut; 900 - 15 minut. |
| Pozycje (wymagane) |
4 | itemids | ID pozycji. Uwaga: Aby skonfigurować wiele pozycji, utwórz obiekt pola widżetu pulpitu nawigacyjnego dla każdej pozycji. |
| Lokalizacja pozycji | 0 | style | 0 - (domyślne) Z lewej; 1 - Na górze. |
| Wyświetl linie | 0 | show_lines | Dopuszczalne wartości od 1-100. Domyślne: 25. |
| Wyświetl tekst jako HTML | 0 | show_as_html | 0 - (domyślne) Wyłączone; 1 - Włączone. |
| Dynamiczna pozycja | 0 | dynamic | 0 - (domyślne) Wyłączone; 1 - Włączone. |
Przykłady
Poniższe przykłady mają na celu jedynie opisanie konfiguracji obiektów pól widżetu pulpitu dla widżetu Zwykły tekst. Aby uzyskać więcej informacji na temat konfigurowania pulpitu nawigacyjnego, zobacz dashboard.create.
Konfiguracja widżetu Zwykły tekst
Skonfiguruj widżet Zwykły tekst, który wyświetla najnowsze dane dla pozycji "42269" i "42253". Dodatkowo skonfiguruj nazwy pozycji tak, aby znajdowały się na górze kolumn z danymi, oraz aby wyświetlanych było tylko 15 linii danych.
Zapytanie:
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "plaintext",
"name": "Plain text",
"x": 0,
"y": 0,
"width": 6,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemids",
"value": 42269
},
{
"type": 4,
"name": "itemids",
"value": 42253
},
{
"type": 0,
"name": "style",
"value": 1
},
{
"type": 0,
"name": "show_lines",
"value": 15
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź: