Create External Task

UiPath.Persistence.Activities.ExternalTask.CreateExternalTask

Beschreibung

Erstellt eine externe Aktion mit den angegebenen Daten, dem Aufgabentitel, der Aufgabenpriorität und dem Aufgabenkatalog.

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 strings and String variables only.
• TaskData - A collection of business data, in the form Dictionary<String,Argument>, that you want to store in a given action. Modifying Out and In/Out arguments maps them back to the workflow after the action is completed. This field supports Dictionary<String,Argument> objects only.
• Aufgabenobjekt (Ausgabe) – Das Aufgabenobjekt, das nach der Erstellung der Aktion vom Orchestrator als ExternalTaskData -Objekt zurückgegeben wird. Dieses Objekt kann an die Aktivität Wait for External Task and Resume übergeben werden, um die Ausführung des Workflows bis zum Abschluss der Aktion auszusetzen.

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

• External Tag - A tag that can be used to identify the external system which is the source for the data in the given action. This field supports strings and String variables only.

• 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 Namensbeschrä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-Ordnerpfad – Der Pfad zu einem Orchestrator-Ordner, der sich von demjenigen unterscheidet, in dem der aktuelle Prozess ausgeführt wird, in dem Sie die Aufgabe erstellen möchten. Weitere Informationen zu Orchestrator-Ordnern finden Sie hier. Für klassische Ordner kann diese Eigenschaft nur mit Floating-Robotern verwendet werden und nur, wenn der aktuelle Benutzer über die richtigen Aufgabenberechtigungen im Zielordner verfügt. Bei modernen Ordnern wird das Überschreiben von Ordnerpfaden nicht unterstützt. Dieses Feld unterstützt nur Strings und String -Variablen.

  Hinweis:

  Die Eigenschaft Ordnerpfad darf nur verwendet werden, wenn die Aufgabe von einem anderen Ordner als dem aktuellen aus gestartet oder abgefragt werden muss. 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 den Ordnerberechtigungen finden Sie hier.

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

  Hinweis:

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

• TaskData - A collection of business data, in the form Dictionary<String,Argument>, that you want to store in a given action. Modifying Out and In/Out arguments maps them back to the workflow after the action is completed. This field supports Dictionary<String,Argument> objects 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.

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

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 ExternalTaskData -Objekt zurückgegeben wird. Dieses Objekt kann an die Aktivität Wait for External Task and Resume übergeben werden, um die Ausführung des Workflows bis zum Abschluss der Aktion auszusetzen.

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 strings and String variables only.

  Hinweis:

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

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

• Aufgabenobjekt (Ausgabe) – Das Aufgabenobjekt, das nach der Erstellung der Aktion vom Orchestrator als ExternalTaskData -Objekt zurückgegeben wird. Dieses Objekt kann an die Aktivität Wait for External Task and Resume übergeben werden, um die Ausführung des Workflows bis zum Abschluss der Aktion auszusetzen.

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

• 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 Namensbeschrä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-Ordnerpfad – Der Pfad zu einem Orchestrator-Ordner, der sich von demjenigen unterscheidet, in dem der aktuelle Prozess ausgeführt wird, in dem Sie die Aufgabe erstellen möchten. Weitere Informationen zu Orchestrator-Ordnern finden Sie hier. Für klassische Ordner kann diese Eigenschaft nur mit Floating-Robotern verwendet werden und nur, wenn der aktuelle Benutzer über die richtigen Aufgabenberechtigungen im Zielordner verfügt. Bei modernen Ordnern wird das Überschreiben von Ordnerpfaden nicht unterstützt. Dieses Feld unterstützt nur Strings und String -Variablen.

  Hinweis:

  Die Eigenschaft Ordnerpfad darf nur verwendet werden, wenn die Aufgabe von einem anderen Ordner als dem aktuellen aus gestartet oder abgefragt werden muss. 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 den Ordnerberechtigungen finden Sie hier.

• Reference - A tag that you can use to identify the external system which is the source for the data in the given action. This field supports strings and String variables only.

Externe Aktionen erstellen

Um eine externe Aktion zu erstellen, wählen Sie zwischen den folgenden Verfahren aus:

1. Add a Create External Task activity into your workflow and provide information for the following property fields:
   • Aufgabentitel
   • Aufgabenpriorität
   • Aufgabendaten (Sammlung)
   • External Tag - Specify a tag to uniquely identify batches of external tasks that you want to retrieve from a third-party system. You can use this tag to sync External Tasks with an external system. Also, you can use this tag to complete tasks based on the actions a user takes in the third party system.
2. Erstellen Sie eine externe Aktion mithilfe von APIs.

Externe Aktionen mit Tools von Drittanbietern synchronisieren

Um externe Aktionen mit anderen externen Systemen zu synchronisieren, müssen Sie zuerst ein entsprechendes Objekt dafür innerhalb des externen Systems erstellen und dann die Aufgabe oder den Aufgabenstapel abrufen, die vom Drittanbietersystem erstellt wurde, mithilfe eines API-Aufrufs.

1. Erstellen Sie ein Objekt in einem externen System, z. B.:
   • Erstellen Sie ein Problem in Jira.
   • Erstellen Sie einen Kontakt in Salesforce.
2. Call the following API in Swagger: GET /odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders.

For example: GET <ORCH_URL>/odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders?$filter=(Type eq 'ExternalTask') and (IsDeleted eq false) and (ExternalTag eq 'JiraTasks') and (Status ne 'Completed')&$count=true.

Externe Aktionen abrufen

Call the following API to retrieve information about an external task, using the Task Id and the Organization Unit Id (the Id of the Orchestrator folder): GET /tasks/GenericTasks/GetTaskDataById. You can use the retrieved details to create a similar task in a third-party system.

Die folgenden Screenshots zeigen die API-Parameter und Antworten in Swagger. Um in Swagger auf Ihren Mandanten zuzugreifen, folgen Sie dem Verfahren Zugreifen auf Ihre Swagger-Datei .

Abschließen externer Aktionen

Call the following API to complete an external task, using the Task Id and the Organization Unit Id (the Id of the Orchestrator folder): POST /tasks/GenericTasks/CompleteTask.

Weitere Informationen finden Sie im Verfahren zum Abschließen einer externen Aufgabe im Orchestrator-API-Handbuch.

Workflow-Beispiel

Sehen Sie sich als Beispiel oder spätere Referenz das Beispielprojektan