Konfigurieren von Aktivitäten

Aktivitäten können Daten als Eingabe empfangen und Ausgabedaten erzeugen, die als Eingabe in anderen Aktivitäten verwendet werden können. Wichtige Aktivitätsoptionen oder -eigenschaften sind standardmäßig in Aktivitätskarten sichtbar. Wenn eine Aktivität über zusätzliche Eigenschaften verfügt, können Sie diese konfigurieren, indem Sie Zusätzliche Eigenschaften anzeigen auswählen.

Im Eigenschaftenbereich können Sie steuern, wie Aktivitätseigenschaften angezeigt werden. Sie können dieses Panel auch verwenden, um den Namen des Projekts oder den Namen des Workflows zu ändern, der im Projekt-Explorer ausgewählt ist .

Um auf den Bereich zuzugreifen, wählen Sie das entsprechende Symbol oben rechts auf der Projektseite aus. Im Eigenschaftenbereich können Sie jederzeit zwischen zwei Ansichten wechseln:

• Canvas-Ansicht – Alle Eigenschaften der ausgewählten Aktivität werden auf der Aktivitätskarte angezeigt.

• Bereichsansicht – Alle Eigenschaften der ausgewählten Aktivität, einschließlich der erweiterten Eigenschaften, werden nur im Eigenschaftenbereich angezeigt und die Aktivitätskarte wird reduziert.

  

Auswählen von Mehr anzeigen neben einem Aktivitätsfeld die Optionen für dieses Feld anzeigen. Die Optionen für die meisten Felder sind:

• Variable verwenden
• Textgenerator
• Variable erstellen
• Ausdrucks-Editor öffnen
  Hinweis:

  Die verfügbaren Optionen können je nach den mit dem Feld verbundenen Datentypen variieren.

Dedizierte Eingabesteuerelemente, Editoren und Generatoren stehen zur Verfügung, mit denen Sie Aktivitäten je nach Datentyp konfigurieren können, entweder direkt von der Aktivität im Projektdesigner oder über einen Editor oder Generator.

Einige Aktivitäten definieren einen Scope oder die Bedingungen, die für die Ausführung anderer Aktivitäten erfüllt werden müssen, die ihnen hinzugefügt wurden. Diese werden als Containeraktivitäten bezeichnet. Beispiele sind:

• Für jede/n -Aktivitäten
  • Definieren Sie eine Sammlung von Elementen, und wiederholen Sie die darin hinzugefügten Aktivitäten einmal für jedes dieser Elemente.
• If – Bewertet eine Bedingung und bestimmt den Ablauf der Automatisierung, indem bestimmte Aktivitäten basierend auf der Erfüllung der Bedingung ausgeführt werden.
• Browser verwenden – Wird an eine Seite in Ihrem Browser angehängt und führt alle darin hinzugefügten UI-Automatisierungsaktivitäten auf dieser Seite aus.

In den folgenden Abschnitten wird beschrieben, wie Sie einige der verfügbaren Editoren und Generatoren verwenden können.

Ausdrucks-Editor

Schreiben Sie komplexe Ausdrücke, um Aktivitätseigenschaften zu konfigurieren. Der Ausdrucks-Editor ist für die meisten Aktivitätseigenschaften verfügbar und verfügt über eine intelligente Codevervollständigung für Variablen, Argumente, Methoden, Eigenschaften, Klassen oder Schlüsselwörter. Sie können Ausdrücke in mehrere Zeilen schreiben und Strg + Leertaste verwenden, um die Liste der verfügbaren Optionen anzuzeigen. Sie können auch Variable einfügen wählen, um das Variablenauswahlfenster zu öffnen und eine Variable, ein Argument oder eine Eigenschaft auszuwählen.

Verwenden Sie „Strg + F“ im Editor, um die Funktion zum Suchen und Ersetzen zu öffnen. Das Fehlersymbol gibt an, ob eine Inkompatibilität zwischen einem Ausdruck und dem Aktivitätseigenschaftstyp besteht (z. B. die Verwendung eines Ausdrucks vom Typ String in einer Eigenschaft vom Typ Boolean).

