Abonnieren

UiPath Insights

Das UiPath Insights-Handbuch

Benutzerdefinierte Variablen

Insights always ingests data via the pre-defined fields available in the Insights data model, but Admins can also configure custom variables extracted from robot logs and queues to use for calculating specific KPIs or building more specialized dashboards.

👍

Bevor Sie beginnen

Um benutzerdefinierte Variablen für Prozesse einzuschließen, müssen Sie zuerst sicherstellen, dass diese über die Aktivität UiPath.Core.Activities.AddLogFields in Studio zu den Protokollen in Ihrer Automatisierung hinzugefügt werden. Dann müssen Sie sie für die Aufnahme auswählen.


Um benutzerdefinierte Variablen für Warteschlangen einzuschließen, müssen Sie zuerst sicherstellen, dass diese über eine Aktivität in Studio in Workflows hinzugefügt und dann zur Aufnahme ausgewählt werden.

  • Verwenden Sie die Aktivität UiPath.Core.Activities.AddQueueItem für spezifische Daten;
  • Verwenden Sie die Aktivität UiPath.Core.Activities.SetTransactionStatus für Ausgabedaten und Analysedaten.

 

Benutzerdefinierte Variablen konfigurieren

Zum Konfigurieren benutzerdefinierter Variablen muss ein Administrator die folgenden Schritte ausführen:

  1. Öffnen Sie das 3-Punkte-Menü in der oberen rechten Ecke einer beliebigen Insights-Seite und wählen Sie Benutzerdefinierte Variablen konfigurieren aus. Die Konfigurationsseite wird geöffnet und enthält alle benutzerdefinierten Felder, die für die Extraktion verfügbar sind.

  2. Entscheiden Sie, ob Sie benutzerdefinierte Variablen für Prozesse oder Warteschlangen konfigurieren möchten, indem Sie oben auf der Konfigurationsseite auf die entsprechende Registerkarte klicken.

2510
  1. Wählen Sie in der Spalte Extrahieren die benutzerdefinierten Variablen aus, die Sie beim Erstellen von Dashboards verwenden möchten.

  2. Wählen Sie in der Spalte Typ den Typ der benutzerdefinierten Variablen aus. Sie können String, Number oder DateTime auswählen.

🚧

Wichtig!

  • The fields are limited to 40 characters and any characters after this number will be cut. To add more than 40 characters, change the Insights.Etl.Json.MaxStringLen flag. You can add this flag in the Orchestrator web configuration and set the value according to your project's needs. For example:
    <add key="Insights.Etl.Json.MaxStringLen" value="60" />

  • Der Abgleichprozentsatz zeigt den Fortschritt beim Extrahieren einer benutzerdefinierten Variablen aus allen Prozessen oder Warteschlangen. Sie müssen die Seite aktualisieren, um den letzten Abgleichprozentsatz anzuzeigen. Je nach Datengröße kann dies einige Zeit in Anspruch nehmen. Benutzerdefinierte Variablenwerte werden von den neuesten Daten zu den ältesten abgeglichen. Das Feld ist kurz nach dem Speichern der Konfiguration für die Verwendung verfügbar. Sie müssen nicht warten, bis es zu 100 % abgeglichen ist.

  • Sie können maximal 500 Prozesse oder Warteschlangen und maximal 200 Variablen pro Prozess oder Warteschlange extrahieren.

  • Wenn Sie den Typ einer benutzerdefinierten Variablen als Number konfigurieren, stellen Sie sicher, dass sie kein , oder andere nicht numerische Zeichen wie z. B. $ enthält, da diese Zeichen nicht unterstützt werden. Wählen Sie für Zahlen mit Sonderzeichen den Typ String aus.

  • Jede Änderung bei der Konfiguration benutzerdefinierter Variablen führt zu einem vollständigen neuen Abgleich für diesen spezifischen Prozess. Die Dauer des Abgleichs hängt von der Anzahl der Protokolle ab, die in der Insights-Datenbank für diesen spezifischen Prozess gespeichert sind.

  1. Speichern Sie die Konfiguration. Alle extrahierten Variablen für einen bestimmten Prozess sollten in einem Analysefenster mit dem Namen *Prozess – Prozessname angezeigt werden und alle extrahierten Variablen für eine bestimmte Warteschlange sollten in einem Analysefenster mit dem Namen *Warteschlange – Warteschlangenname angezeigt werden.

🚧

Wichtig!

Sie können maximal 500 Prozesse oder Warteschlangen und maximal 200 Variablen pro Prozess oder Warteschlange extrahieren.

Number of Custom Variables ConfiguredHardware ScaleNumber of ProcessesNumber of Robot Logs per ProcessApproximate Time for Extraction
30Large Scale11,000,0005 minutes
30Large scale140,000,000120 minutes

 

Bearbeiten einer vorhandenen Konfiguration

