- Versionshinweise
- Installation und Upgrade
- Bevor Sie beginnen
- Erste Schritte
- Aktivitäten
- Gestalten von Workflows mit langer Ausführungszeit
- Start Job And Get Reference
- Wait for Job and Resume
- Add Queue Item And Get Reference
- Wait For Queue Item And Resume
- Create Form Task
- Wait for Form Task and Resume
- Nach Verzögerung fortsetzen
- Assign Tasks
- Create External Task
- Wait For External Task and Resume
- Complete Task
- Forward Task
- Get Form Tasks
- Get Task Data
- Add Task Comment
- Update Task Labels
- Aktionen
- Prozesse
- Audit
Create Form Task
UiPath.Persistence.Activities.FormTask.CreateFormTask
Erstellt eine Formularaktion sowohl in Cloud- als auch in lokalen Instanzen von Action Center. Außerdem wird eine Formularaufgabe in On-Premises Orchestrator Version 21.4 und niedriger erstellt.
Voraussetzungen
- Installieren Sie die Version 2.0.7 oder höher des Pakets UiPath.FormActivityLibrary, um den Formulardesigner zu aktivieren.
- Formularaufgaben sind auf maximal 1 MB begrenzt. Um dieses Limit von 1 MB einzuhalten, müssen Sie Bilder in Formulare einbetten, indem Sie nur Speicher-Buckets verwenden. Außerdem empfehlen wir, Bilder vom Typ
base64
nur für Logos und Symbole zu verwenden, die kleiner als 2 KB sind.
Designer-Panel
- TaskTitle – Der Titel der Aktion, die Sie erstellen möchten. Dieses Feld unterstützt nur Zeichenfolgen und
String
-Variablen. - TaskPriority – Ermöglicht Ihnen die Auswahl der Prioritätsstufe der Aktion. Standardmäßig ist diese Eigenschaft auf TaskPriority.Medium festgelegt. Die folgenden Optionen sind verfügbar: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
-
TaskCatalog – Eine optionale Geschäftsklassifizierung von Aufgabenelementen. Dieses Feld unterstützt nur Strings und String-Variablen.
Wichtig: Stellen Sie sicher, dass der Aktionskatalog vor der Aktionserstellung vorhanden ist. Andernfalls schlägt die Aktionserstellung mit der folgenden Fehlermeldung fehl: „Kein Aufgabenkatalog mit dem Namen [Aktionskatalogname] vorhanden, Fehlercode: 2451“. - FormData – Eine Sammlung von Geschäftsdaten im Formular
Dictionary<String,Argument>
, die Sie in einem Formular im Posteingang „Aktionen“ anzeigen möchten. Durch das Ändern der ArgumenteOut
undIn/Out
werden sie nach Abschluss der Aufgabe wieder dem Workflow zugeordnet. Dieses Feld unterstützt nurDictionary<String,Argument>
-Objekte. - Aufgabenobjekt (Ausgabe) – Das Aufgabenobjekt, das vom Orchestrator als
FormTaskData
-Objekt zurückgegeben wird, nachdem die Actions erstellt wurden. Dieses Objekt kann an die Aktivität Wait for Form Task and Resume übergeben werden, um die Ausführung des Workflows bis zum Abschluss der Actions auszusetzen.
TaskUrl
gibt Ihnen beispielsweise die URL zur Aktion auf der Registerkarte Aktionen im lokalen Orchestrator, während Sie mit dem Attribut ActionUrl
die URL zur Aktion auf der Registerkarte Aktionen in der Automation Cloud erhalten. Um über das lokale Action Center auf die Aktion zuzugreifen, fügen Sie /actions_/tasks/taskID
zur Action Center-Basis-URL hinzu, zum Beispiel: https://laptop-name:port-number/actions_/tasks/taskID
.
Wenn Sie auf die Schaltfläche Formulardesigner öffnen klicken, wird der Assistent des Formulardesigners geöffnet, mit dem Sie das Formular anpassen können, das Sie in Ihrem Workflow verwenden möchten.
Die Schaltfläche Massenformulardesigner öffnen wird verfügbar, wenn die Eigenschaft Massenbearbeitung aktivieren ausgewählt ist. Mit dieser Option wird der Massenformulardesigner geöffnet, mit dem Sie Formularaktionen entwerfen können, die auf der Registerkarte Aktionen der entsprechenden Action-Center-Instanz bearbeitet oder abgeschlossen werden können.
Eigenschaften-Panel
Allgemein
- BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.
- AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.
- AuszeitMS (TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe einer laufenden Aktivität an. Der Standardwert ist 30000 Millisekunden (30 Sekunden).
Eingabe
- Erweiterte Formulare aktivieren – Aktiviert erweiterte Funktionen und Anpassungsoptionen für Formular-Rendering und -Logik, wie z. B.:
- Anpassbare Vorlagen für Bearbeitungsraster.
- Schaltflächen, die als Ereignisse fungieren.
- Die Möglichkeit, Formulare mit ES6 und modernem JavaScript anzupassen.
- Die Verfügbarkeit der Variablen
instance
undoptions
zum Anpassen von Formularen.
- Massenbearbeitung aktivieren – Wenn diese Option ausgewählt ist, wird die Schaltfläche Massenformulardesigner öffnen im Textkörper der Aktivität verfügbar. Mit dieser Option können Sie Formularaktionen generieren, die über die Registerkarte Aktionen im Action Center massenweise bearbeitet oder abgeschlossen werden können.
- FormData – Eine Sammlung von Geschäftsdaten im Formular
Dictionary<String,Argument>
, die Sie in einem Formular im Posteingang „Aktionen“ anzeigen möchten. Durch das Ändern der ArgumenteOut
undIn/Out
werden sie nach Abschluss der Aufgabe wieder dem Workflow zugeordnet. Dieses Feld unterstützt nurDictionary<String,Argument>
-Objekte. - GenerateInputFields – Wenn diese Option ausgewählt ist, werden alle Einträge aus der Formulardatensammlung als Komponenten im Formular-Designer generiert. Wenn Sie es leer lassen, werden dem Designer keine zusätzlichen Formularfelder hinzugefügt.
- Beschriftungen – Der Roboter fügt der Aktion die eingegebenen Beschriftungen hinzu und ermöglicht so eine zukünftige Filterung. Dieses Feld unterstützt nur Zeichenfolgenwerte und unterliegt Namensbeschränkungen.
- Orchestrator-Ordnerpfad – Der Pfad zum Orchestrator-Ordner, den Sie mit dieser Aktivität verwenden möchten. Wenn dies leer gelassen wird, wird der aktuelle Orchestrator-Ordner verwendet. Dieses Feld unterstützt nur Strings und String-Variablen.
- Referenz - Der Name, der als Referenz für das zukünftige Filtern der Aktionen verwendet wird. Dieses Feld unterstützt nur Zeichenfolgenwerte.
-
TaskCatalog – Eine optionale Geschäftsklassifizierung von Aufgabenelementen. Dieses Feld unterstützt nur Strings und String-Variablen.
Wichtig: Stellen Sie sicher, dass der Aktionskatalog vor der Aktionserstellung vorhanden ist. Andernfalls schlägt die Aktionserstellung mit der folgenden Fehlermeldung fehl: „Kein Aufgabenkatalog mit dem Namen [Aktionskatalogname] vorhanden, Fehlercode: 2451“. - TaskPriority – Ermöglicht Ihnen die Auswahl der Prioritätsstufe der Aktion. Standardmäßig ist diese Eigenschaft auf TaskPriority.Medium festgelegt. Die folgenden Optionen sind verfügbar: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
- TaskTitle – Der Titel der Aktion, die Sie erstellen möchten. Dieses Feld unterstützt nur Zeichenfolgen und
String
-Variablen. -
Lokale Formulardatei verwenden – ermöglicht die Erstellung von Formularaktionen mithilfe einer JSON-Formulardatei, die bei der Ausführung angegeben wird. Dieses Feld unterstützt nur
Boolean
-Werte. Wenn Sie es aktivieren, wird das Eigenschaftsfeld Form File Path im Textkörper der Aktivität angezeigt, in dem Sie den Pfad zur JSON-Datei angeben, in der ein bestimmtes Formularlayout gespeichert ist.Nachdem Sie Lokale Formulardatei verwendenausgewählt haben, klicken Sie auf Formular-Designer öffnen, wählen Sie Neuaus, und beginnen Sie mit der Erstellung eines Formulars. Wenn Sie fertig sind, wählen Sie Speichernunter aus, und speichern Sie es im entsprechenden Projektordner. Jetzt haben Sie das Formular, das Sie zuvor erstellt haben, in einer JSON-Datei gespeichert. Geben Sie den Pfad zu dieser JSON-Datei in das Feld Formulardateipfad ein, um dieses Formular zur Laufzeit zu verwenden.
Sonstiges
- Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.
Ausgabe
- Aufgabenobjekt (Ausgabe) – Das Aufgabenobjekt, das vom Orchestrator als
FormTaskData
-Objekt zurückgegeben wird, nachdem die Actions erstellt wurden. Dieses Objekt kann an die Aktivität Wait for Form Task and Resume übergeben werden, um die Ausführung des Workflows bis zum Abschluss der Actions auszusetzen.
Speicher
- Name des Speicher-Buckets – Der Speicher-Bucket, den Sie für große Datendateien verwenden möchten, auf die in den Formulardaten verwiesen wird.
-
Speicherordnerpfad – Der vollständige Pfad zum Ordner im angegebenen Speicher-Bucket. Dieses Feld unterstützt nur Zeichenfolgen und
String
-Variablen.Tipp:Die Verwendung der Bildeinbettung mit den Speicher-Buckets muss in Verbindung mit der Aktivität Upload Storage File erfolgen. Der Argumentname muss in der Eigenschaft Formulardatensammlung als Suffix angehängt und einem Bild im Formular zugeordnet werden, indem Unterstriche (_
) in einer HTML-Element -Komponente verwendet werden.Der Argumentname (<key>_storage
) muss dem Speicherwert in der Eigenschaft Destination der Aktivität Speicherdatei hochladen zugeordnet werden.Beachten Sie, dass Bilddateinamen kein Pluszeichen (+
) enthalten dürfen, da dieses Zeichen vom Speicher-Bucket-Upload-Prozess maskiert wird, was zu einem Fehler führt.
- TaskTitle – Der Titel der Aktion, die Sie erstellen möchten. Dieses Feld unterstützt nur Zeichenfolgen und
String
-Variablen. - TaskPriority – Ermöglicht Ihnen die Auswahl der Prioritätsstufe der Aktion. Standardmäßig ist diese Eigenschaft auf TaskPriority.Medium festgelegt. Die folgenden Optionen sind verfügbar: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
-
TaskCatalog – Eine optionale Geschäftsklassifizierung von Aufgabenelementen. Dieses Feld unterstützt nur Strings und String-Variablen.
Wichtig: Stellen Sie sicher, dass der Aktionskatalog vor der Aktionserstellung vorhanden ist. Andernfalls schlägt die Aktionserstellung mit der folgenden Fehlermeldung fehl: „Kein Aufgabenkatalog mit dem Namen [Aktionskatalogname] vorhanden, Fehlercode: 2451“. - FormData – Eine Sammlung von Geschäftsdaten im Formular
Dictionary<String,Argument>
, die Sie in einem Formular im Posteingang „Aktionen“ anzeigen möchten. Durch das Ändern der ArgumenteOut
undIn/Out
werden sie nach Abschluss der Aufgabe wieder dem Workflow zugeordnet. Dieses Feld unterstützt nurDictionary<String,Argument>
-Objekte. - Aufgabenobjekt (Ausgabe) – Das Aufgabenobjekt, das vom Orchestrator als
FormTaskData
-Objekt zurückgegeben wird, nachdem die Actions erstellt wurden. Dieses Objekt kann an die Aktivität Wait for Form Task and Resume übergeben werden, um die Ausführung des Workflows bis zum Abschluss der Actions auszusetzen.
TaskUrl
gibt Ihnen beispielsweise die URL zur Aktion auf der Registerkarte Aktionen im lokalen Orchestrator, während Sie mit dem Attribut ActionUrl
die URL zur Aktion auf der Registerkarte Aktionen in der Automation Cloud erhalten. Um über das lokale Action Center auf die Aktion zuzugreifen, fügen Sie /actions_/tasks/taskID
zur Action Center-Basis-URL hinzu, zum Beispiel: https://laptop-name:port-number/actions_/tasks/taskID
.
Wenn Sie auf die Schaltfläche Formulardesigner öffnen klicken, wird der Assistent des Formulardesigners geöffnet, mit dem Sie das Formular anpassen können, das Sie in Ihrem Workflow verwenden möchten.
Die Schaltfläche Massenformulardesigner öffnen wird verfügbar, wenn die Eigenschaft Massenbearbeitung aktivieren ausgewählt ist. Mit dieser Option wird der Massenformulardesigner geöffnet, mit dem Sie Formularaktionen entwerfen können, die auf der Registerkarte Aktionen der entsprechenden Action-Center-Instanz bearbeitet oder abgeschlossen werden können.
Erweiterte Optionen
Allgemein
- BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.
- AuszeitMS (TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe einer laufenden Aktivität an. Der Standardwert ist 30000 Millisekunden (30 Sekunden).
Eingabe
- Erweiterte Formulare aktivieren – Aktiviert erweiterte Funktionen und Anpassungsoptionen für Formular-Rendering und -Logik, wie z. B.:
- Anpassbare Vorlagen für Bearbeitungsraster.
- Schaltflächen, die als Ereignisse fungieren.
- Die Möglichkeit, Formulare mit ES6 und modernem JavaScript anzupassen.
- Die Verfügbarkeit der Variablen
instance
undoptions
zum Anpassen von Formularen.
- Massenbearbeitung aktivieren – Wenn diese Option ausgewählt ist, wird die Schaltfläche Massenformular-Designer öffnen im Hauptteil der Aktivität verfügbar. Mit dieser Option können Sie Formularaktionen generieren, die auf der Registerkarte Aktionen im Action Center in großen Mengen bearbeitet oder abgeschlossen werden können.
- Lokale Formulardatei verwenden – ermöglicht die Erstellung von Formularaktionen mithilfe einer JSON-Formulardatei, die bei der Ausführung angegeben wird. Dieses Feld unterstützt nur
Boolean
-Werte. Wenn Sie es aktivieren, wird das Eigenschaftsfeld Form File Path im Textkörper der Aktivität angezeigt, in dem Sie den Pfad zur JSON-Datei angeben, in der ein bestimmtes Formularlayout gespeichert ist. - GenerateInputFields – Wenn diese Option ausgewählt ist, werden alle Einträge aus der Formulardatensammlung als Komponenten im Formular-Designer generiert. Wenn Sie es leer lassen, werden dem Designer keine Formularfelder hinzugefügt.
- Beschriftungen – Der Roboter fügt der Aktion die eingegebenen Beschriftungen hinzu und ermöglicht so eine zukünftige Filterung. Dieses Feld unterstützt nur Zeichenfolgenwerte und unterliegt Namensbeschränkungen.
- Orchestrator-Ordnerpfad – Der Pfad zum Orchestrator-Ordner, den Sie mit dieser Aktivität verwenden möchten. Wenn dies leer gelassen wird, wird der aktuelle Orchestrator-Ordner verwendet. Dieses Feld unterstützt nur Strings und String-Variablen.
- Referenz - Der Name, der als Referenz für das zukünftige Filtern der Aktionen verwendet wird. Dieses Feld unterstützt nur Zeichenfolgenwerte.
- Formulardateipfad – Geben Sie den relativen Pfad zur JSON-Formulardatei ein, die Sie im aktuellen Projekt gespeichert haben.
Speicher
- Name des Speicher-Buckets – Der Speicher-Bucket, den Sie für große Datendateien verwenden möchten, auf die in den Formulardaten verwiesen wird.
- Speicherordnerpfad – Der vollständige Pfad zum Ordner im angegebenen Speicher-Bucket. Dieses Feld unterstützt nur Zeichenfolgen und
String
-Variablen.
Der Formulardesigner wird möglicherweise nicht automatisch aktualisiert, wenn den Rasterkomponenten eine neue Spalte hinzugefügt wird. Um dies zu beheben, können Sie die folgende Problemumgehung verwenden:
- Öffnen Sie den Formular-Designer.
- Bearbeiten Sie eine beliebige Komponente im Formular und speichern Sie dann die Änderungen.
- Speichern Sie das gesamte Formular.
- Öffnen Sie das Formular erneut, machen Sie die vorherigen Änderungen rückgängig und speichern Sie es erneut.
Jetzt sollte das Formular zurückgesetzt werden und die neuen Spalten sollten sichtbar sein.