Benutzerdefinierte Variablen

Insights erfasst immer Daten über die vordefinierten Felder, die im Insights-Datenmodell verfügbar sind, aber Administratoren können auch benutzerdefinierte Variablen konfigurieren, die aus Roboter-Protokollen und Warteschlangen extrahiert wurden, um sie zum Berechnen bestimmter KPIs oder zum Erstellen spezieller Dashboards zu verwenden.

Tipp:

1. Um benutzerdefinierte Variablen für Prozesse einzuschließen, müssen Sie zuerst sicherstellen, dass diese über die UiPath.System.Activities.AddLogFields-Aktivität in Studio zu Protokollen in Ihrer Automatisierung hinzugefügt werden. Dann müssen Sie sie für die Aufnahme auswählen.
   • Benutzerdefinierte Prozessvariablen werden mit Standard-Roboterprotokollen (Prozess wurde gestartet/beendet) und allen Nachrichten gesendet, die mit der Aktivität Log Message geschrieben werden. Wenn keine Variablen aufgefüllt werden, stellen Sie sicher, dass Sie eine Protokollmeldungsaktivität schreiben.
2. 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 werden. Wählen Sie sie dann für die Aufnahme aus.
   • Verwenden Sie die Aktivität UiPath.System.Activities.AddQueueItem für spezifische Daten;
   • Verwenden Sie die Aktivität UiPath.System.Activities.SetTransactionStatus für Ausgabedaten und Analysedaten.
3. Das Deaktivieren von benutzerdefinierten Variablen kann dazu führen, dass die vorhandenen Dashboards, die auf die Variablen verweisen, beschädigt werden.
4. Wenn Sie die benutzerdefinierten Felder bereits in der Aktivität Warteschlangenobjekt hinzufügen (Add Queue Item) hinzugefügt haben, müssen Sie nur ein Transaktionsobjekt als entweder Erfolgreich (Successful) oder Fehlgeschlagen (Failed) bestimmen und Sie brauchen die Eigenschaften Ausgabedaten (OutputData) oder Analysedaten (AnalyticsData) nicht auszufüllen. Wenn Sie die Felder in der Aktivität Warteschlangenobjekt hinzufügen nicht angegeben haben, müssen sie beim Festlegen des Status in der Aktivität Transaktionsobjekt festlegen hinzugefügt werden.

Verwenden benutzerdefinierter Variablen in organisationsbezogenen Dashboards

Beachten Sie bei der Verwendung von benutzerdefinierten Variablen in organisationsbezogenen Dashboards Folgendes:

• Nur benutzerdefinierte Variablen, die in der Mandantenansicht aus dem Fenster Benutzerdefinierte Variable konfigurieren extrahiert wurden, werden im Abschnitt zur Konfiguration benutzerdefinierter Variablen im Scope der Organisation angezeigt. Alle benutzerdefinierten Variablen, die nicht aus dem Mandanten extrahiert werden, werden nicht in organisationsbezogenen Dashboards angezeigt.
• Beim Ändern von benutzerdefinierten Variablen im Mandanten-Scope werden die benutzerdefinierten Variablen, die in den Scope der Organisation fallen, in der Organisation deaktiviert. Stellen Sie sicher, dass Sie sie wieder aktivieren, nachdem alle Änderungen vorgenommen wurden, damit sie in Dashboards angezeigt werden.
• Die Abschnitte „ROI“ und „Benutzerdefinierte Variablen“ sind schreibgeschützt.

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.

   
   

   

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

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

   Wichtig:

   • Die Felder sind auf 40 Zeichen begrenzt und alle Zeichen nach dieser Zahl werden abgeschnitten. Um mehr als 40 Zeichen hinzuzufügen, ändern Sie das Flag Insights.Etl.Json.MaxStringLen . Sie können dieses Flag in der Orchestrator-Webkonfiguration hinzufügen und den Wert entsprechend den Anforderungen Ihres Projekts festlegen. Zum Beispiel:

   <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.

