Eingabevariablen erstellen

Erstellen Sie im Formular Eingaben des Aktivitätendesigners die Variablen, die an die Aktivität übergeben werden sollen.

Vorbereitungen

Sie müssen Ihrer Aktivität im Formular Allgemein einen Namen geben, bevor Sie mit der Stufe Eingaben fortfahren können.

Erforderliche Rollen: workflow_admin oder activity_creator

Hinweis:

Variablenzeichenfolgen im Formular Eingaben haben eine Höchstgrenze von 255 Zeichen.

Prozedur

1. Klicken Sie auf das +-Symbol, um eine neue Eingabevariable zu erstellen.

   Der Designer erstellt eine Standardvariable namens Eingabe1.

   

2. Geben Sie den Namen Ihrer neuen Variable in das Feld ein.
3. Um den Namen einer Variablen oder eines ihrer Attribute zu ändern, doppelklicken Sie auf den Wert und wählen dann einen neuen Wert aus dem angezeigten Feld aus.
4. Konfigurieren Sie Ihre Variable mit diesen Feldern:

   Tabelle : 1. Variablenkonfiguration

   Feld	Beschreibung
   Typ	Datentyp für diese Variable. Doppelklicken Sie auf das Feld, um die Auswahlliste anzuzeigen. Neben den üblichen Datentypen können Sie Eingabe-Arrays erstellen und einzelne Variablen verschlüsseln, die vertrauliche Daten enthalten. Verschlüsselte Variablen werden an die ECC-Warteschlange übergeben und dann vom MID-Server entschlüsselt, wenn sie auf dem Zielhost ausgeführt werden. Vertrauliche Daten, die bei der Ausführung dieser Variablen auf dem Host zurückgegeben werden, können dann über verschlüsselte Ausgabevariablen an eine andere Aktivität übergeben werden.
   Obligatorisch	Kennzeichnet eine Eingabevariable als obligatorisch. Als obligatorisch gekennzeichnete Variablen sind Pflichtfelder im Eigenschaftenformular für die Aktivität im Workflow. Mit der Funktion zum Testen von Eingaben können Sie nach obligatorischen Variablen filtern.
   Standard	Standardwert für diese Eingabevariable. Variablen im Eigenschaftenformular für die Aktivität im Workflow werden mit Standardwerten vorbelegt. Sie können diesen Wert überschreiben, wenn Sie die Variablen testen.

5. Um die Variablenliste neu anzuordnen, wählen Sie eine Zeile aus und ziehen sie an die neue Position.

   Wenn Sie eine Zeile zum Verschieben auswählen, ändert sich das Zeigersymbol in ein Aufwärts-/Abwärtspfeilsymbol ().

6. Um eine Variable zu löschen, klicken Sie in der Zeile auf das Löschsymbol ().
7. Klicken Sie auf Fortsetzen, um mit der Stufe Ausführungsbefehl fortzufahren, oder klicken Sie auf Zur Vorverarbeitung wechseln (Erweitert), um ein Skript zu erstellen, das vor der Aktivität ausgeführt wird.

Eingabevariablen zuordnen

Nachdem Sie die Eingabevariablen erstellt haben, ordnen Sie sie den Feldern im Formular „Ausführungsbefehl“ zu.

Vorbereitungen

Erforderliche Rolle: activity_admin, activity_creator

Warum und wann dieser Vorgang ausgeführt wird

Diese Felder enthalten Werte, die der Zielhost oder Endpunkt für die Authentifizierung und Abfrage von Daten benötigt. In diesem Beispiel sind Felder für einen Befehl zur Ausführung auf dem Ziel und den zu verwendenden MID-Server enthalten, falls einer erforderlich ist.

Prozedur

Um eine Variable zuzuordnen, ziehen Sie sie in das entsprechende Feld.

Der Designer drückt die Variable automatisch in der vom System benötigten Syntax aus.

