---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ProcessMiningIntegrationAPI -- Umfang

# ProcessMiningIntegrationAPI -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 13 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](https://www.servicenow.com/docs/access?context=process-mining&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US).

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, die täglich mithilfe von APIs geplant werden können. Standard: 25.

promin.limit.api.max_daily_minings_per_project

:   Begrenzt die Anzahl von Minings Das täglich pro Projekt mithilfe von APIs geplant werden kann.Standard: 1.

promin.api.allow_no_role_mining

:   Ermöglicht das Mining von Projekten von Anwendern ohne sn_process_optimization_analyst-Rolle.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, ZeichenfolgencodedQuery, ZeichenfolgentemplateType, Objektberechtigungen, boolesche automatische Neubestellung) {#ariaid-title2}

Erstellt ein Process Mining-Projekt.
Ein Projekt fungiert als Blueprint für Process Mining-Vorgänge. Wählt den Prozess aus, für den das Mining ausgeführt wird, und welche Attribute des Prozesses beim Mining berücksichtigt werden.
{#ProcMinInt-createProj_S_O_O_S_S_O_B__table_xs3_lqs_kdc__entry__3}

| 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 eine Spalte aus der Tabelle sein, die in angegeben ist tableParameter. Zum Mining eines Projekts ist mindestens eine Aktivitätsdefinition erforderlich. Weitere Informationen zu Aktivitätsdefinitionen finden Sie unter [Set activity definitions](https://www.servicenow.com/docs/access?context=set-activity-def&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US). 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 eine Spalte aus der Tabelle sein, die in angegeben ist tableParameter. Aufgliederungsdefinitionen sind zum Mining eines Projekts nicht erforderlich. Weitere Informationen zu Aufgliederungsdefinitionen finden Sie unter [Set breakdown definitions](https://www.servicenow.com/docs/access?context=breakdown&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US). 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 zum Auswählen der zu analysierenden Daten. Dadurch können Sie die analysierten Daten einschränken, z. B. indem Sie Daten nur aus einem angegebenen Zeitraum auswählen. Um alle Daten in die Tabelle einzubeziehen, 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 {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_xgh_dzh_xdc} Wählen Sie für ein Projekt, das nicht Teil von WFO, Lieferantenmanagement oder digitalem 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 das Projekt Mining durchführen. { "<user_sys_id>":"user", "<role_sys_id>":"role", "<group_sys_id>":"group" } |
| autoRetire | 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. {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_kq1_jck_xdc} Standard: Falsch |
[Tabelle : 1. Parameter]

{#ProcMinInt-createProj_S_O_O_S_S_O_B__table_xs3_lqs_kdc} {#ProcMinInt-createProj_S_O_O_S_S_O_B__id_x1l_krq_c2c__entry__2}

| 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 Analysten-Workbench angezeigt. * Falsch: Feldänderungen werden nicht in der Analysten-Workbench angezeigt, können aber weiterhin unter kontextbezogenen Bedingungen in Übergängen oder Ergebnissen verwendet werden. {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_hds_v2k_xdc} |
| \<Object\>.Entität.aktivityDefinitionen.Feld | Feld, das die zu analysierenden Daten enthält. Das Feld muss aus der Tabelle stammen, die in angegeben ist tableParameter. |
| \<Object\>.Entität.activityDefinitions.type | Der Typ der zu minierenden Werte. Gültige Werte: * Feldwerte (Standard): Dies ist die Standardauswahl. Diese Option ist verfügbar, wenn Sie eine Aktivitätsdefinition erstellen. * Datum/Uhrzeit: Verwendet den Datums-/Uhrzeitwert aus dem tatsächlichen Datensatz und nicht den Audit-Verlauf und wird als gruppierter Knoten in der Prozesszuordnung angezeigt. * Verbindung: Ein Knoten oder Prozessdiagramm, das dargestellt wird Ändern Im Mehrfachfeld Wert aus dem tatsächlichen Datensatz und nicht aus dem Auditverlauf. * 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. {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_bjc_ffk_xdc} |
| \<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 zum Auswählen 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 Indikatortabelle \[PA_indicators\]. Weitere Informationen zum Suchen von Definitionen und KPIs finden Sie unter [Working with finding definitions](https://www.servicenow.com/docs/access?context=po-finding-definition&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US)Und [Viewing business insights](https://www.servicenow.com/docs/access?context=view-business-findings&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US). 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 erstellt wurde. Datentyp: Zeichenfolge |
| \<Object\>.MiningStatus | Mining-Status für das Projekt. Beschreibungen der Mining-status finden Sie unter [Mine states](https://www.servicenow.com/docs/access?context=generate-process-map&version=yokohama&pubname=yokohama-now-intelligence&section=extraction-states&ft:locale=en-US). Datentyp: Zeichenfolge |
| \<Object\>.Name | Name des Projekts. Datentyp: Zeichenfolge |
| \<Object\>.Berechtigungen | Gruppe, Rolle und Anwenderberechtigungen für das Projekt. Datentyp: Objekt [ { "type":"String", "value":"String" } ] |
| \<Object\>.Permissions.type | Typ der Berechtigung. Gültige Werte: * Gruppe * Rolle * Anwender {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_unx_q1l_ydc} Datentyp: Zeichenfolge |
| \<Object\>.Permissions.value | 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 |
[Tabelle : 2. Rückgaben]

{#ProcMinInt-createProj_S_O_O_S_S_O_B__id_x1l_krq_c2c}  
In diesem Beispiel wird ein Projekt anhand von Daten aus Incidents erstellt, die 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(Zeichenfolge projectId) {#ariaid-title3}

Löscht ein Process Mining-Projekt.
{#ProcMinInt-deleteProject_S__table_cfn_f5t_kdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| projectId | Zeichenfolge | SYS_ID des Projekts. Tabelle: Projektdefinition \[promin_project\] |
[Tabelle : 3. Parameter]

{#ProcMinInt-deleteProject_S__table_cfn_f5t_kdc} {#ProcMinInt-deleteProject_S__table_dfn_f5t_kdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 4. Rückgaben]

{#ProcMinInt-deleteProject_S__table_dfn_f5t_kdc}  
Dieses Beispiel löscht ein Process Mining-Projekt.

    SNC.ProcessMiningIntegrationAPI.deleteProject("a4286c4f4f831210c98b8a4a91ce0bf5");

## ProcessMiningIntegrationAPI -- getBreakDownStats(Zeichenfolge projectId) {#ariaid-title4}

Ruft Aufgliederungsstatistiken für ein Process Mining-Projekt ab.
Mit Aufgliederungen können Sie Datensätze filtern und einen Prozess nach Kategorien analysieren, z. B. Priorität oder Geschäftskategorie.
{#ProcMinInt-getBreakDownStats_S__table_qqp_l5t_kdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| projectId | Zeichenfolge | SYS_ID des Projekts. Tabelle: Projektdefinition \[promin_project\] |
[Tabelle : 5. Parameter]

{#ProcMinInt-getBreakDownStats_S__table_qqp_l5t_kdc} {#ProcMinInt-getBreakDownStats_S__table_rqp_l5t_kdc__entry__2}

| 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\>.fieldValue | 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 Öffnen 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 Quartils für Dauer. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.q3 | Wert des dritten Quartils der Dauer. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.q4 | Wert des vierten Quartils der Dauer (Maximum). Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.PerformanceStatistiken.stdAbweichung | Abweichung vom Durchschnittswert der Routendauer. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.Summe | Summe aller Zeitdauern, vom ersten bis zum letzten Ereignis, für alle Datensätze, die einer Route folgen. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.gesamt | Summe aller Zeitdauern, vom ersten bis zum letzten Ereignis, für alle Datensätze, die einer Route folgen. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.gekürzteDurchschnitt | 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.gekürzte Prozentzahl | 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 |
[Tabelle : 6. Rückgaben]

{#ProcMinInt-getBreakDownStats_S__table_rqp_l5t_kdc}  
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) {#ariaid-title5}

Ruft Ergebnisse für ein Process Mining-Projekt ab.
{#ProcMinInt-getFindings_S__table_syh_k5t_kdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| projectId | Zeichenfolge | SYS_ID des Projekts. Tabelle: Projektdefinition \[promin_project\] |
[Tabelle : 7. Parameter]

{#ProcMinInt-getFindings_S__table_syh_k5t_kdc} {#ProcMinInt-getFindings_S__table_tyh_k5t_kdc__entry__2}

| 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 {#ProcMinInt-getFindings_S__ul_u2f_1kq_c2c} Datentyp: Zeichenfolge |
| \<Array\>.kategorieBeschreibung | Beschreibung der Ergebniskategorie. Datentyp: Zeichenfolge |
| \<Array\>.kategoriebezeichnung | Bezeichnung für die Ergebniskategorie. Datentyp: Zeichenfolge |
| \<Array\>.erstellt am | 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 Ergebnistabelle \[promin_finding\]. Datentyp: Zeichenfolge |
| \<Array\>.ImpactedKpis | Liste der sys_IDs der vom Ergebnis betroffenen KPIs. Befindet sich in der Indikatortabelle \[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 Öffnen 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 Quartils für Dauer. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.q3 | Wert des dritten Quartils der Dauer. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.q4 | Wert des vierten Quartils der Dauer (Maximum). Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.PerformanceStatistiken.stdAbweichung | Abweichung vom Durchschnittswert der Routendauer. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.Summe | Summe aller Zeitdauern, vom ersten bis zum letzten Ereignis, für alle Datensätze, die einer Route folgen. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.gesamt | Summe aller Zeitdauern, vom ersten bis zum letzten Ereignis, für alle Datensätze, die einer Route folgen. Datentyp: Zahl Einheit: Millisekunden |
| \<Array\>.Leistungsstatistiken.gekürzteDurchschnitt | 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.gekürzte Prozentzahl | 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 * LEISTUNGSAUSREISSER * PINGPONG * ÜBERARBEITEN {#ProcMinInt-getFindings_S__ul_jzp_smq_c2c} Weitere Informationen finden Sie unter [Automated improvement opportunities](https://www.servicenow.com/docs/access?context=automated-findings&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US). |
| \<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 |
[Tabelle : 8. Rückgaben]

{#ProcMinInt-getFindings_S__table_tyh_k5t_kdc}  
Dieses Beispiel ruft Ergebnisse für ein Projekt ab.

    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) {#ariaid-title6}

Ruft den Mining-Status eines Process Mining-Projekts ab.
{#ProcMinInt-getMiningStatus_S__table_r12_j5t_kdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| projectId | Zeichenfolge | SYS_ID des Projekts. Tabelle: Projektdefinition \[promin_project\] |
[Tabelle : 9. Parameter]

{#ProcMinInt-getMiningStatus_S__table_r12_j5t_kdc} {#ProcMinInt-getMiningStatus_S__table_s12_j5t_kdc__entry__2}

| 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\>.Tracker-ID | SYS_ID des Trackers, der den Mining-Fortschritt für das Projekt überwacht. Tabelle: Ausführungstracker \[sys_Execution_Tracker\] Datentyp: Zeichenfolge |
[Tabelle : 10. Rückgaben]

{#ProcMinInt-getMiningStatus_S__table_s12_j5t_kdc}  
Dieses Beispiel ruft den Mining-Status für ein Projekt ab.

    SNC.ProcessMiningIntegrationAPI.getMiningStatus("c0b91f0cff01121047cae835f2cb14bc");

Ausgabe:

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

## ProcessMiningIntegrationAPI -- getProject(Zeichenfolge projectId) {#ariaid-title7}

Ruft ein Process Mining-Projekt ab.
{#ProcMinInt-getProject_S__table_ik3_d5t_kdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| projectId | Zeichenfolge | SYS_ID des Projekts. Tabelle: Projektdefinition \[promin_project\] |
[Tabelle : 11. Parameter]

{#ProcMinInt-getProject_S__table_ik3_d5t_kdc} {#ProcMinInt-getProject_S__id_x1l_krq_c2c__entry__2}

| 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 Analysten-Workbench angezeigt. * Falsch: Feldänderungen werden nicht in der Analysten-Workbench angezeigt, können aber weiterhin unter kontextbezogenen Bedingungen in Übergängen oder Ergebnissen verwendet werden. {#ProcMinInt-getProject_S__ul_hds_v2k_xdc} |
| \<Object\>.Entität.aktivityDefinitionen.Feld | Feld, das die zu analysierenden Daten enthält. Das Feld muss aus der Tabelle stammen, die in angegeben ist tableParameter. |
| \<Object\>.Entität.activityDefinitions.type | Der Typ der zu minierenden Werte. Gültige Werte: * Feldwerte (Standard): Dies ist die Standardauswahl. Diese Option ist verfügbar, wenn Sie eine Aktivitätsdefinition erstellen. * Datum/Uhrzeit: Verwendet den Datums-/Uhrzeitwert aus dem tatsächlichen Datensatz und nicht den Audit-Verlauf und wird als gruppierter Knoten in der Prozesszuordnung angezeigt. * Verbindung: Ein Knoten oder Prozessdiagramm, das dargestellt wird Ändern Im Mehrfachfeld Wert aus dem tatsächlichen Datensatz und nicht aus dem Auditverlauf. * 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. {#ProcMinInt-getProject_S__ul_bjc_ffk_xdc} |
| \<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 zum Auswählen 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 Indikatortabelle \[PA_indicators\]. Weitere Informationen zum Suchen von Definitionen und KPIs finden Sie unter [Working with finding definitions](https://www.servicenow.com/docs/access?context=po-finding-definition&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US)Und [Viewing business insights](https://www.servicenow.com/docs/access?context=view-business-findings&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US). 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 erstellt wurde. Datentyp: Zeichenfolge |
| \<Object\>.MiningStatus | Mining-Status für das Projekt. Beschreibungen der Mining-status finden Sie unter [Mine states](https://www.servicenow.com/docs/access?context=generate-process-map&version=yokohama&pubname=yokohama-now-intelligence&section=extraction-states&ft:locale=en-US). Datentyp: Zeichenfolge |
| \<Object\>.Name | Name des Projekts. Datentyp: Zeichenfolge |
| \<Object\>.Berechtigungen | Gruppe, Rolle und Anwenderberechtigungen für das Projekt. Datentyp: Objekt [ { "type":"String", "value":"String" } ] |
| \<Object\>.Permissions.type | Typ der Berechtigung. Gültige Werte: * Gruppe * Rolle * Anwender {#ProcMinInt-getProject_S__ul_unx_q1l_ydc} Datentyp: Zeichenfolge |
| \<Object\>.Permissions.value | 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 |
[Tabelle : 12. Rückgaben]

{#ProcMinInt-getProject_S__id_x1l_krq_c2c}  
Dieses Beispiel ruft ein Process Mining-Projekt ab.

    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(Zeichenfolge projectId) {#ariaid-title8}

Übermittelt ein Process Mining-Projekt für das Mining.
{#ProcMinInt-scheduleMining_S__table_yyx_h5t_kdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| projectId | Zeichenfolge | SYS_ID des Projekts. Tabelle: Projektdefinition \[promin_project\] |
[Tabelle : 13. Parameter]

{#ProcMinInt-scheduleMining_S__table_yyx_h5t_kdc} {#ProcMinInt-scheduleMining_S__table_s12_j5t_kdc__entry__2}

| 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\>.Tracker-ID | SYS_ID des Trackers, der den Mining-Fortschritt für das Projekt überwacht. Tabelle: Ausführungstracker \[sys_Execution_Tracker\] Datentyp: Zeichenfolge |
[Tabelle : 14. Rückgaben]

{#ProcMinInt-scheduleMining_S__table_s12_j5t_kdc}  
Dieses Beispiel übermittelt ein Projekt zum Mining.

    SNC.ProcessMiningIntegrationAPI.scheduleMining("c0b91f0cff01121047cae835f2cb14bc");

Ausgabe:

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


