UIP-PM-Erfassungen, UIP-PM-Transformationen

Syntax und Optionen zum Auslösen und Prüfen von Process Mining-Datenerfassungen und dbt-Transformationen mit „uip pm ingestions“ und „uip pm transforms“.

Teil des Tools uip pm . ingestions lädt hochgeladene Datendateien in eine Prozess-App; transformations verwaltet und führt die dbt-SQL-Modelle aus, die erfasste Daten in die abfragebaren Tabellen der App umwandeln. Beide unterstützen --wait , um zu blockieren, bis eine Ausführung abgeschlossen ist – siehe Konzepte auf der übergeordneten Seite.

Zusammenfassung

uip pm ingestions create <app-id> [--stage dev|published] [--file-format csv|tsv] [--field-delimiter <char>] [--quote-character <char>] [--encoding utf-8|iso-8859-1] [--wait] [--timeout <s>] [--poll-interval <s>]
uip pm ingestions cancel <app-id> <ingestion-id> [--stage dev|published]
uip pm ingestions logs <app-id> <ingestion-id> [--stage dev|published] [--limit <n>] [--offset <n>]

uip pm transformations list <app-id> [--stage dev|published]
uip pm transformations get <app-id> <path> [--stage dev|published] [--destination <file>]
uip pm transformations create <app-id> <path> --file <local-file> [--stage dev|published]
uip pm transformations update <app-id> <path> --file <local-file> --etag <etag> [--stage dev|published]
uip pm transformations run <app-id> [--model <path>] [--wait] [--timeout <s>] [--poll-interval <s>]
uip pm transformations apply <app-id> [--stage dev|published] [--wait] [--timeout <s>] [--poll-interval <s>]
uip pm transformations cancel <app-id>
uip pm transformations status <app-id>
uip pm transformations logs <app-id>

UIP-PM-Datenaufnahme erstellen

Lösen Sie eine Erfassung der hochgeladenen Datendateien aus.

Argumente

Name	Erforderlich	Zweck
<app-id>	ja	Prozess-App-ID.

Optionen

Long	Wert	Standard	Beschreibung
--stage <stage>	dev | published	dev	App-Phase, in die erfasst werden soll.
--file-format <format>	csv | tsv	csv	Das Format der Datendatei.
--field-delimiter <char>	string	,	Feldtrennzeichen in den Datendateien.
--quote-character <char>	string	"	Anführungszeichen, die Felder umschließen.
--encoding <encoding>	utf-8 | iso-8859-1	utf-8	Dateicodierung.
--wait	Markieren	aus	Blockieren, bis die Erfassung einen Endzustand erreicht; Beenden Sie bei Fehler einen anderen Wert als Null.
--timeout <seconds>	Integer	1800	Max. Sekunden, die gewartet werden soll, wenn --wait festgelegt ist.
--poll-interval <seconds>	Integer	5	Sekunden zwischen Statusabfragen, wenn --wait festgelegt ist.

Beispiel

uip pm ingestions create 9c46289e --file-format csv --encoding iso-8859-1

Datenform (--output json)

Ohne --wait:

{ "Code": "PmIngestionsCreate", "Data": { "Status": "Accepted", "Message": "Ingestion started. Poll 'uip pm apps list' (LastIngestion) for progress." } }

Mit --wait:

{ "Code": "PmIngestionsCreate", "Data": { "Status": "SUCCESS", "IngestionId": "1d7e1421" } }

Bei einem --wait -Fehler wird ein Exit ungleich Null beendet, wobei die eigenen Fehlerprotokollzeilen der Erfassung (über ingestions logs) in die Fehlermeldung eingebettet werden.

Erfassungen von UIP-PM-Erfassung werden abgebrochen

Bricht eine Erfassung ab, die noch ausgeführt wird.

Argumente

Name	Erforderlich	Zweck
<app-id>	ja	Prozess-App-ID.
<ingestion-id>	ja	Erfassungs-ID (uip pm apps get <app-id> zeigt LastIngestion).

Optionen

Long	Wert	Standard	Beschreibung
--stage <stage>	dev | published	dev	App-Phase, auf der die Erfassung ausgeführt wird.

Beispiel

uip pm ingestions cancel 9c46289e 1d7e1421

Datenform (--output json)

{ "Code": "PmIngestionsCancel", "Data": { "AppId": "9c46289e", "IngestionId": "1d7e1421", "Status": "Cancelling" } }

Erfassungsprotokolle für UIP-PM

Rufen Sie die Protokolle einer Erfassungsausführung ab.

Argumente

Name	Erforderlich	Zweck
<app-id>	ja	Prozess-App-ID.
<ingestion-id>	ja	Erfassungs-ID.

Optionen

Long	Wert	Standard	Beschreibung
--stage <stage>	dev | published	dev	App-Phase, in der die Erfassung ausgeführt wurde.
--limit <number>	Integer	100	Max. abzurufende Protokolleinträge (Seitengröße).
--offset <number>	Integer	0	Anzahl der Protokolleinträge, die vor der Seite übersprungen werden sollen.

Beispiel

uip pm ingestions logs 9c46289e 1d7e1421 --limit 50 --offset 50

Datenform (--output json)

{ "Code": "PmIngestionsLogs", "Data": [{ "Message": "Data run started" }] }

UIP-PM-Transformationsliste

Listen Sie die Transformationsdateien (dbt-Modell) einer Prozess-App auf.

Name/Option	Erforderlich	Zweck
<app-id>	ja	Prozess-App-ID.
--stage <stage>	nein	dev | published.Standardmäßig dev.

{ "Code": "PmTransformationsList", "Data": {} }

