Verwalten von Argumenten

Argumente werden zum Übergeben von Daten von einem Projekt zum anderen verwendet. Global gesehen ähneln sie Variablen, da sie Daten dynamisch speichern und übergeben. Variablen übergeben Daten zwischen Aktivitäten, und Argumente übergeben Daten zwischen Automatisierungen. Infolgedessen ermöglichen sie Ihnen immer wieder die Wiederverwendung bestimmter Projekte.

Studio supports a large number of argument types, which coincide with the types of variables. Therefore, you can create Generic Value, String, Boolean, Object, Array, or DataTable arguments and you can also browse for .Net types, just as you do in the case of variables.

Additionally, arguments have specific directions (In, Out, In/Out, Property) that tell the application where the information stored in them is supposed to go.

Wichtig:

• Wenn es eine Variable und ein Argument mit demselben Namen gibt, wird zur Laufzeit standardmäßig immer die Variable verwendet.
• Bei der Übergabe komplexer In-Argumente (z. B. vom Typ System.Data.DataTable) an eine nicht isolierte Aktivität Invoke Workflow File wird wie bei der Übergabe eines Verweises vorgegangen, d. h. alle Änderungen an dem Objekt innerhalb des aufgerufenen Workflows ändern das Objekt im Haupt-Workflow. Integrierte Argumenttypen (z. B. Boolesch) werden immer als Werte übergeben.

Please take into consideration that if you create an In/Out argument with an In value when used in the Invoke Workflow activity, and then change the value to Out, you may notice that an error is thrown when executing the project. This is because the Invoke Workflow activity did not return the values by reference. Use a Global Handler in your project to get access to the exact values the arguments had inside the invoked workflow.

Diese Argumente können schließlich zur Integration in andere Tools in Ihrem Unternehmen verwendet werden, wenn diese ebenfalls in Orchestrator bereitgestellt werden. Das bedeutet, dass jeder von Ihnen erstellte Prozess nun Eingabeparameter über die Orchestrator-API oder -Benutzeroberfläche erhalten sowie eine Ausgabe an alle oben genannten Ressourcen zurückgeben kann. Weitere Informationen finden Sie hier.

Erstellen von Argumenten

Argument names should be in upper CamelCase with a prefix stating the argument direction, such as in_DefaultTimeout, in_FileName, out_TextResult, io_RetryNumber. You can check out our Workflow Design Naming Conventions recommendations for more details.

Über den Data Manager

1. Öffnen Sie den Data Manager und wählen Sie Neu > Neues Argument aus.
2. Ein neues Element mit dem Standardnamen argument wird unter „Argumente“ hinzugefügt.
3. Konfigurieren Sie das erstellte Argument:
   • Klicken Sie auf den Namen des Arguments, um ihn zu bearbeiten.
   • Erweitern Sie das Argument mit dem Pfeil auf der linken Seite und konfigurieren Sie die Richtung, den Datentyp, ob es Erforderlich sein soll und optional den Standardwert.

Im Data Manager können Sie Argumente auch massenweise erstellen, indem Sie mit der rechten Maustaste auf den Argumente-Knoten klicken und dann Massenerstellung von Argumenten auswählen. Ein neues Fenster wird angezeigt, in dem Sie mehrere Argumente hinzufügen und konfigurieren können.

Über den Text einer Aktivität

1. Ziehen Sie eine Aktivität aus dem Panel Aktivitäten in das Panel Designer. Klicken Sie mit der rechten Maustaste auf ein Feld, und wählen Sie im Kontextmenü Eingabeargument erstellen oder Ausgabeargument erstellen aus. Alternativ können Sie Strg+M oder Strg+Umschalt+M drücken. Das Feld Arg. festlegen wird angezeigt.
2. Tragen Sie den Namen ein, und drücken Sie die Eingabetaste. Das Argument wird erstellt und im Feld angezeigt. Prüfen Sie seine Richtung und seinen Typ im Panel Argumente.

Aus Ausdrücken

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

1. Wählen Sie einen Teil des Ausdrucks aus, und drücken Sie Strg+M oder Strg+Umschalt+M. Das Feld Arg. festlegen wird angezeigt.

2. Geben Sie den Namen ein und drücken Sie die Eingabetaste. Das Argument wird erstellt. Überprüfen Sie dessen Typ und Richtung im Argumente-Panel.

   

Auf diese Weise erstellte Argumente erhalten automatisch den Typ gemäß der Aktivität. Wenn Sie beispielsweise ein Argument im Data TableFeld einer Aktivität „Write Range“ erstellen, wird der Typ des Arguments auf DataTable.Wenn Sie ein Argument im TextFeld einer Aktivität „Write Line“ erstellen, wird der Typ des Arguments auf String.

Über das Panel „Eigenschaften“

1. Klicken Sie im Panel Eigenschaften einer beliebigen Aktivität mit der rechten Maustaste auf ein Feld, das bearbeitet werden kann, und wählen Sie im Kontextmenü die Option Eingabeargument erstellen oder Ausgabeargument erstellen aus. Alternativ können Sie Strg+M oder Strg+Umschalt+M drücken. Das Feld Arg. festlegen wird angezeigt.
2. Tragen Sie den Namen ein, und drücken Sie die Eingabetaste. Das Argument wird erstellt und im Feld angezeigt. Prüfen Sie seine Richtung und seinen Typ im Panel Argumente.

Der Argumenttyp wird abhängig von der ausgewählten Eigenschaft automatisch generiert.

Aus dem Panel „Argumente“

1. Klicken Sie im Panel Designer (Designer) auf Argumente (Arguments). Das Panel Argumente (Arguments) wird angezeigt.

2. Klicken Sie auf die Zeile Argument erstellen, und geben Sie den Namen ein. Ein neues Argument wird erstellt.

   Hinweis:

   Standardmäßig haben alle Argumente den Typ String und eine (Hinein)In-Richtung.

Entfernen von Argumenten

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 Argumente und wählen Sie dann Löschen aus. Alternativ können Sie sie auswählen und die Entf-Taste drücken.

Aus dem Panel „Argumente“

1. Öffnen Sie den Argumente-Bereich.

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

   

Entfernen aller nicht verwendeten Argumente

Um alle Argumente zu entfernen, die nirgendwo in der aktuellen Datei verwendet werden, wählen Sie Nicht verwendete entfernen > Argumente im Studio-Menüband und dann Ja aus, wenn Sie zur Bestätigung aufgefordert werden.