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 – 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 Zeichenfolgen und String -Variablen.
• TaskData – Eine Sammlung von Geschäftsdaten im Format Dictionary<String,Argument>, die Sie in einer bestimmten Aktion speichern möchten. Wenn Sie die Argumente Out und In/Out ändern, werden sie nach Abschluss der Aktion wieder dem Workflow zugeordnet. Dieses Feld unterstützt nur Dictionary<String,Argument> -Objekte.
• Aufgabenobjekt (Ausgabe) – Das Aufgabenobjekt, das vom Orchestrator als ExternalTaskData -Objekt zurückgegeben wird, nachdem die Actions erstellt wurden. 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 Actions auszusetzen.

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

• Externes Tag – Ein Tag, das verwendet werden kann, um das externe System zu identifizieren, das die Quelle für die Daten in der angegebenen Aktion ist. Dieses Feld unterstützt nur Zeichenfolgen und String -Variablen.
• 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 zu einem Orchestrator-Ordner , der sich von dem des aktuellen Prozesses unterscheidet, in dem Sie die Aufgabe erstellen möchten. Weitere Informationen zu Orchestrator-Ordnern finden Sie hier. Bei klassischen Ordnern kann diese Eigenschaft nur mit Floating-Robotern verwendet werden und nur, wenn der aktuelle Benutzer über die richtigen Aufgabenberechtigungen im Zielordner verfügt. Für moderne Ordner wird das Überschreiben von Ordnerpfaden nicht unterstützt. Dieses Feld unterstützt nur Zeichenfolgen und String -Variablen.

Hinweis: Die Eigenschaft FolderPath darf nur verwendet werden, wenn die Aufgabe in einem anderen Ordner als dem aktuellen erstellt 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 Aufgabenerstellung fehl und es wird ein kritischer Fehler ausgegeben. Weitere Informationen zu Ordnerberechtigungen finden Sie hier.

• TaskCatalog – Eine optionale Geschäftsklassifizierung von Aufgabenelementen. Dieses Feld unterstützt nur Zeichenfolgen und String -Variablen.

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

• TaskData – Eine Sammlung von Geschäftsdaten im Format Dictionary<String,Argument>, die Sie in einer bestimmten Aktion speichern möchten. Wenn Sie die Argumente Out und In/Out ändern, werden sie nach Abschluss der Aktion wieder dem Workflow zugeordnet. Dieses Feld unterstützt nur Dictionary<String,Argument> -Objekte.
• 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.

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 ExternalTaskData -Objekt zurückgegeben wird, nachdem die Actions erstellt wurden. 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 Actions auszusetzen.

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 Zeichenfolgen und String -Variablen.

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

• TaskData – Eine Sammlung von Geschäftsdaten im Format Dictionary<String,Argument>, die Sie in einer bestimmten Aktion speichern möchten. Wenn Sie die Argumente Out und In/Out ändern, werden sie nach Abschluss der Aktion wieder dem Workflow zugeordnet. Dieses Feld unterstützt nur Dictionary<String,Argument> -Objekte.
• Aufgabenobjekt (Ausgabe) – Das Aufgabenobjekt, das vom Orchestrator als ExternalTaskData -Objekt zurückgegeben wird, nachdem die Actions erstellt wurden. 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 Actions auszusetzen.

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

• 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 zu einem Orchestrator-Ordner , der sich von dem des aktuellen Prozesses unterscheidet, in dem Sie die Aufgabe erstellen möchten. Weitere Informationen zu Orchestrator-Ordnern finden Sie hier. Bei klassischen Ordnern kann diese Eigenschaft nur mit Floating-Robotern verwendet werden und nur, wenn der aktuelle Benutzer über die richtigen Aufgabenberechtigungen im Zielordner verfügt. Für moderne Ordner wird das Überschreiben von Ordnerpfaden nicht unterstützt. Dieses Feld unterstützt nur Zeichenfolgen und String -Variablen.

Hinweis: Die Eigenschaft FolderPath darf nur verwendet werden, wenn die Aufgabe in einem anderen Ordner als dem aktuellen erstellt 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 Aufgabenerstellung fehl und es wird ein kritischer Fehler ausgegeben. Weitere Informationen zu Ordnerberechtigungen finden Sie hier.

• Referenz – Ein Tag, mit dem Sie das externe System identifizieren können, das die Quelle für die Daten in der angegebenen Aktion ist. Dieses Feld unterstützt nur Zeichenfolgen und String -Variablen.

Externe Aktionen erstellen

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

1. Fügen Sie die Aktivität Externe Aufgabe erstellen zu Ihrem Workflow hinzu und geben Sie Informationen für die folgenden Eigenschaftsfelder an:

   • Aufgabentitel
   • Aufgabenpriorität
   • Aufgabendaten (Sammlung)
   • Externes Tag – Geben Sie ein Tag an, um Stapel externer Aufgaben, die Sie von einem Drittanbietersystem abrufen möchten, eindeutig zu identifizieren. Sie können dieses Tag verwenden, um externe Aufgaben mit einem externen System zu synchronisieren. Sie können dieses Tag auch verwenden, um Aufgaben basierend auf den Aktionen abzuschließen, die ein Benutzer im Drittanbietersystem ausführt.
2. Erstellen externer Actions 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. Rufen Sie die folgende API in Swagger auf: GET /odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders.
   Beispiel: 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

Rufen Sie die folgende API auf, um Informationen zu einer externen Aufgabe abzurufen, indem Sie die Aufgaben-ID und die Organisationseinheits-ID (die ID des Orchestrator-Ordners) verwenden: GET /tasks/GenericTasks/GetTaskDataById. Sie können die abgerufenen Details verwenden, um eine ähnliche Aufgabe in einem Drittanbietersystem zu erstellen.

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

Abschließen externer Aktionen

Rufen Sie die folgende API auf, um eine externe Aufgabe abzuschließen, indem Sie die Aufgaben-ID und die Organisationseinheits-ID (die ID des Orchestrator-Ordners) verwenden: POST /tasks/GenericTasks/CompleteTask.

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

Workflow-Beispiel

Ein Beispiel oder eine zukünftige Referenz finden Sie im Beispielprojekt.