UIP-PM-Transformationen abrufen

Rufen Sie den Inhalt einer Transformationsdatei sowie deren ETag ab – das update als --etag benötigt.

Name/Option	Erforderlich	Zweck
<app-id>	ja	Prozess-App-ID.
<path>	ja	Pfad der Transformationsdatei, z. B. models/Cases.sql).
--stage <stage>	nein	dev | published.Standardmäßig dev.
--destination <local-file>	nein	Schreiben Sie Inhalt in diese lokale Datei anstelle des Ausgabeumschlags.

{ "Code": "PmTransformationsGet", "Data": { "Path": "models/Cases.sql", "ETag": "W/\"...\"", "Content": "select ..." } }

UIP-PM-Transformationen erstellen

Erstellen Sie eine neue Transformationsdatei aus einer lokalen Datei. Verwenden Sie update, um einen vorhandenen zu ändern – dies schlägt fehl, wenn der Pfad bereits vorhanden ist.

Optionen

Long	Wert	Erforderlich	Beschreibung
--file <local-file>	Pfad	ja	Lokale Datei mit dem neuen Inhalt.
--stage <stage>	dev | published	nein	Der Standardwert ist dev.

uip pm transformations create 9c46289e models/Workload.sql --file ./Workload.sql

{ "Code": "PmTransformationsCreate", "Data": { "Path": "models/Workload.sql", "ETag": "W/\"...\"" } }

Aktualisierung der UIP-PM-Transformationen

Aktualisieren Sie eine Transformationsdatei aus einer lokalen Datei (ETag-sicher).

Optionen

Long	Wert	Erforderlich	Beschreibung
--file <local-file>	Pfad	ja	Lokale Datei mit dem neuen Inhalt.
--etag <etag>	string	ja	ETag der Datei, auf der diese Bearbeitung basiert, von transformations get.
--stage <stage>	dev | published	nein	Der Standardwert ist dev.

uip pm transformations update 9c46289e models/Cases.sql --file ./Cases.sql --etag 'W/"639204059477096903"'

{ "Code": "PmTransformationsUpdate", "Data": { "Path": "models/Cases.sql", "ETag": "W/\"639209312397638135\"" } }

Eine veraltete --etag schlägt mit einem Konflikt fehl – lesen Sie sie erneut über transformations get, wiederholen Sie die Bearbeitung und versuchen Sie es erneut.

UIP-PM-Transformationen werden ausgeführt

Führen Sie die dbt-Transformationen in der Entwicklungsphase aus – erstellen Sie nur geänderte/abhängige Modelle. Verwenden Sie apply, um eine vollständige erneute Ausführung für bereits erfasste Daten zu erzwingen.

Optionen

Long	Wert	Standard	Beschreibung
--stage <stage>	dev	dev	Nur dev wird unterstützt.
--model <model-path>	Pfad	–	Führen Sie nur dieses Modell aus (z. B models/Cases.sql) und deren Abhängigkeiten. Ausführen von allem auslassen.
--wait	Markieren	aus	Blockieren, bis der Build einen Endstatus erreicht; beenden Sie bei Fehler einen anderen Wert als Null (geben Sie den dbt-Fehler automatisch aus).
--timeout <seconds>	Integer	1800	Max. Sekunden zu warten.
--poll-interval <seconds>	Integer	5	Sekunden zwischen Abfragen.

Beispiel

uip pm transformations run 9c46289e --model models/Cases.sql

Datenform (--output json)

{ "Code": "PmTransformationsRun", "Data": { "Status": "Accepted", "Message": "Build started. Re-run with --wait to block until it finishes, or poll 'uip pm transformations status 9c46289e'." } }

UIP-PM-Transformationen werden abgebrochen

Bricht den dbt-Build ab, der derzeit auf der Entwicklung ausgeführt wird.

uip pm transformations cancel 9c46289e

{ "Code": "PmTransformationsCancel", "Data": { "AppId": "9c46289e", "Status": "Cancelling" } }

Es werden UIP-PM-Transformationen angewendet

Führen Sie die vollständige Datentransformation mit bereits erfassten Daten erneut aus (im Gegensatz zu run, das nur geänderte Entwicklungsmodelle erstellt).

Long	Wert	Standard	Beschreibung
--stage <stage>	dev | published	dev	App-Phase.
--wait	Markieren	aus	Blockieren, bis die Transformation einen Endzustand erreicht; Beenden Sie bei Fehler einen anderen Wert als Null.
--timeout <seconds>	Integer	1800	Max. Sekunden zu warten.
--poll-interval <seconds>	Integer	5	Sekunden zwischen Abfragen.

uip pm transformations apply 9c46289e

{ "Code": "PmTransformationsApply", "Data": { "Status": "Accepted", "Message": "Transform started. Poll 'uip pm apps list' (LastIngestion) for progress." } }

UIP-PM-Transformationsstatus

Rufen Sie den Status des aktuellen/letzten Transformationsbuilds ab.

uip pm transformations status 9c46289e

{ "Code": "PmTransformationsStatus", "Data": {} }

UIP-PM-Transformationsprotokolle

Rufen Sie die Protokolle des aktuellen/letzten Transformationsbuilds ab.

uip pm transformations logs 9c46289e

{ "Code": "PmTransformationsLogs", "Data": {} }

Zugehörig

• uip pm – Übersicht, apps, files.
• apps model – Modell-/Feld-/Datenzuordnungsänderungen, die erneut erfasst oder erneut transformiert werden müssen, um wirksam zu werden.
• conformance, deviations und query – analysieren Sie das Ergebnis.

Siehe auch

• Globale Optionen
• Exitcodes