Sie können den Wert gültiger Ausdrücke testen, indem Sie Test auswählen. Das Testen von Ausdrücken, die komplexe Werte verwenden, wird derzeit nicht unterstützt.

Generieren Sie Ausdrücke mit Autopilot™

Mit den generativen KI-Funktionen von Autopilot™ können Sie Ihren Ausdruck auch in natürlicher Sprache beschreiben. Anstatt einen Ausdruck manuell in den Ausdrucks-Editor zu schreiben, können Sie das Feld „Ausdruck generieren“ verwenden, um die gewünschte Aktion zu beschreiben (z. B. „Extrahieren des Gesamtumsatzes aus dem Verkaufsbericht“).

Das KI-Modell generiert einen Ausdruck basierend auf der bereitgestellten Beschreibung, der dann im Editor angezeigt wird. Sie können dann den generierten Ausdruck ändern oder so akzeptieren, wie er ist. Das KI-Modell lernt kontinuierlich von den von Ihnen übermittelten Beschreibungen, sodass es seine Leistung im Laufe der Zeit verfeinern und verbessern kann. Das Modell kann auch benutzerdefinierte Variablen und Argumente verwenden und erkennt alle bereits verwendeten Ausdrücke.

Wählen Sie die Schaltfläche Korrektur neben einem Fehlersymbol aus. Autopilot versucht dann, die Unstimmigkeit zu beheben und einen gültigen Ausdruck zu liefern. Eine Fehlermeldung informiert Sie, wenn der Ausdruck nicht automatisch korrigiert werden kann.

Beispiel für die Verwendung des Ausdrucks-Editors mit Autopilot -Funktionen

Eine einfache Möglichkeit, die Funktionen von Autopilot zu testen, besteht darin, eine Variable von Kleinbuchstaben in Großbuchstaben umzuwandeln. Gehen Sie dazu wie folgt vor:

1. Erstellen Sie ein neues Projekt mit einem manuellen Trigger und erstellen Sie eine neue Variable (z. B. MyVariable).

2. Legen Sie den Variablentyp auf Text und den Standardwert auf „example“ fest.

3. Fügen Sie eine Aktivität Set Variable Value hinzu.

4. Wählen Sie im Feld Wert festlegen die Option Mehr anzeigen aus > Ausdruckseditor öffnen.

5. Geben Sie im Feld „Ausdruck generieren“ Ihre Anweisungen in natürlicher Sprache ein (z. B. „Konvertieren Sie MyVariable in Großbuchstaben“).

6. Wählen Sie aus, um Ihren Ausdruck zu generieren. Wählen Sie optional Test im Ausdrucks-Editor, um den neuen Wert der Variablen zu testen.

7. Wählen Sie Speichern aus, um den von Autopilot generierten Ausdruck zu verwenden.

8. Wählen Sie im Feld An Variablenausgabe die Option MeineVariable aus.

   

9. Fügen Sie eine Log Message- Aktivität hinzu.

10. Schreiben Sie in das Feld Meldung die Meldung, die Sie protokollieren möchten (z. B. „Meine Variable, MyVariable ist jetzt in Großbuchstaben“) und wählen Sie eine Protokollierungsstufe aus.

11. Wählen Sie In der Cloud debuggen oben im Designer aus, um die Automatisierung zu testen, und überprüfen Sie im Bereich Ausführungsausgabe, wie die Variable von Kleinbuchstaben („example)“ in Großbuchstaben (EXAMPLE) geändert wurde.

    

Filtergenerator

Erstellen Sie einen komplexen Filter mit einer oder mehreren Bedingungen. Filter ermöglichen es Ihren Automatisierungen, die genauen Elemente zu bestimmen, die verwendet werden sollten. Beispielsweise enthalten die meisten Ereignistrigger Filter, mit denen Sie die genauen Kriterien bestimmen können, die ein Ereignis erfüllen muss, damit die Automatisierung startet.

Erstellen eines Filters:

