Verwalten von Variablen

In Studio werden Variablen verwendet, um mehrere Arten von Daten zu speichern. Ein weiterer Hauptaspekt von Variablen ist, dass ihr Wert veränderbar ist. So können Sie zum Beispiel kontrollieren, wie oft ein Schleifentextkörper ausgeführt wird.

Hinweis:

• Variablen müssen mit unterschiedlichen Namen erstellt werden, selbst wenn sie in unterschiedlichen Scopes verwendet werden. Wenn zwei Variablen denselben Namen haben, sich aber in unterschiedlichen Scopes befinden, hat die Variable im inneren Scope Vorrang. Sie können sich unsere Empfehlungen zu den Workflow-Design-Namenskonventionen ansehen.
• Variablennamen müssen mit einem Buchstaben oder Unterstrich _ beginnen.
• Die Verwendung bestimmter Schlüsselwörter (z. B. „Ersetzen“) zum Benennen von Variablen kann zu unerwarteten Fehlern führen.

Aus der Sicht von Studio ist der Name der Variablen ihre eindeutige ID, und dieser definiert, wie sie angezeigt und verwendet wird. Wenn dieser geändert oder gelöscht wird, kann Studio die .xaml-Dateien nicht basierend auf den geladenen Aktivitäten interpretieren. Alle Strings müssen in Anführungszeichen gesetzt werden.

Important: Wenn es eine Variable und ein Argument mit demselben Namen gibt, wird zur Laufzeit standardmäßig immer die Variable verwendet.

Sie können Variablen auf verschiedene Weise verwalten. Für die beste Erfahrung und Flexibilität wird empfohlen, den Data Manager zu verwenden.

Variablentyp

Die in einer Variablen gespeicherten Daten werden als Wert bezeichnet, und sie kann von verschiedenen Typen sein. Wenn Sie eine Variable erstellen, sind die folgenden Optionen verfügbar:

• Boolescher Wert – Dieser Typ hat nur zwei mögliche Werte: true oder false. Diese Variablen ermöglichen es Ihnen, Entscheidungen zu treffen und somit Ihren Workflow besser zu kontrollieren.
• Int32 – Dieser Typ wird verwendet, um numerische Informationen zu speichern. Er dient unter anderem dazu, Gleichungen und Vergleiche durchzuführen und wichtige Daten zu übermitteln.
• String – Speichert Textinformationen. Dieser Variablentyp kann verwendet werden, um textbasierte Informationen wie Mitarbeiternamen, Benutzernamen oder andere Strings zu speichern.
• Object – Kann verwendet werden, um verschiedene Datentypen zu speichern. Sie können diesen Variablentyp verwenden, wenn Sie Flexibilität für den Typ der Daten benötigen, die Sie in einer Variablen speichern. Stellen Sie sicher, dass der in Object-Variablen verwendete Datentyp mit den Aktivitäten kompatibel ist, welche die Variable verwenden.
• System.Data.DataTable – Dieser Typ kann große Informationen speichern und als Datenbank oder einfache Tabelle mit Zeilen und Spalten fungieren. Er kann unter anderem nützlich sein, um bestimmte Daten aus einer Datenbank in eine andere zu migrieren und Informationen aus einer Website zu extrahieren und lokal in einer Tabelle zu speichern.
• Array von [T] – Ermöglicht Ihnen das Speichern mehrerer Werte des gleichen Typs.

• Nach Typen suchen – Ermöglicht es Ihnen, weitere Typen zu erkunden, die für Ihre Aufgabe relevant sein können.

  Hinweis: Die Verwendung von Variablen von Typen, die durch die im Projekt verwendete Sprache als statisch definiert sind, führt zu einem Kompilierungsfehler in Windows- und plattformübergreifenden Projekten.

Variablenumfang

Die Scope-Eigenschaft gibt Variablen einen klar definierten Kontext vor, in dem sie verwendet werden können. Der Scope kann auf global (im gesamten Projekt verfügbar), die aktuelle Workflow-Datei oder eine beliebige Containeraktivität innerhalb der Workflow-Datei festgelegt werden.

Sie können globale Variablen nur über den Data Manager erstellen.

Hinweis:

• Globale Variablen sind nicht serialisierbar und deshalb mit Persistenzaktivitäten mit langer Ausführungszeit nicht kompatibel.
• Globale Variablen werden in Bibliotheksprojekten nicht unterstützt.

Erstellen von Variablen

