ProcessMiningIntegrationAPI – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 14 Minuten Lesedauer

    • Die ProcessMiningIntegrationAPI Die Skripteinbindung bietet Methoden zum Verwalten von Process Mining-Projekten und zum Abrufen von Ergebnissen und Aufgliederungen.

    Diese Skripteinbindung erfordert das Plugin „Process Mining Core“ (com.sn_Process_Optimization). Weitere Informationen finden Sie unter Process Mining.

    Der aufrufende Anwender muss über die Rolle sn_Process_Optimization_Analyst oder sn_Process_Optimization_Power_user verfügen.

    Die folgenden Systemeigenschaften können zum Verwalten der API-Funktionalität verwendet werden.
    promin.limit.api.project_creation
    Begrenzt die Anzahl der Projekte, die täglich mit APIs erstellt werden können.

    Standard: 25.

    promin.limit.api.max_daily_minings
    Begrenzt die Anzahl der Mining-Vorgänge, die täglich mithilfe von APIs geplant werden können.

    Standard: 25.

    promin.limit.api.max_daily_minings_per_project
    Begrenzt die Anzahl von Mining Die täglich pro Projekt mithilfe von APIs geplant werden kann.

    Standard: 1.

    promin.api.allow_no_role_mining
    Ermöglicht das Mining von Projekten durch Anwender ohne die Rolle „sn_Process_Optimization_Analyst“.

    Standard: Falsch.

    promin.api.auto_share_project_with_creator
    Gibt das Projekt automatisch für den Ersteller des Projekts frei.

    Standard: Falsch.

    ProcessMiningIntegrationAPI – createProject(Zeichenfolgentabelle, Array-Aktivitäten, Array-Aufgliederungen, Zeichenfolge encodedQuery, Zeichenfolge templateType, Objektberechtigungen, boolesche automatische Neubestellung)

    Erstellt ein Process Mining-Projekt.

    Ein Projekt fungiert als Blueprint für Process Mining-Vorgänge. Sie wählt den Prozess aus, für den das Mining durchgeführt wird, und welche Attribute des Prozesses beim Mining berücksichtigt werden.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    table Zeichenfolge Name der Tabelle, die die zu analysierenden Daten enthält.
    Aktivitäten Array Aktivitätsdefinitionen für das Projekt.

    Eine Aktivitätsdefinition ist ein Attribut des Prozesses, das beim Mining berücksichtigt werden soll, z. B. Status oder Zuweisungsgruppe. Es muss sich um eine Spalte aus der in angegebenen Tabelle handeln tableParameter. Zum Mining eines Projekts ist mindestens eine Aktivitätsdefinition erforderlich. Weitere Informationen zu Aktivitätsdefinitionen finden Sie unter Set activity definitions.

    Hinweis:
    Aktivitätsdefinitionen sind auch in der Projektvorlage enthalten, die in angegeben ist templateTypeParameter. Verwenden Sie activitiesParameter zum Angeben zusätzlicher Aktivitäten, die nicht in der Vorlage enthalten sind.
    ["<column_name>"]
    Aufgliederungen Array Aufgliederungsdefinitionen für das Projekt.

    Mit einer Aufgliederungsdefinition können Sie Datensätze filtern und eine Prozesszuordnung nach Kategorien analysieren, z. B. Priorität oder Geschäftskategorie. Es muss sich um eine Spalte aus der in angegebenen Tabelle handeln tableParameter. Zum Mining eines Projekts sind keine Aufgliederungsdefinitionen erforderlich. Weitere Informationen zu Aufgliederungsdefinitionen finden Sie unter Set breakdown definitions.

    Hinweis:
    Aufgliederungsdefinitionen sind auch in der Projektvorlage enthalten, die in angegeben ist templateTypeParameter. Verwenden Sie breakdownsParameter zum Angeben zusätzlicher Aufgliederungen, die nicht in der Vorlage enthalten sind.
    ["<column_name>"]
    encodedQuery Zeichenfolge Codierte Abfrage zur Auswahl der zu analysierenden Daten. Auf diese Weise können Sie die analysierten Daten einschränken, z. B. indem Sie Daten nur aus einem bestimmten Zeitraum auswählen.

    Um alle Daten in die Tabelle aufzunehmen, können Sie eine leere Zeichenfolge übergeben.
    templateType Zeichenfolge Typ der Vorlage, die für das Projekt verwendet werden soll.
    Gültige Werte:
    • Standard
    • Digital-Portfoliomanagement
    • Lieferantenmanagement
    • WFO

    Wählen Sie für ein Projekt, das nicht Teil von WFO, Lieferantenmanagement oder Digital-Portfoliomanagement ist, Standard. Um beispielsweise ein Performance Analytics-Projekt zu erstellen, wählen Sie Standard aus.
    permissions Objekt Zuordnung von Gruppen, Rollen und Anwendern, für die das Projekt freigegeben werden soll, wobei der Schlüssel eine sys_ID ist und der Wert den Typ angibt (Gruppe, Rolle oder Anwender).

    Alle Anwender, für die das Projekt freigegeben ist, können das analysierte Modell und Projektkonfigurationen anzeigen. Nur Anwender mit sn_Process_Optimization_Analyst oder sn_Process_Optimization_Power_user können ein Mining für das Projekt durchführen.

    {
   "<user_sys_id>":"user",
   "<role_sys_id>":"role",
   "<group_sys_id>":"group"
}
    Automatische Neubestellung Boolean

    Optional. Kennzeichnung, die angibt, ob das Projekt automatisch stillgelegt werden soll.

    Gültige Werte:
    • Wahr: Das Projekt wird sieben Tage nach der Erstellung automatisch stillgelegt.
    • Falsch: Das Projekt wird nicht automatisch stillgelegt.

    Standardwert: False
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Objekt Objekt mit Informationen zum Projekt.
    {
   "entity": {Object},
   "findingDefinitionKPIMap": {Object},
   "id": "String",
   "lastMined": String",
   "miningState": "String",
   "name": "String",
   "permissions": [Array],
   "retiredDate": "String"
}
    <Object>.Entität Objekt mit Informationen zu den im Projekt analysierten Daten.

    Datentyp: Objekt

    {
   "activityDefinitions": [Array],
   "breakdownDefinitions": [Array],
   "condition": "String,"
   "table": "String"
}
    <Object>.Entität.aktivityDefinitionen Aktivitätsdefinitionen für das Projekt.

    Datentyp: Array

    [
   {
      "activityOfInterest":Boolean,
      "field":"String",
      "type":"String"      
   }
]
    <Object>.Entität.activityDefinitions.activityOfInterest

    Kennzeichnung, die angibt, ob Feldänderungen in der Workbench für Analysten angezeigt werden.

    Gültige Werte:
    • Wahr: Feldänderungen werden in der Workbench für Analysten angezeigt.
    • Falsch: Feldänderungen werden nicht in der Workbench für Analysten angezeigt, können aber weiterhin unter kontextbezogenen Bedingungen in Übergängen oder Ergebnissen verwendet werden.
    <Object>.Entität.aktivityDefinitionen.Feld Feld mit den zu analysierenden Daten. Das Feld muss aus der in angegebenen Tabelle stammen tableParameter.
    <Object>.Entität.aktivityDefinitions.type Der Typ der Werte, für die ein Mining durchgeführt werden soll.
    Gültige Werte:
    • Feldwerte (Standard): Dies ist die Standardauswahl. Diese Option ist immer verfügbar, wenn Sie eine Aktivitätsdefinition erstellen.
    • Datum/Uhrzeit: Verwendet den Datums-/Uhrzeitwert aus dem tatsächlichen Datensatz anstelle des Auditverlaufs und wird als gruppierter Knoten in der Prozesszuordnung angezeigt.
    • Verbindung: Ein Knoten oder Prozessdiagramm, das dargestellt wird Ändern Im Feld „mehrere“ Wert aus dem tatsächlichen Datensatz und nicht aus dem Audit-Verlauf.
    • Untergeordnetes Element angehängt: Diese Option ist verfügbar, wenn Sie zwei Tabellen für die Tabellenkonfiguration ausgewählt und eine untergeordnete/übergeordnete Beziehung festgelegt haben. Diese Option ist nur für die Konfiguration der übergeordneten Tabelle verfügbar. In der Visualisierung wird angezeigt, wann das untergeordnete Element im Prozess angehängt wurde.
    • Übergeordnetes Element angehängt: Diese Option erstellt einen Knoten im untergeordneten Prozess, der angibt, wann ein übergeordneter Datensatz an ein untergeordnetes Element angehängt wurde.
    <Object>.entity.breakdownDefinitions Aufgliederungsdefinitionen für das Projekt.

    Datentyp: Array

    [
 {
   "field":"String",
   "fieldLabel":"String"
 }
]
    <Object>.entity.breakdownDefinitions.field Name des in der Aufgliederung verwendeten Felds.

    Datentyp: Zeichenfolge
    <Object>.entity.breakdownDefinitions.fieldLabel Bezeichnung des in der Aufgliederung verwendeten Felds.

    Datentyp: Zeichenfolge
    <Object>.Entität.Bedingung Codierte Abfrage zur Auswahl der zu analysierenden Daten.

    Datentyp: Zeichenfolge
    <Object>.Entität.Tabelle Name der Tabelle, die die zu analysierenden Daten enthält.

    Datentyp: Zeichenfolge
    <Object>.FindingDefinitionKPIMap Zuordnung von Ergebnisdefinitionen und Leistungskennzahlen (Key Performance Indicators, KPIs), wobei der Schlüssel eine sys_ID der Ergebnisdefinition ist und der Wert ein Array von sys_IDs der von der Ergebnisdefinition betroffenen KPIs ist.

    Ergebnisdefinitionen befinden sich in den Tabellen „Ergebnisdefinition“ [promin_finding_def] und „automatisierte Ergebnisdefinition“ [promin_Automated_finding]. KPIs befinden sich in der Tabelle „Indikator“ [PA_indicators].

    Weitere Informationen zum Suchen von Definitionen und KPIs finden Sie unter Working with finding definitions Und Viewing business insights.

    Datentyp: Objekt

    {
   "<finding_def_sys_id":[
      "<kpi_sys_id>"
   ]
}
    <Object>.ID SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]

    Datentyp: Zeichenfolge
    <Object>.LastMined Datum, an dem das Projekt zuletzt ein Mining durchgeführt wurde.

    Datentyp: Zeichenfolge
    <Object>.MiningStatus Mining-Status für das Projekt.

    Beschreibungen der Mining-status finden Sie unter Mine states.

    Datentyp: Zeichenfolge
    <Object>.Name Name des Projekts.

    Datentyp: Zeichenfolge
    <Object>.Berechtigungen Gruppen-, Rollen- und Anwenderberechtigungen für das Projekt.

    Datentyp: Objekt

    [
   {
      "type":"String",
      "value":"String"      
   }
]
    <Object>.Permissions.type Typ der Berechtigung.
    Gültige Werte:
    • Gruppe
    • role
    • Anwender

    Datentyp: Zeichenfolge
    <Object>.Berechtigungen.Wert SYS_ID der Gruppe, Rolle oder des Anwenders, der die Berechtigung gewährt werden soll.

    Datentyp: Zeichenfolge
    <Object>.Stilllegungsdatum Datum, an dem das Projekt stillgelegt wird.

    Datentyp: Zeichenfolge

    In diesem Beispiel wird ein Projekt anhand von Daten aus Incidents erstellt, die im letzten Monat erstellt wurden.

    SNC.ProcessMiningIntegrationAPI