PowerShell-Ausführungsbefehle konfigurieren

Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration auf dem Windows-Zielcomputer ausführt.

Vorbereitungen

Erstellen Sie im Formular Eingaben die benötigten Eingabevariablen, bevor Sie mit der Stufe Ausführungsbefehl fortfahren.

Erforderliche Rolle: activity_creator, admin

Hinweis:

Sie können die PowerShell-Verbindung zwischen dem MID-Server und dem Zielcomputer testen, ohne die Aktivität in einem Workflow-Kontext ausführen zu müssen. Details dazu finden Sie unter Vorlagenausgaben testen.

Prozedur

1. Ziehen Sie Variablen aus der Liste der Eingaben, und legen Sie sie in den Befehlsfeldern ab.
   Das System formatiert die Variablen in der richtigen Syntax für den Befehl.

   Abbildung : 1. PowerShell-Ausführungsbefehl

   

2. Füllen Sie die in der Tabelle angegebenen Felder aus.

   Tabelle : 2. PowerShell-Befehlsfelder

   Feld	Beschreibung
   Eingabe	Generator für Eingabevariablen. Erstellen Sie Variablen, um sie verfügbaren Feldern zuzuordnen.
   Zielhost	Hostname oder IP-Adresse des Zielservers für diese PowerShell-Aktivität
   Skripttyp	Typ des Skripts, das auf dem PowerShell-Host ausgeführt werden soll. Verfügbare Optionen sind: Benutzerdefinierter PowerShell-Befehl MID-Serverskriptdatei
   MID-Serverskriptdatei	Die auszuführende MID-Server-Skriptdatei. Dieses Feld ist verfügbar, wenn der Skripttyp MID-Server-Skriptdatei ausgewählt ist.
   Befehl	Befehl, der diese Aktivität auf dem Zielhost ausführt. Dieses Feld ist verfügbar, wenn der Skripttyp Benutzerdefinierter PowerShell-Befehl ausgewählt ist. Sie können Eingabevariablen aus dem Variablen-Generator in dieses Feld ziehen, um Ihren Befehl zu erstellen.
   PowerShell-Variablen	Name-Wert-Paare, die mit PowerShell an den Host übergeben werden sollen. Sie können diese Variablen manuell erstellen oder Eingabevariablen in das Feld Wert ziehen. Verschlüsselte Eingabevariablen behalten ihre Verschlüsselung bei, unabhängig von den Datentypeinstellungen in diesem Feld. Wenn Sie einen Wert eingeben und den Datentyp Verschlüsselt auswählen, wird der Wert in diesem Feld in Klartext angezeigt und erst verschlüsselt, wenn er an die ECC-Warteschlange übergeben wird.
   MID-Serviceaccount verwenden	Erzwingt, dass diese Aktivität auf dem Zielhost nur mit den Anmeldeinformationen des MID-Server-Serviceaccounts authentifiziert wird, ohne dass andere Anmeldeinformationen verwendet werden. Wenn diese Checkbox aktiviert ist, wird das Feld Anmelde-Tag ausgeblendet.
   Anmelde-Tag	Spezifische Aliasse für Anmeldeinformationen für Orchestration-Aktivitäten, die diese Aktivität zum Ausführen von PowerShell-Befehlen auf dem Host verwenden muss. Wenn dieses Feld leer gelassen wird, versucht der MID-Server alle verfügbaren Anmeldeinformationen, bis er eine gültige findet, und endet mit dem MID-Server-Servicekonto. Wenn ein Alias ​​für Anmeldeinformationen definiert ist, verwendet der MID-Server nur die Anmeldeinformationen für diesen Alias ​​und probiert den MID-Server-Serviceaccount nicht aus. Dieses Feld ist nicht verfügbar, wenn die Checkbox MID-Serviceaccount verwenden aktiviert ist.
   Erforderliche MID-Server-Fähigkeiten	Für die Abfrage von PowerShell zu verwendender MID-Server nach Fähigkeiten. Standardmäßig wählt das System einen PowerShell-MID-Server aus.

