Áú»¢¶Ä²©

This is a translation of the original English documentation page. Help us make it better.

service.get

Opis

integer/array service.get(object parameters)

Metoda umo?liwia pobranie us?ug zgodnie z podanymi parametrami.

Ta metoda jest dost?pna dla u?ytkownik¨®w dowolnego typu. Uprawnienia do wywo?ywania metody mo?na odebra? w ustawieniach roli u?ytkownika. Zobacz Role u?ytkownika aby uzyska? wi?cej informacji.

Parametry

(object) Parametry definiuj?ce po??dany wynik.

Metoda obs?uguje nast?puj?ce parametry. | Parametr | Typ | | |------------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | serviceids | string/array | Zwraca tylko us?ugi o podanych identyfikatorach. | | parentids | string/array | Zwraca tylko us?ugi po??czone z podanymi us?ugami nadrz?dnymi. | | deep_parentids | flag | Zwraca wszystkie bezpo?rednie i po?rednie us?ugi podrz?dne. U?ywane razem z parentids. | | childids | string/array | Zwraca tylko us?ugi po??czone z podanymi us?ugami podrz?dnymi. | | evaltype | integer | Zasady wyszukiwania znacznik¨®w.

Mozliwe warto?ci:
0 - (domy?lne) I/Lub;
2 - Lub. | | tags | object/array | Zwraca tylko us?ugi z okre?lonymi znacznikami. Dok?adne dopasowanie tagu i wyszukiwanie z uwzgl?dnieniem wielko?ci liter lub bez, w zale?no?ci od warto?ci operatora.
Format: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Pusta tablica zwraca wszystkie us?ugi.

Mo?liwe warto?ci operatora:
0 - (domy?lne) Zawiera;
1 - Jest r¨®wny;
2 - Nie zawiera;
3 - Nie jest r¨®wny;
4 - Istnieje;
5 - Nie istnieje. | | problem_tags | object/array | Zwraca tylko us?ugi z okre?lonymi znacznikami problem¨®w. Dok?adne dopasowanie tagu i wyszukiwanie z uwzgl?dnieniem wielko?ci liter lub bez, w zale?no?ci od warto?ci operatora.
Format: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Pusta tablica zwraca wszystkie us?ugi.

Mo?liwe warto?ci operatora:
0 - (domy?lne) Zawiera;
1 - Jest r¨®wny;
2 - Nie zawiera;
3 - Nie jest r¨®wny;
4 - Istnieje;
5 - Nie istnieje. | | without_problem_tags | flag | Zwraca tylko us?ugi bez znacznik¨®w problem¨®w. | | slaids | string/array | Zwraca tylko us?ugi po??czone z okre?lonymi SLA. | | selectChildren | query | Zwraca w?a?ciwo?? children z us?ugami podrz?dnymi.

Obs?uguje count. | | selectParents | query | Zwraca w?a?ciwo?? parents z us?ugami nadrz?dnymi.

Obs?uguje count. | | selectTags | query | Zwraca w?a?ciwo?? tags z znacznikami us?ugi.

Obs?uguje count. | | selectProblemEvents | query | Zwraca w?a?ciwo?? problem_events z tablic? obiekt¨®w problem¨®w.

Obiekt problemu ma nast?puj?ce w?a?ciwo?ci:
eventid - (string) ID zdarzenia;
severity - (string) Bie??cy poziom zdarzenia;
name - (string) Nazwa rozwi?zanego zdarzenia.

Obs?uguje count. | | selectProblemTags | query | Zwraca w?a?ciwo?? problem_tags z znacznikami problem¨®w.

Obs?uguje count. | | selectStatusRules | query | Zwraca w?a?ciwo?? status_rules z zasadami statusu.

Obs?uguje count. | | selectStatusTimeline | object/array | Zwraca w?a?ciwo?? status_timeline zawieraj?c? zmiany stanu us?ugi dla okre?lonych okres¨®w.

Format [{"period_from": "<period_from>", "period_to": "<period_to>"}, ...] - period_from to pocz?tkowa data (w??cznie; znacznik czasu jako liczba ca?kowita) i period_to to ko¨½cowa data (wy??cznie; znacznik czasu jako liczba ca?kowita) dla interesuj?cego ci? okresu.

Zwraca tablic? wpis¨®w zawieraj?c? w?a?ciwo?? start_value i tablic? ²¹±ô²¹°ù³¾¨®·É dla zmian stanu w okre?lonych okresach. |

sortfield string/array Sortuj wynik wed?ug podanych w?a?ciwo?ci.

Mo?liwe warto?ci to: serviceid, name, status, sortorder i created_at.
countOutput boolean Te parametry, kt¨®re s? wsp¨®lne dla wszystkich metod get, s? szczeg¨®?owo opisane w komentarzu referencyjnym.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Zwracane warto?ci

(integer/array) Zwraca jedn? z opcji:

  • tablic? obiekt¨®w;
  • liczb? pobranych obiekt¨®w, je?li parametr countOutput zosta? wykorzystany.

Przyk?ady

Pobieranie wszystkich us?ug

Pobierz wszystkie dane dotycz?ce wszystkich us?ug i ich zale?no?ci.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "service.get",
           "params": {
               "output": "extend",
               "selectChildren": "extend",
               "selectParents": "extend"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowied?:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "serviceid": "1",
                   "name": "My Service - 0001",
                   "status": "-1",
                   "algorithm": "2",
                   "sortorder": "0",
                   "weight": "0",
                   "propagation_rule": "0",
                   "propagation_value": "0",
                   "description": "My Service Description 0001.",
                   "uuid": "dfa4daeaea754e3a95c04d6029182681",
                   "created_at": "946684800",
                   "readonly": false,
                   "parents": [],
                   "children": []
               },
               {
                   "serviceid": "2",
                   "name": "My Service - 0002",
                   "status": "-1",
                   "algorithm": "2",
                   "sortorder": "0",
                   "weight": "0",
                   "propagation_rule": "0",
                   "propagation_value": "0",
                   "description": "My Service Description 0002.",
                   "uuid": "20ea0d85212841219130abeaca28c065",
                   "created_at": "946684800",
                   "readonly": false,
                   "parents": [],
                   "children": []
               }
           ],
           "id": 1
       }

?°ù¨®»å?´Ç

CService::get() w ui/include/classes/api/services/CService.php.