Hinzufügen benutzerdefinierter Daten zu Insights

Wichtig:

• For deployments exceeding 75 processes and/or queues with custom data added per tenant, you must either add your desired process and queue tables to an allowlist or Enable Table Grouping.
• A configurable alert is displayed warning you when you are approaching this limit.
• Table grouping may also need to be enabled based upon the total number of such tables across all tenants. Review the Hardware and Software Requirements for additional details.
• Die Anzahl der Spalten in Prozess- und Warteschlangentabellen ist auf 40 begrenzt.

Workflow-Design für Insights

Wichtig:

Unique case-insensitive names must be used for all custom variables (i.e. do not use successfulTransaction and SuccessfulTransaction). If your variables are not unique, you must set Insights to be case insensitive.

Beim Entwerfen Ihrer Automatisierungsworkflows, die für die Nutzung und Analyse in Insights vorgesehen sind, gibt es Änderungen, die im bisher verwendeten Best Practice-Ansatz zu berücksichtigen sind.

Sie müssen einzelne Elemente und/oder Datenpunkte nicht mit Tags versehen, um ihre Verfügbarkeit für die Analyse in Insights sicherzustellen. Für alle Prozesse bzw. Warteschlangen mit benutzerdefinierten Feldern wird automatisch eine benutzerdefinierte Tabelle mit den verfügbaren Feldern generiert.

Die folgenden Aktivitäten können zum Entwerfen Ihrer Automatisierungsworkflows verwendet werden, um die gewünschten Daten zu erfassen:

• Add Log Fields - all added log fields are ingested as a custom table in Insights. See [here] (doc:adding-custom-data-to-insights#logs) for more details.
• Add Queue Item - all data added via the ItemInformation property are ingested as a custom table in Insights. See here for more details.
• Set Transaction Status - all data added via the Analytics and Output properties are ingested as a custom table in Insights. See here for more details.

For complete details about all data ingested by Insights, see the Insights Data Model page.

Hinweis:

Für die Workflows, die Sie in Insights analysieren möchten, wird empfohlen, alle gewünschten Daten am Ende jedes Workflows zu protokollieren.

Where previously you would use the RemoveLogFields activity at the end of any individual sequence to remove logs not needed in the rest of the workflow, removing all custom logs as such results in the process and data not being ingested into the Insights database.

Protokolle

Es gibt 2 Methoden, um Protokolle zum Senden von Daten an Insights zu nutzen:

• Log Message - ermöglicht Ihnen das Hinzufügen einer benutzerdefinierten String-Nachricht, die im Falle eines Fehlers in Ihrem Workflow an Insights in Form eines Protokollereignisses gesendet wird.
• Add Log Fields - Ermöglicht das Hinzufügen benutzerdefinierter Variablen zum standardmäßigen Insights-Dashboard.

Wenn Insights erkennt, dass eine Protokollmeldung über benutzerdefinierte Protokollfelder verfügt, die über die Aktivität Add Log Fields hinzugefügt wurden, wird eine neue Tabelle in Insights erstellt, die die benutzerdefinierten Felder mit dem Titel "Process-<your process name>” enthält. Diese benutzerdefinierten Felder werden über einen benutzerdefinierten JSON-Parser aus der unformatierten Nachricht extrahiert und der Tabelle im RawMessage_CustomFieldName-Format hinzugefügt.

Die folgenden Datentypen für benutzerdefinierte Felder werden unterstützt: Integer, String, Boolean, Double und Float.

Hinweis:

Die benutzerdefinierten Tabellen sind nicht mit dem OOTB-Datenschema verbunden, sodass tabellenübergreifende Widgets nur möglich sind, wenn eine Beziehung erstellt wurde. Wenden Sie sich für diese Anpassung an Ihren Ansprechpartner bei UiPath.

Insights erhält für erfolgreiche Prozesse nur das letzte Protokollereignis. Wenn Sie die Aktivität Remove Log Fields verwenden, kann Insights die benutzerdefinierten Felder nicht erfassen, da sie vor Abschluss des Prozesses vom Workflow entfernt werden.

Dies bedeutet auch, dass transaktionale Prozesse, die Protokolle zum Erfassen von Daten pro Transaktion nutzen, die Daten für die einzelnen Transaktionsprotokolle nicht an Insights senden. Wenn Sie einen Prozess verwenden, der Transaktionen durchläuft und Sie für jede benutzerdefinierte Daten speichern möchten, sollten Sie die bewährten Methoden von UiPath befolgen und Warteschlangen verwenden. Warteschlangen unterstützen das Senden benutzerdefinierter Variablen für jedes Warteschlangenelement an Insights.

Warteschlangen

Jedes Warteschlangenelement hat drei Abschnitte, in denen Sie benutzerdefinierte Variablen speichern können. Nach dem Erstellen eines Warteschlangenelements über die Aktivität Add Queue Item wird ein Feld mit dem Namen ItemInformation verfügbar. Dort können Sie alle gewünschten benutzerdefinierten Variablen speichern. Die unterstützten Datentypen für alle Warteschlangendaten sind die gleichen wie für benutzerdefinierte Protokolle: Integer, String, Boolean, Double und Float.

Um einem Warteschlangenelement benutzerdefinierte Variablen hinzuzufügen, nachdem die Verarbeitung abgeschlossen ist, nutzen Sie die Aktivität Set Transaction Status. Sie enthält zwei Eingaben, in denen Sie Variablen speichern können: Analytics und Output.

Wenn benutzerdefinierte Felder von Insights in der Warteschlange erkannt werden, wird eine benutzerdefinierte Tabelle im Datenmodell mit dem Namen Queue-"your queue name” erstellt. Die Felder werden über die Eingabe identifiziert, in der sie gespeichert wurden:

• In Analytics gespeicherte Variablen werden “AnalyticsData_<yourfieldname>” benannt.
• In Output gespeicherte Variablen werden “Output_<yourfieldname>” benannt.
• In ItemInformation gespeicherte Variablen werden “SpecificData_<yourfieldname>” benannt.

Hinweis:

Die benutzerdefinierten Warteschlangentabellen sind nicht mit dem OOTB-Datenschema verbunden, sodass tabellenübergreifende Widgets nur möglich sind, wenn eine Beziehung erstellt wurde. Wenden Sie sich für diese Anpassung an Ihren Ansprechpartner bei UiPath.