Zu Content springen
Deutsch
zum Kundenportal Anmelden
Zum Kundenportal
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

📉 KPI-Werte löschen mit Postman (Beispiel: Maschinenstörungen am 19.10.2025)

Dieser Artikel beschreibt Schritt für Schritt, wie Sie mithilfe von Postman gezielt KPI-Werte in ValueStreamer löschen können. Als Praxisbeispiel wird gezeigt, wie ein versehentlich erfasster KPI-Wert für einen arbeitsfreien Sonntag entfernt wird.

🔍 Inhalt


Voraussetzungen

  • Ein kostenloses Postman-Konto: Postman

  • Ihre ValueStreamer API-Zugangsdaten (Benutzername & Passwort)

ℹ️ Hinweis: Falls Sie keine Zugangsdaten haben, wenden Sie sich bitte über das Help Desk an den Support.

1. API-Endpunkt zum Abrufen aller KPIs aufrufen

GET https://api-Tenant.valuestreamer.de/api/exchange/kpi/

📸 Screenshot: Abfrage aller KPIs in Postman mit Basic Auth

Sie erhalten eine Liste aller Kennzahlen im JSON-Format. Beispiel:

 
[
    {
        "id": "87fa7b38-44e8-4465-b5b7-e6b17489205c",
        "name": "OEE ZACN"
    },
    {
        "id": "888fa6ec-4f58-4518-8568-a0b33aa1d84c",
        "name": "Machine failure > 2 h"
    },
    {
        "id": "90b1ba3e-4877-4e14-a87a-63362e3664f9",
        "name": "Rework [h]"
    }
 }
]
 

2. Detaildaten zur gewählten KPI abfragen

GET https://api-Tenant.valuestreamer.de/api/exchange/kpi/888fa6ec-4f58-4518-8568-a0b33aa1d84c

Hier sehen Sie alle zugehörigen Teams und weitere KPI-Informationen.

📸 Screenshot: Detailansicht einer KPI in Postman

3. Team-ID für das Zielteam identifizieren

Im JSON sehen Sie z. B.:

 
        {
            "id": "fa9089f3-2bef-4750-8226-40a8ca12b7cd",
            "name": "S_Endmontage",
            "subTileRecording": false
        }

Diese ID wird für den DELETE-Request benötigt.

4. Wert gezielt löschen

Zum Löschen von KPI-Werten benötigen Sie folgenden API-Endpunkt: 

https://api-tenant.valuestreamer.de/api/exchange/kpi-data/{date}/{team-id}/{kpi-id}

Dabei gilt:

  • {date}: Datum im Format YYYY-MM-DD (z. B. 2025-10-19 für eine Tages-KPI)

  • {team-id}: Die ID des betroffenen Teams (z. B. fa9089f3-2bef-4750-8226-40a8ca12b7cd für S_Endmontage)

  • {kpi-id}: Die ID der KPI (z. B. 888fa6ec-4f58-4518-8568-a0b33aa1d84c für "Machine failure > 2 h")

Konkret für unser Beispiel:

 
https://api-tenant.valuestreamer.de/api/exchange/kpi-data/2025-10-19/fa9089f3-2bef-4750-8226-40a8ca12b7cd/888fa6ec-4f58-4518-8568-a0b33aa1d84c

📸 Screenshot: DELETE-Request in Postman absenden

✅ Wenn alles korrekt ist, erhalten Sie eine 200 OK Rückgabe und der Wert ist gelöscht.

⚠️ Achtung: Der Löschvorgang ist nicht rückgängig. Prüfen Sie vorab, ob Sie die korrekten IDs und das richtige Datum verwenden.

5. KPI-Wert für Sub-KPIs löschen

Bei KPIs mit Sub-Tile-Aufzeichnung (z. B. Schichtdaten wie Früh/Spät/Nacht) benötigen Sie zusätzlich die Sub-Tile-ID. Die DELETE-URL erweitert sich wie folgt:

 
https://api-tenant.valuestreamer.de/api/exchange/kpi-data/{date}/{team-id}/{kpi-id}/{sub-tile-id}

Die {sub-tile-id} erhalten Sie ebenfalls aus der Detailabfrage:

        {
            "id": "ace4b82a-d233-4610-8781-7df6bc9dc072",
            "name": "D_Pre-Assembly",
            "subTileRecording": true,
            "subTiles": [
                {
                    "id": "77d03d83-3519-43dc-b995-9a68e297d88e",
                    "name": "Early",
                    "team": "ace4b82a-d233-4610-8781-7df6bc9dc072",
                    "orderId": 1
                },
                {
                    "id": "e896db9d-fdd0-4fb4-b07d-f97668caa811",
                    "name": "Late",
                    "team": "ace4b82a-d233-4610-8781-7df6bc9dc072",
                    "orderId": 2
                },
                {
                    "id": "ee5dbd67-e368-4ab5-bd1e-b109e94b53f9",
                    "name": "Night",
                    "team": "ace4b82a-d233-4610-8781-7df6bc9dc072",
                    "orderId": 3
                }
            ]
        },

✨ Tipp: Verwenden Sie Sub-Tile-IDs nur bei Teams mit aktivierter Sub-Tile-Aufzeichnung (subTileRecording: true).

✨ Tipps & Best Practices

  • Nutzen Sie GET vorab zur Kontrolle, ob Daten vorhanden sind

  • DELETE-Anfragen immer gezielt mit Datum, Team-ID und KPI-ID nutzen

  • Dokumentieren Sie Löschvorgänge für die Nachvollziehbarkeit

❓ FAQ

Wie finde ich heraus, welche KPI-ID zu welcher Kennzahl gehört? Nutzen Sie den GET-Request auf /api/exchange/kpi/ – die Antwort zeigt Ihnen eine Liste aller KPIs mit IDs und Namen.

Kann ich KPI-Werte auch mit anderen Tools löschen? Ja, z. B. mit Power Automate oder eigenen Skripten über die REST API. Postman eignet sich jedoch für schnelle Tests und manuelle Eingriffe.

Was ist das richtige Datumsformat für den Lösch-Request?

  • Tages-KPIs: YYYY-MM-DD

  • Wochen-KPIs: Montag der Woche (YYYY-MM-DD)

  • Monats-KPIs: Erster Tag des Monats (YYYY-MM-01)

Kann ich versehentlich alle Werte einer KPI löschen? Nur wenn Sie DELETE-Anfragen mehrfach mit verschiedenen Datumswerten absenden. Verwenden Sie die URL immer gezielt mit einem konkreten Datum.