1. Wählen Sie im Feld auf der linken Seite das Element aus, das gefiltert werden soll. Wenn Sie beispielsweise E-Mails filtern, können Sie ein E-Mail-Feld wie Von oder Textkörper auswählen.
2. Wählen Sie einen Operator aus der Dropdownliste in der Mitte für den Vergleich des Elements aus. Je nach Datentyp sind verschiedene Operatoren auswählbar. Wenn Sie beispielsweise E-Mails nach Absender filtern, können Sie den Operator enthält oder enthält nicht für das „Von“-Feld auswählen.
3. Wählen Sie im rechten Feld den Wert aus, mit dem das ausgewählte Element verglichen werden soll.

Um einen Filter mit mehreren Bedingungen zu erstellen, klicken Sie im Filter-Generator auf Bedingung hinzufügen und erstellen Sie jede zusätzliche Bedingung auf ähnliche Weise. Wenn Sie mehrere Bedingungen hinzufügen, wird oben im Fenster ein Dropdownmenü angezeigt, in dem Sie auswählen müssen, wann der Filter angewendet werden soll: Wählen Sie All (AND) aus, wenn der Filter angewendet wird, wenn alle Bedingungen erfüllt sind, oder Any (OR) wenn der Filter angewendet wird, wenn verfügbar der Bedingungen ist erfüllt.

Beispiel für das Erstellen eines Filters

Sie entwerfen eine Automatisierung, die durch das Ereignis Datei erstellt in OneDrive oder Google Drive ausgelöst wird, und Sie möchten nur, dass die Automatisierung ausgeführt wird, wenn Dateien mit den Erweiterungen erstellt werden: PDF, TIF, JPG, PNG, JPEG.

1. Wählen Sie in der Triggeraktivität Zusätzliche Filter aus, um den Filtergenerator zu öffnen.

2. Fügen Sie eine Bedingung für jede Dateierweiterung hinzu, die in den Filter aufgenommen werden soll, indem Sie im ersten Feld Erweiterung auswählen, im zweiten Feld enthält und im dritten Feld eine Erweiterung eingeben.

3. Wählen Sie Beliebige (ODER) aus der Dropdownliste oben im Fenster aus, um anzugeben, dass die Erstellung von Dateien mit einer beliebigen Erweiterung die Automatisierung auslösen soll.

   

Bedingungsgenerator

Definieren Sie eine wahre oder falsche Aussage, die von einer Aktivität ausgewertet wird, um zu bestimmen, wie die Automatisierung fortgesetzt werden soll.

Erstellen einer Bedingung:

1. Wählen Sie im Feld auf der linken Seite den ersten Wert für den Vergleich aus, z. B. eine Variable aus Ihrem Projekt.
2. Wählen Sie einen Operator aus der Dropdownliste in der Mitte für den Vergleich des ersten Werts aus. Je nach Datentyp sind verschiedene Operatoren auswählbar: greater than, greater than or equal, less than, less than or equal, equals, not equals, is empty text, is not empty text, is true, is false, starts with, does not start with, ends with, does not end with, contains, does not contain, has value, has no value, list is empty, list is not empty.
3. Je nach Operator müssen Sie eventuell auch einen zweiten Wert aus dem rechten Feld auswählen, mit dem der erste Wert verglichen werden soll.

To create a statement with multiple conditions, click Add in the Condition Builder and provide the same information for each additional statement. When you add multiple statements, a dropdown menu appears at the top of the window where you must select when the statement is true: select All (AND) if the statement is true when all the conditions are met, or Any (OR) if the statements is true when any of the conditions are met.

Beispiel für das Erstellen einer Bedingung

Sie entwerfen eine Automatisierung, die jede Datei, die in einem bestimmten Ordner auf Ihrem Google Drive oder OneDrive erstellt wird, in einen von zwei Ordnern verschiebt, basierend auf der Größe jeder Datei: Dateien ab 1 MB werden in den Ordner Große Dateien, Dateien unter 1 MB in den Ordner Kleine Dateien verschoben.

