Create Form Task

UiPath.Persistence.Activities.FormTask.CreateFormTask

Beschreibung

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.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Windows, Windows – Legacy-Konfiguration

Designer-Panel

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.
  Wichtig:

  Stellen Sie sicher, dass der Aktionskatalog vor der Aktionserstellung vorhanden ist. Andernfalls schlägt die Aktionserstellung mit der folgenden Fehlermeldung fehl: „Kein Aufgabenkatalog namens [action_catalog_name] vorhanden. Fehlercode: 2451“.

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• Aufgabenobjekt (Ausgabe) – Das Aufgabenobjekt, das nach der Erstellung der Aktion vom Orchestrator als FormTaskData -Objekt zurückgegeben wird. 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 Aktion auszusetzen.
  Hinweis:

  Aufgabenobjekt verfügt über mehrere Attribute, die Informationen über das Ausgabeaktionsobjekt enthalten. Beispielsweise gibt das Attribut TaskUrl die URL zur Aktion auf der Registerkarte Aktionen im lokalen Orchestrator an, während das Attribut ActionUrl die URL zur Aktion auf der Registerkarte Aktionen in der Automation Cloud angibt. 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• 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 das Rendering und die Logik von Formularen, 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 und options 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 auf der Registerkarte Aktionen im Action Center massenweise bearbeitet oder abgeschlossen werden können.

  

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.

• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add additional form fields to the designer.

• Labels – Der Roboter fügt der Aktion die eingegebenen Beschriftungen hinzu, um eine zukünftige Filterung zu ermöglichen. Dieses Feld unterstützt nur Zeichenfolgenwerte und hat Benennungsbeschränkungen.

  Hinweis:

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

  Hinweis:

  Wenn der Benutzer, der diese Aktion ausführt, nicht über die erforderlichen Berechtigungen für den Zielordner verfügt, schlägt die Erstellung der Aufgabe fehl und es wird ein kritischer Fehler ausgegeben. Weitere Informationen zu Ordnerberechtigungen anzeigen.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.

• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.

  Wichtig:

  Stellen Sie sicher, dass der Aktionskatalog vor der Aktionserstellung vorhanden ist. Andernfalls schlägt die Aktionserstellung mit der folgenden Fehlermeldung fehl: „Kein Aufgabenkatalog namens [action_catalog_name] vorhanden. Fehlercode: 2451“.

• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.

• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.

After you select Use Local Form File, click Open Form Designer, select New, and start building a form. When you finish , select Save As, and save it inside the corresponding project folder. Now you have the form that you previously created stored inside a JSON file. Input the path to this JSON file inside the Form File Path field to use that form at runtime.

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 nach der Erstellung der Aktion vom Orchestrator als FormTaskData -Objekt zurückgegeben wird. 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 Aktion auszusetzen.

Speicher

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.
  Tipp:

  Die Verwendung der Bildeinbettung mit den Speicher-Buckets muss in Verbindung mit der Aktivität Upload Storage File erfolgen. Der Name des Arguments muss in der Eigenschaft Formulardatensammlung mit einem Suffix versehen und einem Image im Formular zugeordnet werden, indem ein Unterstrich (_) in einer HTML-Element -Komponente verwendet wird. Der Argumentname (<key>_storage) muss dem Speicherwert in der Eigenschaft Ziel der Aktivität Upload Storage File zugeordnet sein. Beachten Sie, dass Bilddateinamen kein Pluszeichen (+) enthalten dürfen, da dieses Zeichen durch den Uploadprozess des Speicher-Buckets maskiert wird, was zu einem Fehler führt.

Plattformübergreifende Konfiguration

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.
  Wichtig:

  Stellen Sie sicher, dass der Aktionskatalog vor der Aktionserstellung vorhanden ist. Andernfalls schlägt die Aktionserstellung mit der folgenden Fehlermeldung fehl: „Kein Aufgabenkatalog namens [action_catalog_name] vorhanden. Fehlercode: 2451“.

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• Aufgabenobjekt (Ausgabe) – Das Aufgabenobjekt, das nach der Erstellung der Aktion vom Orchestrator als FormTaskData -Objekt zurückgegeben wird. 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 Aktion auszusetzen.
  Hinweis:

  Aufgabenobjekt verfügt über mehrere Attribute, die Informationen über das Ausgabeaktionsobjekt enthalten. Beispielsweise gibt das Attribut TaskUrl die URL zur Aktion auf der Registerkarte Aktionen im lokalen Orchestrator an, während das Attribut ActionUrl die URL zur Aktion auf der Registerkarte Aktionen in der Automation Cloud angibt. 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• 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 das Rendering und die Logik von Formularen, 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 und options 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 auf der Registerkarte Aktionen im Action Center massenweise bearbeitet oder abgeschlossen werden können.

  

• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.

• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add form fields to the designer.

• Labels – Der Roboter fügt der Aktion die eingegebenen Beschriftungen hinzu, um eine zukünftige Filterung zu ermöglichen. Dieses Feld unterstützt nur Zeichenfolgenwerte und hat Benennungsbeschränkungen.

  Hinweis:

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

  Hinweis:

  Wenn der Benutzer, der diese Aktion ausführt, nicht über die erforderlichen Berechtigungen für den Zielordner verfügt, schlägt die Erstellung der Aufgabe fehl und es wird ein kritischer Fehler ausgegeben. Weitere Informationen zu Ordnerberechtigungen anzeigen.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.

• Form File Path - input the relative path to the form JSON file that you saved inside the current project.

Speicher

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.

Bekanntes Problem

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:

1. Öffnen Sie den Formular-Designer.
2. Bearbeiten Sie eine beliebige Komponente im Formular und speichern Sie dann die Änderungen.
3. Speichern Sie das gesamte Formular.
4. Ö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.