report.create
Opis
object report.create(object/array reports)
Ta metoda umożliwia tworzenie nowych zaplanowanych raportów.
Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.
Parametry
(object/array) Zaplanowane raporty do utworzenia.
Oprócz standardowych właściwości zaplanowanego raportu, metoda akceptuje następujące parametry.
| Parametr | Type | Opis |
|---|---|---|
| users | object/array | Użytkownicy, do których ma zostać wysłany raport. Zachowanie parametrów: - wymagane, jeśli user_groups nie jest ustawione |
| user_groups | object/array | Grupy użytkowników, do których ma zostać wysłany raport. Zachowanie parametrów: - wymagane, jeśli users nie jest ustawione |
Zwracane wartości
(object) Zwraca obiekt zawierający identyfikatory utworzonych zaplanowanych
raportów we właściwości reportids. Kolejność zwróconych identyfikatorów
odpowiada kolejności przekazanych zaplanowanych raportów.
Przykłady
Tworzenie zaplanowanego raportu
Utwórz raport tygodniowy, który będzie przygotowywany za poprzedni tydzień w każdy poniedziałek-piątek o 12:00 od 2021-04-01 do 2021-08-31.
{
"jsonrpc": "2.0",
"method": "report.create",
"params": {
"userid": "1",
"name": "Raport tygodniowy",
"dashboardid": "1",
"period": "1",
"cycle": "1",
"start_time": "43200",
"weekdays": "31",
"active_since": "2021-04-01",
"active_till": "2021-08-31",
"subject": "Raport tygodniowy",
"message": "Tekst towarzyszący raportowi",
"status": "1",
"description": "Opis raportu",
"users": [
{
"userid": "1",
"access_userid": "1",
"exclude": "0"
},
{
"userid": "2",
"access_userid": "0",
"exclude": "1"
}
],
"user_groups": [
{
"usrgrpid": "7",
"access_userid": "0"
}
]
},
"id": 1
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"reportids": [
"1"
]
},
"id": 1
}Zobacz także
Źródło
CReport::create() w ui/include/classes/api/services/CReport.php.