Terminalsitzung (Terminal Session)

UiPath.Terminal.Activities.TerminalSession

Ein Container, der eine Verbindung zu einem Terminal herstellt und Ihnen ermöglicht, mehrere Aktionen darin auszuführen. Sobald die Aktivität in den Workflow-Designer gezogen wurde, wird das Fenster Verbindung konfigurieren geöffnet. Wenn sie geschlossen ist, kann sie mit der Schaltfläche Verbindung konfigurieren... im Textkörper der Aktivität erneut geöffnet werden.

Sobald eine Verbindung eingerichtet ist, kann die Schaltfläche Start Recorder verwendet werden, um eine Verbindung mit dem Terminal herzustellen und die erforderlichen Aktionen aufzuzeichnen. Die Schaltfläche wird im Textkörper der Aktivität platziert.

Eigenschaften

Allgemein

• Fortfahren bei Fehler (Continue On Error) – Gibt an, ob die Automation fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (wahr, falsch). Der Standardwert ist falsch. Als Ergebnis ist das Feld leer und ein Fehler wird ausgegeben; die Ausführung des Projekts wird angehalten. Wenn der Wert auf Wahr gesetzt wird, wird die Ausführung des Projekts unabhängig von Fehlern fortgesetzt.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft Bei Fehler Fortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Neue Sitzung

• Verbindungszeichenfolge – Die Zeichenfolge, die die Verbindungsdetails enthält. Dieses Feld unterstützt nur Strings und String -Variablen.
• Output Connection – Die hergestellte Verbindung, die in einer TerminalSession -Variablen gespeichert wird. Diese Variable kann im Eigenschaftsfeld Bestehende Verbindung an andere Terminal Session -Aktivitäten weitergegeben werden, wenn Sie die bereits hergestellte Verbindung wiederverwenden möchten. Dieses Feld unterstützt nur TerminalSession -Variablen.

Optionen

