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

• AufgabenTitel – Der Titel der Aktion, die Sie erstellen möchten. Dieses Feld unterstützt nur Zeichenfolgen und String -Variablen.
• TaskPriority – Ermöglicht es Ihnen, die Prioritätsstufe der Aktion auszuwählen. Standardmäßig ist diese Eigenschaft auf TaskPriority.Medium festgelegt. Die folgenden Optionen sind verfügbar: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Criical.
• 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

• BeiFehlerFortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.

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:

Um die Beschriftung von automatischen Aktionen über Persistenzaktivitäten zu ermöglichen, benötigt das Roboterkonto, das den Workflow ausführt, die Berechtigungen Anzeigen, Erstellen und Löschen für 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 – Ermöglicht es Ihnen, die Prioritätsstufe der Aktion auszuwählen. Standardmäßig ist diese Eigenschaft auf TaskPriority.Medium festgelegt. Die folgenden Optionen sind verfügbar: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Criical.
• AufgabenTitel – 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 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

• AufgabenTitel – Der Titel der Aktion, die Sie erstellen möchten. Dieses Feld unterstützt nur Zeichenfolgen und String -Variablen.
• TaskPriority – Ermöglicht es Ihnen, die Prioritätsstufe der Aktion auszuwählen. Standardmäßig ist diese Eigenschaft auf TaskPriority.Medium festgelegt. Die folgenden Optionen sind verfügbar: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Criical.
• 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

• BeiFehlerFortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.

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:

Um die Beschriftung von automatischen Aktionen über Persistenzaktivitäten zu ermöglichen, benötigt das Roboterkonto, das den Workflow ausführt, die Berechtigungen Anzeigen, Erstellen und Löschen für 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.

• Referenz – Ein Tag, das Sie verwenden können, 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.

Externe Aktionen erstellen

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

1. Fügen Sie eine Create External Task- Aktivität in Ihren Workflow ein und geben Sie Informationen für die folgenden Eigenschaftsfelder an:
   • Aufgabentitel
   • Aufgabenpriorität
   • Aufgabendaten (Sammlung)
   • Externes Tag – Geben Sie ein Tag an, um Batches 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 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. Rufen Sie die folgende API in Swagger auf: GET /odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders.

   Zum 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 über eine externe Aufgabe abzurufen, indem Sie die Aufgaben-ID und die ID der Organisationseinheit (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 in Swagger auf Ihren Mandanten zuzugreifen, folgen Sie dem Verfahren Zugreifen auf Ihre Swagger-Datei .

Abschließen externer Aktionen

Rufen Sie die folgende API auf, um eine externe Aufgabe mithilfe der Aufgaben-ID und der ID der Organisationseinheit (der ID des Orchestrator-Ordners) abzuschließen: 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