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 beachten Sie, dass, wenn Sie ein In/Out-Argument mit einem In-Wert in der Invoke Workflow-Aktivität erstellen und den Wert dann in Out ändern, möglicherweise ein Error auftritt, wenn Sie das Projekt ausführen.Dies liegt daran, dass die Aktivität Invoke Workflow die Werte nicht als Referenz zurückgegeben hat. Verwenden Sie einen globalen Handler in Ihrem Projekt, um auf die genauen Werte zuzugreifen, die die Argumente im aufgerufenen Workflow 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

Argumentnamen sollten im oberen CamelCase mit einem Präfix stehen, das die Argumentrichtung angibt, z. B. in_DefaultTimeout, in_FileName, out_TextResult, io_RetryNumber.Weitere Informationen finden Sie in unseren Empfehlungen zu Namenskonventionen für das Workflow-Design. Aktivieren Sie diese, um mehr zu erfahren.

Über den Data Manager

1. Öffnen Sie den Data Manager.
2. Navigieren Sie zum Argumente-Panel,
3. Wählen Sie die Zeile Argument erstellen aus. Ein neues Argument wird erstellt.
   Hinweis:

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

4. Konfigurieren Sie das erstellte Argument:
   • Wählen Sie den Argumentnamen aus, um seinen Namen 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.

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

Entfernen von Argumenten

You can remove arguments from the Data Manager:

1. Öffnen Sie den Data Manager.
2. Navigieren Sie zum Argumente-Panel.
3. 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.