Aktivitätsdesigner

Überblick

Der Aktivitätsdesigner ist eine neue Connector Builder-Funktion. Mit dem Aktivitätsdesigner können Sie eine Vorschau des Layouts Ihrer benutzerdefinierten Integration Service-Aktivitäten anzeigen, wie sie in UiPath® Studio angezeigt werden.

Zu den wichtigsten Funktionen gehören:

• Vorschau des Layouts: Zeigen Sie eine Vorschau des Designs Ihrer benutzerdefinierten Aktivitäten an und sehen Sie, wie sie in Studio angezeigt werden. Sie können das Setup visualisieren und erforderliche Anpassungen vornehmen, bevor Sie Ihren Connector bereitstellen.
• Parametereinstellungen: Erstellen und verwalten Sie Parameterfelder, um mehr Flexibilität beim Anpassen Ihrer Aktivität zu erhalten. Dazu gehören Eingaben, Ausgaben, In-/Out-Argumente und Eigenschaften, die in Ihrem Workflow verwendet werden.
• Anforderungs- und Antwortfelder: Fügen Sie Anforderungs- und Antwortfelder hinzu. Auf diese Weise können Sie die für die Aktivität erforderlichen Informationen (Anforderung) und die Informationen definieren, die von der Aktivität zurückgegeben werden (Antwort).

Eingabefelder

Um die Ressourcen eines benutzerdefinierten Connectors zu konfigurieren, verwenden Sie die Registerkarte Parameter , um Felder hinzuzufügen, die für Ihren Anforderungstyp spezifisch sind. Jetzt ruft der Aktivitätsdesigner alle Parameterfelder ab und zeigt sie im Abschnitt „ Eingabe “ an.

Die folgende Abbildung zeigt die Registerkarte Parameter der Ressource. Nur ein Feld ist als erforderlich markiert:

Die folgende Abbildung zeigt die Registerkarte „ Aktivitätsdesigner “ der Ressource. Die gleichen Parameter werden auf der linken Seite aufgeführt, aber nur das als Erforderlich gekennzeichnete Feld wird im Vorschaufenster angezeigt:

Gruppenparameter werden bearbeitet…

Bearbeiten oder löschen Sie Parameter auf der Registerkarte Aktivitätsdesigner, indem Sie auf Weitere Optionen klicken Menü.

Ändern Sie, wie der Parameter im Vorschaufenster angezeigt wird (sein Anzeigename und eine Beschreibung), indem Sie auf Bearbeiten klicken Symbol neben dem Namen des Parameters.

Eingabeparameterwerte

Auf der Registerkarte Aktivitätsdesigner können Sie jedes Eingabefeld entweder als Erforderlich, Main oder Zusätzlich markieren. Jede Option bestimmt das Verhalten des Parameters und wo er auf der Aktivitäts-Canvas angezeigt wird.

• Erforderlich: Der Parameter wird mit dem Sternchen (*) als erforderlich markiert. Das bedeutet, dass er immer auf der Canvas sichtbar ist und ein Wert dafür angegeben werden muss.

  
  

  

  
  
• Main: Der Parameter wird im primären Abschnitt der Aktivität angezeigt. Es kann leer gelassen werden, wenn die Aktivität in einer Automatisierung verwendet wird.
  
  

  

  
  
• Zusätzlich: Der Parameter ist auf der Haupt-Arbeitsfläche ausgeblendet. Sie wird im Abschnitt Zusätzliche Optionen anzeigen angezeigt. Diese Felder sind optional und können leer bleiben.
  
  

  

  
  

Sortieren von Eingabeparametern

Die Reihenfolge der Eingabeparameter bestimmt die Position der Parameter im Vorschaufenster der Aktivität. Sie können die Reihenfolge mit Ziehen ändern Symbol neben jedem Parameter.

Um beispielsweise das Feld Wenn an den oberen Rand des Abschnitts Eingabe zu verschieben, ziehen Sie das entsprechende Element Symbol nach oben.

Im Vorschaufenster der Aktivität werden Felder in der Reihenfolge angezeigt, in der sie auf der Registerkarte Eingabe aufgeführt sind, abhängig von der Gruppe, der sie zugewiesen sind (Erforderlich, Haupt und Zusätzlich).

Anforderungsfelder

Mit Anforderungsfeldern können Sie den Text einer HTTP-Anforderung ausfüllen.

Anforderungsfelder werden meistens mit POST -, PUT - oder PATCH -Anforderungen verknüpft (Aktivitäten „Insert“, „Upsert“, „Aktualisierung des Datensatzes“). Wenn Sie ein Anforderungsfeld zu einer GET - oder DELETE -Anforderung (Aktivitäten auflisten, abrufen oder löschen) hinzufügen, wird eine Fehlermeldung angezeigt, die Sie darüber informiert, dass das Feld für diesen Vorgang nicht angezeigt wird.

Die folgende Abbildung zeigt die Fehlermeldung, die angezeigt wird, wenn Sie versuchen, ein Anforderungsfeld zu einer DELETE -Ressource hinzuzufügen:

Ausfüllen der Anforderungs- und Antwortfelder

Es gibt zwei Möglichkeiten, die Anforderungs- und Antwortfelder auszufüllen.

Option 1 (empfohlen)

Verwenden Sie eine richtig formatierte JSON.

1. Klicken Sie auf die Schaltfläche Anforderung senden einer Ressource.
2. Fügen Sie das JSON-Objekt hinzu.
3. Stellen Sie sicher, dass die Option Felder bei Sendeanforderung überschreiben aktiviert ist.
4. Klicken Sie auf Ausführen.

Wenn die Antwort erfolgreich ist, werden die Eingabefelder mit den JSON-Eigenschaften für die Anforderung aufgefüllt und die Ausgabefelder werden basierend auf der Antwort ausgefüllt.

Hinweis: Wenn Sie diese Methode verwenden, stellen Sie sicher, dass alle Felder, die Sie in Ihrer Aktivität verwenden möchten, vollständig sind.

Die folgende Abbildung zeigt eine Beispielnutzlast für eine POST -Anforderung. Beachten Sie, dass das Feld Felder bei Sendeanforderung überschreiben aktiviert ist:

Option 2

Sie können jedes Anforderungs- und Antwortfeld manuell auf der Registerkarte Aktivitätsdesigner hinzufügen.

1. Navigieren Sie zur Registerkarte Aktivitätsdesigner .
2. Klicken Sie auf der Registerkarte Eingabe auf Weitere Optionen Menü.
3. Wählen Sie Anforderungsfeld hinzufügen aus.
4. Fügen Sie die Details des Anforderungsfelds auf ähnliche Weise wie einen Parameter hinzu.
   
   

   

   
   
5. Um Antwortfelder hinzuzufügen, wechseln Sie zur Registerkarte Ausgabe und wählen Sie die Option Antwortfeld hinzufügen aus.
   
   

   

   
   

Ausgabefelder

Die Ausgabefelder im Aktivitätsdesigner werden aus den Antwortfeldern abgerufen. Die Werte können aufgefüllt werden, indem erfolgreich eine Anforderung an die Ressource gestellt wird.

Kuratierte Felder

Sie können Ausgabefelder als Kuratiert markieren. Der Feldwert wird speziell aus dem Antwortobjekt extrahiert und kann einer Variablen zugewiesen werden, sodass er einfach zugänglich und in anderen Aktivitäten zu verwenden ist, wenn er in einer Automatisierung verwendet wird.

Die folgende Abbildung zeigt, wie Url, das kuratierte Feld, direkt im Abschnitt Ausgabe der Aktivität angezeigt wird: