Freigeben über


IA-Connect Mainframe (Vorschau)

IA-Connect ist eine RPA-Plattform (Robot Process Automation), die RPA-Funktionen aus der Cloud zu lokalen virtuellen Computern oder über Citrix- oder RdS-Verbindungen (Microsoft Remote Desktop) hinzufügt. Dies ist das Modul zum Automatisieren von 5250- und 3270-Mainframesitzungen mithilfe von Terminalemulationsanwendungen, die die HLLAPI-API unterstützen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Ultima Labs
URL https://www.ultima.com/ultima-labs
Email IAConnect@ultima.com
Connectormetadaten
Herausgeber Ultima Labs
Webseite https://www.ultima.com/ultima-labs
Datenschutzrichtlinie https://www.ultima.com/privacy-policy
Kategorien IT-Vorgänge; Produktivität

IA-Connect ist eine RPA-Plattform (Robot Process Automation), die RPA-Funktionen von Power Automate Cloud Flows zu lokalen virtuellen Computern oder über Citrix- oder RdS-Verbindungen (Microsoft Remote Desktop) hinzufügt. Die IA-Connect Connectors bieten über 650 Aktionen, sodass Sie jede Art von lokaler Anwendung direkt aus einem Power Automate Cloud Flow automatisieren können. Alle IA-Connect Aktionen stehen direkt aus Ihrem Power Automate Cloud Flow zur Verfügung, die eine einfache Integration zwischen Cloud-basierten und lokalen Anwendungen ermöglicht, die Möglichkeit, vorhandene Power Automate-Bedingungen, Schleifen, dynamische Inhalte, Ausdrücke und Ausnahmebehandlung in Ihren RPA-Prozessen zu nutzen. Die Verwendung der IA-Connect Connectors bietet außerdem vollständige Ausführungsverlauf und Auditierbarkeit aus dem Flussausführungsverlauf und entfernt gleichzeitig die Notwendigkeit, eine separate Anwendung/Konsole/Studio für die Entwicklung Ihrer RPA-Prozesse zu haben.

Voraussetzungen

Um einen der IA-Connect Connectors zu verwenden, müssen Sie die IA-Connect Software installieren. Dies ist kostenlos für 30 Tage zu testen, nachdem Sie eine IA-Connect Lizenz benötigen.

Die IA-Connect Software besteht aus zwei Hauptkomponenten:

  • Der IA-Connect Orchestrator, bei dem es sich um eine Azure WebApp handelt, die Sie in Ihrem eigenen Azure-Mandanten hosten würden. Dies behandelt das Routing und die Sicherheit von RPA-Flüssen an einen oder mehrere lokale oder cloudbasierte virtuelle Computer.

  • Der IA-Connect Agent und Director, der auf den virtuellen Computern installiert ist, auf denen die Software, auf die Sie automatisieren möchten, zugänglich ist. Darüber hinaus kann der IA-Connect-Agent innerhalb einer Citrix- oder Microsoft Remote Desktop Services (RDS)-Sitzung ausgeführt werden, in der die RPA-Befehle zur Ausführung in die Remotesitzung übergeben werden. Der IA-Connect Agent kann über eine Netzwerkfreigabe ausgeführt werden und erfordert keine Installation.

Verfügbare IA-Connect Connectors

Die verfügbaren IA-Connect Connectors sind:

  • dynamischer Code IA-Connect
  • IA-Connect Java
  • IA-Connect Mainframe
  • IA-Connect Microsoft Office
  • IA-Connect SAP-GUI
  • IA-Connect-Sitzung
  • IA-Connect UI
  • IA-Connect Webbrowser

So erhalten Sie Anmeldeinformationen

