Datensätze

Data Management API

Laden Sie Datensätze hoch, verwalten und aktualisieren Sie diese mit Unterstützung für mehrere Dateiformate, einschließlich CSV, ZIP-Pakete und Binärformate.

Funktionen

Datensatz-Erstellung

Erstellen Sie neue Datensätze aus CSV-, ZIP-Paketen oder Binärdateien.

Datensätze erstellen

Datenimport

Importieren Sie Daten mit Spaltenzuordnung für Process Mining-Analysen.

Daten importieren

Datensatz-Aktualisierungen

Aktualisieren Sie bestehende Datensätze mit neuen Daten und bewahren Sie dabei die Konfigurationen.

Datensätze aktualisieren

Dateiformate

Unterstützte Dateiformate und Datenstrukturen.

Formate anzeigen

Verfügbare Endpunkte

Verbindungstest

  • GET /api/{tenantId}/{projectId}/dataset/unauthorized-ping - Öffentlicher Verbindungstest (keine Authentifizierung erforderlich)
  • GET /api/{tenantId}/{projectId}/dataset/ping - Authentifizierter Verbindungstest

Datensatz-Operationen

  • GET /api/{tenantId}/{projectId}/dataset - Listet alle Datensätze eines Projekts auf

Datensatz-Erstellung

  • POST /api/{tenantId}/{projectId}/dataset/csv - Datensatz aus CSV-Datei erstellen
  • POST /api/{tenantId}/{projectId}/dataset/package - Datensatz aus ZIP-Paket erstellen
  • POST /api/{tenantId}/{projectId}/dataset/binary - Datensatz aus Binärdatei erstellen

Datensatz-Aktualisierungen

  • PUT /api/{tenantId}/{projectId}/dataset/{datasetId}/csv - Datensatz aus CSV aktualisieren
  • PUT /api/{tenantId}/{projectId}/dataset/{datasetId}/package - Datensatz aus ZIP-Paket aktualisieren
  • PUT /api/{tenantId}/{projectId}/dataset/{datasetId}/binary - Datensatz aus Binärdatei aktualisieren

Unterstützte Dateiformate

mindzieStudio unterstützt mehrere Datenformate für Process Mining:

CSV-Dateien

Kommagetrennte Werte mit flexibler Spaltenzuordnung.

  • Ereignisprotokolle mit Case ID, Aktivität, Zeitstempel
  • Benutzerdefinierte Kultur-Einstellungen für Datums- und Zahlenformatierung
  • UTF-8-Codierung unterstützt

ZIP-Pakete

Komprimierte Pakete mit mehreren verwandten Dateien.

  • Komplexe Datensätze mit mehreren Tabellen
  • Metadaten- und Konfigurationsdateien
  • mindzie-Datensatz Verpackungsstandards

Binärdateien

Natives Binärformat für effizienten Datentransfer.

  • Vorgefilterte Ereignisprotokolldaten
  • Optimiert für große Datensätze
  • Spaltenzuordnungen erforderlich

Datensatz-Struktur

Verstehen der erwarteten Datenstruktur für Process Mining-Analysen:

Erforderliche Spalten

Spalte Beschreibung
Case ID Eindeutiger Identifikator für jede Prozessinstanz
Aktivität Name der Aktivität oder des Ereignisses
Zeitstempel Zeitpunkt, zu dem die Aktivität stattfand

Optionale Spalten

Spalte Beschreibung
Ressource Benutzer oder System, das die Aktivität ausgeführt hat
Startzeit Startzeit der Aktivität (für Dauerberechnungen)
Erwartete Reihenfolge Spalte für die Reihenfolge der Abläufe

Antwortstruktur

{
  "datasetId": "550e8400-e29b-41d4-a716-446655440000",
  "datasetName": "Purchase Order Process",
  "datasetDescription": "Ereignisprotokoll aus SAP-Beschaffung",
  "projectId": "660e8400-e29b-41d4-a716-446655440000",
  "caseIdColumnName": "CaseID",
  "activityColumnName": "Activity",
  "timeColumnName": "Timestamp",
  "resourceColumnName": "Resource",
  "beginTimeColumnName": "StartTime",
  "useDateOnlySorting": false,
  "useOnlyEventColumns": false,
  "dateCreated": "2024-01-15T10:30:00Z",
  "dateModified": "2024-01-15T14:45:00Z",
  "createdBy": "user@example.com",
  "modifiedBy": "user@example.com"
}

Upload-Antwortstruktur

Datensatz-Erstellungs- und Aktualisierungsendpunkte geben Importstatistiken zurück:

{
  "datasetId": "550e8400-e29b-41d4-a716-446655440000",
  "caseCount": 5200,
  "eventCount": 150000,
  "invalidValueCount": 12,
  "skippedRowsCount": 3,
  "errors": [],
  "rowIssues": [],
  "statusCode": 200
}

Häufige Anwendungsfälle

  • Ereignisprotokoll-Import: Hochladen von Prozessereignisdaten aus ERP-, CRM- oder BPM-Systemen
  • Datenaktualisierung: Aktualisieren vorhandener Datensätze mit neuen Daten bei Beibehaltung der Analysekonfigurationen
  • Mehrformat-Unterstützung: Datenimport aus CSV-Exports oder proprietären Binärformaten
  • Batch-Verarbeitung: Hochladen großer Datensätze bis zu 1 GB mit Fortschrittsanzeige

Dateigrößenbeschränkungen

Alle Upload-Endpunkte unterstützen Dateien bis zu einer Größe von 1 GB. Für größere Datensätze sollten Sie:

  • Daten in mehrere Uploads aufteilen
  • Das Binärformat für Effizienz verwenden
  • Den Support für Enterprise-Datenlösungen kontaktieren

Authentifizierung

Alle API-Endpunkte für Datensätze (außer unauthorized-ping) erfordern eine gültige Authentifizierung mit entsprechenden Berechtigungen für das Zielprojekt und den Mandanten.

Erste Schritte

Beginnen Sie mit Datensatz-Erstellung, um zu lernen, wie Datensätze erstellt werden, und erkunden Sie dann Datenimport für Details zur Spaltenzuordnung.