Über den Data Manager

1. Öffnen Sie den Data Manager und wählen Sie Neu > Neue Variable aus.
2. Konfigurieren Sie den Namen, Datentyp, Scope und Standardwert für die Variable.

Über den Text einer Aktivität

1. Ziehen Sie eine Aktivität aus dem Aktivitäten-Bereich in den Designer-Bereich. Klicken Sie mit der rechten Maustaste auf ein Feld und wählen Sie Variable erstellen im Kontextmenü aus, drücken Sie Strg+K oder wählen Sie Variable erstellen im Plus-Menü rechts neben dem Feld aus. Das Feld Var. festlegen wird angezeigt.
2. Geben Sie den Namen ein und drücken Sie die Eingabetaste. Die Variable wird erstellt und ist im Feld sichtbar. Überprüfen Sie ihren Scope und Typ im Data Manager.

Aus Ausdrücken

Alternativ können Argumente aus Ausdrücken direkt in einem Aktivitätseingabefeld oder im Ausdrucks-Editor erstellt werden:

1. Wählen Sie einen Teil des Ausdrucks aus, und drücken Sie Strg+K. Das Feld Var. festlegen wird angezeigt.

2. Geben Sie den Namen ein und drücken Sie die Eingabetaste. Die Variable wird erstellt. Überprüfen Sie ihren Scope und Typ im Data Manager.

   
   

   

   
   

Auf diese Weise erstellte Argumente erhalten automatisch den Typ gemäß der Aktivität. Wenn Sie beispielsweise ein Argument im Feld Data Table einer Write Range-Aktivität erstellen, wird der Argumenttyp auf DataTable festgelegt. Wenn Sie ein Argument im Feld Text einer Write Line-Aktivität erstellen, wird der Argumenttyp auf String festgelegt.

Der Scope solcher Variablen ist der kleinste Container, zu dem er gehört. Der Typ wird abhängig von der ausgewählten Eigenschaft automatisch generiert.

Über das Panel „Eigenschaften“

1. Klicken Sie im Eigenschaften-Bereich einer Aktivität mit der rechten Maustaste auf ein Feld und wählen Sie Variable erstellen im Kontextmenü aus, drücken Sie Strg+K oder wählen Sie Variable erstellen im Plus-Menü rechts neben dem Feld aus. Das Feld Var. festlegen wird angezeigt.
2. Geben Sie den Namen ein und drücken Sie die Eingabetaste. Die Variable wird erstellt und ist im Feld sichtbar. Überprüfen Sie ihren Scope und Typ im Data Manager.

Der so erstellte Variablenbereich ist der kleinste Container, dessen Teil er ist. Der Typ wird abhängig von der ausgewählten Eigenschaft automatisch generiert.

Aus dem Panel „Variablen“

1. Klicken Sie im Panel Designer (Designer) auf Variablen(Variables). Das Panel Variablen(Variables) wird angezeigt.
2. Klicken Sie auf die Zeile Variable erstellen, und geben Sie den Namen ein. Eine neue Variable wird erstellt.

Der standardmäßige Variablentyp, der auf diese Weise erstellt wird, ist Zeichenfolge.

Automatisch von Aktivitätsausgaben generierte Variablen (nur für Windows- und plattformübergreifende Projekte)

Wenn die Designeinstellung Aktivitätsausgaben automatisch generieren aktiviert ist, setzt Studio automatisch eine Variable in jedes Ausgabe-Feld von Aktivitäten ein, die eine Ausgabe generieren. Sie können die generierte Variable dann in anderen Aktivitäten verwenden, indem Sie das Plus-Menü rechts neben den Aktivitätseingabefeldern und dann Variable verwenden auswählen.

Wenn Sie eine Ausgabevariable lieber manuell erstellen möchten, ist dies im Ausgabefeld möglich. Dadurch wird die generierte Variable durch Ihre erstellte Variable ersetzt. Wenn Sie nach dem manuellen Erstellen einer Variablen die Option Wert löschen auswählen, wird die standardmäßig generierte Variable wiederhergestellt.

Die generierte Variable ist im Variablen-Bereich und im Data Manager verfügbar (wenn die Variable in einer anderen Aktivität verwendet wird). Wie bei jeder anderen Variablen können Sie den Namen, Datentyp, Scope und Standardwert der generierten Variablen ändern.