5. 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.

   Anzahl der konfigurierten benutzerdefinierten Variablen	Hardware-Skalierung	Anzahl der Prozesse	Anzahl der Roboterprotokolle pro Prozess	Geschätzte Dauer für die Extraktion
   30	Groß	1	1.000.000	5 Minuten
   30	Groß	1	40.000.000	120 Minuten

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 Status Allgemein aus einer Variablen zu entfernen, deaktivieren Sie das entsprechende Kontrollkästchen.
5. Um den Typ einer Variablen zu ändern, wählen Sie den neuen gewünschten Typ aus dem Dropdownmenü aus.
6. Stellen Sie sicher, dass Sie die Konfiguration speichern.
7. Führen Sie die folgenden Überprüfungen für vorhandene Dashboards durch, die eine geänderte oder entfernte Variable verwendet haben:
   1. 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;
   2. Wenn Sie den Variablentyp geändert haben, stellen Sie sicher, dass der neue Typ weiterhin korrekt gilt;
   3. Wenn die Variable nicht mehr den Status Allgemein hat, müssen Sie den Verweis auf die allgemeine Variable durch den aktualisierten Wert pro Prozess ersetzen.

Konfigurationsbeispiel

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

In der folgenden Abbildung ist die Variable ProcessCount in mehreren Prozessen vorhanden, während die Argument1_Email-Variable nur in einem Prozess auftritt.

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. Markieren Sie die Variable als Allgemein, damit Sie ihren Wert in allen Prozessen abrufen, in denen sie angezeigt wird.

2. Aktivieren Sie die Variable Argument1_Email und wählen Sie den String-Typ aus. Da diese Variable nicht in mehreren Prozessen auftritt, sollten Sie nicht Allgemein auswählen. Klicken Sie auf Speichern.

   
   

   

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

4. Wählen Sie den Explorer der Roboterprotokolle aus, um die bereits konfigurierten benutzerdefinierten Variablen anzuzeigen.

   Da Sie für ProcessCount Allgemein ausgewählt haben, können Sie sehen, dass kein Prozessnamenpräfix vorhanden ist, da es dem Standarddatenmodell hinzugefügt wurde. Im Gegensatz zu ProcessCount haben Sie für Argument1_Email nicht Allgemein ausgewählt, daher wurde das benutzerdefinierte Feld als Log_Email.Argument1_Email hinzugefügt.

   
   

   

   
   

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.

Für dieses Szenario gibt es zwei Möglichkeiten, die NULL-Werte zu beseitigen:

Option 1: Fügen Sie die benutzerdefinierte Variable als einen Filter hinzu und legen Sie die Bedingung auf „ist nicht NULL“

Option 2: Legen Sie einen Filter für den Prozessnamen fest, der die benutzerdefinierte Variable enthält. Beachten Sie jedoch, dass, wenn Sie diesen Ansatz verfolgen, das zweite Szenario unten auftreten könnte.

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 als NULL anzeigen.

Das folgende Beispiel veranschaulicht diesen speziellen Fall.

1. Gehen Sie zu Benutzerdefinierte Variablen konfigurieren. Sie sehen, dass das benutzerdefinierte Variablenfeld Argument1_Email nur im Log_Email-Prozess auftritt. Wenn Sie berücksichtigen, dass Argument1_Email ein prozessspezifisches, benutzerdefiniertes Variablenfeld ist, wählen Sie Allgemein nicht aus.

   
   

   

   
   
2. Öffnen Sie ein neues oder vorhandenes Dashboard und fügen Sie eine Kachel hinzu.
3. Navigieren Sie zum Explorer der Roboterprotokolle. Wählen Sie das Feld Prozessname und das benutzerdefinierte Variablenfeld aus. In diesem Fall ist das benutzerdefinierte Variablenfeld Log_Email.Argument1_Email.

4. Klicken Sie auf Ausführen. Die Ergebnisse, die Sie sehen, sollten denen im folgenden Screenshot ähneln.

   
   

   

   
   

Um die NULL-Werte zu entfernen, fügen Sie das benutzerdefinierte Variablenfeld als Filter hinzu. Legen Sie schließlich die Bedingung auf „ist nicht NULL“ fest, sodass Sie die NULL-Werte aus der Visualisierung entfernen können.

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

In unserem Abschnitt Fehlerbehebung finden Sie Informationen zu Fehlerbehebung und Einschränkungen.