1. Konfigurieren Sie den Trigger Datei erstellt.

2. Fügen Sie eine If-Aktivität hinzu und klicken Sie auf das Feld Bedingung, um den Bedingungsgenerator zu öffnen.

3. Fügen Sie im Bedingungsgenerator die Bedingung „Die Datei ist kleiner als 1 MB“ hinzu. Wir verwenden die Eigenschaft GrößeInBytes der erstellten Datei, und 1 MB = 1.000.000 Byte.

   1. Klicken Sie auf das erste Feld und wählen Sie Datei erstellt > Mehr anzeigen > Datei > SizeInBytes aus.
   2. Wählen Sie im mittleren Feld weniger als aus.
   3. Geben Sie im dritten Feld 1,000,000 ein und klicken Sie dann auf Speichern.

   

4. Wir fügen dann zwei Move File-Aktivitäten hinzu, um die erstellte Datei wie folgt zu verschieben:

   • Eine Aktivität in der Then-Verzweigung der If-Aktivität. Diese Aktivität wird ausgeführt, wenn die Bedingung erfüllt ist (die Dateigröße ist unter 1 MB), also wählen wir Kleine Dateien als Zielordner aus.
   • Die andere Aktivität in der Else-Verzweigung der If-Aktivität. Diese Aktivität wird ausgeführt, wenn die Bedingung nicht erfüllt ist (die Dateigröße ist nicht unter 1 MB), also wählen wir Große Dateien als Zielordner aus.

   

Sammlungsgenerator

Erstellen Sie eine Sammlung von Elementen desselben Typs.

Um eine Sammlung zu erstellen, wählen Sie ein Element und dann Eintrag hinzufügen für jeden Eintrag aus, den Sie hinzufügen möchten.

Beispiel für das Erstellen einer Sammlung

Sie entwerfen eine Automatisierung, bei der Sie Dateien in zwei verschiedenen Download-Aktivitäten abgerufen haben. Anschließend möchten Sie die Dateien mit einer einzigen Upload Files-Aktivität auf OneDrive oder Google Drive hochladen.

1. Wählen Sie in der Aktivität „Upload Files“ die Option Mehr anzeigen aus > Erstellen Sie eine Sammlung von Dateien neben dem Feld Datei .

2. Wählen Sie Klicken zum Öffnen des Sammlungsgenerators aus.

3. Wählen Sie Hinzufügen aus, klicken Sie dann auf das erste Feld und wählen Sie die Ausgabe der ersten Aktivität „Download File“ aus. Wiederholen Sie den Vorgang für die Ausgabe der zweiten Aktivität und klicken Sie dann auf Speichern.

   

Selektor für Datum und Uhrzeit

Wählen Sie ein Datum aus dem Kalender und eine Uhrzeit (Stunde und Minute) aus. Verfügbar für Felder, die einen Datums- und Uhrzeitwert erfordern.

Wenn Sie eine Variable in einem Feld verwenden, das Datums- und Uhrzeitwerte akzeptiert, sind auch Snippets verfügbar, mit denen Sie allgemeine Datums- und Uhrzeitvariablen schnell hinzufügen können:

• Heute
• Gestern
• Morgen
• Vor zwei Tagen
• Beginn der letzten Arbeitswoche
• Ende der letzten Arbeitswoche
• StartOfNextWeek
• StartOfNextMonth
• Anfang dieser Woche
• Anfang dieses Monats
• Anfang des letzten Monats
• Anfang dieses Jahres
• Vor 3 Monaten
• Vor 6 Monaten
• Jetzt

Datenzuordnungseditor

Der Editor Datenzuordnung vereinfacht die End-to-End-Automatisierung von Geschäftsprozessen mit komplexen Datenstrukturen. Mithilfe der Datenzuordnung können Sie zwischen Systemen innerhalb einer einzigen Integration Service-Aktivität leichter komplexe Datenobjekte zuordnen.

So greifen Sie auf den Editor zur Datenzuordnun zu:

