Terminalsitzung (Terminal Session)

UiPath.Terminal.Activities.TerminalSession

Beschreibung

A container that connects to a terminal and enables you to perform multiple actions within it.

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Designer-Panel

• Verbindung konfigurieren… – Ermöglicht das Einrichten einer Verbindung. Sobald die Aktivität in den Workflow-Designer gezogen wurde, wird das Fenster Verbindung konfigurieren geöffnet. Wenn sie geschlossen ist, kann sie mit dieser Option wieder geöffnet werden.
• Recorder starten – Sobald eine Verbindung eingerichtet ist, kann die Schaltfläche Recorder starten verwendet werden, um eine Verbindung mit dem Terminal herzustellen und die erforderlichen Aktionen aufzuzeichnen.

Eigenschaften-Panel

Allgemein

• Bei Fehler fortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf „True“ gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers 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 Anbietertyp variieren, der für die 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 Runtime 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.

Verbindungseinstellungen

• 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 – Wird 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:
  • Telnet – Das Telnet-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 – 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.
• Proxy-Typ – Der Protokolltyp, der vom Proxyserver verwendet wird:
  • Keiner (Standard) – Kein Proxy
  • Tunnel – HTTPS-Proxy.
  • SOCKS4
  • SOCKS5
  • SOCKS4A
• Proxy-Host – IP-Adresse oder Hostname des Proxy-Servers.
• Proxy-Port – Die Portnummer, die vom Proxy-Server verwendet wird.
• Proxybenutzer – Der Benutzername, der für die Authentifizierung auf dem Proxyserver verwendet werden soll.
• Proxykennwort – Das Kennwort, das für die Authentifizierung auf dem Proxyserver verwendet werden soll.

Hinweis: Der Direktverbindungsanbieter verwendet eine native DLL-Bibliothek, die nicht von UiPath signiert ist. Die Bibliothek hat den Namen ttermdotnet.dll. Wenn Sie diesen Anbieter verwenden, müssen Sie das Laden und Ausführen dieser Bibliothek zulassen.

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.

Verbindungseinstellungen

• 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 – 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. Aktivitäten auf Feldebene (Get Field, Set Field usw.) funktionieren in diesem Modus.
• 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 diese Funktion deaktiviert. Die Kommunikation erfolgt in diesem Fall über einen Proxy-Prozess, eine andere ausführbare Datei, die Teil des Terminalaktivitätspakets ist. Zur Laufzeit kommuniziert der Proxy-Prozess mit dem UiPath Executor-Prozess über IPC (Interprozesskommunikation). Wenn diese Option aktiviert ist, erfolgt die Kommunikation mit der Terminalemulationssoftware eines Drittanbieters innerhalb des UiPath Executor-Prozesses. Diese Option sollte nur dann aktiviert werden, wenn das ordnungsgemäße Funktionieren des Proxy-Prozesses durch Antiviren-Software oder Sicherheitsrichtlinien der Software verhindert wird.
  Hinweis: Wenn Sie den Parameter In Prozess ausführen auf True ändern, kann dies dazu führen, dass die Terminalsitzung aufgrund von Unterschieden in der Architektur (32-Bit vs. 64-Bit) zwischen dem Drittanbieter-Emulator und dem UiPath Studio-/Executor-Prozess nicht ordnungsgemäß funktioniert. 32-Bit-EHLL-Bibliotheken funktionieren nur in Windows Legacy-Projekten ordnungsgemäß, während 64-Bit-EHLL-Bibliotheken nur in Windows-Projekten ordnungsgemäß funktionieren.

Hinweis: Aufgrund einer Einschränkung in der Spezifikation von EHLLAPIunterstü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. Dies bedeutet, dass die erweiterte EHLL- Option deaktiviert ist und die DLL-Datei, die im EHLL-DLL -Feld aufgeführt ist, eine Version ist, die die Standard-EHLLAPI-Spezifikation implementiert.

Der Attachmate Reflection-Anbieter

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

Nur für Windows-Legacy-Projekte verfügbar.

Verbindungseinstellungen

• 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 der Terminalumgebung
  • Port – Eine Portnummer, unter der die Terminalumgebung 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.

Verbindungseinstellungen

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

Der Reflection for UNIX-Anbieter

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

Verbindungseinstellungen

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

The Reflection for IBM-Anbieter

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

Verbindungseinstellungen

• 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 der Terminalumgebung
  • Port – Eine Portnummer, unter der die Terminalumgebung 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.

Verbindungseinstellungen

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

Verbindungseinstellungen

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