Der Scope der generierten Variablen basiert auf der Position der Aktivität im Workflow (beispielsweise variiert der Scope, wenn sich die Aktivität in der Haupt-Sequence oder in einer For Each-Aktivität befindet). Der Scope der generierten Variablen wird aktualisiert, wenn Sie die Aktivität kopieren, ausschneiden oder einfügen. Das Umbenennen einer Aktivität wirkt sich nicht auf die generierte Variable aus. Doch das Löschen einer Aktivität:

• Löscht den Wert der Variablen, wenn sie nicht verwendet wird.
• Löscht die Variable, wenn sie verwendet wird, und eine Warnung wird in den Aktivitäten angezeigt, welche die Variable als Eingabe verwendet haben.

Entfernen von Variablen

Sie können Variablen über den Data Manager oder Variablen-Bereich entfernen.

Über den Data Manager

1. Öffnen Sie den Data Manager und erweitern Sie den *Variablen-Knoten.
2. Klicken Sie mit der rechten Maustaste auf eine Variable und wählen Sie Variable löschen aus. Alternativ können Sie sie auswählen und die Entf-Taste drücken.

Aus dem Panel „Variablen“

1. Öffnen Sie den Variablen-Bereich.

2. Klicken Sie mit der rechten Maustaste auf eine Variable und wählen Sie Löschen aus. Alternativ können Sie sie auswählen und die Entf-Taste drücken.

   
   

   

   
   

Entfernen aller nicht verwendeten Variablen

Um alle Variablen zu entfernen, die definiert wurden, aber nirgendwo in der aktuellen Datei verwendet werden, wählen Sie Nicht verwendete entfernen > Variablen im Studio-Menüband und dann Ja aus, wenn Sie zur Bestätigung aufgefordert werden. Dadurch werden auch Variablen entfernt, die nicht verwendet, aber in Anmerkungen erwähnt werden.

Hinweis: Wenn Sie ein Paket entfernen oder aktualisieren, das zu einer undefinierten Variablen oder einem ebensolchen Argument führen kann, wird an dieser Stelle Unbekannter Typ (Unknown Type) hinzugefügt, sodass die Datei in Studio geöffnet und bearbeitet werden kann.

Suchen nach .NET-Variablentypen

Führen Sie die folgenden Schritte aus, um nach Variablentypen zu suchen, die nicht standardmäßig in der Liste Variable Type angezeigt werden:

1. Wählen Sie im Data Manager von der Dropdownliste Datentyp für eine Variable die Option Nach Typen suchen aus. Sie können auf das Menü auch über die Dropdownliste Variablentyp im Variablen-Bereich zugreifen. Das Fenster .NET-Typ suchen und auswählen wird angezeigt.
2. Geben Sie in das Feld Type Name ein Schlüsselwort für die Variable ein, nach der Sie suchen, z. B. Excel. Beachten Sie, dass der Ergebnisbereich aktualisiert wird und alle .NET-Variablentypen anzeigt werden, die Ihr Schlüsselwort enthalten.

3. Wählen Sie einen und klicken Sie auf OK (OK). Eine neue Variable mit dem ausgewählten Typ wird erstellt und im Panel Variables angezeigt.

   
   

   

   
   
   Hinweis: Hinweis: Nachdem Sie diesen Variablentyp aus dem Fenster .NET-Typ suchen und auswählen (Browse and Select a .Net Type) zum ersten Mal verwendet haben, wird dieser in der Dropdown-Liste Variablentyp (Variable Type) im Panel Variablen (Variables) angezeigt.

Variablen und Argumente, die zu proprietären Studio- oder Robot-Assemblys gehören, sind ausgeblendet. Workflows, die sich auf Typen solcher Assemblys beziehen, dürften zur Ausführungszeit nicht betroffen sein. Wenn Sie einen Typ aus einer anderen Assembly als einer .NET Framework-Assembly verwenden möchten, müssen Sie diesen im Fenster Pakete verwalten als Abhängigkeit zu Ihrem Projekt hinzufügen.

Hinweis: Die Zuweisung eines Gleitkommaliterals (z. B. 10,5) zu einer Variablen oder einem Argument vom Typ float (System.Single) führt beim Ausführen des Workflows zu einem Kompilierungsfehler. Um den Wert erfolgreich zuzuweisen, können Sie entweder:

• Verwenden Sie das Suffix f oder F (1.5f oder 1.5F).
• Verwenden Sie Umwandlungsoperatoren ((float)1.5 für C# oder CSng(1.5) für VB)