• DelayMS - Verzögerungszeit (in Millisekunden), bevor die Aktivität mit der Ausführung von Vorgängen beginnt. Der Standardwert ist 1000 Millisekunden (1 Sekunde).
• TimeoutMS – Gibt die Zeit (in Millisekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor ein Fehler ausgegeben wird. Der Standardwert ist 50000 Millisekunden (50 Sekunden).

SSH-Verbindungseigenschaften

• SSH-Kennwort - Das SecureShell-Kennwort, das zum Herstellen einer Verbindung mit dem angegebenen Terminal verwendet wird und in einer SecureString -Variablen gespeichert wird. Dieses Feld unterstützt nur SecureString -Variablen.
• SSH-Benutzername - Der SecureShell-Benutzername, der zum Herstellen einer Verbindung mit dem angegebenen Terminal verwendet wird, gespeichert in einer String -Variablen. Dieses Feld unterstützt nur Zeichenfolgen und String -Variablen.

Vorhandene Verbindung verwenden

• Verbindung schließen ( Close Connection ) - Wenn dieses Auswahlfeld ausgewählt ist, wird die bestehende Verbindung geschlossen, nachdem die Ausführung der Aktivität beendet wurde. Standardmäßig ist dieses Kontrollkästchen aktiviert. Bitte beachten Sie, dass diese Eigenschaft ignoriert wird, wenn die Eigenschaft Output Connectionfestgelegt ist.
• Vorhandene Verbindung – Wenn Sie eine TerminalSession -Variable in diesem Eigenschaftsfeld angeben, wird die in der Variablen gespeicherte Verbindung zum Herstellen einer Verbindung mit einem Terminal verwendet. Dieses Feld unterstützt nur TerminalSession -Variablen.

Das Fenster Verbindung konfigurieren

Das Fenster Verbindung konfigurieren enthält verschiedene Konfigurationsoptionen, die je nach Art des Anbieters variieren, der für die Herstellung der Verbindung mit der Terminalumgebung ausgewählt wurde.

Eigenschaften unabhängig vom ausgewählten Anbieter:

• Clientanwendung anzeigen – Wenn diese Option aktiviert ist, wird während der Ausführung eine Ansicht des Terminalbildschirms angezeigt.

Der Direktverbindungsanbieter

Der Direktverbindungsanbieter ist ein interner UiPath-Anbieter, der keine Terminalemulationssoftware von Drittanbietern auf der Robotermaschine benötigt. Die Emulation wird vom Roboter zur Laufzeit durchgeführt.

Konfigurationseigenschaften:

• Adresse - IP-Adresse oder Hostname des Terminalumgebungssystems.
• Port - Eine Portnummer, unter der das Terminalumgebungssystem Verbindungen akzeptiert.

• Typ (Type) - Der Typ der benötigten Terminalemulation:

  • TN3270 – Wird häufig von Systemen der IBM Z-Serie verwendet
  • TN5250 – Häufig von Systemen der IBM I-Serie (AS-400) verwendet
  • VT – DEC VT-kompatible Terminals
  • HP-Serie – HP-spezifische Terminalemulation
  • Tandem – Terminalemulation von Tandemsystemen
  • Wyse - Terminalemulation der Wyse-Serie
  • ANSI – Terminalemulation basierend auf der ANSI-Spezifikation
  • Scope ANSI - Erweiterung der ANSI-Spezifikation, die von SCO Unix-Systemen verwendet wird

• Protocol (Protokoll) - Das zu verwendende Kommunikationsprotokoll für die Verbindung:

  • Anmelden ( Telnet ) - Das Anmelde-Protokoll
  • SSH - Das SSH-Protokoll, das von den meisten Unix-/Linux-Systemen verwendet wird
  • HPVT – HP-spezifisches Protokoll, das in Verbindung mit der Terminalemulation der HP-Serie verwendet wird
• Terminalmodus - Die spezielle Variante der Terminalemulation. Der hier verfügbare Wert hängt vom Wert ab, der im Feld Typ gewählt wurde.
• Codierung ( Encoding ) - Die verwendete Codeseite des Terminalumgebungssystems. Der Standardwert ist IBM037 für die Terminals der IBM-Familie und ASCII für andere Terminaltypen.
• SSL/TLS aktivieren ( Enable SSL/TLS ) - Wird in Verbindung mit demTelnet-Protokoll verwendet, um anzugeben, dass das Terminalumgebungssystem eine verschlüsselte SSL- oder TLS-Verbindung verwendet.
• LUName (LUName ) - Der Name der logischen Einheit, der mit den Terminaltypen der IBM-Familie verwendet wird.
• Antwort – Eine Textnachricht, die an das Hostsystem gesendet wird, wenn das Terminal das Steuerzeichen ENQ empfängt. Die Nachricht kann die Eingabetaste enthalten, die im Zeichenfolgenwert als ^M codiert ist. Diese Konfigurationsoption ist nur verfügbar, wenn der ausgewählte Terminaltyp VT ist.

Der IBM EHLLAPI-Anbieter

Der IBM EHLLAPI- Anbieter funktioniert mit jeder Terminalemulationssoftware von Drittanbietern, die die EHLL-API implementiert. Die Details zur Implementierung der EHLL-API finden Sie in der Dokumentation zur Terminalemulatorsoftware des Drittanbieters.

Hinweis: Die Terminalemulationssoftware muss gestartet und verbunden werden, bevor Sie versuchen, eine Verbindung über die EHLLAPI herzustellen.

Konfigurationseigenschaften:

• EHLL dll - Der Pfad zu dem DLL, das zum Implementieren der EHLLAPI in der Terminal-Emulator-Software von Drittanbietern verwendet wird.
• EHLL-Funktion – Der Name der Einstiegspunktfunktion in der EHLL-DLL. Normalerweise „hllapi“.
• EHLL-Sitzung - Der Name der Sitzung, wie er in der Terminalemulationssoftware angezeigt wird. In der Regel „A“, aber bei der gleichzeitigen Verwendung mehrerer Sitzungen kann der Wert variieren.
• EHLL-Codierung - Die Codierung, die von der Terminalemulationssoftware für die jeweilige Verbindung verwendet wird.
• EHLL erweitert – Wird verwendet, um anzugeben, ob der Terminalemulator des Drittanbieters die Standardversion oder die erweiterte Version der EHLL-API implementiert.
• Codierung ( Encoding ) - Die verwendete Codeseite des Terminalumgebungssystems. Der Standardwert ist IBM037 für die Terminals der IBM-Familie und ASCII für andere Terminaltypen.
• Standardmodus – Ein Modus, der die Verarbeitung auf Feldebene deaktiviert, um eine bessere Leistung zu erzielen. Beachten Sie, dass Aktivitäten auf Feldebene (Get Field, Set Field usw.) in diesem Modus nicht funktionieren.
• In Prozess ausführen – Steuert die Art und Weise, wie die Kommunikation mit der Terminalemulation eines Drittanbieters über die EHLL-API erfolgt. Standardmäßig ist dies deaktiviert . In diesem Fall erfolgt die Kommunikation über einen Proxy-Prozess, eine andere ausführbare Datei, die Teil des Terminalaktivitätspakets ist. Zur Laufzeit kommuniziert der Proxyprozess mit dem UiPath Executor-Prozess über IPC (Inter-Prozess-Kommunikation). Wenn diese Option aktiviert ist, erfolgt die Kommunikation mit der Terminalemulationssoftware des Drittanbieters innerhalb des UiPath Executor-Prozesses. Diese Option sollte nur aktiviert werden, wenn das ordnungsgemäße Funktionieren des Proxyprozesses durch Antivirensoftware oder Software-Sicherheitsrichtlinien verhindert wird.

Hinweis: Aufgrund einer Einschränkung in der Spezifikation von EHLLAPI unterstützt die erweiterte Version von EHLLAPI nicht die Arbeit mit mehreren EHLLAPI-Sitzungen, wenn die Option In Prozess ausführen aktiviert ist. Nur die Standardimplementierung von EHLLAPI unterstützt ein solches Szenario. Das bedeutet, dass die erweiterte Option EHLL deaktiviert ist und die im Feld EHLL -DLL aufgeführte DLL-Datei eine Version ist, die die EHLLAPI-Standardspezifikation implementiert.

Der Attachmate Reflection-Anbieter

Der Attachmate Reflection- Anbieter funktioniert mit dem Attachmate Reflection-Terminalemulator.

Konfigurationseigenschaften:

• An vorhandene Sitzung anhängen – In diesem Modus wird erwartet, dass der Terminalemulator bereits gestartet und verbunden ist. In diesem Fall wird kein Konfigurationsprofil verwendet.
• Ein vorhandenes Profil verwenden – In diesem Modus muss der Pfad zu einem Konfigurationsprofil angegeben werden. Der Terminalemulator wird automatisch gestartet.

• Adresse manuell angeben – In diesem Modus wird kein Konfigurationsprofil verwendet. Die Konfigurationseigenschaften müssen manuell angegeben werden:

  • Adresse - IP-Adresse oder Hostname des Terminalumgebungssystems
  • Port - Eine Portnummer, unter der das Terminalumgebungssystem Verbindungen akzeptiert

  • Typ (Type) - Der Typ der benötigten Terminalemulation:

    • TN3270
    • TN5250
    • VT

Der Attachmate Extra-Anbieter

Der Attachmate Extra-Anbieter funktioniert mit dem Attachmate Extra! Terminal-Emulator.

Konfigurationseigenschaften:

• Ein vorhandenes Profil verwenden – Ein Pfad zu einem Konfigurationsprofil muss angegeben werden. Der Terminalemulator wird automatisch gestartet.

Der Reflection for UNIX-Anbieter

Der Reflection for UNIX-Anbieter funktioniert mit dem Reflection for Unix-Terminalemulator.

Konfigurationseigenschaften:

• Ein vorhandenes Profil verwenden – Ein Pfad zu einem Konfigurationsprofil muss angegeben werden. Der Terminalemulator wird automatisch gestartet.

The Reflection for IBM-Anbieter

Der Reflection for IBM-Anbieter funktioniert mit dem Reflection for IBM-Terminalemulator.

Konfigurationseigenschaften:

• Ein vorhandenes Profil verwenden – In diesem Modus muss der Pfad zu einem Konfigurationsprofil angegeben werden. Der Terminalemulator wird automatisch gestartet.

• Adresse manuell angeben – In diesem Modus wird kein Konfigurationsprofil verwendet. Die Konfigurationseigenschaften müssen manuell angegeben werden:

  • Adresse - IP-Adresse oder Hostname des Terminalumgebungssystems
  • Port - Eine Portnummer, unter der das Terminalumgebungssystem Verbindungen akzeptiert

  • Typ (Type) - Der Typ der benötigten Terminalemulation:

    • TN3270
    • TN5250
    • VT

Der Rocket BlueZone-Anbieter

Der Rocket BlueZone-Anbieter funktioniert mit dem Rocket BlueZone-Terminalemulator.

Konfigurationseigenschaften:

• Ein vorhandenes Profil verwenden – In diesem Modus muss der Pfad zu einem Konfigurationsprofil angegeben werden. Der Terminalemulator wird automatisch gestartet.

• Adresse manuell angeben – In diesem Modus wird kein Konfigurationsprofil verwendet. Die Konfigurationseigenschaften müssen manuell angegeben werden:

  • Adresse - IP-Adresse oder Hostname des Terminalumgebungssystems.
  • Port - Eine Portnummer, unter der das Terminalumgebungssystem Verbindungen akzeptiert.

  • Typ (Type) - Der Typ der benötigten Terminalemulation:

    • TN3270
    • TN5250
    • VT

Der IBM Personal Communications-Anbieter

Der IBM Personal Communications-Provider arbeitet mit dem IBM Personal Communications-Terminalemulator.

Konfigurationseigenschaften:

• Ein vorhandenes Profil verwenden – In diesem Modus muss der Pfad zu einem Konfigurationsprofil angegeben werden. Der Terminalemulator wird automatisch gestartet.

Bewährte Methoden für Terminalaktivitäten

• Stellen Sie bei Verwendung der Eigenschaften „Output Connection“/„Vorhandene Verbindung “ sicher, dass Sie die Terminalsitzung schließen, wenn sie im Workflow/Prozess nicht mehr benötigt wird. Wenn die Terminalsitzung geöffnet bleibt, kann dies nachteilige Auswirkungen auf die Leistung und die Ausführung anderer Terminalsitzungen haben. Um eine zuvor gespeicherte Terminalsitzung ordnungsgemäß zu schließen, fügen Sie Ihrem Workflow eine neue Terminalsitzung (mit einem leeren Textkörper) mit den folgenden Eigenschaften hinzu:
  • Verbindung schließen: True
  • Vorhandene Verbindung: Die Variable TerminalSession, die die gespeicherte Sitzung enthält
• Vermeiden Sie die Verwendung der Eigenschaften „Ausgabeverbindung“ /„Vorhandene Verbindung “ in Verbindung mit dem IBM EHLLAPI- Anbieter. Diese Optionen werden verwendet, um die Persistenz der Verbindung zwischen Workflows sicherzustellen. Da die Verbindung bereits im Terminalemulator beibehalten wird, ist keine zweite Persistenzebene erforderlich. Außerdem müssen Sie dadurch die zusätzlichen Schritte zum Schließen der Verbindung nicht ausführen, wie oben beschrieben.
• Vermeiden Sie die Verwendung von Terminalsitzungen, die in anderen Terminalsitzungen verschachtelt sind. Dies gilt auch für die indirekte Verschachtelung, wie z. B. das Aufrufen eines Workflows aus einem Terminalsitzungstext, der eine Terminalsitzung mit derselben Verbindung enthält, oder das Aufrufen einer Bibliotheksfunktion, die eine Terminalsitzung mit derselben Verbindung enthält.
• Vermeiden Sie die Verwendung von feldbasierten Aktivitäten wie Get Field/Set Field. Es ist nicht immer klar, ob oder wie der Bildschirm in Felder aufgeteilt ist, was zu Verwirrung führen kann. Außerdem können verschiedene Anbieter denselben Bildschirm auf unterschiedliche Weise aufteilen, da unterschiedliche APIs verwendet werden. Es ist sicherer, Methoden zu verwenden, die denen von Menschen ähneln, z. B. Kombinationen aus Cursor bewegen ( Move Cursor ) oder Senden der Strg-Taste = Tab ( Send Control Key = Tab) gefolgt von den Aktivitäten „ Senden Tasten “ zum Senden von Daten an den Bildschirm. Zum Abrufen von Daten aus dem Bildschirm verwenden Sie Get Screen Range oder Get Text At Position.
• Verwenden Sie die Aktivität Bildschirmtext warten , um sicherzustellen, dass der richtige Bildschirm geladen wurde, bevor Sie Vorgänge darauf ausführen
• Um tabellarische Daten aus Bildschirmen im DataTable-Format zu extrahieren, verwenden Sie die Aktivität „ Get Screen Area “ für den Teil des Bildschirms, der die Tabelle enthält, und verwenden Sie die Ausgabe dieser Aktivität als Eingabe für die Aktivität „ Generate Data Table “ aus dem UiPath.System.Activities-Paket .