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 unterstützt eine große Anzahl an Argumenttypen, die sich mit den Variablentypen überschneiden. Daher können Sie Argumente vom Typ generischer Wert, Zeichenfolge, Boolescher Wert, Objekt, Array oder DataTable erstellen und auch nach .NET-Typen suchen, wie es auch mit Variablen möglich ist.

Darüber hinaus haben Argumente bestimmte Richtungen(directions) (Hinein(In), Aus(Out), Hinein/Aus(In/Out), Eigenschaft(Property)), die der Anwendung mitteilen, wohin die in ihnen gespeicherten Informationen gehen sollen.

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.

Bitte berücksichtigen Sie, dass Sie beim Erstellen eine Eingabe-/Ausgabearguments mit einem Eingabewert bei Verwendung in der Aktivität Workflow aufrufen und anschließendem Ändern des Werts in einen Ausgabewert möglicherweise feststellen, dass beim Ausführen des Projekts ein Fehler ausgelöst wird. Dies liegt daran, dass die Aktivität „Workflow aufrufen“ die Werte nicht als Verweis zurückgegeben hat. Verwenden Sie einen globalen Handler in Ihrem Projekt, um Zugriff auf die genauen Werte zu erhalten, die die Argumente innerhalb des aufgerufenen Workflows hatten.

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

Argumente sollten ebenfalls mit Binnenmajuskel geschrieben werden und eine Vorsilbe enthalten, die den Argumenttyp festlegt, wie z. B. in_DefaultTimeout, in_FileName, out_TextResult, io_RetryNumber. Sie können sich unsere Empfehlungen zu den Namenskonventionen für Workflow-Design (Workflow Design Naming Conventions) ansehen.

Ü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 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.

Ü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

Um ein Argument zu entfernen, klicken Sie im Panel Variablen entweder mit der rechten Maustaste auf das Argument und wählen Löschen aus, oder Sie wählen das Argument aus und drücken die Löschtaste.

Um alle Argumente zu entfernen, die nirgendwo in der aktuellen Datei verwendet werden, wählen Sie Nicht-Verwendete entfernen > Argumente im Studio-Menüband aus.