Um eine vorhandene Konfiguration zu bearbeiten, muss ein Administrator die folgenden Schritte ausführen:

  1. Öffnen Sie das 3-Punkte-Menü in der oberen rechten Ecke einer beliebigen Insights-Seite und wählen Sie Benutzerdefinierte Variablen konfigurieren aus. Die Konfigurationsseite wird geöffnet und enthält alle benutzerdefinierten Felder, die für die Extraktion verfügbar sind.

  2. Entscheiden Sie, ob Sie benutzerdefinierte Variablen für Prozesse oder Warteschlangen konfigurieren möchten, indem Sie oben auf der Konfigurationsseite auf die entsprechende Registerkarte klicken.

  3. Um zuvor ausgewählte Variablen zu entfernen, deaktivieren Sie das Kontrollkästchen Extrahieren.

  4. Um den Typ einer Variablen zu ändern, wählen Sie den neuen gewünschten Typ aus dem Dropdownmenü aus.

  5. Stellen Sie sicher, dass Sie die Konfiguration speichern.

  6. Führen Sie die folgenden Überprüfungen für vorhandene Dashboards durch, die eine geänderte oder entfernte Variable verwendet haben:
    a. Wenn Sie die Variable gelöscht haben, müssen Sie alle Verweise auf die Variable aus erstellten oder geänderten Formeln sowie aus Filtern oder in Visualisierungen entfernen;
    b. Wenn Sie den Variablentyp geändert haben, stellen Sie sicher, dass der neue Typ weiterhin korrekt gilt;

 

Konfigurationsbeispiel

Dieser Abschnitt enthält ein Beispiel für die Verwendung einer benutzerdefinierten Variablen in einem Dashboard.

820

Führen Sie die folgenden Schritte aus, um benutzerdefinierte Variablen zu konfigurieren:

  1. Wählen Sie die Variable ProcessCount für die Extraktion und den String-Typ aus.

  2. Aktivieren Sie die Variable Argument1_Email, wählen Sie den Typ String aus und klicken Sie dann auf Speichern.

1059
  1. Navigieren Sie zurück zu Dashboards, erstellen Sie ein neues Dashboard und fügen Sie eine neue Kachel hinzu.

  2. Wählen Sie das Analysefenster *Prozess – CustomLogs2 aus, und wählen Sie dann die Ansicht CustomLogs2 aus, um die konfigurierten benutzerdefinierten Variablen aus diesem Prozess auf Ihrer Kachel zu verwenden.

333

 

Benutzerdefinierte Variablen – NULL-Fälle

Benutzerdefinierte Variablen können in bestimmten Fällen einen NULL-Wert haben, wie in den folgenden Abschnitten beschrieben.

Szenario 1

Wenn Sie ein Feld aus dem Standarddatenmodell in einer Visualisierung zusammen mit einem prozessspezifischen benutzerdefinierten Variablenfeld verwenden und ein Prozess nicht die benutzerdefinierte Variable n in den Roboterprotokollen enthält, ist der Wert aller Felder, die dem Prozess zugeordnet sind, der die benutzerdefinierte Variable nicht in seinen Roboterprotokollen enthält, NULL.

2446

 

There are two ways to eliminate the null values for this scenario:
Option 1: Add the custom variable as a filter, and set the condition to is not null to remove the null values from the visualization.

931

Option 2: Set a filter for the process name that does include the custom variable. Note, however, that if you adopt this approach, you may run into the second scenario below.

2443

 

Szenario 2

Wenn eine benutzerdefinierte Variable nicht in allen Protokollen vorhanden ist, die von einem Prozess generiert wurden, werden die Protokolle, die keinen Wert für diese benutzerdefinierte Variable enthalten, den Wert der Variablen wie im Bild unten als Null anzeigen.

2443

Das folgende Beispiel veranschaulicht diesen speziellen Fall.

  1. Gehen Sie zu Benutzerdefinierte Variablen konfigurieren. Sie sehen, dass das benutzerdefinierte Variablenfeld Birthday2 im Prozess CustomLogs2 erscheint.
2319
  1. Öffnen Sie ein neues oder vorhandenes Dashboard und fügen Sie eine Kachel hinzu.
  2. Navigieren Sie zum Analysefenster CustomLogs2. Wählen Sie das Feld Prozessname und das benutzerdefinierte Variablenfeld aus. In diesem Fall ist das benutzerdefinierte Variablenfeld CustomLogs2.Birthday2.
  3. Klicken Sie auf Ausführen. Die Ergebnisse, die Sie sehen, sollten denen im folgenden Screenshot ähneln.
2458

 

To eliminate the null values, add the custom variable field as a filter. Lastly, set the condition to is not null, so that you can remove the null values from the visualization.

1584

 

📘

Hinweis:

Beide Fälle treten auf, wenn Sie die Rohdaten des benutzerdefinierten Felds anzeigen. Wenn Sie eine Funktion (Summe, Durchschnitt usw.) auf die benutzerdefinierten Variablen anwenden, schließen Sie NULL-Werte aus.

 

Fehlerbehebung und Einschränkungen

See our Troubleshooting section for information about troubleshooting and limitations.

Updated 23 days ago


Benutzerdefinierte Variablen


Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.