Hinzufügen benutzerdefinierter Daten zu Insights

Wichtig:

• Bei Bereitstellungen, die mehr als 75 Prozesse und/oder Warteschlangen mit benutzerdefinierten Daten pro Mandant hinzugefügt haben, müssen Sie entweder die gewünschten Prozess- und Warteschlangentabellen auf eine Zulassungsliste setzen oder die Tabellengruppierung aktivieren.
• Eine konfigurierbare Warnung wird angezeigt, die Sie informiert, wenn Sie sich diesem Grenzwert nähern.
• Die Tabellengruppierung muss möglicherweise auch basierend auf der Gesamtzahl dieser Tabellen für alle Mandanten aktiviert werden. Weitere Details finden Sie in den Hardware- und Softwareanforderungen.
• Die Anzahl der Spalten in Prozess- und Warteschlangentabellen ist auf 40 begrenzt.

Workflow-Design für Insights

Wichtig: Eindeutige Namen ohne Groß-/Kleinschreibung müssen für alle benutzerdefinierten Variablen verwendet werden (d. h. verwenden Sie nicht successfulTransaction und SuccessfulTransaction). Wenn Ihre Variablen nicht eindeutig sind, müssen Sie Insights so festlegen, dass die Groß-/Kleinschreibung nicht berücksichtigt wird.

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 - Alle hinzugefügten Protokollfelder werden als benutzerdefinierte Tabelle in Insights aufgenommen. Weitere Informationen finden Sie [hier] (doc:adding-custom-data-to-insights#logs).
• Add Queue Item - Alle über die Eigenschaft ItemInformation hinzugefügten Daten werden als benutzerdefinierte Tabelle in Insights erfasst. Weitere Details finden Sie hier.
• Set Transaction Status - alle über die Eigenschaften Analytics und Output hinzugefügten Daten werden als benutzerdefinierte Tabelle in Insights aufgenommen. Weitere Details finden Sie hier.

Ausführliche Informationen zu allen von Insights erfassten Daten finden Sie auf der Seite Insights-Datenmodell.

Hinweis:

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

Wenn Sie zuvor die Aktivität RemoveLogFields am Ende einer einzelnen Sequence verwenden würden, um Protokolle zu entfernen, die im Rest des Workflows nicht erforderlich sind, führt das Entfernen aller benutzerdefinierten Protokolle als solche dazu, dass der Prozess und die Daten nicht in die Insights Datenbank aufgenommen werden.

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: Output und Analytics.

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.