.createProject(
"incident", // table name
["state"], // activity definitions
["priority"], // breakdown definitions
"sys_created_onONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()", // incident created on last month
"DEFAULT", // template type
{"02acf036b3120010ed7fc9c316a8dc0c":"user"}, // map of permissions "sys_id":"type"
true // auto retire project
);

    Ausgabe:

    {
   "entity":{
      "table":"incident",
      "condition":"sys_created_onONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()",
      "activityDefinitions":[
         {
            "field":"assignment_group",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"business_service",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"category",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"priority",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"state",
            "type":"DEFAULT",
            "activityOfInterest":false
         }
      ],
      "breakdownDefinitions":[
         {
            "field":"contact_type",
            "fieldLabel":"Channel"
         },
         {
            "field":"assignment_group",
            "fieldLabel":"Assignment group"
         },
         {
            "field":"location",
            "fieldLabel":"Location"
         },
         {
            "field":"priority",
            "fieldLabel":"Priority"
         },
         {
            "field":"category",
            "fieldLabel":"Category"
         }
      ]
   },
   "name":"Incident Process",
   "permissions":[
      {
         "value":"62826bf03710200044e0bfc8bcbe5df1",
         "type":"user"
      },
      {
         "value":"02acf036b3120010ed7fc9c316a8dc0c",
         "type":"user"
      }
   ],
   "id":"a4286c4f4f831210c98b8a4a91ce0bf5",
   "miningState":"NEW",
   "findingDefinitionKPIMap":{
      "f23c20c34fc31210c98b8a4a91ce0bac":[
         "002d65c3d7131100b96d45a3ce6103e2"
      ]
   },
   "retiredDate":null,
   "lastMined":null
}

    ProcessMiningIntegrationAPI – deleteproject(String projectId)

    Löscht ein Process Mining-Projekt.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    projektId Zeichenfolge SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]
    Tabelle : 4. Ausgabe
    Typ Beschreibung
    Keine

    In diesem Beispiel wird ein Process Mining-Projekt gelöscht.

    SNC.ProcessMiningIntegrationAPI.deleteProject("a4286c4f4f831210c98b8a4a91ce0bf5");

    ProcessMiningIntegrationAPI – getBreakDownStats(Zeichenfolge projectId)

    Ruft Aufgliederungsstatistiken für ein Process Mining-Projekt ab.

    Aufgliederungen ermöglichen es Ihnen, Datensätze zu filtern und einen Prozess nach Kategorien zu analysieren, z. B. Priorität oder Geschäftskategorie.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    projektId Zeichenfolge SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]
    Tabelle : 6. Ausgabe
    Typ Beschreibung
    Array Array von Aufgliederungsobjekten. Jedes Objekt enthält Statistiken für die Aufgliederung.
    [
   {
      "caseCount": Number,
      "field": "String",
      "fieldValue": "String",
      "performanceStats": {Object},
      "tableName": "String",
      "variantCount": Number     
   }
]
    < Array>.Fallanzahl Anzahl der Fälle aus der Falldatensatz-Tabelle [promin_Case_Record], die Teil dieser Aufgliederung sind.

    Datentyp: Zahl
    <Array>.Feld Für die Aufgliederung verwendetes Feld.

    Datentyp: Zeichenfolge
    <Array>.Feldwert Feldwert, der für die Aufgliederung verwendet wird.

    Datentyp: Zeichenfolge
    <Array>.Leistungsstatistiken Leistungsstatistiken für die Aufgliederung.
    {
   "max": Number,
   "mean": Number,
   "median": Number, 
   "min": Number,  
   "n": Number, 
   "q1": Number, 
   "q3": Number, 
   "q4": Number, 
   "stdDeviation": Number, 
   "sum": Number, 
   "total": Number, 
   "trimmedAverage": Number, 
   "trimmedPercentage": Number
}

    Datentyp: Objekt
    <Array>.Leistungsstatistiken.max Längste Zeit, die ein Datensatz benötigt hat, um eine Route abzuschließen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.Mittelwert Durchschnittliche Zeit, die Datensätze zum Abschließen einer Route benötigt haben, vom Zeitpunkt des Öffnens bis zum Schließen von Datensätzen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.Median Mittelwert der Dauer oder Durchschnitt zweier Mittelwerte.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.Min Kürzeste Zeit, die ein Datensatz benötigt hat, um eine Route abzuschließen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.n Anzahl der Datensätze, die Teil dieser Aufgliederung sind.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.q1 Wert des ersten Quartals für Dauer.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.q3 Wert des dritten Quartals der Dauer.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.q4 Wert des vierten Quartals der Dauer (Maximum).

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.stdAbweichung Abweichung vom Durchschnittswert der Routendauer.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.Summe Summe aller Zeiträume vom ersten bis zum letzten Ereignis für alle Datensätze, die einer Route folgen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.gesamt Summe aller Zeiträume vom ersten bis zum letzten Ereignis für alle Datensätze, die einer Route folgen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.KürztDurchschnitt Durchschnittliche Zeit, die Datensätze zum Abschließen einer Route benötigt haben, berechnet nach Entfernen eines Prozentsatzes der kleinsten und größten Werte.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.KürztPercentage Prozentsatz, der zur Berechnung von verwendet wird trimmedAverageWert.

    Datentyp: Zahl
    <Array>.tableName Für die Aufgliederung verwendete Tabelle.

    Datentyp: Zeichenfolge
    <Array>.VariantAnzahl Anzahl der Varianten (eine eindeutige Sequenz von Aktivitäten, die in einem Prozess ausgeführt werden), die dieser Aufgliederung entsprechen.

    Datentyp: Zahl

    Dieses Beispiel ruft Aufgliederungsstatistiken für ein Projekt ab.

    SNC.ProcessMiningIntegrationAPI.getBreakDownStats("a4286c4f4f831210c98b8a4a91ce0bf5");

    Ausgabe:

    [
   {
      "fieldValue":"1",
      "field":"priority",
      "tableName":"incident",
      "variantCount":21,
      "caseCount":33,
      "performanceStats":{
         "sum":6.4945381E7,
         "min":0.0,
         "max":5.2334704E7,
         "n":33,
         "median":0.0,
         "mean":0.0,
         "total":64945381,
         "stdDeviation":9144841.0,
         "trimmedAverage":165594.0,
         "trimmedPercentage":-1.0,
         "q1":0.0,
         "q3":313333.0,
         "q4":5.2334704E7
      }
   }
]

    ProcessMiningIntegrationAPI – getFindings(Zeichenfolge projectId)

    Ruft Ergebnisse für ein Process Mining-Projekt ab.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    projektId Zeichenfolge SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]
    Tabelle : 8. Ausgabe
    Typ Beschreibung
    Array Array von Ergebnisobjekten.
    [
   {
      "caseIds":[],  
      "category": "String",
      "categoryDescription": "String",
      "categoryLabel": "String",
      "createdOn": Number, 
      "findingDefId": "String", 
      "id": "String",
      "impactedKpis": [],
      "matchingRecords": Number,
      "message": "String",
      "performanceStats": {},
      "shortMessage": "String",
      "tableName": "String",
      "totalRecords": Number,
      "type": "String",
      "typeLabel": "String",    
      "versionId": "String"  
   }
]
    < Array>.caseIds Liste von ids von Fällen Die dem Ergebnismuster entsprechen. Befindet sich in der Spalte „Fall-ID“ der Tabelle „Falldatensatz“ [promin_Case_Record].

    Datentyp: Array
    <Array>.Kategorie Kategorie des Ergebnisses.
    Mögliche Werte:
    • AUTOMATISIERUNG
    • COMPLIANCE
    • KONFORMITÄT
    • KOSTEN
    • LEISTUNG
    • QUALITÄT
    • GESCHWINDIGKEIT

    Datentyp: Zeichenfolge
    <Array>.kategorieBeschreibung Beschreibung der Ergebniskategorie.

    Datentyp: Zeichenfolge
    <Array>.kategoriebezeichnung Bezeichnung für die Ergebniskategorie.

    Datentyp: Zeichenfolge
    <Array>.CreatedOn Erstellungsdatum des Ergebnisses.

    Datentyp: Zahl
    <Array>.findingDefId SYS_ID der Ergebnisdefinition.

    Ergebnisdefinitionen befinden sich in den Tabellen „Ergebnisdefinition“ [promin_finding_def] und „automatisierte Ergebnisdefinition“ [promin_Automated_finding].

    Datentyp: Zeichenfolge
    <Array>.ID SYS_ID des Ergebnisses. Befindet sich in der Tabelle „Ergebnis“ [promin_finding].

    Datentyp: Zeichenfolge
    <Array>.BetroffenKpis Liste der sys_IDs der vom Ergebnis betroffenen KPIs. Befindet sich in der Tabelle „Indikator“ [PA_indicators].

    Datentyp: Array
    <Array>.übereinstimmender Datensätze Anzahl der Fall-IDs aus der Falldatensatz-Tabelle [promin_Case_Record], die dem Ergebnismuster entsprechen.

    Datentyp: Zahl
    <Array>.Nachricht Nachricht aus der Ergebnisdefinition.

    Datentyp: Zeichenfolge
    <Array>.Leistungsstatistiken Leistungsstatistiken für das Ergebnis.
    {
   "max": Number,
   "mean": Number,
   "median": Number, 
   "min": Number,  
   "n": Number, 
   "q1": Number, 
   "q3": Number, 
   "q4": Number, 
   "stdDeviation": Number, 
   "sum": Number, 
   "total": Number, 
   "trimmedAverage": Number, 
   "trimmedPercentage": Number
}

    Datentyp: Objekt
    <Array>.Leistungsstatistiken.max Längste Zeit, die ein Datensatz benötigt hat, um eine Route abzuschließen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.Mittelwert Durchschnittliche Zeit, die Datensätze zum Abschließen einer Route benötigt haben, vom Zeitpunkt des Öffnens bis zum Schließen von Datensätzen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.Median Mittelwert der Dauer oder Durchschnitt zweier Mittelwerte.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.Min Kürzeste Zeit, die ein Datensatz benötigt hat, um eine Route abzuschließen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.n Anzahl der Datensätze, die Teil dieses Ergebnisses sind.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.q1 Wert des ersten Quartals für Dauer.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.q3 Wert des dritten Quartals der Dauer.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.q4 Wert des vierten Quartals der Dauer (Maximum).

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.stdAbweichung Abweichung vom Durchschnittswert der Routendauer.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.Summe Summe aller Zeiträume vom ersten bis zum letzten Ereignis für alle Datensätze, die einer Route folgen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.gesamt Summe aller Zeiträume vom ersten bis zum letzten Ereignis für alle Datensätze, die einer Route folgen.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.KürztDurchschnitt Durchschnittliche Zeit, die Datensätze zum Abschließen einer Route benötigt haben, berechnet nach Entfernen eines Prozentsatzes der kleinsten und größten Werte.

    Datentyp: Zahl

    Einheit: Millisekunden
    <Array>.Leistungsstatistiken.KürztPercentage Prozentsatz, der zur Berechnung von verwendet wird trimmedAverageWert.

    Datentyp: Zahl
    <Array>.ShortMessage Kurznachricht aus der Ergebnisdefinition.

    Datentyp: Zeichenfolge
    <Array>.tableName Name der im Ergebnis verwendeten Tabelle.

    Datentyp: Zeichenfolge
    <Array>.Gesamtdatensätze Gesamtanzahl der im Mining analysierten Datensätze.

    Datentyp: Zahl
    <Array>.Typ Typ der Ergebnisdefinition.
    Mögliche Werte:
    • EXTRA_STEP
    • EXTREME_DURATION
    • EXTREME_REPETITION
    • OTHER
    • MUSTER
    • PERFORMANCE_OUTLIER
    • PINGPONG
    • ÜBERARBEITEN

    Weitere Informationen finden Sie unter Automated improvement opportunities.
    <Array>.typeBezeichnung Bezeichnung für den Ergebnisdefinitionstyp.

    Datentyp: Zeichenfolge
    <Array>.VersionID SYS_ID der Projektversion. Befindet sich in der Tabelle „Projektdefinitionsversion“ [promin_model_def_Version].

    Datentyp: Zeichenfolge

    In diesem Beispiel werden Ergebnisse für ein Projekt abgerufen.

    SNC.ProcessMiningIntegrationAPI.getFindings("a4286c4f4f831210c98b8a4a91ce0bf5");

    Ausgabe:

    [
   {
      "message":"Rework on Closed",
      "id":"0ef09b2e1c6cf0d98045e6ba1c3c9edb",
      "type":"REWORK",
      "createdOn":1727036052.000000000,
      "category":"AUTOMATION",
      "tableName":"incident",
      "categoryLabel":"Automation",
      "matchingRecords":111,
      "versionId":"9a2f187177b412102f7a1b56ba5a99e2",
      "totalRecords":19758,
      "findingDefId":"791f587177b412102f7a1b56ba5a99eb",
      "categoryDescription":"Category that groups all opportunities that are subject to automation.",
      "impactedKpis":[
         
      ],
      "performanceStats":{
         "sum":2.09532828E8,
         "min":1.0,
         "max":6563078.0,
         "n":111,
         "median":1036715.0,
         "mean":1.0,
         "total":209532828,
         "stdDeviation":1855944.0,
         "trimmedAverage":1716904.0,
         "trimmedPercentage":-1.0,
         "q1":776859.0,
         "q3":2246368.0,
         "q4":6563078.0
      },
      "typeLabel":"Automation",
      "shortMessage":"Closed",
      "caseIds":[
         "119e4a569397fd14849bbcd74dba1018",
         "b16b355f47197190498cc044846d43b0",
         "cf9bca7597fe7d90ef889504a253af9e",
      ]
   }
]

    ProcessMiningIntegrationAPI – getMiningStatus(Zeichenfolge projectId)

    Ruft den Mining-Status eines Process Mining-Projekts ab.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    projektId Zeichenfolge SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]
    Tabelle : 10. Ausgabe
    Typ Beschreibung
    Objekt Objekt, das die sys_ID des Projekts und einen Tracker enthält. 
    {
   "projectId":"String",
   "trackerId":"String"  
}
    <Object>.ProjectId SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]

    Datentyp: Zeichenfolge
    <Object>.TrackerId SYS_ID des Trackers, der den Mining-Fortschritt für das Projekt überwacht.

    Tabelle: Ausführungstracker [sys_Execution_Tracker]

    Datentyp: Zeichenfolge

    Dieses Beispiel ruft den Mining-Status für ein Projekt ab.

    SNC.ProcessMiningIntegrationAPI.getMiningStatus("c0b91f0cff01121047cae835f2cb14bc");

    Ausgabe:

    {
   "trackerId":"aec9530cff01121047cae835f2cb147e",
   "projectId":"c0b91f0cff01121047cae835f2cb14bc"
}

    ProcessMiningIntegrationAPI – getProject(String projectId)

    Ruft ein Process Mining-Projekt ab.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    projektId Zeichenfolge SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    Objekt Objekt mit Informationen zum Projekt.
    {
   "entity": {Object},
   "findingDefinitionKPIMap": {Object},
   "id": "String",
   "lastMined": String",
   "miningState": "String",
   "name": "String",
   "permissions": [Array],
   "retiredDate": "String"
}
    <Object>.Entität Objekt mit Informationen zu den im Projekt analysierten Daten.

    Datentyp: Objekt

    {
   "activityDefinitions": [Array],
   "breakdownDefinitions": [Array],
   "condition": "String,"
   "table": "String"
}
    <Object>.Entität.aktivityDefinitionen Aktivitätsdefinitionen für das Projekt.

    Datentyp: Array

    [
   {
      "activityOfInterest":Boolean,
      "field":"String",
      "type":"String"      
   }
]
    <Object>.Entität.activityDefinitions.activityOfInterest

    Kennzeichnung, die angibt, ob Feldänderungen in der Workbench für Analysten angezeigt werden.

    Gültige Werte:
    • Wahr: Feldänderungen werden in der Workbench für Analysten angezeigt.
    • Falsch: Feldänderungen werden nicht in der Workbench für Analysten angezeigt, können aber weiterhin unter kontextbezogenen Bedingungen in Übergängen oder Ergebnissen verwendet werden.
    <Object>.Entität.aktivityDefinitionen.Feld Feld mit den zu analysierenden Daten. Das Feld muss aus der in angegebenen Tabelle stammen tableParameter.
    <Object>.Entität.aktivityDefinitions.type Der Typ der Werte, für die ein Mining durchgeführt werden soll.
    Gültige Werte:
    • Feldwerte (Standard): Dies ist die Standardauswahl. Diese Option ist immer verfügbar, wenn Sie eine Aktivitätsdefinition erstellen.
    • Datum/Uhrzeit: Verwendet den Datums-/Uhrzeitwert aus dem tatsächlichen Datensatz anstelle des Auditverlaufs und wird als gruppierter Knoten in der Prozesszuordnung angezeigt.
    • Verbindung: Ein Knoten oder Prozessdiagramm, das dargestellt wird Ändern Im Feld „mehrere“ Wert aus dem tatsächlichen Datensatz und nicht aus dem Audit-Verlauf.
    • Untergeordnetes Element angehängt: Diese Option ist verfügbar, wenn Sie zwei Tabellen für die Tabellenkonfiguration ausgewählt und eine untergeordnete/übergeordnete Beziehung festgelegt haben. Diese Option ist nur für die Konfiguration der übergeordneten Tabelle verfügbar. In der Visualisierung wird angezeigt, wann das untergeordnete Element im Prozess angehängt wurde.
    • Übergeordnetes Element angehängt: Diese Option erstellt einen Knoten im untergeordneten Prozess, der angibt, wann ein übergeordneter Datensatz an ein untergeordnetes Element angehängt wurde.
    <Object>.entity.breakdownDefinitions Aufgliederungsdefinitionen für das Projekt.

    Datentyp: Array

    [
 {
   "field":"String",
   "fieldLabel":"String"
 }
]
    <Object>.entity.breakdownDefinitions.field Name des in der Aufgliederung verwendeten Felds.

    Datentyp: Zeichenfolge
    <Object>.entity.breakdownDefinitions.fieldLabel Bezeichnung des in der Aufgliederung verwendeten Felds.

    Datentyp: Zeichenfolge
    <Object>.Entität.Bedingung Codierte Abfrage zur Auswahl der zu analysierenden Daten.

    Datentyp: Zeichenfolge
    <Object>.Entität.Tabelle Name der Tabelle, die die zu analysierenden Daten enthält.

    Datentyp: Zeichenfolge
    <Object>.FindingDefinitionKPIMap Zuordnung von Ergebnisdefinitionen und Leistungskennzahlen (Key Performance Indicators, KPIs), wobei der Schlüssel eine sys_ID der Ergebnisdefinition ist und der Wert ein Array von sys_IDs der von der Ergebnisdefinition betroffenen KPIs ist.

    Ergebnisdefinitionen befinden sich in den Tabellen „Ergebnisdefinition“ [promin_finding_def] und „automatisierte Ergebnisdefinition“ [promin_Automated_finding]. KPIs befinden sich in der Tabelle „Indikator“ [PA_indicators].

    Weitere Informationen zum Suchen von Definitionen und KPIs finden Sie unter Working with finding definitions Und Viewing business insights.

    Datentyp: Objekt

    {
   "<finding_def_sys_id":[
      "<kpi_sys_id>"
   ]
}
    <Object>.ID SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]

    Datentyp: Zeichenfolge
    <Object>.LastMined Datum, an dem das Projekt zuletzt ein Mining durchgeführt wurde.

    Datentyp: Zeichenfolge
    <Object>.MiningStatus Mining-Status für das Projekt.

    Beschreibungen der Mining-status finden Sie unter Mine states.

    Datentyp: Zeichenfolge
    <Object>.Name Name des Projekts.

    Datentyp: Zeichenfolge
    <Object>.Berechtigungen Gruppen-, Rollen- und Anwenderberechtigungen für das Projekt.

    Datentyp: Objekt

    [
   {
      "type":"String",
      "value":"String"      
   }
]
    <Object>.Permissions.type Typ der Berechtigung.
    Gültige Werte:
    • Gruppe
    • role
    • Anwender

    Datentyp: Zeichenfolge
    <Object>.Berechtigungen.Wert SYS_ID der Gruppe, Rolle oder des Anwenders, der die Berechtigung gewährt werden soll.

    Datentyp: Zeichenfolge
    <Object>.Stilllegungsdatum Datum, an dem das Projekt stillgelegt wird.

    Datentyp: Zeichenfolge

    In diesem Beispiel wird ein Process Mining-Projekt abgerufen.

    SNC.ProcessMiningIntegrationAPI.getProject("fa465748ff01121047cae835f2cb1473");

    Ausgabe:

    {
   "entity":{
      "table":"incident",
      "activityDefinitions":[
         {
            "field":"assignment_group",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"business_service",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"state",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"category",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"priority",
            "type":"DEFAULT",
            "activityOfInterest":false
         }
      ],
      "condition":"",
      "breakdownDefinitions":[
         {
            "field":"contact_type",
            "fieldLabel":"Channel"
         },
         {
            "field":"close_code",
            "fieldLabel":"Resolution code"
         },
         {
            "field":"assignment_group",
            "fieldLabel":"Assignment group"
         },
         {
            "field":"location",
            "fieldLabel":"Location"
         },
         {
            "field":"priority",
            "fieldLabel":"Priority"
         },
         {
            "field":"category",
            "fieldLabel":"Category"
         }
      ]
   },
   "name":"Incident Process",
   "permissions":[
      {
         "value":"some_group_sys_id",
         "type":"group"
      },
      {
         "value":"some_role_sys_id",
         "type":"role"
      },
      {
         "value":"some_user_sys_id",
         "type":"user"
      }
   ],
   "id":"fa465748ff01121047cae835f2cb1473",
   "miningState":"NEW",
   "findingDefinitionKPIMap":{
      
   },
   "retiredDate":1728292672.622894000,
   "lastMined":null
}

    ProcessMiningIntegrationAPI – scheduleMining(String projectId)

    Übermittelt ein Process Mining-Projekt zum Mining.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    projektId Zeichenfolge SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]
    Tabelle : 14. Ausgabe
    Typ Beschreibung
    Objekt Objekt, das die sys_ID des Projekts und einen Tracker enthält. 
    {
   "projectId":"String",
   "trackerId":"String"  
}
    <Object>.ProjectId SYS_ID des Projekts.

    Tabelle: Projektdefinition [promin_project]

    Datentyp: Zeichenfolge
    <Object>.TrackerId SYS_ID des Trackers, der den Mining-Fortschritt für das Projekt überwacht.

    Tabelle: Ausführungstracker [sys_Execution_Tracker]

    Datentyp: Zeichenfolge

    In diesem Beispiel wird ein Projekt zum Mining übermittelt.

    SNC.ProcessMiningIntegrationAPI.scheduleMining("c0b91f0cff01121047cae835f2cb14bc");

    Ausgabe:

    {
   "trackerId":"aec9530cff01121047cae835f2cb147e",
   "projectId":"c0b91f0cff01121047cae835f2cb14bc"
}