3. Klicken Sie auf Speichern.
4. Klicken Sie auf Fortsetzen, um mit der Stufe Ausgaben fortzufahren.

Eingaben für Aktivitätsvorlagen testen

Sie können die Eingabeparameter einer benutzerdefinierten Aktivität während der Entwicklung testen, ohne die Aktivität in einem Workflow-Kontext ausführen zu müssen.

Vorbereitungen

Erstellen Sie Eingabevariablen, und ordnen Sie sie den Feldern im Formular Ausführungsbefehl zu, oder geben Sie tatsächliche Werte für diese Felder an.

Erforderliche Rolle: web_service_admin, activity_admin, activity_creator

Warum und wann dieser Vorgang ausgeführt wird

Ein Eingabetest führt nur die Eingabeparameter für einen Endpunkt aus und nicht die Vorverarbeitungs- oder Nachverarbeitungsskripts. Sie müssen einen Workflow verwenden, um ein Vorverarbeitungs- oder Nachverarbeitungsskript zu testen. Die Aktivität muss zum Testen nicht ausgecheckt werden, und Sie können Eingabevariablen aus jeder Stufe des Aktivitätendesigners testen, wenn die Aktivität ordnungsgemäß konfiguriert ist. Normalerweise ist die Stufe Ausführungsbefehl der Punkt, an dem Eingaben zum Testen bereit sind.

Hinweis:

Wenn Sie die automatische Zuordnung verwenden möchten, müssen Sie die Eingabevariablen testen.

Prozedur

1. Klicken Sie auf Testeingaben.
   Die Liste der Variablen der Eingabequelle wird angezeigt. Wenn Sie für diese Variablen Standardwerte hinzugefügt haben, werden diese Werte in der Spalte Wert ersetzen angezeigt. Pflichtvariablen sind mit einem roten Stern gekennzeichnet. In diesem Beispiel gibt ein SOAP-Endpunkt einen Wert für eine Aktienkursvariable zurück.

   

2. Filtern Sie die Variablenliste mit diesen Steuerelementen:
   • Alle Eingaben: Zeigt alle Eingabevariablen an. Dies ist die Standardansicht.
   • Pflichteingaben: Zeigt nur obligatorische Eingabevariablen an
   • Eingaben ohne Standardwerte: Zeigt Eingabevariablen an, denen keine Standardwerte zugewiesen wurden
3. Setzen Sie die Werte nach Bedarf zurück.
   • Standardwerte zurücksetzen: Ersetzt alle in diesem Formular festgelegten Testwerte durch die Standardwerte, sofern vorhanden
   • Werte löschen: Löscht alle Werte in der Eingabevariablenliste, auch wenn Standardwerte vorhanden sind
4. Wenn die Testwerte korrekt konfiguriert sind, klicken Sie auf OK.
   Das System führt die Werte für alle für das angegebene Ziel konfigurierten Eingaben aus und gibt das resultierende Payload zurück. Über die Schaltflächen im Antwortformular können verschiedene Ansichten des Payload angezeigt werden. Das gesamte Payload wird im Fenster Rohausgabe angezeigt.

   Abbildung : 2. Antwort-Payload aus dem Eingabetest

   

5. Um geeignete Parameterwerte im Payload automatisch Variablen der Stufe Ausgaben zuzuordnen, wählen Sie eine Option für die automatische Zuordnung aus.
6. Alternativ können Sie auf Zum Analysieren von Regeln speichern klicken, um das gesamte Payload in die Analyseregeln zu kopieren.
   Auf diese Weise können Sie manuell Werte für die Ausgabevariablen direkt aus dem Payload auswählen. Diese Aktion überschreibt alle vorherigen, in den Analyseregeln vorhandenen Payload-Daten vollständig.
7. Klicken Sie auf das X in der rechten oberen Ecke des Fensters, um es zu schließen.