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

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.

Konfigurieren von Argumenteigenschaften

Im Fenster Argumenteigenschaften werden die in Ihrem Projekt verwendeten Argumente und ihre Eigenschaften zentral angezeigt. Nach der Veröffentlichung des Projekts sind diese Informationen in Pipelines von Orchestrator, Assistant und Automation Ops sichtbar.

Zum Konfigurieren von Argumenteigenschaften öffnen Sie den Projekt-Bereich, klicken Sie mit der rechten Maustaste auf eine XAML-Datei, die als Hauptdatei festgelegt oder als Einstiegspunkt für das Projekt markiert ist, und wählen Sie die Option Argumenteigenschaften aus. Sie können die im Fenster aufgeführten Argumente neu anordnen, indem Sie sie per Drag-and-drop im linken Menü verschieben.

Wählen Sie im linken Menü ein Argument aus und geben Sie Folgendes ein:

• Anzeigename – Die Beschriftung, die für das Argument angezeigt wird.
• QuickInfo – QuickInfo, die angezeigt wird, wenn Sie mit der Maus auf das Argument zeigen.
• Erforderlich – Gibt an, ob das Argument erforderlich ist.