1 Aktionsprotokoll

Beschreibung

Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets Aktionsprotokoll in den Methoden dashboard.create und dashboard.update.

Die Eigenschaften von Widget-fields werden bei der Erstellung oder Aktualisierung eines Dashboards nicht validiert. Dadurch können Benutzer integrierte Widgets ändern und benutzerdefinierte Widgets erstellen, es besteht jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren. Um die erfolgreiche Erstellung oder Aktualisierung des Widgets Aktionsprotokoll sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Parameterverhalten.

Parameter

Die folgenden Parameter werden für das Widget Aktionsprotokoll unterstützt.

Parameter type name value
Aktualisierungsintervall 0 rf_rate 0 - Keine Aktualisierung;
10 - 10 Sekunden;
30 - 30 Sekunden;
60 - (Standard) 1 Minute;
120 - 2 Minuten;
600 - 10 Minuten;
900 - 15 Minuten.
Empfänger 11 userids.0 ID des Benutzers.

Hinweis: Um mehrere Benutzer zu konfigurieren, erstellen Sie für jeden Benutzer ein Dashboard-Widget-Feldobjekt mit einer fortlaufenden Nummer im Eigenschaftsnamen.
Aktionen 12 actionids.0 ID der Aktion.

Hinweis: Um mehrere Aktionen zu konfigurieren, erstellen Sie für jede Aktion ein Dashboard-Widget-Feldobjekt mit einer fortlaufenden Nummer im Eigenschaftsnamen.
Medientypen 13 mediatypeids.0 ID des Medientyps.

Hinweis: Um mehrere Medientypen zu konfigurieren, erstellen Sie für jeden Medientyp ein Dashboard-Widget-Feldobjekt mit einer fortlaufenden Nummer im Eigenschaftsnamen.
Status 0 statuses.0 0 - In Bearbeitung;
1 - Gesendet/Ausgeführt;
2 - Fehlgeschlagen.

Hinweis: Um mehrere Werte zu konfigurieren, erstellen Sie für jeden Wert ein Dashboard-Widget-Feldobjekt mit einer fortlaufenden Nummer im Eigenschaftsnamen.
Suchzeichenfolge 1 message Beliebiger Zeichenfolgenwert.
Zeitraum 1 time_period._reference DASHBOARD._timeperiod - den Zeitraumauswahlschalter des Dashboards als Datenquelle festlegen;
ABCDE._timeperiod - ein kompatibles Widget (dessen Parameter Referenz auf "ABCDE" gesetzt ist) als Datenquelle festlegen.

Standard: DASHBOARD._timeperiod

Alternativ können Sie den Zeitraum nur in den Parametern Von und Bis festlegen.
Von 1 time_period.from Gültige Zeitangabe im absoluten (YYYY-MM-DD hh:mm:ss) oder relativen Zeitformat (now, now/d, now/w-1w usw.).

Parameterverhalten:
- unterstützt, wenn Zeitraum nicht festgelegt ist
- erforderlich, wenn time_period.to festgelegt ist
Bis 1 time_period.to Gültige Zeitangabe im absoluten (YYYY-MM-DD hh:mm:ss) oder relativen Zeitformat (now, now/d, now/w-1w usw.).

Parameterverhalten:
- unterstützt, wenn Zeitraum nicht festgelegt ist
- erforderlich, wenn time_period.from festgelegt ist
Einträge sortieren nach 0 sort_triggers 3 - Zeit (aufsteigend);
4 - (Standard) Zeit (absteigend);
5 - Typ (aufsteigend);
6 - Typ (absteigend);
7 - Status (aufsteigend);
8 - Status (absteigend);
11 - Empfänger (aufsteigend);
12 - Empfänger (absteigend).
Zeilen anzeigen 0 show_lines Mögliche Werte liegen zwischen 1 und 100.

Standard: 25.

Beispiele

Die folgenden Beispiele sollen lediglich die Konfiguration der Dashboard-Widget-Feldobjekte für das Aktionsprotokoll-Widget beschreiben. Weitere Informationen zur Konfiguration eines Dashboards finden Sie unter dashboard.create.

Konfiguration eines Widgets Aktionsprotokoll

Konfigurieren Sie ein Widget Aktionsprotokoll, das 10 Einträge mit Details zu Aktionsoperationen anzeigt, nach Zeit sortiert (in aufsteigender Reihenfolge). Zeigen Sie außerdem nur Details für diejenigen Aktionsoperationen an, die versucht haben, eine E-Mail an Benutzer „1“ zu senden, jedoch nicht erfolgreich waren.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "actionlog",
                        "name": "Action log",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "show_lines",
                                "value": 10
                            },
                            {
                                "type": 0,
                                "name": "sort_triggers",
                                "value": 3
                            },
                            {
                                "type": 11,
                                "name": "userids.0",
                                "value": 1
                            },
                            {
                                "type": 13,
                                "name": "mediatypeids.0",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "statuses.0",
                                "value": 2
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}

Siehe auch