Erstellen Sie Eingabevariablen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer
  • Erstellen Sie die Variablen, die an die Aktivität in übergeben werden sollen Eingaben Formular des Aktivitätendesigners.

    Vorbereitungen

    Sie müssen Ihre Aktivität in benennen Allgemein Formular, bevor Sie mit fortfahren können Eingaben Phase.

    Erforderliche Rollen: Workflow_admin oder activity_Creator

    Hinweis:
    Variablenzeichenfolgen in Eingaben Formular hat eine Beschränkung von 255 Zeichen.

    Prozedur

    1. Klicken Sie auf + Symbol zum Erstellen einer neuen Eingabevariable.

      Der Designer erstellt eine Standardvariable namens Eingabe1 .

      Eingabevariable wird erstellt
    2. Geben Sie Ihren neuen Variablennamen in das Feld ein.
    3. Um den Namen einer Variable oder eines ihrer Attribute zu ändern, doppelklicken Sie auf den Wert, und wählen Sie dann einen neuen Wert aus, oder geben Sie ihn in das angezeigte Feld ein.
    4. Konfigurieren Sie Ihre Variable mithilfe dieser Felder:
      Tabelle : 1. Variablenkonfiguration
      Feld Beschreibung
      Typ Datentyp für diese Variable. Doppelklicken Sie auf das Feld, um die Auswahlliste anzuzeigen. Zusätzlich zu 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 von 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 Markiert eine Eingabevariable als obligatorisch. Als Pflichtfelder markierte Variablen sind Pflichtfelder im Eigenschaftsformular für die Aktivität im Workflow. Mit der Eingabetestfunktion können Sie nach obligatorischen Variablen filtern.
      Standard Standardwert für diese Eingabevariable. Standardwerte werden für Variablen im Eigenschaftenformular für die Aktivität im Workflow vorab ausgefüllt. 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 die Zeile dann an ihre neue Position.

      Wenn Sie eine Zeile auswählen, um sie zu verschieben, ändert sich das Zeigersymbol in ein nach-oben-/nach-unten-Pfeilsymbol ( Pfeilsymbol nach oben/unten).

    6. Klicken Sie zum Löschen einer Variable auf das Löschsymbol ( Symbol „Löschen“) In der Zeile.
    7. Klicken Sie Auf Fahren Sie Fort Um zu weiterzufahren Ausführungsbefehl Phase oder klicken Sie auf Zur Vorverarbeitung wechseln (erweitert) Dient zum Erstellen eines Skripts, das vor der Ausführung der Aktivität ausgeführt wird.

    Ordnen Sie eine Eingabevariable zu

    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 zur Authentifizierung und Abfrage von Daten benötigt. In diesem Beispiel sind Felder für einen Befehl enthalten, der auf dem Ziel ausgeführt werden soll, und der zu verwendende MID-Server, falls erforderlich.

    Prozedur

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

    Der Designer drückt die Variable automatisch in der vom System erforderlichen Syntax aus.

    Eingabevariablen werden zugeordnet

    Konfigurieren Sie den PowerShell-Ausführungsbefehl

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

    Vorbereitungen

    Erstellen Sie die Eingabevariablen, die Sie benötigen, in Eingaben Formular, bevor Sie mit fortfahren können Ausführungsbefehl Phase.

    Erforderliche Rolle: Activity_Creator, Administrator

    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. Weitere Informationen finden Sie unter Testvorlagenausgaben .

    Prozedur

    1. Ziehen Sie Variablen aus der Liste der Eingaben, und legen Sie sie in Befehlsfelder ab.
      Das System formatiert die Variable in der richtigen Syntax für den Befehl.
      Abbildung : 1. PowerShell-Ausführungsbefehl
      PowerShell-Ausführungsbefehl
    2. Füllen Sie die in der Tabelle angezeigten Felder aus.
      Tabelle : 2. PowerShell-Befehlsfelder
      Feld Beschreibung
      Eingabe Eingabevariablengenerator. Erstellen Sie Variablen Bis Karte Zu verfügbaren Feldern.
      Ziel-Host 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:
      • Anwenderdefinierter Powershell-Befehl
      • MID-Server-Skriptdatei
      MID-Server-Skriptdatei Auszuführende MID-Server-Skriptdatei. Dieses Feld ist verfügbar, wenn Skripttyp Ausgewählt ist MID-Server-Skriptdatei .
      Befehl Befehl, den diese Aktivität auf dem Zielhost ausgeführt wird. Dieses Feld ist verfügbar, wenn Skripttyp Ausgewählt ist Anwenderdefinierter Powershell-Befehl . Sie können Eingabevariablen aus dem Variablengenerator per Drag-and-Drop 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 ziehen Wert Feld. Verschlüsselte Eingabevariablen behalten ihre Verschlüsselung unabhängig von den Datentypeinstellungen in diesem Feld bei. Wenn Sie einen Wert eingeben und auswählen Verschlüsselt Datentyp: Ihr Wert wird in diesem Feld als nur-Text angezeigt und nur verschlüsselt, wenn er an die ECC-Warteschlange übergeben wird.
      MID-Service-Account verwenden Erzwingt die Authentifizierung dieser Aktivität auf dem Zielhost nur mit den Anmeldeinformationen des MID-Server-Service-Accounts, ohne andere Anmeldeinformationen zu versuchen. Wenn dieses Kontrollkästchen aktiviert ist, wird Anmeldeinformations-Tag Feld ist nicht verfügbar.
      Anmeldeinformations-Tag Spezifisch Anmeldeinformationsaliasse für Orchestration-Aktivitäten Diese Aktivität muss verwendet werden, um Powershell-Befehle auf dem Host auszuführen. Wenn dieses Feld leer gelassen wird, versucht der MID-Server alle verfügbaren Anmeldeinformationen, bis eine gültige gefunden wird, die mit dem MID-Server-Service-Account endet. Wenn ein Anmeldeinformationsalias definiert ist, versucht der MID-Server nur die Anmeldeinformationen für diesen Alias und nicht den MID-Server-Service-Account. Dieses Feld ist nicht verfügbar, wenn MID-Service-Account verwenden Kontrollkästchen ist aktiviert.
      Erforderliche MID-Serverfähigkeiten MID-Server, der zum Abfragen von Powershell verwendet werden soll, nach Fähigkeiten. Standardmäßig wählt das System einen Powershell-MID-Server aus.
    3. Klicken Sie auf Speichern.
    4. Klicken Sie Auf Fahren Sie Fort Um zu weiterzufahren Ausgaben Phase.

    Eingaben für Testaktivitätsvorlage

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

    Vorbereitungen

    Erstellen Sie Eingabevariablen, und ordnen Sie sie Feldern in zu Ausführungsbefehl Erstellen Sie ein Formular, 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 und nicht die vor- oder Nachverarbeitungsskripts aus. Sie müssen einen Workflow verwenden, um einen vor- oder Nachverarbeitungs-Scritp zu testen. Sie müssen die Aktivität nicht auschecken, um sie zu testen, und Sie können Eingabevariablen aus jeder Phase im Aktivitätendesigner testen, wenn Ihre Aktivität ordnungsgemäß konfiguriert ist. In der Regel wird Ausführungsbefehl Phase ist der Punkt, an dem Ihre Eingaben zum Testen bereit sind.
    Hinweis:
    Wenn Sie die automatische Zuordnung verwenden möchten, müssen Sie Ihre Eingabevariablen testen.

    Prozedur

    1. Klicken Sie Auf Testeingaben .
      Die Liste der Eingabequellvariablen wird angezeigt. Wenn Sie Standardwerte für diese Variablen hinzugefügt haben, werden diese Werte in angezeigt Ersatzwert Spalte. Obligatorische Variablen sind mit einem roten Stern markiert. In diesem Beispiel gibt ein SOAP-Endpunkt einen Wert für eine Aktienangebotsvariable zurück.
      Testwert für Eingabevariable
    2. Filtern Sie die Variablenliste mit diesen Steuerungen:
      • Alle Eingaben : Zeigt alle Eingabevariablen an. Dies ist die Standardansicht.
      • Obligatorische Eingaben : Zeigt nur obligatorische Eingabevariablen an.
      • Eingaben Ohne Standards : Zeigt Eingabevariablen an, denen keine Standardwerte zugewiesen sind.
    3. Setzen Sie die Werte nach Bedarf zurück.
      • Setzen Sie die Standardwerte zurück : Ersetzt alle in diesem Formular festgelegten Testwerte durch die Standardwerte, falls vorhanden.
      • Werte löschen : Löscht alle Werte in der Eingabevariablen-Liste, auch wenn Standardwerte vorhanden sind.
    4. Wenn Ihre Testwerte korrekt konfiguriert sind, klicken Sie auf OK .
      Das System führt die Werte für alle Eingaben aus, die für das angegebene Ziel konfiguriert sind, und gibt die resultierende Nutzlast zurück. Die Schaltflächen im Antwortformular zeigen verschiedene Ansichten der Nutzlast an. Die gesamte Nutzlast wird in angezeigt Rohausgabe Fenster.
      Abbildung : 2. Antwortnutzlast aus Eingabetest
      Antwortnutzlast aus Eingabetest
    5. Dient zum Zuordnen geeigneter Parameterwerte in der Nutzlast zu Variablen in Ausgaben Phase automatisch, wählen Sie eine aus Option für automatische Zuordnung .
    6. Alternativ können Sie auf klicken Speichern Sie zum Analysieren von Regeln Zum Kopieren der gesamten Nutzlast in die Analyseregeln.
      Dadurch können Sie Werte für die Ausgabevariablen direkt aus der Nutzlast manuell auswählen. Mit dieser Aktion wird jede vorherige Nutzlast, die in den Analyseregeln vorhanden war, vollständig überschrieben.
    7. Klicken Sie auf X In der oberen rechten Ecke des Fensters, um es zu schließen.