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 – 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 Argumente Out und In/Out werden sie nach Abschluss der Aufgabe wieder dem Workflow zugeordnet. Dieses Feld unterstützt nur Dictionary<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.

Hinweis: TaskObject verfügt über mehrere Attribute, die Informationen über das Ausgabeaktionsobjekt enthalten. Das Attribut 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.

Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.

• 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 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 ü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 Argumente Out und In/Out werden sie nach Abschluss der Aufgabe wieder dem Workflow zugeordnet. Dieses Feld unterstützt nur Dictionary<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.

Hinweis: Um die automatische Beschriftung von Aktionen über Persistenzaktivitäten zu ermöglichen, benötigt das Roboterkonto, das den Workflow ausführt, die Berechtigungen Anzeigen , Erstellenund Löschen für Tags.

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

Hinweis: Wenn der Benutzer, der diese Aktion ausführt, nicht über die erforderlichen Berechtigungen für den Zielordner verfügt, schlägt die Aufgabenerstellung fehl und gibt einen kritischen Fehler aus. Weitere Informationen zu Ordnerberechtigungen anzeigen.

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

Plattformübergreifende Konfiguration

• 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 Argumente Out und In/Out werden sie nach Abschluss der Aufgabe wieder dem Workflow zugeordnet. Dieses Feld unterstützt nur Dictionary<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.

Hinweis: TaskObject verfügt über mehrere Attribute, die Informationen über das Ausgabeaktionsobjekt enthalten. Das Attribut 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.

Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.

• 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 und options 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.

Hinweis: Um die automatische Beschriftung von Aktionen über Persistenzaktivitäten zu ermöglichen, benötigt das Roboterkonto, das den Workflow ausführt, die Berechtigungen Anzeigen , Erstellenund Löschen für Tags.

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

Hinweis: Wenn der Benutzer, der diese Aktion ausführt, nicht über die erforderlichen Berechtigungen für den Zielordner verfügt, schlägt die Aufgabenerstellung fehl und gibt einen kritischen Fehler aus. Weitere Informationen zu Ordnerberechtigungen anzeigen.

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

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.