Um Ihre Lizenz zu erhalten und Ihre 30-tägige kostenlose Testversion zu beginnen, übermitteln Sie bitte eine Anfrage auf unserer Website (https://www.ultima.com/IA-Connect/Power-Automate).

Sobald eine Testanfrage eingegangen ist, werden wir Sie über die angegebene E-Mail-Adresse kontaktieren, um die Einrichtung der IA-Connect Software zu unterstützen und Ihnen die Testlizenz zur Verfügung zu stellen. Dies ist eine voll ausgestattete Testversion und ermöglicht es Ihnen, alle 650 Aktionen in allen 8 IA-Connect Connectors innerhalb Ihrer eigenen Umgebung während des Testzeitraums zu testen.

Erste Schritte mit Ihrem Connector

Nachdem Sie eine Testanforderung für IA-Connect eingereicht haben, können Sie eine ZIP-Datei herunterladen, die die IA-Connect Software und Dokumentation enthält, die die Installation und Einrichtung abdeckt. Wir werden Sie auch kontaktieren, um Support und Anleitungen über den Installationsprozess nach Bedarf anzubieten.

Support

Während des Testzeitraums können Sie sich an Ultima Labs (IAConnect@ultima.com) wenden, um Support und Unterstützung zu erhalten.

Beim Kauf IA-Connect Lizenzen erhalten Sie Supporttoken, die für maßgeschneiderte Schulungen oder Support von Ultimas UK Technical Service Centre (TSC) eingelöst werden können.

Bekannte Probleme, häufige Fehler und HÄUFIG gestellte Fragen

Unsere Knowledge Base enthält eine Reihe von Artikeln über bekannte Probleme, häufige Fehler, die bei verwendung der IA-Connect Connectors und häufig gestellten Fragen auftreten können. Dies ist verfügbar https://support.ultima.com/ultimalabs und ein Konto für den Zugriff auf diese Ressourcen wird während der IA-Connect Testversion und beim Kauf einer IA-Connect-Lizenz bereitgestellt.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
API-Schlüssel securestring Der API-Schlüssel für diese API Richtig
IA-Connect Orchestrator-Adresse Schnur Angeben der IA-Connect Orchestrator-Adresse ohne die HTTP(S)-Komponente Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen der Cursorposition der Terminalemulation

Ruft die aktuelle Cursorposition in einer Mainframesitzung ab.

Abrufen des Terminalemulationsoperatorinformationsbereichs (OIA)

Gibt den Operatorinformationsbereich zurück, der vom Terminal-Emulator angezeigt wird. Dies ist die Zeile am unteren Rand des Terminal-Emulatorbildschirms und gibt häufig Statusinformationen an, z. B. ob das System wartet oder sich in einem ungültigen Eingabezustand befindet.

Abrufen des Terminalemulationsverbindungsstatus

Gibt den aktuellen Terminalemulationsverbindungsstatus innerhalb der angegebenen Sitzung zurück.

Abrufen ist die entsperrte Terminalemulationstastatur

Gibt zurück, ob der Terminal-Emulator meldet, dass die Tastatur entsperrt ist. Die Ausgabe dieser Aktion hängt davon ab, wie der spezifische Emulator HLLAPI implementiert hat, und die Ausgabe kann von Emulator zu Emulator variieren.

Festlegen der Cursorposition der Terminalemulation

Legt die aktuelle Cursorposition in einer Mainframesitzung auf die angegebene Position fest.

Festlegen der Terminalemulation HLLAPI DLL

Startet das IA-Connect HLLAPI-Subsystem (IA-HLLAPI) und verbindet es mit der angegebenen Terminal emulator HLLAPI DLL (eine Komponente der Terminalemulationssoftware, die zum Herstellen einer Verbindung mit Mainframesitzungen verwendet wird).

Festlegen des Sitzungsparameters in terminalemulationssitzung

Diese Aktion legt einen erweiterten HLLAPI-Sitzungsparameter fest. Diese Aktion sollte nur verwendet werden, wenn Sie mit den HLLAPI-Sitzungsparametern vertraut sind.

Herstellen einer Verbindung mit der Terminalemulationssitzung

Verbindet alle ausgeführten IA-Connect HLLAPI-Subsystem (IA-HLLAPI) mit der angegebenen verbundenen Mainframe-Sitzungs-ID. Die Sitzungs-ID ist eine ID, die vom Terminalemulator zugewiesen wird, den Sie für Mainframeverbindungen verwenden. Die Mainframesitzung muss ausgeführt werden, bevor Sie eine Verbindung mit dieser Aktion herstellen.

Kennwort an Terminalemulationssitzung an Position senden

Sendet ein Kennwort an eine Mainframesitzung an der angegebenen Cursorposition.

Lesen des Terminalemulationsbildschirms an der Cursorposition

Liest die angegebene Anzahl von Zeichen aus der Mainframe-Sitzung ab der angegebenen Cursorposition.

Lesen von Terminalemulationsbildschirmzeilen

Liest die Bildschirmzeilen aus einer angegebenen Mainframe-Sitzung. Diese Aktion wird häufig verwendet, um größere Datenmengen zu lesen, die dann bei Bedarf gefiltert werden können.

Senden einer Zeichenfolge an die Terminalemulationssitzung an position

Sendet eine Zeichenfolge an eine Mainframesitzung an der angegebenen Cursorposition.

Senden einer Zeichenfolge an Terminalemulationssitzung

Sendet eine Zeichenfolge an eine Mainframesitzung an der aktuellen Cursorposition. Wenn Sie eine Zeichenfolge an eine bestimmte Cursorposition senden möchten, können Sie stattdessen die Aktion "Zeichenfolge an Terminalemulationssitzung an Position senden" verwenden.

Senden eines Kennworts an terminalemulationssitzung

Sendet ein Kennwort an eine Mainframesitzung an der aktuellen Cursorposition. Wenn Sie ein Kennwort an eine bestimmte Cursorposition senden möchten, können Sie stattdessen die Aktion "Kennwort an Terminalemulationssitzung an Position senden" verwenden.

Sitzungsstatus der Abfrageterminalemulation

Gibt Informationen zur verbundenen Mainframesitzung zurück. Einige Terminal-Emulatoren geben möglicherweise keine Werte für alle Ausgaben zurück.

Suchen nach Zeichenfolgen in Terminalemulationssitzung

Sucht nach einer angegebenen Zeichenfolge in der aktuellen Anzeige des Terminalemulators. Wenn die Zeichenfolge gefunden wird, wird die Position und der Index zurückgegeben.

Terminalemulationssitzung zurücksetzen

Setzt die aktuelle Mainframe-Sitzung zurück. Die Aktion trennt IA-Connect Agent von der Sitzung und hebt alle festgelegten Sitzungsparameter zurück. Nach dem Aufrufen dieser Aktion müssen Sie die Verbindung mit der Sitzung erneut herstellen, indem Sie die Aktion "Mit Sitzung verbinden" verwenden, um die Interaktion damit fortzusetzen.

Verbindung mit terminalemulationssitzung trennen

Trennt das ausgeführte IA-Connect HLLAPI-Subsystem (IA-HLLAPI) von einer angegebenen verbundenen Mainframe-Sitzungs-ID. Die Sitzungs-ID ist eine ID, die vom Terminalemulator zugewiesen wird, den Sie für Mainframeverbindungen verwenden.

Verwerfen der Terminalemulation HLLAPI DLL

Beendet alle ausgeführten IA-Connect HLLAPI-Subsystem (IA-HLLAPI).

Warten, bis das Terminalemulationssystem bereit ist

Wartet, bis der Terminal-Emulator meldet, dass das System bereit ist. Die Ausgabe dieser Aktion hängt davon ab, wie der spezifische Emulator HLLAPI implementiert hat, und die Ausgabe kann von Emulator zu Emulator variieren.

Warten, bis die Terminalemulationstastatatur entsperrt wurde

Wartet darauf, dass der Terminal-Emulator meldet, dass die Tastatur entsperrt ist. Die Ausgabe dieser Aktion hängt davon ab, wie der spezifische Emulator HLLAPI implementiert hat, und die Ausgabe kann von Emulator zu Emulator variieren.

Warten auf Zeichenfolge in Terminalemulationssitzung

Wartet auf die Anzeige einer angegebenen Zeichenfolge in der Terminalemulatorsitzung. Diese Aktion kann verwendet werden, wenn Sie zwischen Bildschirmen navigieren, um zu überprüfen, ob Sie sich auf dem richtigen Bildschirm befinden.

Zurücksetzungsschlüssel an Terminalemulationssitzung senden

Sendet einen Rücksetzschlüssel an die Terminalemulatorsitzung. Dadurch werden alle Eingaben zurückgesetzt und ein ungültiger Eingabezustand gelöscht.

Abrufen der Cursorposition der Terminalemulation

Ruft die aktuelle Cursorposition in einer Mainframesitzung ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
Cursorzeilenindex
CursorRowIndex integer

Der aktuelle Cursorzeilenindex.

Cursorspaltenindex
CursorColIndex integer

Der aktuelle Cursorspaltenindex.

Cursorposition
CursorPos integer

Die absolute Cursorposition. Angenommen, eine 24 Zeile um 80 Spaltensitzung, die erste Spalte der ersten Zeile wäre Position 1 und die erste Spalte der zweiten Zeile wäre Position 81.

Abrufen des Terminalemulationsoperatorinformationsbereichs (OIA)

Gibt den Operatorinformationsbereich zurück, der vom Terminal-Emulator angezeigt wird. Dies ist die Zeile am unteren Rand des Terminal-Emulatorbildschirms und gibt häufig Statusinformationen an, z. B. ob das System wartet oder sich in einem ungültigen Eingabezustand befindet.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
OIA-Format
OIAFormat string

Das OIA-Format (Operator Information Area), z. B. PC400.

Systemwarte warten
SystemWait boolean

Gibt "true" zurück, wenn der Terminal-Emulator meldet, dass das System derzeit auf den Abschluss einer Aktion wartet oder wenn dies nicht der Fall ist.

MÜTZEN
CAPS boolean

Gibt "true" zurück, wenn der Terminal-Emulator meldet, dass die FESTSTELLTASTE aktuell gedrückt wird, oder "false", wenn dies nicht der Fall ist.

Umschalttaste
ShiftKey boolean

Gibt true zurück, wenn der Terminal-Emulator meldet, dass die UMSCHALTTASTE zurzeit gedrückt wird, oder false, wenn dies nicht der Fall ist.

Subsystem bereit
SubsystemReady boolean

Gibt true zurück, wenn der Terminal-Emulator meldet, dass das Subsystem bereit ist, oder false, wenn dies nicht der Fall ist.

Einfügemodus
InsertMode boolean

Gibt true zurück, wenn der Terminal-Emulator meldet, dass der Einfügemodus zurzeit aktiviert ist, oder false, wenn dies nicht der Fall ist.

Ungültige Eingabe
InvalidInput boolean

Gibt "true" zurück, wenn der Terminal-Emulator meldet, dass sich die Mainframe-Sitzung derzeit in einem ungültigen Eingabezustand befindet, oder "false", wenn dies nicht der Fall ist.

Eingabetyp
InputType string

Der Eingabetyp der Mainframesitzung. Dies kann entweder APL, Katakana, Alphanumerisch, Hiragana oder Double-Byte sein.

Abrufen des Terminalemulationsverbindungsstatus

Gibt den aktuellen Terminalemulationsverbindungsstatus innerhalb der angegebenen Sitzung zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
Mit Sitzung verbunden
ConnectedToSession boolean

Gibt "true" zurück, wenn Sie mit der angegebenen Sitzungs-ID verbunden sind, oder "false", wenn dies nicht der Fall ist.

System beschäftigt
SystemBusy boolean

Gibt "true" zurück, wenn das Großrechnersystem meldet, dass es aktuell ausgelastet ist, oder "false", wenn dies nicht der Fall ist.

Tastatur gesperrt
KeyboardLocked boolean

Gibt true zurück, wenn die Mainframesitzung meldet, dass die Tastatur momentan gesperrt ist, oder false, wenn dies nicht der Fall ist.

Sitzung, die von einer anderen HLLAPI-Anwendung verwendet wird
SessionInUseByAnotherHLLAPIApplication boolean

Gibt "true" zurück, wenn die Mainframe-Sitzung derzeit von einer anderen HLLAPI-Anwendung verwendet wird, oder "false", wenn dies nicht der Fall ist.

HLLAPI-Thread-ID
HLLAPIThreadID integer

Meldet die HLLAPI-Thread-ID in IA-Connect. Diese Ausgabe dient nur zu Diagnosezwecken.

COM-Thread-ID
COMThreadID integer

Meldet die COM-Thread-ID in IA-Connect. Diese Ausgabe dient nur zu Diagnosezwecken.

Anrufanzahl
CallCount integer

Meldet die Anzahl der HLLAPI-Aktionen, die von IA-Connect in dieser Sitzung ausgeführt werden. Diese Ausgabe dient nur zu Diagnosezwecken.

Abrufen ist die entsperrte Terminalemulationstastatur

Gibt zurück, ob der Terminal-Emulator meldet, dass die Tastatur entsperrt ist. Die Ausgabe dieser Aktion hängt davon ab, wie der spezifische Emulator HLLAPI implementiert hat, und die Ausgabe kann von Emulator zu Emulator variieren.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
Die Tastatur ist entsperrt.
KeyBoardIsUnlocked boolean

Gibt true zurück, wenn der Terminal-Emulator meldet, dass die Tastatur entsperrt ist.

Festlegen der Cursorposition der Terminalemulation

Legt die aktuelle Cursorposition in einer Mainframesitzung auf die angegebene Position fest.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

Cursorzeilenindex
CursorRowIndex True integer

Der Cursorzeilenindex, an dem der Cursor festgelegt werden soll.

Cursorspaltenindex
CursorColIndex True integer

Der Cursorspaltenindex, an dem der Cursor festgelegt werden soll.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen der Terminalemulation HLLAPI DLL

Startet das IA-Connect HLLAPI-Subsystem (IA-HLLAPI) und verbindet es mit der angegebenen Terminal emulator HLLAPI DLL (eine Komponente der Terminalemulationssoftware, die zum Herstellen einer Verbindung mit Mainframesitzungen verwendet wird).

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
HLLAPI DLL-Dateiname
DLLFilename True string

Der vollständige Dateipfad zur HLLAPI-DLL, die vom Emulator bereitgestellt wird.

IA-HLLAPI Dateinamen
IAHLLAPIPath string

Die optionale Position der IA-HLLAPI 32-Bit-COM-DLL, die als COM-Schnittstelle zur angegebenen HLLAPI DLL verwendet wird (nur, wenn die HLLAPI DLL 32Bit ist). Dies ist in der Regel nicht erforderlich, da IA-Connect über eine integrierte HLLAPI-DLL mit dem Namen 'IA-HLLAPI verfügt. DLL, die zum Einrichten der COM-Schnittstelle zur HLLAPI-DLL des Emulators verwendet wird. Standardmäßig extrahiert IA-Connect dies in das Verzeichnis "%TEMP%\IA-Connect" im Profil des Benutzers.

Einstiegspunktname
EntryPointName string

Der Name des DLL-Einstiegspunkts. Dies variiert je nach verwendeter Emulatorsoftware, und wenn sie leer gelassen wird, versuchen IA-Connect die folgenden allgemeinen Einstiegspunkte: hllapi, HLLAPI, HLLAPI32, EHLLAPI, EHLLAPI32.

Erweiterte Schnittstelle
IsEnhancedInterface boolean

Dieser Parameter sollte auf "true" festgelegt werden, wenn die DLL die erweiterte HLLAPI-Schnittstelle verwendet.

Is 64bit HLLAPI DLL
Is64BitHLLAPIDLL boolean

Dieser Parameter sollte auf "true" festgelegt werden, wenn die HLLAPI-DLL, die Sie laden möchten, 64 Bit beträgt.

Verwenden von COM für 64-Bit-HLLAPI-DLL
UseCOMFor64BitHLLAPIDLL boolean

Legen Sie diesen Wert auf "true" fest, wenn die HLLAPI-DLL, die Sie laden möchten, 64 Bit ist und Sie sie über eine out-of-process COM DLLSurrogate ausführen möchten, anstatt direkt (im Arbeitsspeicher) von IA-Connect aufzurufen.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen des Sitzungsparameters in terminalemulationssitzung

Diese Aktion legt einen erweiterten HLLAPI-Sitzungsparameter fest. Diese Aktion sollte nur verwendet werden, wenn Sie mit den HLLAPI-Sitzungsparametern vertraut sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Parameter
Parameter True string

Der festzulegende HLLAPI-Parameter. Mehrere Parameter können durch Kommas oder Leerzeichen getrennt werden.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Herstellen einer Verbindung mit der Terminalemulationssitzung

Verbindet alle ausgeführten IA-Connect HLLAPI-Subsystem (IA-HLLAPI) mit der angegebenen verbundenen Mainframe-Sitzungs-ID. Die Sitzungs-ID ist eine ID, die vom Terminalemulator zugewiesen wird, den Sie für Mainframeverbindungen verwenden. Die Mainframesitzung muss ausgeführt werden, bevor Sie eine Verbindung mit dieser Aktion herstellen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Kennwort an Terminalemulationssitzung an Position senden

Sendet ein Kennwort an eine Mainframesitzung an der angegebenen Cursorposition.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

Cursorzeilenindex
CursorRowIndex True integer

Der aktuelle Cursorzeilenindex.

Cursorspaltenindex
CursorColIndex True integer

Der aktuelle Cursorspaltenindex.

Eingabekennwort
InputPassword True password

Das Kennwort, das eingegeben werden soll. Dies unterstützt einen vollständigen Satz von Tastatursymbolen, z. B. "@E" für die Eingabe.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Lesen des Terminalemulationsbildschirms an der Cursorposition

Liest die angegebene Anzahl von Zeichen aus der Mainframe-Sitzung ab der angegebenen Cursorposition.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

Cursorzeilenindex
CursorRowIndex True integer

Der aktuelle Cursorzeilenindex.

Cursorspaltenindex
CursorColIndex True integer

Der aktuelle Cursorspaltenindex.

Anzahl der zu lesenden Zeichen
ReadScreenLength True integer

Die Anzahl der Zeichen, die aus der Mainframe-Sitzung gelesen werden sollen.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
Bildschirminhalte
ScreenContents string

Der Bildschirminhalt, der aus der Mainframe-Sitzung gelesen wurde.

Lesen von Terminalemulationsbildschirmzeilen

Liest die Bildschirmzeilen aus einer angegebenen Mainframe-Sitzung. Diese Aktion wird häufig verwendet, um größere Datenmengen zu lesen, die dann bei Bedarf gefiltert werden können.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

Startzeilenindex
StartRowIndex True integer

Der Anfangszeilenindex, von dem aus gelesen werden soll.

Index der Endzeile
EndRowIndex True integer

Der Index der Endzeile, an dem das Lesen beendet werden soll.

Anzahl der Zeilen in der Sitzung
NumberOfRowsInSession integer

Die Anzahl der Zeilen, die von der Sitzung angezeigt werden. Bei Festlegung auf 0 fragt IA-Connect die Sitzung ab, um die Anzahl der Zeilen abzurufen.

Anzahl der Spalten in der Sitzung
NumberOfColumnsInSession integer

Die Anzahl der Spalten, die von der Sitzung angezeigt werden. Bei Festlegung auf 0 fragt IA-Connect die Sitzung ab, um die Anzahl der Spalten abzurufen.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
JSON für Bildschirmzeilen
ScreenRowsJSON string

Die Zeilen, die aus der Mainframe-Sitzung gelesen werden, im JSON-Format.

Senden einer Zeichenfolge an die Terminalemulationssitzung an position

Sendet eine Zeichenfolge an eine Mainframesitzung an der angegebenen Cursorposition.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

Cursorzeilenindex
CursorRowIndex True integer

Der aktuelle Cursorzeilenindex.

Cursorspaltenindex
CursorColIndex True integer

Der aktuelle Cursorspaltenindex.

Eingabezeichenfolge
InputString True string

Die Zeichenfolge, die eingegeben werden soll. Dies unterstützt einen vollständigen Satz von Tastatursymbolen, z. B. "@E" für die Eingabe.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Senden einer Zeichenfolge an Terminalemulationssitzung

Sendet eine Zeichenfolge an eine Mainframesitzung an der aktuellen Cursorposition. Wenn Sie eine Zeichenfolge an eine bestimmte Cursorposition senden möchten, können Sie stattdessen die Aktion "Zeichenfolge an Terminalemulationssitzung an Position senden" verwenden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eingabezeichenfolge
InputString True string

Die Zeichenfolge, die eingegeben werden soll. Dies unterstützt einen vollständigen Satz von Tastatursymbolen, z. B. "@E" für die Eingabe.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Senden eines Kennworts an terminalemulationssitzung

Sendet ein Kennwort an eine Mainframesitzung an der aktuellen Cursorposition. Wenn Sie ein Kennwort an eine bestimmte Cursorposition senden möchten, können Sie stattdessen die Aktion "Kennwort an Terminalemulationssitzung an Position senden" verwenden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eingabekennwort
InputPassword True password

Das Kennwort, das eingegeben werden soll. Dies unterstützt einen vollständigen Satz von Tastatursymbolen, z. B. "@E" für die Eingabe.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Sitzungsstatus der Abfrageterminalemulation

Gibt Informationen zur verbundenen Mainframesitzung zurück. Einige Terminal-Emulatoren geben möglicherweise keine Werte für alle Ausgaben zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
Langer Sitzungsname
SessionLongName string

Der lange Name der Mainframesitzung, z. B. SessionA.

Sitzungstyp
SessionType string

Der Mainframe-Sitzungstyp, z. B. 3270 oder 5250.

Anzahl der Zeilen
NumberOfRows integer

Die Anzahl der Zeilen in der Anzeige.

Spaltenanzahl
NumberOfCols integer

Die Anzahl der Spalten in der Anzeige.

Codepage
CodePage integer

Die Codeseite, die die verwendete Zeichencodierung angibt.

Suchen nach Zeichenfolgen in Terminalemulationssitzung

Sucht nach einer angegebenen Zeichenfolge in der aktuellen Anzeige des Terminalemulators. Wenn die Zeichenfolge gefunden wird, wird die Position und der Index zurückgegeben.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

SuchZeichenkette
SearchString True string

Die Zeichenfolge, nach der gesucht werden soll.

Gesamten Bildschirm durchsuchen
SearchEntireScreen boolean

Sollte der gesamte Bildschirm durchsucht werden? Wenn dieser Wert auf "false" festgelegt ist, können die Eingaben "Suchstartzeilenindex" und "Suchstartspaltenindex" verwendet werden, um den Suchbereich einzuschränken.

Such-Startzeilenindex
SearchStartRowIndex integer

Der Zeilenindex, bei dem mit der Suche nach der angegebenen Zeichenfolge begonnen werden soll, beginnend mit 1. Dieser Wert wird nur verwendet, wenn "Gesamte Suche" auf "false" festgelegt ist.

Suchstartspaltenindex
SearchStartColIndex integer

Der Spaltenindex, bei dem die Suche nach der angegebenen Zeichenfolge beginnen soll, beginnend mit 1. Dieser Wert wird nur verwendet, wenn "Gesamte Suche" auf "false" festgelegt ist.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
Zeichenfolge gefunden
StringFound boolean

Gibt true zurück, wenn die angegebene Zeichenfolge gefunden wurde.

Gefundene Zeichenfolgenposition
StringFoundPosition integer

Wenn die Zeichenfolge gefunden wurde, enthält dieser Parameter die absolute Position des ersten Zeichens in der Suchzeichenfolge. Angenommen, eine 24 Zeile um 80 Spaltensitzung würde die Position als 321 zurückgegeben, wenn die Zeichenfolge in der ersten Spalte der fünften Zeile gefunden wurde, da die fünfte Zeile Positionen 321 bis 400 enthalten würde.

Zeichenfolge gefundener Zeilenindex
StringFoundRowIndex integer

Wenn die Zeichenfolge gefunden wurde, enthält dieser Parameter den Zeilenindex des ersten Zeichens in der Suchzeichenfolge.

Zeichenfolge gefundener Spaltenindex
StringFoundColIndex integer

Wenn die Zeichenfolge gefunden wurde, enthält dieser Parameter den Spaltenindex des ersten Zeichens in der Suchzeichenfolge.

Terminalemulationssitzung zurücksetzen

Setzt die aktuelle Mainframe-Sitzung zurück. Die Aktion trennt IA-Connect Agent von der Sitzung und hebt alle festgelegten Sitzungsparameter zurück. Nach dem Aufrufen dieser Aktion müssen Sie die Verbindung mit der Sitzung erneut herstellen, indem Sie die Aktion "Mit Sitzung verbinden" verwenden, um die Interaktion damit fortzusetzen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Verbindung mit terminalemulationssitzung trennen

Trennt das ausgeführte IA-Connect HLLAPI-Subsystem (IA-HLLAPI) von einer angegebenen verbundenen Mainframe-Sitzungs-ID. Die Sitzungs-ID ist eine ID, die vom Terminalemulator zugewiesen wird, den Sie für Mainframeverbindungen verwenden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Verwerfen der Terminalemulation HLLAPI DLL

Beendet alle ausgeführten IA-Connect HLLAPI-Subsystem (IA-HLLAPI).

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Warten, bis das Terminalemulationssystem bereit ist

Wartet, bis der Terminal-Emulator meldet, dass das System bereit ist. Die Ausgabe dieser Aktion hängt davon ab, wie der spezifische Emulator HLLAPI implementiert hat, und die Ausgabe kann von Emulator zu Emulator variieren.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sekunden, die gewartet werden sollen
SecondsToWait True double

Die maximale Anzahl von Sekunden, bis der Terminal-Emulator wartet, um zu melden, dass das System bereit ist.

Delta-Sekunden warten
DeltaSecondsToWait double

Die Anzahl der Sekunden zwischen jeder Abfrage an den Terminal-Emulator, um den Systemstatus zu überprüfen.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
Das System ist bereit
SystemReady boolean

Gibt true zurück, wenn der Terminal-Emulator meldet, dass das System bereit ist.

Warten, bis die Terminalemulationstastatatur entsperrt wurde

Wartet darauf, dass der Terminal-Emulator meldet, dass die Tastatur entsperrt ist. Die Ausgabe dieser Aktion hängt davon ab, wie der spezifische Emulator HLLAPI implementiert hat, und die Ausgabe kann von Emulator zu Emulator variieren.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sekunden, die gewartet werden sollen
SecondsToWait True double

Die maximale Anzahl von Sekunden, bis der Terminal-Emulator wartet, um zu melden, dass die Tastatur entsperrt ist.

Delta-Sekunden warten
DeltaSecondsToWait double

Die Anzahl der Sekunden zwischen jeder Abfrage an den Terminal-Emulator, um den Status der Tastatursperrung zu überprüfen.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
Die Tastatur ist entsperrt.
KeyBoardIsUnlocked boolean

Gibt true zurück, wenn der Terminal-Emulator meldet, dass die Tastatur entsperrt ist.

Warten auf Zeichenfolge in Terminalemulationssitzung

Wartet auf die Anzeige einer angegebenen Zeichenfolge in der Terminalemulatorsitzung. Diese Aktion kann verwendet werden, wenn Sie zwischen Bildschirmen navigieren, um zu überprüfen, ob Sie sich auf dem richtigen Bildschirm befinden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sitzungs-ID
SessionID True string

Die Einzelzeichen-Mainframe-Sitzungs-ID, z. B. A.

SuchZeichenkette
SearchString True string

Die Zeichenfolge, auf die gewartet werden soll.

Gesamten Bildschirm durchsuchen
SearchEntireScreen boolean

Sollte der gesamte Bildschirm durchsucht werden? Wenn dieser Wert auf "false" festgelegt ist, können die Eingaben "Suchstartzeilenindex" und "Suchstartspaltenindex" verwendet werden, um den Suchbereich einzuschränken.

Such-Startzeilenindex
SearchStartRowIndex integer

Der Zeilenindex, bei dem mit der Suche nach der angegebenen Zeichenfolge begonnen werden soll, beginnend mit 1. Dieser Wert wird nur verwendet, wenn "Gesamte Suche" auf "false" festgelegt ist.

Suchstartspaltenindex
SearchStartColIndex integer

Der Spaltenindex, bei dem die Suche nach der angegebenen Zeichenfolge beginnen soll, beginnend mit 1. Dieser Wert wird nur verwendet, wenn "Gesamte Suche" auf "false" festgelegt ist.

Sekunden, die gewartet werden sollen
SecondsToWait True double

Die maximale Anzahl von Sekunden, bis die angegebene Zeichenfolge angezeigt wird.

Delta-Sekunden warten
DeltaSecondsToWait double

Die Anzahl der Sekunden zwischen jeder Suche nach der angegebenen Zeichenfolge.

Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name Pfad Typ Beschreibung
Zeichenfolge gefunden
StringFound boolean

Gibt true zurück, wenn die angegebene Zeichenfolge vor dem maximalen Wartezeitzeitraum gefunden wurde.

Gefundene Zeichenfolgenposition
StringFoundPosition integer

Wenn die Zeichenfolge gefunden wurde, enthält dieser Parameter die absolute Position des ersten Zeichens in der Suchzeichenfolge. Angenommen, eine 24 Zeile um 80 Spaltensitzung würde die Position als 321 zurückgegeben, wenn die Zeichenfolge in der ersten Spalte der fünften Zeile gefunden wurde, da die fünfte Zeile Positionen 321 bis 400 enthalten würde.

Zeichenfolge gefundener Zeilenindex
StringFoundRowIndex integer

Wenn die Zeichenfolge gefunden wurde, enthält dieser Parameter den Zeilenindex des ersten Zeichens in der Suchzeichenfolge.

Zeichenfolge gefundener Spaltenindex
StringFoundColIndex integer

Wenn die Zeichenfolge gefunden wurde, enthält dieser Parameter den Spaltenindex des ersten Zeichens in der Suchzeichenfolge.

Zurücksetzungsschlüssel an Terminalemulationssitzung senden

Sendet einen Rücksetzschlüssel an die Terminalemulatorsitzung. Dadurch werden alle Eingaben zurückgesetzt und ein ungültiger Eingabezustand gelöscht.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Arbeitsablauf
Workflow True string

Fügen Sie hier den folgenden Ausdruck hinzu: workflow()