1. Fügen Sie Ihrem Workflow eine Integration Service-Aktivität hinzu.

2. Wählen Sie die Taste Zur Objektansicht wechseln im Hauptteil der Aktivität.

3. Wählen Sie das Aktivitätsfeld, das Sie bearbeiten möchten. Der Datenzuordnungseditor wird geöffnet.

   

Alternativ können Sie den Datenzuordnungs-Editor erreichen, indem Sie Mehr anzeigen auswählen > Datenzuordnung neben dem Aktivitätsfeld.

Der Editor verfügt über zwei Modi:

1. Ein Standardmodus, der jedes Mal geöffnet wird, wenn Sie auf den Editor zugreifen. Dies ist der Standardmodus.
2. Ein erweiterter Modus, den Sie mit dem Umschalter Erweiterter Modus in der oberen rechten Ecke des Editors aktivieren können.

Im Standardmodus können Sie:

• Über die Tasten „Alle erweitern“ und „Alle reduzieren“ können Sie alle geschachtelten Objekteigenschaften erweitern oder reduzieren.
• Wählen Sie das Suchsymbol, um eine bestimmte Eigenschaft oder Variable zu finden.
• Zeigen Sie alle Eigenschaften des Objekts in der Spalte Zieleigenschaften an. Einige Eigenschaften können so erweitert werden, dass zusätzliche geschachtelte Eigenschaften sichtbar werden (z. B. Eigenschaften des Typs Liste). Jede Eigenschaft hat einen Anzeigenamen, damit sie in der Liste leicht unterscheidbar ist, sowie den genauen API-Namen, der von der Drittanbieteranwendung definiert ist.
• Ordnen Sie eine Objekteigenschaft einer Aktivitätsausgabe in der Spalte Zuordnung zu. Klicken Sie auf das Feld neben jeder Eigenschaft und wählen Sie eine Variable aus dem Selektor Variablen verwenden aus. Sie können auch Mehr anzeigen auswählen Schaltfläche zum:
  • Öffnen Sie den Selektor Variablen verwenden .
  • Öffnen Sie den Ausdruckseditor.
  • Löschen Sie einen beliebigen Wert im Feld „Aktivitätsausgabe“.
• Wählen Sie in der Spalte Verfügbare Variablen eine Variable aus, die im Workflow verfügbar ist. Variablen können in den Aktivitätsausgaben, die in der Spalte Zuordnung aufgeführt sind, gezogen und abgelegt werden.
• Aktivieren oder deaktivieren Sie den erweiterten Modus. Im erweiterten Modus können Sie Eigenschaften nur zuordnen, indem Sie einen Ausdruck eingeben oder den Selektor Variablen verwenden verwenden. Das Ziehen und Ablegen von Variablen aus der Spalte Verfügbare Variablen ist nicht verfügbar.
  Hinweis:

  In Studio ist der Datenzuordnungs-Editor nur im erweiterten Modus verfügbar.

Ein Fehlersymbol im Ausgabefeld der Aktivität zeigt an, wenn eine Inkompatibilität zwischen einer Variablen und dem Ausgabetyp der Aktivität vorliegt.

Nachdem eine Objekteigenschaft der Ausgabe einer Aktivität zugeordnet wurde, wählen Sie die Taste Speichern, um Ihre Änderungen aufzuzeichnen.

Hinweis:

Wenn eine verschachtelte Eigenschaft oder eine übergeordnete Eigenschaft bereits zugeordnet ist, kann die andere nicht zugeordnet werden.

Wählen Sie im Text der Aktivität Zur Feldansicht wechseln, um wieder zur Inline-Aktualisierung der Aktivitätsfelder zu wechseln.

Wichtig:

Um die im Datenzuordnungs-Editor erstellten Ausgaben zu verwenden, stellen Sie sicher, dass Sie die Aktivität in der Objektansicht verwenden . Wenn die Aktivität in der Feldansicht verwendet wird, werden die im Datenzuordnungs-Editor erstellten Zuordnungen beim Ausführen des Workflows nicht berücksichtigt.