IA-Connect-Sitzung

IA-Connect ist eine Roboter-Prozessautomatisierungs-RPA-Plattform, die RPA-Funktionen aus der Cloud zu lokalen virtuellen Computern oder über Citrix- oder Microsoft Remote Desktop -RDS-Verbindungen hinzufügt. Dies ist das Modul zum Automatisieren der Umgebung, Sitzung, Dateiverwaltung und Konfiguration von IA-Connect.

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 Business
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 800 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 JML
IA-Connect Mainframe
IA-Connect Microsoft Office
IA-Connect SAP-GUI
IA-Connect-Sitzung
IA-Connect Benutzeroberfläche
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 800 Aktionen in allen 9 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

Ablauf als abgeschlossen markieren	Markieren Sie einen Flow als abgeschlossen, der den IA-Connect Orchestrator informiert, dass der zugewiesene Arbeitscomputer jetzt für die Verarbeitung anderer Flüsse verfügbar ist.
Abmelden der Remotesitzung	Protokolliert die Remotesitzung, in der der IA-Connect Agent ausgeführt wird.
Abrufen aller IA-Connect Befehlsstatistiken	Gibt alle aktuell gespeicherten Statistiken zurück, für die der IA-Connect Agent in der aktuellen Sitzung ausgeführt wurde.
Abrufen aller Orchestrator-Automatisierungsaufgaben	Ruft alle Orchestrator-Automatisierungsaufgaben ab, die den Filtern entsprechen.
Abrufen der Arbeitsablaufnutzung von Orchestrator	Gibt die Tägliche Nutzung des Arbeitsflusses von der IA-Connect Orchestrator zurück. Wird für Berichterstellungszwecke verwendet. Sie können optional einen oder mehrere Filter verwenden, um die zurückgegebenen Ergebnisse einzuschränken.
Abrufen der id des übergeordneten Prozesses	Gibt die Prozess-ID des übergeordneten Prozesses für jeden ausgeführten Prozess in der IA-Connect Agent-Benutzersitzung zurück, die über die angegebene Prozess-ID verfügt.
Abrufen der Prozessanzahl nach Name	Gibt die Anzahl der ausgeführten Prozesse in der IA-Connect Agent-Benutzersitzung zurück, die den angegebenen Prozessnamen aufweist.
Abrufen des Anmeldeverlaufs von Orchestrator	Gibt den IA-Connect Orchestrator-Anmeldeverlauf für Berichtszwecke zurück. Sie können optional einen oder mehrere Filter verwenden, um die zurückgegebenen Ergebnisse einzuschränken.
Abrufen des Clienthosts	Gibt den Hostnamen des Clients zurück, auf dem der IA-Connect Director ausgeführt wird.
Abrufen des gespeicherten Kennworts	Ruft ein zuvor generiertes oder gespeichertes Kennwort ab.
Abrufen des Orchestrator-Automatisierungsaufgabenvorgangs	Ruft eine bestimmte Orchestrator-Automatisierungsaufgabe ab, indem die eindeutige Vorgangs-ID bereitgestellt wird.
Abrufen des Status eines Agent-Threads	Ruft den Status eines Agent-Threads ab und ruft optional die Threadausgabedaten ab. Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können.
Abrufen des Verfügbarkeitsstatus von Orchestrator-Workern	Rufen Sie den grundlegenden Orchestrator-Status ab. Dies kann verwendet werden, um zu bestätigen, dass der Orchestrator verfügbar ist und reagiert.
Abrufen generischer Anmeldeinformationen von Orchestrator	Ruft eine generische Anmeldeinformation ab, die im IA-Connect Orchestrator gespeichert wurde. Anmeldeinformationen können Benutzernamen, Kennwörter, Hostnamen, URLs und andere generische Daten enthalten.
Abrufen IA-Connect Agent-Informationen	Gibt die Eigenschaften des IA-Connect-Agents zurück, einschließlich der Versionsnummer und des Pfads zur ausführbaren Datei des Agents.
Abrufen IA-Connect Agent-Protokollebene	Gibt die aktuelle IA-Connect Agent-Protokollierungsebene zurück. Die Protokollierungsebenen werden von 1 bis 4 festgelegt, wobei 1 die niedrigste Ebene und 4 die höchste ist.
Abrufen IA-Connect Agent-Sitzungsinformationen	Gibt Informationen zur IA-Connect Agent-Benutzersitzung zurück.
Abrufen IA-Connect Agentprotokolls	Gibt das aktuelle IA-Connect Agent-Protokoll zurück, entweder als Datei oder durch Lesen des Inhalts und Zurückgeben in einer Ausgabevariable.
Abrufen IA-Connect Agentprozessanzahl	Gibt die Anzahl der Instanzen des aktuell in der Benutzersitzung ausgeführten IA-Connect Agent zurück. Dies ist nützlich, um zu erkennen, ob mehrere Instanzen des IA-Connect-Agents ausgeführt werden.
Abrufen IA-Connect aktuellen Lizenzstatus des Agents	Gibt zurück, ob der IA-Connect Agent derzeit lizenziert ist und ob die Eigenschaften der Lizenz lizenziert sind.
Abrufen IA-Connect Director-Betriebszeit	Gibt die Betriebszeit dieses IA-Connect Director in Sekunden zurück (d. h. wie lange der Director ausgeführt wurde).
Abrufen IA-Connect Director-Informationen	Gibt die Eigenschaften des IA-Connect Director zurück, einschließlich der Versionsnummer und des Pfads zur ausführbaren Datei des Director.
Abrufen IA-Connect Directorprotokollebene	Gibt die aktuelle IA-Connect Director-Protokollierungsebene zurück. Die Protokollierungsebenen werden von 0 bis 4 festgelegt. 0 ist deaktiviert. 1 ist die niedrigste Protokollebene (und der Standardwert). 4 ist die höchste Protokollebene.
Abrufen IA-Connect globalen Koordinatenkonfiguration des Agents	Ruft die Konfiguration der konfiguration des globalen Koordinatensystems des IA-Connect Agent ab, das verwendet wird, um Elementpositionen (z. B. während der Mausüberprüfung) anzuzeigen und Mauspositionen zu berechnen (z. B. beim Ausführen globaler Mausaktionen).
Abrufen IA-Connect status des nächsten Hops	Meldet den Status des nächsten Hop Director für den Agent, der diesen Befehl empfängt. Wenn der nächste Hop aktiviert ist, leitet dieser Agent Befehle an den nächsten Hop weiter (über den Next-Hop Director). Wenn der nächste Hop deaktiviert ist, verarbeitet dieser Agent Befehle selbst (standard).
Abrufen verfügbarer IA-Connect Sitzungen	Ruft eine Liste der IA-Connect Directorsitzungen ab (verfügbare Verbindungen zu Sitzungen, in denen der IA-Connect Agent ausgeführt wird, z. B. lokal, Microsoft RDP oder Citrix ICA).
Abrufen von Arbeitsverfügbarkeitsstatistiken von Orchestrator	Gibt Arbeitsverfügbarkeitsstatistiken aus dem IA-Connect Orchestrator zurück. Wird für Berichterstellungszwecke verwendet. Sie können optional einen oder mehrere Filter verwenden, um die zurückgegebenen Ergebnisse einzuschränken.
Abrufen von CSV-Text als Sammlung	Gibt eine CSV-Datei auf dem Computer zurück, auf dem der IA-Connect Agent als Sammlung (Tabelle) ausgeführt wird. Erfordert nur lesegeschützten Zugriff auf CSV-Datei.
Abrufen von Dateien	Gibt eine Liste von Dateien in einem Ordner (übereinstimmend mit einer CSV-Liste von Mustern) auf dem Computer zurück, auf dem der IA-Connect Agent ausgeführt wird.
Abrufen von Dateiinhalten als Base64	Rufen Sie den Inhalt der angegebenen Datei im Base64-Format ab, ein Format, das für die Übertragung über DIE API geeignet ist und problemlos wieder in das ursprüngliche Text- oder Binärformat konvertiert wird.
Abrufen von Dateisicherheitsberechtigungen	Gibt eine Liste der Berechtigungen zurück, die derzeit auf einer Datei auf dem Computer festgelegt sind, auf der der IA-Connect Agent ausgeführt wird.
Abrufen von Director-Clienttyp und Sitzungsinformationen	Gibt die Details der lokalen oder Remotesitzung zurück, die vom Director der Ebene 1 behandelt wird.
Abrufen von Flow-Statistiken von Orchestrator	Gibt eine Liste der Flow-Statistiken aus dem IA-Connect Orchestrator zurück. Wird für Berichterstellungszwecke verwendet. Sie können optional einen oder mehrere Filter verwenden, um die zurückgegebenen Ergebnisse einzuschränken.
Abrufen von Ordnern	Gibt alle Unterordner innerhalb eines angegebenen Ordners auf dem Computer zurück, auf dem der IA-Connect Agent ausgeführt wird.
Abrufen von Ordnersicherheitsberechtigungen	Gibt eine Liste der Berechtigungen zurück, die derzeit auf einem Ordner auf dem Computer festgelegt sind, auf dem der IA-Connect Agent ausgeführt wird.
Abrufen von Prozess-ID-Befehlszeileneigenschaften	Gibt die Befehlszeileneigenschaften für jeden ausgeführten Prozess in der IA-Connect Agent-Benutzersitzung zurück, die die angegebene Prozess-ID aufweist.
Abrufen von Prozessen	Gibt eine Liste der ausgeführten Prozesse in der IA-Connect Agent-Benutzersitzung zurück. Dies kann optional durch Angabe eines Prozessnamens gefiltert werden.
Abrufen von speicherplatzfreiem Speicherplatz	Gibt den freien Speicherplatz für einen angegebenen Datenträger auf dem Computer zurück, auf dem der IA-Connect Agent ausgeführt wird.
Abrufen von Umgebungsinformationen	Gibt Informationen zur Umgebung zurück, in der die IA-Connect Agent-Benutzersitzung ausgeführt wird.
Agent-Threads abrufen	Gibt eine Liste der Agent-Threads zurück. Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können. Sobald ein Agent-Thread abgeschlossen und seine Daten abgerufen wurden, wird der Agent-Thread gelöscht und wird nicht in der Liste der Threads angezeigt.
Aktivieren der Ordnersicherheitsvererbung	Aktiviert die Sicherheitsvererbung auf einem Ordner auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.
Aktivieren IA-Connect nächsten Hop	Aktiviert den nächsten Hop, der alle zukünftigen Befehle weiterleitet, die an den IA-Connect Agent weitergeleitet werden, der in der nächsten Hopsitzung ausgeführt wird.
Aktuelle Mauskoordinate abrufen	Ruft die aktuelle Mauscursorposition in der IA-Connect Agent-Benutzersitzung mithilfe der setcursorpos-API ab.
Alle anderen IA-Connect Agents töten	Kills any other instances of the IA-Connect Agent that are currently running in the user session. Dadurch wird sichergestellt, dass nur eine Instanz des IA-Connect Agent ausgeführt wird.
An die Ebene 1 IA-Connect Sitzung anfügen	Fügt an die IA-Connect Director-Sitzung des Director an, der die SOAP- und /oder REST-Nachrichten empfängt. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden.
An die letzte IA-Connect-Sitzung anfügen	Fügt an die IA-Connect Director-Sitzung an, die zuletzt verbunden ist (optional eines angegebenen Typs). Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden.
An IA-Connect Sitzung mithilfe des Namens anfügen	Fügt die angegebene IA-Connect Directorsitzung anhand des Namens an. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden.
An IA-Connect Sitzung nach Index anfügen	Fügt die angegebene IA-Connect Director-Sitzung nach Index an (z. B. an die erste Citrix ICA-Sitzung anfügen). Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden.
Anhalten der Sitzung am Leben	Hält die IA-Connect Agent-Benutzersitzung aktiv.
Ausführen alternativer IA-Connect Agent, der vom Director gesendet wurde	Führt einen alternativen IA-Connect Agent (z. B. eine spätere Version) aus, indem der alternative Agent aus dem IA-Connect Director hochgeladen und dann die alternative Agent-ausführbare Datei geladen wird.
Ausführen alternativer IA-Connect-Agents	Führt einen alternativen IA-Connect Agent (z. B. eine höhere Version) aus, indem die ausführbare Datei des Agents von einem Dateispeicherort geladen wird.
Ausführen des generischen IA-Connect-Agents-Befehls	Führt einen generischen IA-Connect Agent-Befehl aus, der Argumente als JSON übergibt und Ausgabedaten als JSON zurückgibt. Wird zum Ausführen von Agent-Befehlen verwendet, wenn der Director und inspector ältere Versionen als der Agent sind und daher den Befehl nicht verstehen.
Ausführen des PowerShell-Prozesses	Starten Sie einen PowerShell-Prozess, indem Sie entweder ein vorhandenes Skript auf dem Datenträger ausführen oder den Inhalt des auszuführenden Skripts bereitstellen. Erwägen Sie stattdessen die Verwendung der Aktion "PowerShell-Skript ausführen", die viel leistungsstärker ist, und stellt eine Datentabelle der Ausgabe aus dem PowerShell-Skript bereit. Verwenden Sie diese Aktion, wenn Ihr PowerShell-Skript als Standardausgabe- oder Standardfehler ausgegeben wird (z. B. Write-Host verwendet, anstatt eine Tabelle zurückzugeben), PowerShell 7 erfordert oder Active Directory-Aktionen als alternativer Benutzer ausführt, und CredSSP über WinRM ist nicht verfügbar.
Ausführungsprozess	Starten Sie einen Prozess, einen Befehl oder eine Anwendung.
Ausnahme auslösen	Lösen Sie eine Ausnahme mit der angegebenen Nachricht aus, wenn die Eingabe ausnahme nicht leer ist. Dies ist hilfreich, um eine Ausnahmemeldung in Ihrem Fluss (HTTP 400) auszulösen, die dann von einer Fehlerbehandlungsphase abgefangen wird, wenn eine frühere Aktion einen Fehler hatte. Diese Ausnahme wird nicht in den Statistiken zur Ausführung IA-Connect Orchestrator-Ablaufs aufgezeichnet.
Berechtigung zur Datei hinzufügen	Fügt eine Berechtigung zu einer Datei auf dem Computer hinzu, auf dem der IA-Connect Agent ausgeführt wird.
Besitzer für Ordner festlegen	Legt den Besitzer auf einem Ordner auf dem Computer fest, auf dem der IA-Connect Agent ausgeführt wird.
Bildschirmauflösung abrufen	Gibt die Bildschirmauflösung der IA-Connect Agent-Benutzersitzung zurück. Für den lokalen Agent IA-Connect, der auf einem physischen Desktop oder Laptop ausgeführt wird, enthält dies Informationen zu allen Anzeigegeräten und deren Skalierung. Auf einem virtuellen Computer wird in der Regel nur eine Anzeige gemeldet, es sei denn, der virtuelle Computer wurde so konfiguriert, dass mehrere Displays vorhanden sind (ungewöhnlich). In einer Remotesitzung wird in der Regel nur eine Anzeige gemeldet, auch wenn diese Anzeige mehrere lokale Displays umfasst, da Remotesitzungen in der Regel eine einzelne virtuelle Anzeige erstellen.
Computerdomäne abrufen	Gibt die Domäne des Computers zurück, auf dem die IA-Connect Agent-Benutzersitzung ausgeführt wird.
Computername abrufen	Gibt den Namen des Computers zurück, auf dem die IA-Connect Agent-Benutzersitzung ausgeführt wird.
Datei in Zwischenablage kopieren	Kopiert die angegebene lokale Datei in die Zwischenablage in der IA-Connect Agent-Benutzersitzung.
Datei kopieren	Kopiert eine Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.
Datei löschen	Löscht eine Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.
Datei verschieben	Verschiebt eine Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.
Datei vom Client auf den Server kopieren	Kopiert eine Datei vom lokalen Computer (unter Ausführung des IA-Connect Director) auf den Remotecomputer (unter Ausführung des IA-Connect-Agents).
Dateien löschen	Löscht Dateien in einem angegebenen Ordner, der einem Muster auf dem Computer entspricht, auf dem der IA-Connect Agent ausgeführt wird.
Dateigröße abrufen	Gibt die Größe (in Byte) einer Datei auf dem Computer zurück, auf der der IA-Connect Agent ausgeführt wird.
Doppelklick mit der Maus	Doppelklicken Sie in der IA-Connect Agent-Benutzersitzung auf die linke Maustaste.
Doppelklick mit der Maus an der Koordinate	Doppelklicken Sie in der IA-Connect Agent-Benutzersitzung an den angegebenen Koordinaten auf die linke Maustaste. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.
Entsperren der Sitzung	Entsperrt die Sitzung, in der der IA-Connect Agent ausgeführt wird. Dazu muss der IA-Connect Entsperrungsanbieter für Anmeldeinformationen auf dem Computer installiert werden, auf dem die Sitzung gehostet wird, da nur ein Anmeldeinformationsanbieter einen Computer entsperren kann.
EntZIP-Datei	Entzippt eine Datei, die mithilfe der ZIP-Komprimierung komprimiert wurde.
Ersetzen von Variablendaten in der INI-Datei	Aktualisiert eine einzelne Variable in einer INI-Datei.
Erstellen eines einmal geheimen Orchestrator-Schlüssels	Ein einmaliges Geheimnis bietet eine Möglichkeit, einen geheimen Schlüssel zu speichern, der einmal über eine nichtguessierbare eindeutige URL abgerufen werden kann. Dies wird in der Regel verwendet, um geheime Schlüssel mit einem Drittanbieter zu teilen. Sie können einen einmaligen Geheimschlüssel mithilfe der Orchestrator-Benutzeroberfläche, der REST-API oder aus Ihrem Flow erstellen.
Fehlermeldung "Fehlgeschlagene Aktion abrufen" aus Ablaufergebnis-JSON	Deserialisiert die JSON-Ausgabe eines oder mehrerer Flow result()-Ausdrücke und ruft die erste gefundene Fehlermeldung aus einer fehlgeschlagenen Aktion ab. Die Fehlermeldung kann in der JSON in einer Vielzahl von Formaten gespeichert werden. Diese Aktion verarbeitet bekannte Formate und gibt die erste gefundene Fehlermeldung zurück.
Festlegen der Mausbewegungsmethode	Legt die aktuelle Mausbewegungsmethode entweder auf mouse_event oder setcursorpos fest.
Festlegen der Mauscursorposition	Legt den Mauszeiger in der IA-Connect Agent-Benutzersitzung auf die angegebene Position fest. Die setcursorpos-API wird verwendet, um die Maus zu verschieben, unabhängig von der ausgewählten aktiven Mausbewegungs-API.
Festlegen der Zwischenablage	Legt den Inhalt der Zwischenablage in der IA-Connect Agent-Benutzersitzung fest.
Festlegen des Besitzers für die Datei	Legt den Besitzer auf einer Datei auf dem Computer fest, auf dem der IA-Connect Agent ausgeführt wird.
Festlegen des Mausmultiplikators	Legt den globalen Mausmultiplikator in der IA-Connect Agent-Benutzersitzung fest. Dies kann während der Entwicklung hilfreich sein, wenn Probleme mit der Remotedesktopskalierung auftreten.
Festlegen des Orchestrator-Arbeitswartungsmodus	Setzen Sie einen IA-Connect Worker, der im IA-Connect Orchestrator definiert ist, in den Wartungsmodus ein (sodass den Arbeitsflüssen nicht zugewiesen werden), oder nehmen Sie einen Mitarbeiter aus dem Wartungsmodus.
Festlegen einer Sprachausgabe	Aktiviert oder deaktiviert die Sprachausgabe in der IA-Connect Agent-Benutzersitzung.
Festlegen IA-Connect Agent-Befehlstimeout	Legt das Befehlstimeout fest, das der IA-Connect Agent für jeden ausgeführten Befehl verwendet.
Festlegen IA-Connect Agent-GUI-Deckkraft	Legt die Deckkraft des IA-Connect Agent von 1 (sichtbar) auf 0 (transparent) fest.
Festlegen IA-Connect Agent-GUI ganz oben	Legt den IA-Connect Agent ganz oben fest. Dies bedeutet, dass der IA-Connect Agent immer auf dem Bildschirm sichtbar ist und nicht hinter anderen Anwendungsfenstern ausgeblendet werden kann.
Festlegen IA-Connect Agent-GUI-Position	Legt die Position des IA-Connect Agent-GUI auf den angegebenen Speicherort fest.
Festlegen IA-Connect Agent-Protokollebene	Legt die IA-Connect Agent-Protokollierungsebene auf den angegebenen Wert fest (1 ist die niedrigste Ebene und 4 ist die höchste).
Festlegen IA-Connect Director-Protokollebene	Legt die IA-Connect Director-Protokollierungsebene auf den angegebenen Wert fest. Die Protokollierungsebenen werden von 0 bis 4 festgelegt. 0 ist deaktiviert. 1 ist die niedrigste Protokollebene (und der Standardwert). 4 ist die höchste Protokollebene.
Festlegen IA-Connect globalen Koordinatenkonfiguration des Agents	Konfiguriert das globale Koordinatensystem IA-Connect Agent, das verwendet wird, um Elementpositionen (z. B. während der Mausüberprüfung) anzuzeigen und Mauspositionen zu berechnen (z. B. beim Ausführen von globalen Mausaktionen). Die Standardwerte stellen die neueste Funktionalität bereit, aber Sie können diese Aktion verwenden, um auf das Verhalten in früheren Versionen des Agents zurückgesetzt zu werden oder anzugeben, dass eine API ein anderes Koordinatensystem verwendet.
Festlegen IA-Connect Lizenzschlüssels	Lizenziert den IA-Connect Agent mit einem Lizenzschlüssel. Hierbei kann es sich um eine Lizenzzeichenfolge oder den Anzeigenamen einer lizenz im IA-Connect Orchestrator handelt.
Festlegen von Ausgabedaten für Orchestrator-Automatisierungsaufgaben	Legt die Ausgabedaten für eine Orchestrator-Automatisierungsaufgabe fest. Wird häufig verwendet, wenn Sie eine Aufgabe abgeschlossen haben und Ausgabedaten bereitstellen möchten, die vom Prozess erfasst werden sollen, der die Aufgabe erstellt hat.
Festlegen von IA-Connect Lizenzcode	Lädt eine Agent-Domänenlizenz im alten Stil (7.0 und 7.1) in den IA-Connect Agent hoch.
Get mouse move method	Ruft die aktuelle Mausbewegungsmethode ab.
Gibt die Datei an	Meldet wahr oder falsch, ob eine Datei auf dem Computer vorhanden ist, auf dem der IA-Connect Agent ausgeführt wird.
Gibt IA-Connect Sitzung anhand des Namens an	Gibt zurück, wenn die angegebene IA-Connect Director-Sitzung vorhanden ist. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden. Der Name wird aus einer früheren Aktion "Anfügen" bekannt sein.
Hinzufügen einer Datei zu ZIP	ZIPs einer Datei (speichert die Datei in einem Komprimierungsarchiv).
Hinzufügen einer neuen Orchestrator-Automatisierungsaufgabe	Fügen Sie eine neue Orchestrator-Automatisierungsaufgabe zu einer Warteschlange hinzu, die über einen Flow überwacht werden kann. Aufgaben können entweder sofort ausgeführt werden oder zur späteren Ausführung zurückgestellt werden.
Hinzufügen einer Notiz zu einer Orchestrator-Automatisierungsaufgabe	Fügt einer ausgewählten Orchestrator-Automatisierungsaufgabe eine Notiz hinzu. Diese Notiz wird an das Quellsystem übergeben, das mit dieser Automatisierungsaufgabe verknüpft ist (z. B. ServiceNow), und wird am häufigsten verwendet, um Details zu einem Ticket hinzuzufügen. Wenn die Orchestrator-Automatisierungsaufgabe nicht mit einer Quelle verknüpft ist, wird eine Ausnahme ausgelöst.
Hinzufügen eines neuen Orchestrator-Automatisierungsvorgangs	Fügen Sie eine neue Orchestrator-Automatisierungsaufgabe hinzu, und erhalten Sie eine Vorgangs-ID. Ein bestimmter Vorgangsname ist erforderlich, wenn die Aufgabe von einem externen Poller oder einem Orchestrator-Trigger verarbeitet wird. Diese Aktion unterscheidet sich von "Neue Orchestrator-Automatisierungsaufgabe hinzufügen" (TasksAddNewTaskOperation) darin, dass sie mit einer unguessablen Vorgangs-ID reagiert, anstelle einer erratenden Vorgangs-ID.
Hinzufügen eines neuen Orchestrator-Vorgangs für verzögerte Aufgaben	Fügen Sie eine neue verzögerte Orchestrator-Aufgabe hinzu, und erhalten Sie eine Vorgangs-ID. Der Vorgang wird in Zukunft auf einen bestimmten Zeitpunkt zurückgestellt. Verwenden Sie diese Aktion, um einen Vorgang vorübergehend für einen bestimmten Zeitraum anzusetzen (z. B. wenn Sie auf etwas warten). Ein bestimmter Vorgangsname ist erforderlich, wenn die Aufgabe von einem externen Poller oder einem Orchestrator-Trigger verarbeitet wird. Diese Aktion unterscheidet sich von "Neue Orchestrator-verzögerte Aufgabe hinzufügen" (TasksAddNewDeferral), da sie mit einer unguessablen Vorgangs-ID antwortet, anstelle einer erratenen Vorgangs-ID.
Hinzufügen von Berechtigungen zu Ordnern	Fügt einen Ordner auf dem Computer, in dem der IA-Connect Agent ausgeführt wird, eine Berechtigung hinzu.
HTTP-Datei herunterladen	Lädt eine Datei auf den Computer herunter, auf dem der IA-Connect Agent mit HTTP(S) ausgeführt wird.
IA-Connect Agent-GUI an den Anfang bringen	Bringt die IA-Connect Agent-GUI in den Vordergrund, sodass sie auf dem Bildschirm sichtbar ist.
IA-Connect nächsten Hop deaktivieren	Deaktiviert den nächsten Hop, sodass alle zukünftigen Befehle vom Agent verarbeitet werden, der sie empfängt (im Gegensatz zur Weiterleitung an den nächsten Hop-Agent).
Identität aus Dateisicherheit entfernen	Entfernt eine Identität (z. B. Benutzer, Gruppe oder Computer) aus den Sicherheitsberechtigungen für eine Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.
Identität aus Ordnersicherheit entfernen	Entfernt eine Identität (z. B. einen Benutzer, eine Gruppe oder einen Computer) aus den Sicherheitsberechtigungen für einen Ordner auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.
In CSV-Datei schreiben	Erstellt eine CSV-Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird. Die CSV-Datei wird aus einer Auflistung (Tabelle) oder aus einer Tabelle im JSON-Format erstellt.
Ist auf das Verzeichnis zugegriffen werden kann	Gibt zurück, ob auf ein Verzeichnis (Ordner) zugegriffen werden kann und ob Berechtigungen den Zugriff auf das Verzeichnis auf dem Computer einschränken, auf dem der IA-Connect Agent zugreifen kann.
Ist das Verzeichnis vorhanden	Meldet wahr oder falsch, ob ein Verzeichnis (Ordner) auf dem Computer vorhanden ist, auf dem der IA-Connect Agent ausgeführt wird.
Ist die Sprachausgabe aktiviert	Gibt zurück, ob die Sprachausgabe in der IA-Connect Agent-Benutzersitzung aktiviert wurde.
Ist sitzungssperrt	Gibt an, ob die Sitzung, in der der IA-Connect Agent ausgeführt wird, gesperrt ist.
Kalibrieren mouse_event	Kalibriert die mouse_event-Methode, indem sie die Maus um die angegebene Anzahl von Pixeln bewegt und dann die neue Mausposition liest.
Kennwort generieren	Generiert ein Kennwort mit Wörterbuchwörtern, Zahlen, Symbolen, Zeichen, wie in einem Vorlagenformat definiert.
Kennwortschlüssel senden	Sendet globale Tastendrücke an die IA-Connect Agent-Benutzersitzung, insbesondere zum Eingeben eines Kennworts. Dadurch wird ein Benutzer simuliert, der diese Tasten auf der Tastatur drückt. Stellen Sie sicher, dass das Zielfensterelement fokussiert ist, oder dass die Tastendrücke von der falschen Anwendung empfangen werden oder ignoriert werden.
Kennwortzeichenfolge erweitern	Akzeptiert eine Eingabezeichenfolge, die Verweise auf IA-Connect gespeicherte Kennwörter enthält und diese Zeichenfolge mit den durch die gespeicherten Kennwörter ersetzten Verweisen zurückgibt.
Kill IA-Connect session by name	Kills the specified IA-Connect Director session if it exists. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden. Der Name wird aus einer früheren Aktion "Anfügen" bekannt sein.
Kill process ID	Kills a running process in the IA-Connect Agent user session which has the specified process ID. Process IDs are unique so only one process can match the ID. Process IDs are dynamic and are different for every launch of an application.
Kill-Prozess	Beendet alle ausgeführten Prozesse in der IA-Connect Agent-Benutzersitzung, die den angegebenen Prozessnamen hat.
Konfigurieren des nächsten Hops IA-Connect Director	Konfigurieren Sie den Director für den nächsten Hop in einem Double-Hop-Szenario. Dies ist nur erforderlich, wenn die Standardeinstellungen IA-Connect Next-Hop Director nicht geeignet sind.
Konvertieren von Rechteckkoordinaten	Konvertiert eine Rechteckpixelkoordinate von einer virtuellen in eine physische oder physische Koordinate. Wenn Sie einen Punkt konvertieren möchten, legen Sie einfach "Right=Left" und "Bottom=Top" fest. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet. Virtuelle Koordinaten werden skaliert. Wenn die zugrunde liegende Anzeigeskalierung aller Anzeigegeräte 100%beträgt, sind sowohl physische als auch virtuelle Koordinaten identisch.
Lesen des gesamten Texts aus datei	Liest den Textinhalt einer Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.
Lesen von Benutzeranmeldeinformationen	Liest einen Benutzernamen und ein Kennwort aus einer Anmeldeinformation im Profil des Benutzers in der IA-Connect Agent-Sitzung. Anmeldeinformationen können über die Windows-Systemsteuerung angezeigt werden. Sowohl der Benutzername als auch das Kennwort können aus generischen Anmeldeinformationen abgerufen werden, während nur der Benutzername aus einer Windows-Anmeldeinformation abgerufen werden kann.
Letzte Eingabeinformationen abrufen	Ruft die Zeit seit dem Empfang der letzten Benutzereingabe in der IA-Connect Agent-Benutzersitzung ab.
Letzte fehlgeschlagene Aktion aus Orchestrator-Flussstatistiken abrufen	Ruft Details der letzten Aktion ab, die durch den IA-Connect Orchestrator an einen Worker übergeben wurde, wenn diese Aktion fehlgeschlagen war. Diese Aktion wird am häufigsten während der Fehlerbehandlung verwendet.
Linke Maustaste nach oben	Gibt die linke Maustaste in der IA-Connect Agent-Benutzersitzung frei.
Linke Maustaste nach unten	Drückt die linke Maustaste in der IA-Connect Agent-Benutzersitzung (und lässt sie nicht los). Um die Maus loszulassen, verwenden Sie die linke Maustaste nach oben.
Linksklick mit der Maus	Klickt in der IA-Connect Agent-Benutzersitzung auf die linke Maustaste.
Linksklick mit der Maus an der Koordinate	Klickt in der IA-Connect Agent-Benutzersitzung an den angegebenen Koordinaten auf die linke Maustaste. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.
Liste der Drucker abrufen	Gibt eine Liste aller verfügbaren Drucker in der IA-Connect Agent-Sitzung zurück.
Liste der Laufwerke abrufen	Gibt eine Liste der Laufwerke auf dem Computer zurück, auf dem der IA-Connect Agent ausgeführt wird.
Liste der Orchestrator-Mitarbeiter abrufen	Rufen Sie eine Liste der Mitarbeiter ab, die mit dem IA-Connect Orchestrator registriert sind, und deren Livestatus.
Löschen des Kennworts im Agent-Speicher	Löschen Sie ein im Agent-Speicher gespeichertes Kennwort, oder löschen Sie alle gespeicherten Kennwörter des Agents.
Löschen des Orchestrator-Automatisierungsvorgangs	Löschen Sie eine bestimmte Orchestrator-Automatisierungsaufgabe, indem Sie die eindeutige Vorgangs-ID angeben.
Löschen eines Agentthreads	Löscht einen Agent-Thread oder alle Agent-Threads, wenn er noch ausgeführt wird, zuerst den Thread zu töten (beenden, abzubrechen). Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können. Prozesse oder Abläufe, die den Agent-Thread überwachen, erhalten einen Fehler "Agentthread-ID ist nicht vorhanden".
Löscht benutzeranmeldeinformationen	Löscht eine Anmeldeinformation im Profil des Benutzers in der IA-Connect Agent-Sitzung. Anmeldeinformationen können über die Windows-Systemsteuerung angezeigt werden.
Maus an der Koordinate links halten	Hält die linke Maustaste an den angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.
Maus in Koordinate verschieben	Verschiebt die Maus in der IA-Connect Agent-Benutzersitzung zu den angegebenen Pixelkoordinaten. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.
Maus mit mittlerem Halteraum	Hält die mittlere Maustaste in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden.
Maus mit mittlerem Klick	Klickt in der IA-Connect Agent-Benutzersitzung auf die mittlere Maustaste.
Maus mit mittlerem Klick an der Koordinate	Klickt in der IA-Connect Agent-Benutzersitzung an den angegebenen Koordinaten auf die mittlere Maustaste. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.
Maus mit mittlerer Haltetaste an der Koordinate	Hält die mittlere Maustaste an den angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.
Maus nach links halten	Hält die linke Maustaste in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden.
Maus relativ verschieben	Verschiebt die Maus in der IA-Connect Agent-Benutzersitzung um die angegebene Anzahl von Pixeln relativ zur aktuellen Position. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.
Maus Wiggle	Verschiebt die Maus um die angegebene Anzahl von Koordinaten hin und her. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben.
Maus zwischen Koordinaten verschieben	Verschiebt die Maus zwischen zwei angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt. Ein optionaler Jitter wird in der Mausbewegung unterstützt, um es eher wie eine menschliche Handbewegung zu gestalten.
Mausmultiplikator abrufen	Ruft den globalen Mausmultiplikator in der IA-Connect Agent-Benutzersitzung ab. Dies ist standardmäßig auf (1, 1) festgelegt, konnte aber durch die Aktion "Mausmultiplikator festlegen" geändert werden.
Mausrad drehen	Dreht das Mausrad (positive oder negative Notches) in der IA-Connect Agent-Benutzersitzung.
Mauszeiger ziehen zwischen Koordinaten	Führt eine linke Maustaste zwischen den beiden angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung aus. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt. Ein optionaler Jitter wird in der Mausbewegung unterstützt, um es eher wie eine menschliche Handbewegung zu gestalten.
Mittlere Maustaste nach oben	Gibt die mittlere Maustaste in der IA-Connect Agent-Benutzersitzung frei.
Mittlere Maustaste nach unten	Drückt die mittlere Maustaste in der IA-Connect Agent-Benutzersitzung (und lässt sie nicht los). Um die Maus loszulassen, verwenden Sie die mittlere Maustaste nach oben.
Nachricht an Web-API senden	Senden Sie eine Nachricht an eine Web-API, und empfangen Sie eine Antwort. Dies kann mit jeder Web-API verwendet werden, aber eine häufige Verwendung wäre eine REST-API. IA-Connect unterstützt das Senden von Nachrichten an Web-APIs von einem virtuellen Computer (d. h. für den Zugriff auf lokale Ressourcen) oder über Citrix- oder Microsoft Remote Desktop-Sitzungen (z. B. für den Zugriff auf APIs nur über isolierte Umgebungen).
Neue verzögerte Orchestrator-Aufgabe hinzufügen	Fügen Sie eine neue verzögerte Orchestrator-Aufgabe zu einer Warteschlange hinzu, die von einem Flow überwacht werden kann. Der Vorgang wird in Zukunft auf einen bestimmten Zeitpunkt zurückgestellt. Verwenden Sie diese Aktion, um einen Vorgang vorübergehend für einen bestimmten Zeitraum anzusetzen (z. B. wenn Sie auf etwas warten).
Nächste Orchestrator-Automatisierungsaufgabe abrufen	Ruft die nächste Orchestrator-Automatisierungsaufgabe ab, die den angegebenen Suchkriterien entspricht. Es können nur "Neue" und "Verzögerte" Vorgänge (die das Verzögerungsdatum erreicht haben) abgerufen werden. Haltevorgänge werden nicht abgerufen.
Orchestrator-Automatisierungsaufgabe abrufen	Ruft eine bestimmte Orchestrator-Automatisierungsaufgabe ab.
Orchestrator-Automatisierungsaufgabe löschen	Löschen Sie eine Orchestrator-Automatisierungsaufgabe, die zurückgestellt wurde.
Orchestrator-Status abrufen	Rufen Sie den grundlegenden Orchestrator-Status ab. Dies kann verwendet werden, um zu bestätigen, dass der Orchestrator verfügbar ist und reagiert.
Orchestrator-Worker abrufen	Rufen Sie Details und den Livestatus eines einzelnen Mitarbeiters ab, der beim IA-Connect Orchestrator registriert ist.
Ordner zu ZIP hinzufügen	ZIPs-Dateien in einem Ordner in einer ZIP-Datei (speichert die Dateien in einem Komprimierungsarchiv).
Pixelfarbe an Koordinate abrufen	Gibt die RGB-Farbe eines Pixels an einer bestimmten Koordinate zurück.
Prozess nach Prozess-ID abrufen	Gibt zurück, ob ein Prozess mit der angegebenen Prozess-ID in der IA-Connect Agent-Benutzersitzung ausgeführt wird. Prozess-IDs sind eindeutig, sodass nur ein Prozess mit der ID übereinstimmen kann. Prozess-IDs sind dynamisch und unterscheiden sich für jeden Start einer Anwendung.
Reagiert der TCP-Port	Meldet, ob ein Tcp-Netzwerkport auf einen Verbindungsversuch des IA-Connect-Agents reagiert. Dies kann ein TCP-Port auf dem Computer sein, auf dem der IA-Connect Agent ausgeführt wird (geben Sie "localhost" für den Remotehost ein) oder auf einem beliebigen Remotecomputer. Wenn der IA-Connect Agent erfolgreich eine Verbindung mit einem TCP-Port herstellt, wird die TCP-Verbindung sofort geschlossen.
Rechte Maustaste nach oben	Gibt die rechte Maustaste in der IA-Connect Agent-Benutzersitzung frei.
Rechte Maustaste nach unten	Drückt die rechte Maustaste in der IA-Connect Agent-Benutzersitzung (und lässt sie nicht los). Verwenden Sie die rechte Maustaste, um die Maus loszulassen.
Rechter Mauszeiger zwischen Koordinaten	Führt eine rechte Maustaste zwischen den beiden angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung aus. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt. Ein optionaler Jitter wird in der Mausbewegung unterstützt, um es eher wie eine menschliche Handbewegung zu gestalten.
Rechts gedrückter Maus	Hält die rechte Maustaste in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden.
Rechts gedrückter Maus an der Koordinate	Hält die rechte Maustaste an den angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.
Rechtsklick mit der Maus	Klicken Sie in der IA-Connect Agent-Benutzersitzung auf die rechte Maustaste.
Rechtsklick mit der Maus an der Koordinate	Klickt in der IA-Connect Agent-Benutzersitzung an den angegebenen Koordinaten auf die rechte Maustaste. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.
Remotedesktopsitzung (RDS)-Startdatei erstellen	Erstellen Sie eine RdS-Startdatei (Remote Desktop Session), die verwendet werden kann, um automatisch eine Remotedesktopsitzung mit angegebenen Parametern zu starten, anstatt die Remotedesktopclient-Benutzeroberfläche zu automatisieren. Eine RDS-Startdatei hat die Erweiterung ".rdp" und wird häufig als RDP-Datei bezeichnet.
Remotedesktopsitzung starten (RDS)	Starten Sie eine Remotedesktopsitzung (RDS) mit einer RDP-Startdatei.
Remotesitzung trennen	Wenn der IA-Connect Agent in einer Remotesitzung ausgeführt wird, trennt diese Aktion die Remotesitzung. Dies ist nicht mit der Abmeldung identisch und belässt die Remotesitzung, die in einem getrennten Zustand ausgeführt wird. Diese Aktion kann verwendet werden, wo Sie später eine Verbindung mit der Remotesitzung herstellen möchten, und von demselben Zustand fortfahren möchten, anstatt eine neue Sitzung zu starten. Wenn der IA-Connect Agent lokal ausgeführt wird, sperrt diese Aktion die Sitzung.
Schließen IA-Connect Agent	Schließt den IA-Connect Agent. Dies wirkt sich nicht auf die Benutzersitzung aus, in der der IA-Connect Agent ausgeführt wurde.
Schlüssel senden	Sendet globale Tastendrücke an die IA-Connect Agent-Benutzersitzung. Dadurch wird ein Benutzer simuliert, der diese Tasten auf der Tastatur drückt. Stellen Sie sicher, dass das Zielfensterelement fokussiert ist, oder dass die Tastendrücke von der falschen Anwendung empfangen werden oder ignoriert werden.
Schreiben einer Textdatei	Erstellt eine Textdatei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird, und schreibt Text in die Datei.
Schreiben in Benutzeranmeldeinformationen	Schreibt einen Benutzernamen und ein Kennwort in eine Anmeldeinformation im Profil des Benutzers in der IA-Connect Agent-Sitzung, sodass diese Anmeldeinformationen erstellt werden, wenn sie nicht vorhanden ist. Anmeldeinformationen können über die Windows-Systemsteuerung angezeigt werden.
Screenshot erstellen	Erstellt einen Screenshot der IA-Connect Agent-Benutzersitzung und gibt sie als Base64-codierte Zeichenfolge zurück.
Senden von Kennwortschlüsselereignissen	Sendet globale Tastendruckereignisse an die IA-Connect Agent-Benutzersitzung, insbesondere zum Eingeben eines Kennworts, mithilfe des Tastaturtreibers auf niedriger Ebene. Dadurch wird ein Benutzer simuliert, der diese Tasten auf der Tastatur drückt. Stellen Sie sicher, dass das Zielfensterelement fokussiert ist, oder dass die Tastendrücke von der falschen Anwendung empfangen werden oder ignoriert werden.
Senden von Schlüsselereignissen	Sendet globale Tastendruckereignisse mithilfe des Tastaturtreibers auf niedriger Ebene an die IA-Connect Agent-Benutzersitzung. Dadurch wird ein Benutzer simuliert, der diese Tasten auf der Tastatur drückt. Stellen Sie sicher, dass das Zielfensterelement fokussiert ist, oder dass die Tastendrücke von der falschen Anwendung empfangen werden oder ignoriert werden.
Sitzung lebendig halten	Hält die IA-Connect Agent-Benutzersitzung aktiv, indem die Maus im angegebenen Intervall bewegt wird, um zu verhindern, dass die Sitzung im Leerlauf bleibt.
Speichern des Kennworts im Agent-Speicher	Speichern Sie ein Kennwort im Agent-Speicher (verschlüsselt), wo es von allen Aktionen verwendet werden kann, die gespeicherte Kennwörter unterstützen. Kennwörter werden nur im Arbeitsspeicher gespeichert und gehen verloren, wenn der Agent geschlossen wird.
Sperrsitzung	Sperrt die Sitzung, in der der IA-Connect Agent ausgeführt wird.
Standarddrucker abrufen	Ruft den Namen des Standarddruckers für den Benutzer in der IA-Connect Agent-Sitzung ab.
Standarddrucker festlegen	Legt den Standarddrucker für den Benutzer in der IA-Connect Agent-Sitzung fest.
Töten eines Agent-Threads	Beendet (beendet, abgebrochen) einen Agent-Thread. Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können. Der Agent-Thread wird nicht gelöscht (verwenden Sie die Aktion "Agent-Thread löschen", um Threads zu löschen), um allen Prozessen oder Flüssen zu ermöglichen, die den Agent-Thread überwachen, um den Fehler "IA-Connect Agent-Thread wurde abgebrochen" zu erhalten.
Umgebungsvariable erweitern	Erweitert eine Zeichenfolge mit Umgebungsvariablen (z. B. %USERPROFILE% oder %TEMP%) in der IA-Connect Agent-Benutzersitzung.
Unterbrechen der Ordnersicherheitsvererbung	Hebt die Sicherheitsvererbung auf einem Ordner auf dem Computer auf, auf dem der IA-Connect Agent ausgeführt wird.
Update Orchestrator Flow stats result	Aktualisieren Sie die Ergebnisstatistiken für den aktuellen Worker Flow im IA-Connect Orchestrator. Dies wird verwendet, um das Endergebnis eines Flussstates im IA-Connect Orchestrator zu ändern, der in der Regel für Berichtszwecke verwendet wird. Dies funktioniert nur für den aktuellen Flow (der Orchestrator erkennt die Ablaufausführungs-ID). Sie können die Statistiken für einen anderen Flow nicht ändern.
Verzeichnis erstellen	Erstellt ein Verzeichnis (Ordner) auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.
Verzeichnis löschen	Löscht ein Verzeichnis (Ordner) auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.
Verzeichnis löschen	Löscht ein Verzeichnis (Ordner) auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird, und entfernt alle Dateien, die im Verzeichnis gespeichert sind.
Warten Sie, bis der Agent-Thread erfolgreich abgeschlossen wurde.	Wartet auf den Abschluss eines Agent-Threads und ruft optional die Threadausgabedaten ab. Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können. Wenn der Agent-Thread abgeschlossen ist, aber in Einem Fehler wird eine Ausnahme ausgelöst.
Warten Sie, bis IA-Connect nächste Hopsitzung eine Verbindung herstellt.	Wartet auf die nächste Hopsitzung, um eine Verbindung herzustellen, und bis der IA-Connect Agent in der nächsten Hopsitzung ausgeführt wird.
Warten Sie, bis IA-Connect Sitzung nach Namen geschlossen wird.	Wartet auf das Schließen der angegebenen IA-Connect Directorsitzung. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden. Der Name wird aus einer früheren Aktion "Anfügen" bekannt sein.
Zeichnen eines Rechtecks auf dem Bildschirm	Zeichnet ein Rechteck auf dem Bildschirm, um die Identifizierung von Bildschirmkoordinaten oder die Ausgabe einer Aktion zu unterstützen, die Bildschirmkoordinaten meldet. Das Rechteck wird nach 5 Sekunden automatisch entfernt.
Ziehen der mittleren Maus zwischen Koordinaten	Führt eine mittlere Maustaste zwischen den beiden angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung aus. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt. Ein optionaler Jitter wird in der Mausbewegung unterstützt, um es eher wie eine menschliche Handbewegung zu gestalten.
Zuordnen von Workern von Orchestrator	Weist einen Worker vom IA-Connect Orchestrator zu. Sie können einen Mitarbeiter anhand des Tags oder des Arbeitsnamens (oder auch nicht oder beides) anfordern, sodass Sie genauer auswählen können, welche Arbeit Sie benötigen. Sobald ein Mitarbeiter zugewiesen ist, wird er Ihrem Fluss zugewiesen und als ausgeführte Arbeit gemeldet. Beachten Sie, dass der Orchestrator weiterhin "Unterstützte Flussumgebungs-IDs", "Unterstützte Flussnamen" und "Nicht unterstützte Flussnamen" bei der Zuweisung berücksichtigt. Wenn mehrere Mitarbeiter mit der Suche übereinstimmen, gelten normale Lastenausgleichsregeln.
Zurücksetzen der Einstellungen für den nächsten Hop IA-Connect Director	Setzt alle benutzerdefinierten IA-Connect Director-Einstellungen zurück, die festgelegt wurden, und stellt die Standardeinstellungen wieder her.
Zurücksetzen IA-Connect Befehlsstatistiken	Setzt alle aktuell gespeicherten Statistiken zurück, für die der IA-Connect Agent in der aktuellen Sitzung ausgeführt wurde.
Zurückstellen eines vorhandenen Orchestrator-Automatisierungsvorgangs	Verzögern Sie eine vorhandene Orchestrator-Aufgabe, die sich bereits in der Warteschlange befindet. Der Vorgang wird in Zukunft auf einen bestimmten Zeitpunkt zurückgestellt. Dies wird häufig verwendet, um einen vorhandenen Vorgang erneut zurückzusetzen (d. h. der Vorgang wurde zuvor zurückgestellt und muss jetzt erneut zurückgestellt werden). Verwenden Sie diese Aktion, um einen Vorgang vorübergehend für einen bestimmten Zeitraum anzusetzen (z. B. wenn Sie auf etwas warten).
Zurückstellen vorhandener Orchestrator-Automatisierungsaufgaben	Verzögern Sie eine vorhandene Orchestrator-Aufgabe, die sich bereits in der Warteschlange befindet. Der Vorgang wird in Zukunft auf einen bestimmten Zeitpunkt zurückgestellt. Dies wird häufig verwendet, um einen vorhandenen Vorgang erneut zurückzusetzen (d. h. der Vorgang wurde zuvor zurückgestellt und muss jetzt erneut zurückgestellt werden). Verwenden Sie diese Aktion, um einen Vorgang vorübergehend für einen bestimmten Zeitraum anzusetzen (z. B. wenn Sie auf etwas warten).
Zuweisen einer Orchestrator-Automatisierungsaufgabe	Weist einem bestimmten Benutzer oder einer bestimmten Gruppe eine ausgewählte Orchestrator-Automatisierungsaufgabe zu. Diese Zuordnung wird an das Quellsystem übergeben, das mit dieser Automatisierungsaufgabe verknüpft ist (z. B. ServiceNow), und wird am häufigsten verwendet, um ein Ticket an eine andere Person oder Eine andere Personengruppe zu übergeben, um weitere Verarbeitungen zu ermöglichen. Wenn die Orchestrator-Automatisierungsaufgabe nicht mit einer Quelle verknüpft ist, wird eine Ausnahme ausgelöst.
Zwischenablage abrufen	Ruft den aktuellen Inhalt der Zwischenablage in der IA-Connect Agent-Benutzersitzung ab.
Zwischenablage löschen	Löscht den Inhalt der Zwischenablage in der IA-Connect Agent-Benutzersitzung.
Ändern des Vorgangsstatus der Orchestrator-Automatisierung	Ändert den ausgewählten Orchestrator-Automatisierungsaufgabenstatus oder andere Aufgabeneigenschaften.

Ablauf als abgeschlossen markieren

Vorgangs-ID:: WorkflowCompleted

Markieren Sie einen Flow als abgeschlossen, der den IA-Connect Orchestrator informiert, dass der zugewiesene Arbeitscomputer jetzt für die Verarbeitung anderer Flüsse verfügbar ist.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Abmelden der Remotesitzung

Vorgangs-ID:: LogoffSession

Protokolliert die Remotesitzung, in der der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Sekunden, die gewartet werden sollen	SecondsToWait		integer	Die Zeit, die nach dem Ausgeben des Abmeldebefehls an das Betriebssystem zu warten ist, damit der IA-Connect Agent den Abschluss des Befehls melden kann.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Abrufen aller IA-Connect Befehlsstatistiken

Vorgangs-ID:: GetAllCommandStats

Gibt alle aktuell gespeicherten Statistiken zurück, für die der IA-Connect Agent in der aktuellen Sitzung ausgeführt wurde.

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
Json für Befehlsstatistiken	CommandStatsJSON	string	Die Liste der Befehle, die vom IA-Connect-Agent in der aktuellen Sitzung im JSON-Format ausgeführt werden. Diese Liste enthält den Namen jeder Aktion und die Anzahl der Ausgeführten.

Abrufen aller Orchestrator-Automatisierungsaufgaben

Vorgangs-ID:: TasksGetAllTasks

Ruft alle Orchestrator-Automatisierungsaufgaben ab, die den Filtern entsprechen.

Parameter

Name	Schlüssel	Typ	Beschreibung
Automatisierungsnamenfilter	AutomationName	string	Geben Sie einen Wert ein, um nur Aufgaben mit diesem Automatisierungsnamen abzurufen. Lassen Sie nichts, um Orchestrator-Automatisierungsaufgaben mit einem beliebigen Namen zurückzugeben (d. h. diesen Filter deaktivieren).
Automatisierungsaufgabenstatusfilter	AutomationTaskStatus	string	Filtern Sie die Automatisierungsaufgaben nach dem angegebenen Automatisierungsaufgabenstatus. Lassen Sie das Feld leer, um alle Automatisierungsaufgabenstatus zurückzugeben (d. h. diesen Filter deaktivieren).
Filtern nach Eigenschaftenabfrage	FilterByPropertyQuery	string	Filtern Sie die Automatisierungsaufgaben mithilfe einer Abfragezeichenfolge. Dies ist identisch mit der Eingabe "Filtern nach Eigenschaft" in der Orchestrator-Aufgabenbenutzeroberfläche. Lassen Sie das Feld leer, um nicht nach Eigenschaft zu filtern (d. h. diesen Filter deaktivieren). Ein Suchfilter muss sich im Format "Eigenschaftsbedingungswert" befinden. Es wird nur ein einzelner Suchfilter unterstützt (sie können nicht verwenden und oder). Unterstützte Eigenschaften sind: name, org, dept, tags, stage, ticketid. Unterstützte Bedingungen sind gleich, enthalten, nicht gleich, nicht enthalten. Beispiel: Name ist gleich "Neue Starter", "Name" enthält "Starter", "Org" entspricht nicht "Acme", "Dept" enthält "Sales".
Minuten bis zum Zurückstellungsdatum	MinutesUntilDeferralDate	integer	Gibt nur Orchestrator-Automatisierungsaufgaben zurück, die innerhalb der angegebenen Anzahl von Minuten ausgeführt werden können. Legen Sie auf 0 fest, wenn Sie nur Automatisierungsaufgaben benötigen, die jetzt ausgeführt werden können. Lassen Sie den Wert leer, wenn Sie Vorgänge unabhängig von der Verzögerung abrufen möchten.
Mindestprioritätsstufe	MinimumPriorityLevel	integer	Gibt nur Orchestrator-Automatisierungsaufgaben zurück, die die angegebene Prioritätsstufe oder höher aufweisen. Beispiel: Das Festlegen von 2 gibt Vorgänge mit einer Prioritätsebene von 1 und 2 zurück.
Sortieren nach Verzögerungsdatum	SortByDeferralDate	boolean	Legen Sie den Wert auf "true" fest, um die Daten zurückzugeben, die nach dem Zurückstellungsdatum und der Verzögerungszeit sortiert sind. Legen Sie den Wert auf "false" fest, damit die in der Reihenfolge zurückgegebenen Daten gespeichert werden.
Abrufen von Haltevorgängen	RetrieveOnHoldTasks	boolean	Wenn dieser Wert auf "true" festgelegt ist (der Standardwert für die Abwärtskompatibilität), werden Aufgaben auch dann abgerufen, wenn sie im Halteraum sind. Wenn dieser Wert auf "false" festgelegt ist, werden haltevorgänge nicht abgerufen.
Überspringen	Skip	integer	Wenn Sie viele Hunderte von Ergebnissen abrufen, können Sie skip und MaxResults verwenden, um einen Block von Ergebnissen abzurufen. Skip gibt an, wie viele Ergebnisse übersprungen werden sollen, bevor das erste Element im Block zurückgegeben wird. Das Festlegen von "Überspringen" auf "0" gibt Ergebnisse vom Anfang zurück.
Max. Ergebnisse	MaxResults	integer	Wenn Sie viele Hunderte von Ergebnissen abrufen, können Sie skip und MaxResults verwenden, um einen Block von Ergebnissen abzurufen. MaxResults gibt die maximale Anzahl der zurückzugebenden Ergebnisse an, oder 0, um alle Ergebnisse zurückzugeben, nachdem die Eingabe übersprungen wurde.
Vorgangsdaten ausschließen	ExcludeTaskData	boolean	Wenn dieser Wert auf "true" festgelegt ist, werden Aufgabendateneigenschaften (TaskData, DeferralStoredData, TaskOutputData) in der Antwort nicht zurückgegeben. Dies kann die Größe der Antwort erheblich reduzieren, wenn Ihre Aufgaben viele gespeicherte Daten haben.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Automatisierungsaufgaben	AutomationTasks	array of object	Eine Datentabelle mit allen Orchestrator-Automatisierungsaufgaben, die den angegebenen Suchkriterien entsprechen. Datentabellen sind ein gängiges .NET-Datenformat, speichern jedoch Nullen als DbNull. Das IA-Connect PowerShell-Modul behebt dies, indem die meisten DbNull-Zeichenfolgen in "" konvertiert werden. Datetime-Antworten vom Orchestrator werden im Zeichenfolgenformat angezeigt.
items	AutomationTasks	object
Anzahl der Automatisierungsaufgaben	NumberOfAutomationTasks	integer	Die Anzahl der zurückgegebenen Automatisierungsaufgaben.

Abrufen der Arbeitsablaufnutzung von Orchestrator

Vorgangs-ID:: GetOrchestratorWorkerFlowUsageHeatmap

Gibt die Tägliche Nutzung des Arbeitsflusses von der IA-Connect Orchestrator zurück. Wird für Berichterstellungszwecke verwendet. Sie können optional einen oder mehrere Filter verwenden, um die zurückgegebenen Ergebnisse einzuschränken.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Startfenster des Ablaufs der Startzeit	SearchStartDateStartWindow	True	date-time	Filtern Sie Ergebnisse, um nur die Arbeitsablaufverwendung nach dem angegebenen Startdatum abzurufen (Zeitkomponente wird ignoriert). Legen Sie den Wert auf "Leer" fest, um den Filter nicht zu filtern. Beispiel: "2022-01-24T00:00:00" würde einen Worker für Flows zurückgeben, der am oder nach dem 24. Januar 2022 begonnen hat. Alle Datetimes befinden sich in UTC (GMT+0), sodass Sie die Aktion "DateTime konvertieren" verwenden möchten, um Ihre lokale Zeit in UTC zu konvertieren.
Ablaufanfangs-Endfenster	SearchStartDateEndWindow	True	date-time	Filtern Sie Ergebnisse, um nur die Arbeitsablaufverwendung vor dem angegebenen Startdatum abzurufen (Die Zeitkomponente wird ignoriert). Legen Sie den Wert auf "Leer" fest, um den Filter nicht zu filtern. Beispiel: "2022-01-25T00:00:00" würde einen Worker für Flow zurückgeben, der am oder vor dem 25. Januar 2022 begonnen hat. Alle Datetimes befinden sich in UTC (GMT+0), sodass Sie die Aktion "DateTime konvertieren" verwenden möchten, um Ihre lokale Zeit in UTC zu konvertieren.
Zeitzonenminutenversatz von UTC	TimeZoneMinutesOffsetFromUTC		integer	Der Zeitzonenversatz von UTC in Minuten, um die tägliche Tageszeitung auszurichten. Beispiel: Wenn Sie 60 Minuten angeben, werden die täglichen Utc-Tage von 01:00 UTC bis 01:00 UTC ausgeführt.
IA-Connect-Arbeitskraftnamen	WorkerNames		string	Eine Liste der Namen von IA-Connect Workern, für die ein Schema im JSON- oder CSV-Format zurückgegeben werden soll. Wenn sie leer gelassen werden, wird für alle Mitarbeiter, die dem Orchestrator zurzeit bekannt sind, ein Markup generiert. Beispiel: [{"WorkerName": "Worker1"}, {"WorkerName": "Worker2"}] (JSON-Tabellenformat), ["Worker1", "Worker2"] (JSON-Arrayformat) oder Worker1,Worker2 (CSV-Format).

Gibt zurück

Name	Pfad	Typ	Beschreibung
Arbeitsablaufnutzungs-JSON	WorkerFlowUsageHeatmapJSON	string	Verwendung eines Arbeitsablaufs als Ransomware im JSON-Format.
Anzahl der Arbeitsflussnutzungselemente	NumberOfWorkerFlowUsageHeatmapItems	integer	Die Anzahl der zurückgegebenen Elemente für die Arbeitsablaufverwendung. Ein Element pro Arbeit pro Tag.

Abrufen der id des übergeordneten Prozesses

Vorgangs-ID:: GetParentProcessId

Gibt die Prozess-ID des übergeordneten Prozesses für jeden ausgeführten Prozess in der IA-Connect Agent-Benutzersitzung zurück, die über die angegebene Prozess-ID verfügt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Prozess-ID	ProcessId	True	integer	Die Prozess-ID des untergeordneten Prozesses.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Übergeordnete Prozess-ID	ParentProcessId	integer	Die Prozess-ID des übergeordneten Prozesses.
Übergeordneter Prozess wird noch ausgeführt	ParentProcessStillRunning	boolean	Gibt true zurück, wenn der übergeordnete Prozess noch ausgeführt wird und nicht beendet wurde.
Name des übergeordneten Prozesses	ParentProcessName	string	Der Prozessname des übergeordneten Prozesses.

Abrufen der Prozessanzahl nach Name

Vorgangs-ID:: GetProcessCountByName

Gibt die Anzahl der ausgeführten Prozesse in der IA-Connect Agent-Benutzersitzung zurück, die den angegebenen Prozessnamen aufweist.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Prozessname	ProcessName	True	string	Der Prozessname.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Anzahl der Prozesse	NumberOfProcesses	integer	Die Anzahl der Prozesse, die dem angegebenen Prozessnamen entsprechen.

Abrufen des Anmeldeverlaufs von Orchestrator

Vorgangs-ID:: GetOrchestratorLoginHistory

Gibt den IA-Connect Orchestrator-Anmeldeverlauf für Berichtszwecke zurück. Sie können optional einen oder mehrere Filter verwenden, um die zurückgegebenen Ergebnisse einzuschränken.

Parameter

Name	Schlüssel	Typ	Beschreibung
Innerhalb der letzten Anzahl von Tagen	WithinLastNumberOfDays	integer	Filtert Ergebnisse, um nur Orchestrator-Anmeldungen innerhalb der angegebenen Anzahl von Tagen abzurufen. Auf 0 festgelegt, um nicht zu filtern.
E-Mail-Adresse	SearchByEmail	string	Filtert Ergebnisse, um nur Orchestrator-Anmeldungen mit der angegebenen E-Mail-Adresse abzurufen. Legen Sie den Wert auf "Leer" fest, um nicht nach E-Mail-Adresse zu filtern.
Startfenster des Anmeldeverlaufs	SearchLoginHistoryTimeStartWindow	date-time	Filtert Ergebnisse, um nur Orchestrator-Anmeldungen nach der angegebenen Startzeit abzurufen. Legen Sie den Wert auf "Leer" fest, um den Filter nicht zu filtern. Beispiel: "2022-01-24T07:00:00" würde alle Orchestrator-Anmeldungen am oder nach 07.00 Stunden am 24. Januar 2022 zurückgeben. Alle Datetimes befinden sich in UTC (GMT+0), sodass Sie die Aktion "DateTime konvertieren" verwenden möchten, um Ihre lokale Zeit in UTC zu konvertieren.
Endfenster des Anmeldeverlaufs	SearchLoginHistoryTimeEndWindow	date-time	Filtert Ergebnisse, um nur Orchestrator-Anmeldungen vor der angegebenen Startzeit abzurufen. Legen Sie den Wert auf "Leer" fest, um den Filter nicht zu filtern. Beispiel: "2022-01-25T07:00:00" würde alle Orchestrator-Anmeldungen am 25. Januar 2022 oder vor 07.00 Stunden zurückgeben. Alle Datetimes befinden sich in UTC (GMT+0), sodass Sie die Aktion "DateTime konvertieren" verwenden möchten, um Ihre lokale Zeit in UTC zu konvertieren.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Json des Orchestrator-Anmeldeverlaufs	OrchestratorLoginHistoryJSON	string	Eine Liste aller Orchestrator-Anmeldungen, die die angegebenen Filter im JSON-Format erfüllen.
Anzahl der Orchestrator-Anmeldungen	NumberOfOrchestratorLogins	integer	Die Anzahl der zurückgegebenen Orchestrator-Anmeldungen.

Abrufen des Clienthosts

Vorgangs-ID:: GetRemoteSessionClientHostname

Gibt den Hostnamen des Clients zurück, auf dem der IA-Connect Director ausgeführt wird.

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
Clienthostname	ClientHostname	string	Der Hostname des Clients, auf dem der IA-Connect Director ausgeführt wird.

Abrufen des gespeicherten Kennworts

Vorgangs-ID:: GetStoredPassword

Ruft ein zuvor generiertes oder gespeichertes Kennwort ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kennwortbezeichner	PasswordIdentifier		string	Der Bezeichner des gespeicherten Kennworts. Diese Kennwörter werden nur im Arbeitsspeicher gespeichert und gehen verloren, wenn der Agent geschlossen wird. Beispiel: MyExchangePassword.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Nur-Text-Kennwort	PlainTextPassword	string	Das Kennwort im Nur-Text-Format. Das Kennwort kann im Nur-Text-Format benötigt werden, wenn es sich um ein einmaliges Kennwort handelt, das per SMS oder E-Mail (z. B. per E-Mail) übertragen werden soll und daher as-isangezeigt werden muss.

Abrufen des Orchestrator-Automatisierungsaufgabenvorgangs

Vorgangs-ID:: TasksGetTaskOperation

Ruft eine bestimmte Orchestrator-Automatisierungsaufgabe ab, indem die eindeutige Vorgangs-ID bereitgestellt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	OperationId	True	string	Die Vorgangs-ID der Orchestrator-Aufgabe, die Sie abrufen möchten.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Automatisierungsname	AutomationName	string	Der Name der abgerufenen Orchestrator-Aufgabe.
Zurückstellungsdatum und -uhrzeit	DeferralDateTime	string	Das Datum und die Uhrzeit, zu dem die abgerufene Orchestrator-Aufgabe bereit sein soll. Dies wird als Zeichenfolge in UTC zurückgegeben.
Zurückstellung gespeicherter Daten	DeferralStoredData	string	Optionale Daten, die beim Verzögerten Verschieben des Vorgangs gespeichert wurden. Dies sind in der Regel Daten, die Sie zum Fortsetzen des Prozesses/Flusses benötigen.
Verzögerungsanzahl	DeferralCount	integer	Wie oft dieser Vorgang zurückgestellt wurde. Dies ist in der Regel 0 für einen neuen Vorgang, der nie zurückgestellt wurde, oder 1 oder mehr für einen verzögerten Vorgang. Jedes Mal, wenn eine verzögerte Aufgabe erneut zurückgestellt wurde, erhöht der Orchestrator diese Zahl automatisch.
Vorgangseingabedaten	TaskInputData	string	Optionale Daten, die beim Erstellen der Aufgabe gespeichert wurden. Dies sind in der Regel Daten, die zum Starten des Prozesses/Flusses verwendet wurden, aber Sie können dieses Feld für jeden Zweck verwenden. Dies kann als beliebiges Textformat Ihrer Wahl formatiert werden, z. B. JSON oder XML oder Unformatierter Text.
Vorgangsausgabedaten	TaskOutputData	string	Optionale Daten, die von der Automatisierung gespeichert wurden, als die Aufgabe verarbeitet wurde. Dies kann als beliebiges Textformat Ihrer Wahl formatiert werden, z. B. JSON oder XML oder Unformatierter Text.
Priority	Priority	integer	Die Prioritätsebene dieser Orchestrator-Aufgabe (1 ist höchste Ebene).
Automatisierungsaufgabenstatus	AutomationTaskStatus	string	Der Status der abgerufenen Orchestrator-Aufgabe.
Prozessphase	ProcessStage	string	Der Punkt, an dem der Automatisierungsprozess/Ablauf nach der Verzögerung fortgesetzt werden soll. Dies ist ein optionaler Zeichenfolgenwert, der für den spezifischen Prozess/Fluss eindeutig ist. Dies wird von einer Bedingung innerhalb des verzögerten Prozesses/Flusses verwendet, um zu entscheiden, welcher Schritt als Nächstes ausgeführt werden soll. Beispiel: Wenn der Prozess/Ablauf in der Phase "Exchange" fortgesetzt werden soll, wenn er nach der Verzögerung fortgesetzt wird, geben Sie den Wert "Exchange" ein.
Empfangsdatum und -uhrzeit	ReceivedDateTime	string	Das Datum und die Uhrzeit, zu dem die Aufgabe ursprünglich vom Orchestrator empfangen wurde. Dies wird als Zeichenfolge in UTC zurückgegeben.
Minuten bis zum Zurückstellungsdatum	MinutesUntilDeferralDate	integer	Die Anzahl der Minuten bis zum Zurückstellungsdatum dieses Vorgangs (z. B. wenn diese Aufgabe zur Ausführung bereit ist). Wenn diese Aufgabe bereit ist, die Minuten auszuführen, ist 0.
Zurückgestellt	OnHold	boolean	Ist auf "true" festgelegt, wenn der Vorgang im Haltebereich ist. Eine "On-Hold"-Aufgabe wird nie von der Aktion "Nächste Orchestrator-Automatisierungsaufgabe abrufen" abgerufen und wird daher nicht in einem typischen Aufgabenworkflow verarbeitet.
Organisation	Organisation	string	Die Organisation, mit der diese Aufgabe verbunden ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Abteilung	Department	string	Die Abteilung, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Description	Description	string	Die Beschreibung für diesen Vorgang. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Stichwörter	Tags	string	Eine optionale Liste mit einem oder mehreren Tags, die dieser Aufgabe zugewiesen sind. Wird in der Regel verwendet, um eine Aufgabe zum Suchen und Filtern zu kategorisieren. Keine Unterscheidung zwischen Groß-/Kleinbuchstaben 1 pro Zeile.

Abrufen des Status eines Agent-Threads

Vorgangs-ID:: GetAgentThreadStatus

Ruft den Status eines Agent-Threads ab und ruft optional die Threadausgabedaten ab. Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Thread-ID	ThreadId	True	integer	Wenn Sie zuvor eine Agent-Aktion als Thread ausgeführt haben, geben Sie die Thread-ID an, um den Status des Threads abzurufen. Diese Thread-ID wurde als Ausgabe der vorherigen Ausführung der Aktion als Thread bereitgestellt.
Abrufen von Threadausgabedaten	RetrieveThreadOutputData		boolean	Legen Sie "true" fest, um die Threadausgabedaten im JSON-Format abzurufen. Es wird empfohlen, Threadausgabedaten abzurufen, indem sie dieselbe Aktion aufrufen, die zum Erstellen des Threads verwendet wird, indem sie die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Thread-ID festlegt, aber mit dieser Option können Sie die Threadausgabedaten direkt abrufen und optional die Daten nicht löschen.
Thread nach dem Abrufen der Ausgabedaten löschen	ClearOutputDataFromMemoryOnceRead		boolean	Wenn der Thread erfolgreich abgeschlossen wurde und die Ausgabedaten abgerufen wurden (siehe Eingabe 'Threadausgabedaten abrufen'), legen Sie diese Eingabe auf "true" fest, um den Thread zu löschen, nachdem die Ergebnisse zurückgegeben wurden. Dadurch werden die Threadausgabedaten und der Thread selbst gelöscht, sodass Sie den Thread nicht erneut abfragen können.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Thread wurde gestartet	ThreadStarted	boolean	True, wenn der Thread gestartet wurde. False, wenn der Thread noch nicht gestartet wurde, was vermuten würde, dass etwas schief gegangen ist, da der Thread sofort gestartet wird.
Thread wird ausgeführt	ThreadRunning	boolean	True, wenn der Thread zurzeit ausgeführt wird. False, wenn der Thread nie gestartet wurde (höchst unwahrscheinlich) oder wenn der Thread jetzt abgeschlossen wurde.
Thread ist abgeschlossen	ThreadCompleted	boolean	True, wenn der Thread abgeschlossen ist. False, wenn der Thread nie gestartet wurde (höchst unwahrscheinlich) oder wenn der Thread noch ausgeführt wird.
Thread erfolgreich	ThreadSuccess	boolean	True, wenn der Thread erfolgreich abgeschlossen wurde. False, wenn der Thread nie gestartet wurde (höchst unwahrscheinlich), wird der Thread weiterhin ausgeführt oder wenn der Thread fehlgeschlagen ist.
Threadlaufzeit in Sekunden	ThreadRuntimeInSeconds	integer	Die Gesamtzahl der Sekunden, die der Thread ausgeführt hat.
IA-Connect Aktionsname	IAConnectActionName	string	Der interne Name der IA-Connect Agent-Aktion, die als Thread ausgeführt wird.
Threadstatusmeldung	ThreadStatusMessage	string	Eine Textzeichenfolge, die den Status des Threads beschreibt. Diese Nachricht wird aus den Eigenschaften ThreadStarted,ThreadRunning,ThreadCompleted,ThreadSuccess berechnet. Diese Textzeichenfolge ist sprachunabhängig (sie ändert sich nicht entsprechend dem Gebietsschema).
Threadfehlermeldung	ThreadErrorMessage	string	Wenn der Thread fehlgeschlagen ist, enthält diese Ausgabe die Fehlermeldung.
JSON-Threadausgabedaten	ThreadOutputJSON	string	Wenn "Threadausgabedaten abrufen" auf "true" festgelegt ist, enthält diese Ausgabe die rohen Threadausgabedaten im JSON-Format.

Abrufen des Verfügbarkeitsstatus von Orchestrator-Workern

Vorgangs-ID:: OrchestratorGetWorkerAvailabilityStatusOverview

Rufen Sie den grundlegenden Orchestrator-Status ab. Dies kann verwendet werden, um zu bestätigen, dass der Orchestrator verfügbar ist und reagiert.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Gesamtzahl der Arbeitnehmer	TotalWorkersCount	integer	Die Anzahl der im Orchestrator definierten IA-Connect Mitarbeiter, unabhängig davon, ob sie arbeiten oder nicht.
Anzahl der verfügbaren Mitarbeiter	AvailableWorkersCount	integer	Die Anzahl der im Orchestrator definierten IA-Connect Worker, die für die Arbeit verfügbar sind. Verfügbar bedeutet, dass sie reagieren, lizenziert, nicht im Wartungsmodus, derzeit nicht ausgeführte Flüsse (Automatisierungen). Dies ist die Anzahl der Verfügbaren Mitarbeiter, um neue eingehende Arbeit anzunehmen.
Anzahl der nicht verfügbaren Mitarbeiter	UnavailableWorkersCount	integer	Die Anzahl der im Orchestrator definierten IA-Connect Worker, die für die Arbeit nicht verfügbar sind. Dies entspricht der Gesamtzahl der Arbeitnehmer minus der verfügbaren Arbeitskräfte.
Anzahl der Mitarbeiter, die Abläufe ausführen	WorkersRunningFlowsCount	integer	Die Anzahl der im Orchestrator definierten IA-Connect Worker, die Flüsse (Automatisierungen) ausführen. Diese Arbeitnehmer sind nicht für die Arbeit verfügbar, da sie beschäftigt sind.
Anzahl der Mitarbeiter im Wartungsmodus	WorkersInMaintenanceModeCount	integer	Die Anzahl der im Orchestrator definierten IA-Connect-Mitarbeiter, die sich im Wartungsmodus befinden. Diese Mitarbeiter sind nicht für die Arbeit verfügbar, da sie manuell so konfiguriert wurden, dass keine neue Arbeit akzeptiert wird.
Anzahl der Live-Mitarbeiter	LiveWorkersCount	integer	Die Anzahl der im Orchestrator definierten IA-Connect-Mitarbeiter, die reagieren. Diese Mitarbeiter sind möglicherweise für die Arbeit verfügbar oder nicht verfügbar, da sie möglicherweise nicht lizenziert sind, im Hauptmodus oder im Ausführungsmodus (Automatisierungen) ausgeführt werden.
Anzahl lizenzierter Mitarbeiter	LicensedWorkersCount	integer	Die Anzahl der im Orchestrator definierten IA-Connect Worker, die reagieren und lizenziert sind. Ein lizenzierter Mitarbeiter reagiert immer, da der Orchestrator nur den lizenzierten Zustand eines Arbeitnehmers kennt, wenn der Mitarbeiter reagiert (und daher den Orchestrator über den Status informiert). Wenn ein Worker nicht mehr reagiert, wird er vom Orchestrator nicht mehr als lizenziert betrachtet. Diese Mitarbeiter sind möglicherweise für die Arbeit verfügbar oder nicht verfügbar, da sie sich möglicherweise im Hauptmodus befinden oder Flüsse (Automatisierungen) ausgeführt werden.

Abrufen generischer Anmeldeinformationen von Orchestrator

Vorgangs-ID:: GetGenericCredentialFromOrchestrator

Ruft eine generische Anmeldeinformation ab, die im IA-Connect Orchestrator gespeichert wurde. Anmeldeinformationen können Benutzernamen, Kennwörter, Hostnamen, URLs und andere generische Daten enthalten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Freundlicher Name	FriendlyName		string	Anzeigename der im Orchestrator gespeicherten Anmeldeinformationen.
Abrufen eines Nur-Text-Kennworts	RetrievePlainTextPassword		boolean	Wenn diese Option aktiviert ist, wird das Kennwort für die angegebenen generischen Orchestrator-Anmeldeinformationen als Nur-Text zurückgegeben, wenn die generische Anmeldeinformationseinstellung "Kennwort nicht verfügbar machen" deaktiviert wurde (sodass Kennwörter abgerufen werden können). Es wird empfohlen, Kennwörter nicht als Nur-Text abzurufen und stattdessen IA-Connect Aktionen zu verwenden, die gespeicherte Kennwörter unterstützen (z. B. "Eingabekennwort in UIA-Aktion"), bei dem der Orchestrator das Kennwort zur Laufzeit direkt in die Aktion einfügt.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Nutzername	Username	string	Der Benutzername, der in den generischen Anmeldeinformationen gespeichert ist.
Nur-Text-Kennwort	PlainTextPassword	string	Das Kennwort, das in den generischen Anmeldeinformationen gespeichert ist, als Nur-Text-Zeichenfolge. Orchestrator-Kennwörter werden verschlüsselt gespeichert, werden jedoch als Nur-Text zurückgegeben, damit Sie sie an Aktionen weitergeben können, die sie erfordern.
Hostname	Hostname	string	Der Hostname oder der Domänenname, der in den generischen Anmeldeinformationen gespeichert ist, falls verwendet.
URL	Url	string	Die URL, die bei Verwendung in den generischen Anmeldeinformationen enthalten ist.
Generische Eigenschaft 1	GenericProperty1	string	Eine generische Eigenschaft, die bei Verwendung in den generischen Anmeldeinformationen gespeichert ist. Dies kann verwendet werden, um Daten zu speichern, die möglicherweise den Anmeldeinformationen zugeordnet sind.
Generische Eigenschaft 2	GenericProperty2	string	Eine generische Eigenschaft, die bei Verwendung in den generischen Anmeldeinformationen gespeichert ist. Dies kann verwendet werden, um Daten zu speichern, die möglicherweise den Anmeldeinformationen zugeordnet sind.
Generische Eigenschaft 3	GenericProperty3	string	Eine generische Eigenschaft, die bei Verwendung in den generischen Anmeldeinformationen gespeichert ist. Dies kann verwendet werden, um Daten zu speichern, die möglicherweise den Anmeldeinformationen zugeordnet sind.

Abrufen IA-Connect Agent-Informationen

Vorgangs-ID:: GetIAConnectAgentInfo

Gibt die Eigenschaften des IA-Connect-Agents zurück, einschließlich der Versionsnummer und des Pfads zur ausführbaren Datei des Agents.

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
IA-Connect Agent-Version	IAConnectAgentVersion	string	Die vollständige Versionsnummer des IA-Connect-Agents.
DotNet CLR-Version	DotNetCLRVersion	string	Die DotNet Common Language Runtime (CLR)-Version.
IA-Connect Agent als Benutzername ausgeführt	IAConnectAgentRunAsUsername	string	Der Benutzername der Benutzersitzung, in der der IA-Connect Agent ausgeführt wird.
IA-Connect Agent als Benutzerdomäne ausgeführt	IAConnectAgentRunAsUserdomain	string	Die Benutzerdomäne der Benutzersitzung, in der der IA-Connect Agent ausgeführt wird.
IA-Connect Agentpfad	IAConnectAgentPath	string	Der vollständige Pfad zur ausführbaren Datei des IA-Connect-Agents.
IA-Connect Agent ist 64-Bit-Prozess	IAConnectAgentIs64bitProcess	boolean	Gibt "true" zurück, wenn der IA-Connect Agent ein 64-Bit-Prozess oder "false" ist, wenn dies nicht der Fall ist.
IA-Connect Agent-Version	IAConnectAgentReleaseVersion	string	Die IA-Connect Agent-Version, z. B. 8.0.
IA-Connect Agent RPA-Befehlstimeout	IAConnectAgentRPACommandTimeout	integer	Timeout des IA-Connect Agent RPA-Befehls. Dieser Standardwert ist 30 Sekunden und kann mithilfe der Aktion "IA-Connect Agent-Befehlstimeout festlegen" festgelegt werden.
IA-Connect Agent-Protokolldateiname	IAConnectAgentLogFilename	string	Der IA-Connect Agent-Protokolldateiname. Dieser Wert ist für jeden Start des IA-Connect Agents eindeutig, da er das Startdatum und die Startzeit im Dateinamen aufweist.

Abrufen IA-Connect Agent-Protokollebene

Vorgangs-ID:: GetRemoteLoggingLevel

Gibt die aktuelle IA-Connect Agent-Protokollierungsebene zurück. Die Protokollierungsebenen werden von 1 bis 4 festgelegt, wobei 1 die niedrigste Ebene und 4 die höchste ist.

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
Protokollebene	LoggingLevel	integer	Die aktuelle Protokollierungsebene des IA-Connect-Agents.
IA-Connect Agent-Protokolldateiname	IAConnectAgentLogFilename	string	Der IA-Connect Agent-Protokolldateiname. Dieser Wert ist für jeden Start des IA-Connect Agents eindeutig, da er das Startdatum und die Startzeit im Dateinamen aufweist.

Abrufen IA-Connect Agent-Sitzungsinformationen

Vorgangs-ID:: GetRemoteSessionInfo

Gibt Informationen zur IA-Connect Agent-Benutzersitzung 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
Sitzungs-ID	SessionId	integer	Die aktuelle Remotebenutzersitzungs-ID.
Sitzungstyp	SessionType	integer	Der Typ der Remotesitzung, entweder 1 (Citrix), 2 (RDP) oder 0 (Konsole).
Name des Sitzungstyps	SessionTypeName	string	Der Typ der Remotesitzung, entweder ICA (Citrix), RDP oder Console.

Abrufen IA-Connect Agentprotokolls

Vorgangs-ID:: GetIAConnectAgentLog

Gibt das aktuelle IA-Connect Agent-Protokoll zurück, entweder als Datei oder durch Lesen des Inhalts und Zurückgeben in einer Ausgabevariable.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Komprimieren	Compress		boolean	Sollte die alternative IA-Connect Agent-ausführbare Datei während des Uploads komprimiert werden?
Nur letzte Befehlsprotokolle zurückgeben	ReturnLastCommandOnly		boolean	Sollte das IA-Connect Agent-Protokoll auf das Ergebnis des letzten Befehls und nicht auf das gesamte Protokoll beschränkt werden?
Speichern des Protokolls in datei	SaveLogToFile		boolean	Sollte das IA-Connect Agent-Protokoll als Datei gespeichert werden?
Platzieren von Protokollinhalten in Einem Datenelement	PlaceLogContentInDataItem		boolean	Soll der Inhalt des Protokolls in einer Ausgabevariable zurückgegeben werden?
Lokaler Speicherordner	LocalSaveFolder		string	Der Dateipfad im Ordner, in dem die IA-Connect Agent-Anmeldung gespeichert werden soll.
Agent-Protokolldateiname verwenden	UseAgentLogFilename		boolean	Sollte die Protokolldatei denselben Namen wie der Name der Protokolldatei im Agent erhalten? Wenn dieser Wert auf "false" festgelegt ist, können Sie "Lokaler Dateiname" festlegen, um den Dateinamen anzugeben.
Lokaler Dateiname speichern	LocalSaveFilename		string	Der Dateiname nur der lokalen Speicherdatei für das IA-Connect Agent-Protokoll. Dies wird nur verwendet, wenn "Agent-Protokolldateiname verwenden" auf "false" festgelegt ist.
Max bytes to read	MaxBytesToRead		integer	Die maximale Anzahl von Bytes, die aus dem Agent-Protokoll gelesen werden sollen (vom Ende nach hinten). Dies kann auf 0 oder -1 festgelegt werden, um das gesamte Protokoll abzurufen.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Inhalt des Agentprotokolls	IAConnectAgentLogContentsBase64	string	Der Inhalt des IA-Connect Agent-Protokolls.
Lokal gespeicherter Protokolldateiname	IAConnectAgentLogFilenameOnly	string	Der Pfad zum gespeicherten Protokolldateinamen.

Abrufen IA-Connect Agentprozessanzahl

Vorgangs-ID:: GetAgentProcessCount

Gibt die Anzahl der Instanzen des aktuell in der Benutzersitzung ausgeführten IA-Connect Agent zurück. Dies ist nützlich, um zu erkennen, ob mehrere Instanzen des IA-Connect-Agents ausgeführt werden.

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
Anzahl der Prozesse	NumberOfProcesses	integer	Die Anzahl der IA-Connect Agent-Prozesse, die derzeit in der Benutzersitzung ausgeführt werden.

Abrufen IA-Connect aktuellen Lizenzstatus des Agents

Vorgangs-ID:: GetLicenseState

Gibt zurück, ob der IA-Connect Agent derzeit lizenziert ist und ob die Eigenschaften der Lizenz lizenziert sind.

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
Ist lizenziert	IsLicensed	boolean	Gibt "true" zurück, wenn der IA-Connect Agent zurzeit lizenziert ist, oder "false", wenn dies nicht der Fall ist.
Lizenztyp	LicenseType	string	Der Typ der verwendeten IA-Connect Lizenz.
Agent-Domänenname	CustomerNETBIOSDomainName	string	Der NetBIOS-Domänenname des Computers, auf dem der IA-Connect Agent ausgeführt wird, wenn er nach Domänenname lizenziert ist (IA-Connect 7.0 oder 7.1).
Director-Hostnamen	DirectorHostnameCSV	string	Der Hostname(n) der Computer, auf denen der IA-Connect Director installiert werden kann, wenn er vom Hostnamen lizenziert wird (post IA-Connect 7.2).
Anzeigename des Kunden	CustomerDisplayName	string	Der Kundenname, der in der Titelleiste des IA-Connect Agenten angezeigt werden soll.
Lieferantenname	VendorName	string	Der Name des IA-Connect Anbieters.
Ablaufdatum der Lizenz	LicenseExpiryDate	string	Das Ablaufdatum der IA-Connect-Lizenz.
Tage bis zum Ablauf der Lizenz	DaysUntilLicenseExpires	integer	Die Anzahl der verbleibenden Tage bis zum Ablauf der IA-Connect Lizenz.
Lizenzfeatures	LicenseFeatures	string	Zusätzliche Lizenzfeatures, die in der Regel Zugriff auf zusätzliche Funktionen bieten.
Ist JML-Lizenz	IsJMLLicense	boolean	Bietet diese Lizenz Zugriff auf JML-Funktionen.

Abrufen IA-Connect Director-Betriebszeit

Vorgangs-ID:: GetDirectorUpTime

Gibt die Betriebszeit dieses IA-Connect Director in Sekunden zurück (d. h. wie lange der Director ausgeführt wurde).

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
Director-Betriebszeit in Sekunden	UpTimeInSeconds	integer	Die Anzahl der Sekunden, die der IA-Connect Director ausgeführt wurde.

Abrufen IA-Connect Director-Informationen

Vorgangs-ID:: GetIAConnectDirectorInfo

Gibt die Eigenschaften des IA-Connect Director zurück, einschließlich der Versionsnummer und des Pfads zur ausführbaren Datei des Director.

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
IA-Connect Director-Version	IAConnectDirectorVersion	string	Die Vollständige Versionsnummer des IA-Connect Director.
DotNet CLR-Version	DotNetCLRVersion	string	Die DotNet Common Language Runtime (CLR)-Version.
IA-Connect Director als Benutzername ausgeführt	IAConnectDirectorRunAsUsername	string	Der Benutzername der Benutzersitzung, in der der IA-Connect Director ausgeführt wird.
IA-Connect Director als Benutzerdomäne ausgeführt	IAConnectDirectorRunAsUserdomain	string	Die Benutzerdomäne der Benutzersitzung, in der der IA-Connect Director ausgeführt wird.
IA-Connect Directorpfad	IAConnectDirectorPath	string	Der vollständige Pfad zur ausführbaren Datei des IA-Connect Director.
IA-Connect Director ist 64-Bit-Prozess	IAConnectDirectorIs64bitProcess	boolean	Gibt "true" zurück, wenn der IA-Connect Director ein 64-Bit-Prozess oder "false" ist, wenn dies nicht der Fall ist.
IA-Connect Director-Version	IAConnectDirectorReleaseVersion	string	Die version IA-Connect Director, z. B. 8.0.
IA-Connect Director-Protokolldateiname	IAConnectDirectorLogFilename	string	Der Dateiname des IA-Connect Director-Protokolls. Dieser Wert ist für jeden Start des IA-Connect Director eindeutig, da er das Startdatum und die Startzeit im Dateinamen aufweist.

Abrufen IA-Connect Directorprotokollebene

Vorgangs-ID:: GetLocalLoggingLevel

Gibt die aktuelle IA-Connect Director-Protokollierungsebene zurück. Die Protokollierungsebenen werden von 0 bis 4 festgelegt. 0 ist deaktiviert. 1 ist die niedrigste Protokollebene (und der Standardwert). 4 ist die höchste Protokollebene.

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
Protokollebene	LoggingLevel	integer	Die aktuelle Protokollierungsebene des IA-Connect Director.
IA-Connect Director-Protokolldateiname	IAConnectDirectorLogFilename	string	Der Dateiname des IA-Connect Director-Protokolls. Dieser Wert ist für jeden Start eindeutig, da er das Startdatum und die Startzeit im Dateinamen aufweist.

Abrufen IA-Connect globalen Koordinatenkonfiguration des Agents

Vorgangs-ID:: GetAgentGlobalCoordinateConfiguration

Ruft die Konfiguration der konfiguration des globalen Koordinatensystems des IA-Connect Agent ab, das verwendet wird, um Elementpositionen (z. B. während der Mausüberprüfung) anzuzeigen und Mauspositionen zu berechnen (z. B. beim Ausführen globaler Mausaktionen).

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
Funktionen für mehrere Monitore	MultiMonitorFunctionality	string	Gibt 'PrimaryMonitor' zurück, wenn der IA-Connect Agent zurzeit so konfiguriert ist, dass nur hervorhebungselemente unterstützt und globale Mausaktionen auf dem primären Anzeigegerät ausgeführt werden. Gibt "MultiMonitor" zurück, wenn der IA-Connect Agent Elemente auf allen Monitoren hervorhebung (der Standardwert seit IA-Connect 9,4).
Auto Set Mouse Inspection Multiplier	AutoSetMouseInspectionMultiplier	boolean	Gibt true zurück, wenn der IA-Connect Agent automatisch den Mausüberprüfungsmultiplikator auf dem primären Anzeigegerät beim Starten des Agents berechnet und jedes Mal, wenn die Mausüberprüfung ausgeführt wird (der Standardwert seit IA-Connect 9,4). Gibt "false" zurück, wenn der IA-Connect Agent die Mausüberprüfungsmultiplikator manuell festlegen muss (die einzige verfügbare Option in IA-Connect 9,3 und früher). Diese Option hat nur auswirkungen, wenn der Modus mit mehreren Monitoren deaktiviert ist.
Automatisches Festlegen des globalen Mausmultiplikators	AutoSetGlobalMouseMultiplier	boolean	Gibt true zurück, wenn der IA-Connect Agent automatisch den globalen Mausbewegungsmultiplikator auf dem primären Anzeigegerät beim Agent-Start berechnet und jedes Mal, wenn die Mausüberprüfung ausgeführt wird (der Standardwert seit IA-Connect 9,4). Gibt "false" zurück, wenn der IA-Connect Agent die globale Mausbewegungsmultiplikator manuell festlegen muss (die einzige verfügbare Option in IA-Connect 9,3 und früher). Diese Option hat nur auswirkungen, wenn der Modus mit mehreren Monitoren deaktiviert ist.
Mausinspektion X Multiplizierer	MouseInspectionXMultiplier	double	Der aktuelle horizontale (X)-Mausüberprüfungsmultiplikator (für den Fall, dass der Agent hervorhebung, was sich unter der Maus befindet). Beispiel: Wenn IA-Connect das Inspektionsrechteck an der Hälfte der tatsächlichen Maus X-Position anzeigt, lautet dieser Wert 0,5. Der Multiplikator hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist, da Multiplizierer dynamisch berechnet werden, wenn der IA-Connect Agent so konfiguriert ist, dass er mit mehreren Monitoren kompatibel ist.
Mausinspektion Y-Multiplizierer	MouseInspectionYMultiplier	double	Der aktuelle vertikale (Y)-Mausüberprüfungsmultiplikator (für den Fall, dass der Agent hervorhebung, was sich unter der Maus befindet). Beispiel: Wenn IA-Connect das Inspektionsrechteck an der Hälfte der tatsächlichen Maus-Y-Position anzeigt, lautet dieser Wert 0,5. Der Multiplikator hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist, da Multiplizierer dynamisch berechnet werden, wenn der IA-Connect Agent so konfiguriert ist, dass er mit mehreren Monitoren kompatibel ist.
Global mouse X multiplier	GlobalMouseXMultiplier	double	Der aktuelle horizontale (X) globale Mausbewegungsmultiplikator (für den Zeitpunkt, an dem der Agent die Maus bewegt). Der Multiplikator hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist, da Multiplizierer dynamisch berechnet werden, wenn der IA-Connect Agent so konfiguriert ist, dass er mit mehreren Monitoren kompatibel ist.
Globale Maus Y-Multiplizierer	GlobalMouseYMultiplier	double	Der aktuelle vertikale (Y) globale Mausbewegungsmultiplikator (für den Zeitpunkt, an dem der Agent die Maus bewegt). Der Multiplikator hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist, da Multiplizierer dynamisch berechnet werden, wenn der IA-Connect Agent so konfiguriert ist, dass er mit mehreren Monitoren kompatibel ist.
Globale Mausbewegungsmethode	GlobalMouseMoveMethod	string	Gibt die aktuelle globale Mausbewegungsmethode zurück (entweder mouse_event oder setcursorpos).
Java-Koordinatensystem	JavaCoordinateSystem	string	Gibt das aktuelle Java-Koordinatensystem zurück, das "Virtual" (Standard) oder "Physisch" (neu in IA-Connect 9.4) sein kann. Virtuelle Koordinaten sind dpi-skaliert, während physische Koordinaten direkt Pixeln zugeordnet werden. Dieser Wert sollte auf das Koordinatensystem festgelegt werden, das von der Java Access Bridge präsentiert wird.
SAP-GUI-Koordinatensystem	SAPGUICoordinateSystem	string	Gibt das aktuelle SAP-GUI-Skript-API-Koordinatensystem zurück, das "Virtual" (Standard) oder "Physisch" (neu in IA-Connect 9.4) sein kann. Virtuelle Koordinaten sind dpi-skaliert, während physische Koordinaten direkt Pixeln zugeordnet werden. Dieser Wert sollte auf das Koordinatensystem festgelegt werden, das von der SAP-GUI-Skript-API dargestellt wird.

Abrufen IA-Connect status des nächsten Hops

Vorgangs-ID:: GetNextHopStatus

Meldet den Status des nächsten Hop Director für den Agent, der diesen Befehl empfängt. Wenn der nächste Hop aktiviert ist, leitet dieser Agent Befehle an den nächsten Hop weiter (über den Next-Hop Director). Wenn der nächste Hop deaktiviert ist, verarbeitet dieser Agent Befehle selbst (standard).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Überprüfen, ob der nächste Hop Director ausgeführt wird	CheckNextHopDirectorIsRunning		boolean	Für den nächsten Hop ist ein ausgeführter IA-Connect Director auf demselben Computer wie der Agent erforderlich. Wenn diese Einstellung "true" ist, überprüft der Agent, ob der nächste Hop-Director wie beschrieben ausgeführt wird. Wenn diese Einstellung falsch ist, führt der Agent keine Überprüfungen durch und überprüft einfach den Status des nächsten Hops.
Überprüfen, ob der nächste Hop-Agent ausgeführt wird	CheckNextHopAgentIsRunning		boolean	Für den nächsten Hop ist ein ausgeführter IA-Connect Director auf demselben Computer wie der Agent UND ein ausgeführter IA-Connect Agent in der nächsten Hopsitzung erforderlich. Wenn diese Einstellung "true" ist, überprüft der Agent, wie beschrieben, der nächste Hop-Agent ausgeführt wird. Wenn diese Einstellung falsch ist, führt der Agent keine Überprüfungen durch und überprüft einfach den Status des nächsten Hops.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Nächster Hop aktiviert	NextHopEnabled	boolean	Gibt true zurück, wenn der nächste Hop zurzeit aktiviert ist.
Aktive Adresse des nächsten Hop Director	ActiveNextHopDirectorAddress	string	Die Adresse des aktiven nächsten Hop director, wenn eine verwendet wird.
Aktiver nächster Hop Director TCP-Port	ActiveNextHopDirectorTCPPort	integer	Der TCP-Port des aktiven nächsten Hop Director, wenn eins verwendet wird.
Aktiver nächster Hop Director verwendet HTTPS	ActiveNextHopDirectorUsesHTTPS	boolean	Gibt true zurück, wenn der aktive nächste Hop Director HTTPS verwendet.
Aktiver nächster Hop Director wird ausgeführt	ActiveNextHopDirectorIsRunning	boolean	Gibt true zurück, wenn der aktive nächste Hop Director ausgeführt wird, oder false, wenn dies nicht der Fall ist.
Url des aktiven nächsten Hop Director	ActiveNextHopDirectorURL	string	Die URL des aktiven nächsten Hop Director.
Aktiver Nächster Hop-Agent wird ausgeführt	ActiveNextHopAgentIsRunning	boolean	Gibt "true" zurück, wenn der aktive nächste Hop-Agent ausgeführt wird, oder "false", wenn dies nicht der Fall ist.

Abrufen verfügbarer IA-Connect Sitzungen

Vorgangs-ID:: GetAvailableIAConnectSessions

Ruft eine Liste der IA-Connect Directorsitzungen ab (verfügbare Verbindungen zu Sitzungen, in denen der IA-Connect Agent ausgeführt wird, z. B. lokal, Microsoft RDP oder Citrix ICA).

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
JSON IA-Connect Sitzungen	IAConnectSessionsJSON	string	Eine Liste aller IA-Connect Sitzungen, die als JSON formatiert sind.
Anzahl der IA-Connect Sitzungen	NumberOfIAConnectSessions	integer	Die Gesamtzahl der geöffneten IA-Connect Sitzungen.
Anzahl der lokalen IA-Connect Sitzungen	NumberOfLocalIAConnectSessions	integer	Die Anzahl der geöffneten lokalen IA-Connect Sitzungen.
Anzahl der Citrix ICA IA-Connect Sitzungen	NumberOfCitrixICAIAConnectSessions	integer	Die Anzahl der geöffneten Citrix ICA IA-Connect Sitzungen.
Anzahl der Microsoft RDP-IA-Connect-Sitzungen	NumberOfMicrosoftRDPIAConnectSessions	integer	Die Anzahl der geöffneten Microsoft RDP-IA-Connect Sitzungen.

Abrufen von Arbeitsverfügbarkeitsstatistiken von Orchestrator

Vorgangs-ID:: GetOrchestratorWorkerAvailabilityStats

Gibt Arbeitsverfügbarkeitsstatistiken aus dem IA-Connect Orchestrator zurück. Wird für Berichterstellungszwecke verwendet. Sie können optional einen oder mehrere Filter verwenden, um die zurückgegebenen Ergebnisse einzuschränken.

Parameter

Name	Schlüssel	Typ	Beschreibung
Innerhalb der letzten Anzahl von Tagen	WithinLastNumberOfDays	integer	Filtert Ergebnisse, um nur die innerhalb der letzten angegebenen Anzahl von Tagen gestarteten abzurufen. Auf 0 festgelegt, um nicht zu filtern.
Flussname	SearchFlowName	string	Filtert Ergebnisse, um nur diejenigen mit dem angegebenen Flussnamen abzurufen. Legen Sie den Wert auf "Leer" fest, um nicht nach Flussnamen zu filtern.
Startfenster des Ablaufs der Startzeit	SearchFlowStartTimeStartWindow	date-time	Filtern Sie Ergebnisse, um nur diejenigen abzurufen, die nach der angegebenen Startzeit gestartet wurden. Legen Sie den Wert auf "Leer" fest, um den Filter nicht zu filtern. Beispiel: "2022-01-24T07:00:00" würde alle Orchestrator Flow-Statistiken für Flows zurückgeben, die am 24. Januar 2022 mit oder nach 07,00 Stunden gestartet wurden. Alle Datetimes befinden sich in UTC (GMT+0), sodass Sie die Aktion "DateTime konvertieren" verwenden möchten, um Ihre lokale Zeit in UTC zu konvertieren.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Arbeitsverfügbarkeitsstatistiken JSON	WorkerAvailabilityStatsJSON	string	Eine Liste der Arbeitsverfügbarkeitsstatistiken im JSON-Format.
Anzahl der Arbeitsverfügbarkeitsstatistiken	NumberOfWorkerAvailabilityStats	integer	Die Anzahl der zurückgegebenen Statistiken zur Verfügbarkeit von Mitarbeitern.

Abrufen von CSV-Text als Sammlung

Vorgangs-ID:: GetCSVTextAsCollection

Gibt eine CSV-Datei auf dem Computer zurück, auf dem der IA-Connect Agent als Sammlung (Tabelle) ausgeführt wird. Erfordert nur lesegeschützten Zugriff auf CSV-Datei.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
CSV-Dateipfad	CSVFilePath	True	string	Der vollständige Pfad zur CSV-Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Erste Zeile ist Kopfzeile	FirstLineIsHeader		boolean	Ist die erste Zeile in der CSV-Datei eine Kopfzeile?
Kürzen von Kopfzeilen	TrimHeaders		boolean	Sollen die Kopfzeilen gekürzt werden, um führende oder nachfolgende Leerzeichen zu entfernen?
Leere Zeilen zulassen	AllowBlankRows		boolean	Bei Festlegung auf "true" (Standardeinstellung) sind völlig leere Zeilen in den CSV-Daten zulässig und werden als leere Zeile zurückgegeben. Wenn dieser Wert auf "false" festgelegt ist, werden in den zurückgegebenen Daten vollständig leere Zeilen entfernt (die Datei bleibt unverändert).
Erweitern von Spalten bei Bedarf	ExtendColumnsIfRequired		boolean	Wenn dieser Wert auf "true" festgelegt ist und es Zellen ohne übereinstimmende Spaltenüberschrift gibt (d. h. eine Zeile mit mehr Zellen als die Kopfzeile), wird automatisch eine Spaltenüberschrift mit dem Namen Column_N erstellt (wobei N der Spaltenindex ist). Bei Festlegung auf "false" (Standardeinstellung) gibt es eine Ausnahme, wenn eine Zeile Daten ohne übereinstimmende Spalte enthält.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
CSV-Daten JSON	CSVDataJSON	string	Der Inhalt der CSV-Datei im JSON-Format.

Abrufen von Dateien

Vorgangs-ID:: GetFiles

Gibt eine Liste von Dateien in einem Ordner (übereinstimmend mit einer CSV-Liste von Mustern) auf dem Computer zurück, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Verzeichnispfad	DirectoryPath	True	string	Der vollständige Pfad zum Verzeichnis (Ordner). Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Muster CSV	PatternsCSV	True	string	Eine durch Trennzeichen getrennte Liste von Dateimustern, die übereinstimmen sollen, z . B. für alle Dateien oder ".txt,.docx" für Dateien mit einer .txt oder .docx Erweiterung.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
JSON-Dateien	FilesJSON	string	Eine Liste der Dateien, die im Ordner enthalten sind, im JSON-Format.
Anzahl der erfolgreich gelesenen Dateien	NumberOfFilesReadSuccessfully	integer	Die Anzahl der Dateien, die erfolgreich gelesen wurden.
Die Anzahl der Dateien konnte nicht gelesen werden.	NumberOfFilesFailedToRead	integer	Die Anzahl der Dateien, die nicht gelesen werden konnten.

Abrufen von Dateiinhalten als Base64

Vorgangs-ID:: GetFileContentsAsBase64

Rufen Sie den Inhalt der angegebenen Datei im Base64-Format ab, ein Format, das für die Übertragung über DIE API geeignet ist und problemlos wieder in das ursprüngliche Text- oder Binärformat konvertiert wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	FilePath	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Komprimieren	Compress		boolean	Legen Sie den Wert auf "true" fest, um den Dateiinhalt zu komprimieren, bevor Sie in Base64 konvertieren. Die Datei bleibt unberührt, alle Vorgänge werden im Arbeitsspeicher ausgeführt. Dieses Feature ist nur nützlich, wenn Sie den Dateiinhalt GUnzipieren können, nachdem Sie base64 abgerufen haben (beim Decodieren zurück zum ursprünglichen Dateiinhaltstext oder binärdaten). Legen Sie diesen Wert auf "false" fest, wenn Sie base64 direkt an eine Aktion übergeben, die Base64 als Eingabe akzeptiert und kein GUnzip-Feature aufweist.
Max. Dateigröße	MaxFileSize		integer	Die maximale Größe der Datei, über der eine Ausnahme ausgelöst wird, anstatt den Dateiinhalt abzurufen. Auf diese Weise können Sie die Situation vermeiden, in der der Agent aufgefordert wird, eine riesige Datei abzurufen, was letztendlich dazu führt, dass die Aktion zu einem Timeout führt. Legen Sie auf -1 fest, um die Dateigrößenüberprüfung zu deaktivieren.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Dateiinhalte als Base64	FileContentsAsBase64	string	Der Dateiinhalt im Base64-Format.

Abrufen von Dateisicherheitsberechtigungen

Vorgangs-ID:: GetFileSecurityPermissions

Gibt eine Liste der Berechtigungen zurück, die derzeit auf einer Datei auf dem Computer festgelegt sind, auf der der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	FilePath	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
JSON für Sicherheitsberechtigungen	SecurityPermissionsJSON	string	Die berechtigungen, die derzeit für die angegebene Datei im JSON-Format festgelegt sind.

Abrufen von Director-Clienttyp und Sitzungsinformationen

Vorgangs-ID:: GetRemoteClientType

Gibt die Details der lokalen oder Remotesitzung zurück, die vom Director der Ebene 1 behandelt wird.

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
Remoteclienttyp	RemoteClientType	string	Der Remoteclienttyp ('Local', 'Citrix ICA' oder 'Microsoft RDP').
Virtueller Kanal verbunden	VirtualChannelConnected	boolean	True, wenn der virtuelle Kanal verbunden ist, zwischen dem Director und dem Agent.
Directorversion	DirectorVersion	string	Die Version der IA-Connect Director-DLL. Beispiel: 1.67.21.0.
Director-Version	DirectorReleaseVersion	string	Die IA-Connect Releaseversion des IA-Connect Director. Beispiel: 9.4.
Agentversion	AgentVersion	string	Die Version der IA-Connect Agent EXE, mit der dieser Director verbunden ist. Beispiel: 1.74.21.0.
Agent release version	AgentReleaseVersion	string	Die IA-Connect Releaseversion des IA-Connect Agents, mit dem dieser Director verbunden ist. Beispiel: 9.4.
Agent ist lizenziert	AgentIsLicensed	boolean	True, wenn der IA-Connect Agent, mit dem dieser Director verbunden ist, lizenziert ist. False, wenn der IA-Connect Agent nicht lizenziert ist. Null, wenn der Agent-Lizenzstatus unbekannt ist.
Agent-Lizenzfeatures	AgentLicenseFeatures	string	Eine durch Trennzeichen getrennte Liste der IA-Connect Lizenzfeatures, die dem IA-Connect Agent zugewiesen sind, mit dem dieser Director verbunden ist. Beispiel: JML, DEV.
Director hostname	DirectorHostname	string	Der Hostname des Computers, auf dem der Director ausgeführt wird. Beispiel: vmrpa1.
Director NetBIOS-Domänenname	DirectorNetBIOSDomainName	string	Der NetBIOS-Domänenname des Computers, auf dem der Director ausgeführt wird. Beispiel: Domäne1. Wenn der Computer kein Mitglied einer Domäne ist, gibt dies normalerweise den Hostnamen zurück.
Director DNS-Domänenname	DirectorDNSDomainName	string	Der DNS-Domänenname des Computers, auf dem der Director ausgeführt wird. Beispiel: domain1.myorg.local. Wenn der Computer kein Mitglied einer Domäne ist, gibt dies normalerweise den Hostnamen zurück.
Angefügt an next hop Director	AttachedToNextHopDirector	boolean	Auf "false" festgelegt, wenn die IA-Connect Sitzung zurzeit mit dem Agent verbunden ist, mit dem dieser Director verbunden ist. Wird auf "true" festgelegt, wenn der Director alle Aktionen (d. h. angefügt) an einen anderen Director weiterleitet (der mit einem anderen Agent verbunden ist). Wenn dieser Director z. B. ein lokaler Director ist, der mit einem lokalen Agent kommuniziert, die IA-Connect-Sitzung jedoch derzeit an Citrix angefügt ist, ist dieser Wert wahr.
Sitzungstyp "Nächster Hop Director"	NextHopDirectorSessionType	string	Wenn dieser Director an einen nächsten Hop Director angefügt ist, enthält dieser Wert den nächsten Hopsitzungstyp. Wenn dieser Director beispielsweise ein lokaler Director ist, der mit einem lokalen Agent kommuniziert, aber die IA-Connect-Sitzung derzeit an Citrix angefügt ist, lautet dieser Wert "Citrix ICA", während der Wert "Remote-Clienttyp" "Lokal" lautet (die lokale Director-Weiterleitungsaktionen an Citrix darstellt).

Abrufen von Flow-Statistiken von Orchestrator

Vorgangs-ID:: GetOrchestratorFlowStats

Gibt eine Liste der Flow-Statistiken aus dem IA-Connect Orchestrator zurück. Wird für Berichterstellungszwecke verwendet. Sie können optional einen oder mehrere Filter verwenden, um die zurückgegebenen Ergebnisse einzuschränken.

Parameter

Name	Schlüssel	Typ	Beschreibung
Innerhalb der letzten Anzahl von Tagen	WithinLastNumberOfDays	integer	Filtert Ergebnisse, um nur die innerhalb der letzten angegebenen Anzahl von Tagen gestarteten abzurufen. Auf 0 festgelegt, um nicht zu filtern.
Flussname	SearchFlowName	string	Filtert Ergebnisse, um nur diejenigen mit dem angegebenen Flussnamen abzurufen. Legen Sie den Wert auf "Leer" fest, um nicht nach Flussnamen zu filtern.
Ergebnis der letzten Ablaufaktion	SearchFlowLastActionResult	boolean	Filtert Ergebnisse, um nur die Ergebnisse mit dem angegebenen letzten Aktionsergebnis abzurufen. Auf "true" festgelegt, um nur erfolgreiche Flüsse abzurufen. Auf "false" festgelegt, um nur fehlgeschlagene Flüsse abzurufen. Legen Sie keinen Wert /einen Wert fest, der leer ist, um das letzte Aktionsergebnis des Flusses nicht zu filtern.
Startfenster des Ablaufs der Startzeit	SearchFlowStartTimeStartWindow	date-time	Filtern Sie Ergebnisse, um nur diejenigen abzurufen, die nach der angegebenen Startzeit gestartet wurden. Legen Sie den Wert auf "Leer" fest, um den Filter nicht zu filtern. Beispiel: "2022-01-24T07:00:00" würde alle Orchestrator Flow-Statistiken für Flows zurückgeben, die am 24. Januar 2022 mit oder nach 07,00 Stunden gestartet wurden. Alle Datetimes befinden sich in UTC (GMT+0), sodass Sie die Aktion "DateTime konvertieren" verwenden möchten, um Ihre lokale Zeit in UTC zu konvertieren.
Ablaufanfangs-Endfenster	SearchFlowStartTimeEndWindow	date-time	Filtern Sie Ergebnisse, um nur diejenigen abzurufen, die vor der angegebenen Startzeit gestartet wurden. Legen Sie den Wert auf "Leer" fest, um den Filter nicht zu filtern. Beispiel: "2022-01-25T07:00:00" würde alle Orchestrator Flow-Statistiken für Flows zurückgeben, die am 25. Januar 2022 auf oder vor 07,00 Stunden gestartet wurden. Alle Datetimes befinden sich in UTC (GMT+0), sodass Sie die Aktion "DateTime konvertieren" verwenden möchten, um Ihre lokale Zeit in UTC zu konvertieren.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Orchestrator Flow stats JSON	OrchestratorFlowStatsJSON	string	Eine Liste aller Orchestrator Flow-Statistiken im JSON-Format.
Anzahl der Flussstatistiken	NumberOfOrchestratorFlowStats	integer	Die Anzahl der zurückgegebenen Flow-Statistiken.

Abrufen von Ordnern

Vorgangs-ID:: GetFolders

Gibt alle Unterordner innerhalb eines angegebenen Ordners auf dem Computer zurück, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Verzeichnispfad	DirectoryPath	True	string	Der vollständige Pfad zum Verzeichnis (Ordner). Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
JSON-Ordner	FoldersJSON	string	Eine Liste von Unterordnern, die im Ordner enthalten sind, im JSON-Format.
Anzahl der Erfolgreich gelesenen Ordner	NumberOfFoldersReadSuccessfully	integer	Die Anzahl der Unterordner, die erfolgreich gelesen wurden.
Die Anzahl der Ordner konnte nicht gelesen werden.	NumberOfFoldersFailedToRead	integer	Die Anzahl der Unterordner, die nicht gelesen werden konnten.

Abrufen von Ordnersicherheitsberechtigungen

Vorgangs-ID:: GetFolderSecurityPermissions

Gibt eine Liste der Berechtigungen zurück, die derzeit auf einem Ordner auf dem Computer festgelegt sind, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ordnerpfad	FolderPath	True	string	Der vollständige Pfad zum Ordner. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
JSON für Sicherheitsberechtigungen	SecurityPermissionsJSON	string	Die berechtigungen, die derzeit für den angegebenen Ordner im JSON-Format festgelegt sind.

Abrufen von Prozess-ID-Befehlszeileneigenschaften

Vorgangs-ID:: GetProcessIdCommandLine

Gibt die Befehlszeileneigenschaften für jeden ausgeführten Prozess in der IA-Connect Agent-Benutzersitzung zurück, die die angegebene Prozess-ID aufweist.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Prozess-ID	ProcessId	True	integer	Die Prozess-ID des Prozesses zum Abrufen der Befehlszeileneigenschaften aus.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlszeile "Prozess"	ProcessCommandLine	string	Die Befehlszeileneigenschaften für den Prozess.
Prozessargumente	ProcessArguments	string	Die Argumente, die beim Starten des Prozesses verwendet wurden.
Aktuelles Arbeitsverzeichnis verarbeiten	ProcessCurrentWorkingDirectory	string	Das aktuelle Arbeitsverzeichnis des Prozesses.
Name des Prozessbildpfads	ProcessImagePathName	string	Der Pfad zur ausführbaren Datei, die den Prozess gestartet hat.

Abrufen von Prozessen

Vorgangs-ID:: GetProcesses

Gibt eine Liste der ausgeführten Prozesse in der IA-Connect Agent-Benutzersitzung zurück. Dies kann optional durch Angabe eines Prozessnamens gefiltert werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Prozessname	ProcessName		string	Optionaler Filter für den Prozessnamen.
Prozessbefehlszeile abrufen	GetProcessCommandLine		boolean	Wenn dieser Wert auf "true" festgelegt ist, werden die Details der Prozess-Befehlszeile zurückgegeben.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Anzahl der Prozesse	NumberOfProcesses	integer	Die Anzahl der Prozesse, die in der Benutzersitzung ausgeführt werden.
Json-Prozesse	ProcessesJSON	string	Die Liste der Prozesse, die in der Benutzersitzung ausgeführt werden, im JSON-Format.

Abrufen von speicherplatzfreiem Speicherplatz

Vorgangs-ID:: GetDiskFreeSpace

Gibt den freien Speicherplatz für einen angegebenen Datenträger auf dem Computer zurück, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Laufwerkbuchstabe	DriveLetter	True	string	Der Laufwerkbuchstaben des zu überprüfenden Datenträgers.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Freier Speicherplatz byte	FreeSpaceBytes	integer	Die Menge des freien Speicherplatzes in Byte.
Freier Speicherplatz KB	FreeSpaceKB	integer	Die Menge an freiem Speicherplatz in Kilobyte.
Freier Speicherplatz MB	FreeSpaceMB	integer	Die Menge an freiem Speicherplatz in Megabyte.
Freier Speicherplatz GB	FreeSpaceGB	integer	Die Menge an freiem Speicherplatz in Gigabyte.

Abrufen von Umgebungsinformationen

Vorgangs-ID:: GetEnvironmentInfo

Gibt Informationen zur Umgebung zurück, in der die IA-Connect Agent-Benutzersitzung ausgeführt wird.

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
Hauptversion des Betriebssystems	OSVersionMajor	integer	Die Hauptversion des Betriebssystems.
Nebenversion des Betriebssystems	OSVersionMinor	integer	Die Nebenversion des Betriebssystems.
Betriebssystembuildversion	OSVersionBuild	integer	Die Buildversion des Betriebssystems.
Betriebssystem ist 64-Bit	OSIs64Bit	boolean	Gibt true zurück, wenn das Betriebssystem 64 bit ist.
Prozessoranzahl	ProcessorCount	integer	Die Prozessoranzahl.
Gesamtanzahl des physischen RAM in MB	TotalPhysicalRAMInMB	integer	Die Menge des physischen RAM (in MB).
Gesamtanzahl des virtuellen RAM in MB	TotalVirtualRAMInMB	integer	Die Menge des virtuellen RAM (in MB).
Verfügbarer physischer RAM in MB	AvailablePhysicalRAMInMB	integer	Die Menge des zurzeit verfügbaren physischen RAM (in MB).
Verfügbarer virtueller RAM in MB	AvailableVirtualRAMInMB	integer	Die Menge des derzeit verfügbaren virtuellen RAM (in MB).
Vollständiger Betriebssystemname	OSFullName	string	Der vollständige Name des Betriebssystems, z. B. Microsoft Windows Server 2019 Standard.
Installierter Name der Benutzeroberflächenkultur	InstalledUICultureName	string	Die sprache der Benutzeroberfläche, die mit dem Betriebssystem installiert ist, z. B. en-US.
Aktueller Benutzeroberflächenkulturname	CurrentUICultureName	string	Die Standardsprache der Benutzeroberfläche, z. B. en-US.
Aktueller Kulturname	CurrentCultureName	string	Das Standardgebietsschema des Benutzers, z. B. en-GB.

Agent-Threads abrufen

Vorgangs-ID:: GetAgentThreads

Gibt eine Liste der Agent-Threads zurück. Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können. Sobald ein Agent-Thread abgeschlossen und seine Daten abgerufen wurden, wird der Agent-Thread gelöscht und wird nicht in der Liste der Threads angezeigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Sortierreihenfolge	SortOrder		string	Die Sortierreihenfolge für die Ausgabeliste von Agent-Threads. Unterstützte Sortierreihenfolgen sind 'None', 'ThreadStartTime', 'ThreadStartTime_Desc', 'ThreadEndTime', 'ThreadEndTime_Desc', 'ThreadId', 'ThreadId_Desc', 'ThreadActionName', 'ThreadActionName_Desc', 'ThreadRuntime', 'ThreadRuntime_Desc'.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Anzahl der Agent-Threads	NumberOfAgentThreads	integer	Die Anzahl der Agent-Threads, die noch ausgeführt werden oder für den Abruf verfügbar sind. Sobald ein Agent-Thread abgeschlossen und seine Daten abgerufen wurden, wird der Agent-Thread gelöscht und wird nicht in der Liste der Threads angezeigt.
Agentthreads	AgentThreads	array of object	Die Liste der Agent-Threads und alle verfügbaren Threadinformationen (mit Ausnahme der internen Threaddaten).
ThreadId	AgentThreads.ThreadId	integer
IAConnectActionName	AgentThreads.IAConnectActionName	string
ThreadStartDateTimeUTC	AgentThreads.ThreadStartDateTimeUTC	date-time
ThreadCompletedDateTimeUTC	AgentThreads.ThreadCompletedDateTimeUTC	date-time
ThreadRuntimeInSeconds	AgentThreads.ThreadRuntimeInSeconds	integer
ThreadStarted	AgentThreads.ThreadStarted	boolean
ThreadRunning	AgentThreads.ThreadRunning	boolean
ThreadVervollständigen	AgentThreads.ThreadCompleted	boolean
ThreadSuccess	AgentThreads.ThreadSuccess	boolean
ThreadStatusMessage	AgentThreads.ThreadStatusMessage	string
ThreadErrorMessage	AgentThreads.ThreadErrorMessage	string

Aktivieren der Ordnersicherheitsvererbung

Vorgangs-ID:: EnableFolderSecurityInheritance

Aktiviert die Sicherheitsvererbung auf einem Ordner auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ordnerpfad	FolderPath	True	string	Der vollständige Pfad zum Ordner. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Aktivieren IA-Connect nächsten Hop

Vorgangs-ID:: EnableNextHop

Aktiviert den nächsten Hop, der alle zukünftigen Befehle weiterleitet, die an den IA-Connect Agent weitergeleitet werden, der in der nächsten Hopsitzung ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Adresse des nächsten Hop director	NextHopDirectorAddress		string	Die optionale Adresse für den nächsten Hop IA-Connect Director, an die Befehle weitergeleitet werden sollen, wenn keine der Parameter "Next hop Director address is localhost", "Next hop Director address is hostname", "Next hop Director address is FQDN" oder "Next hop Director address is named pipe" parameter are set to true.
Nächster Hop Director TCP-Port	NextHopDirectorTCPPort		integer	Der TCP-Port, auf dem der nächste Hop Director lauscht (der Director auf dem Computer, auf dem der Agent ausgeführt wird).
Nächster Hop Director verwendet HTTPS	NextHopDirectorUsesHTTPS		boolean	Wird auf "True" festgelegt, wenn der nächste Hop Director HTTPS verwendet, oder "false", wenn dies nicht der Fall ist.
Nächste Hop Director-Adresse ist localhost	NextHopDirectorAddressIsLocalhostname		boolean	Die nächste Hop Director-Adresse (relativ zum Agent) ist "localhost".
Adresse des nächsten Hop Director ist Hostname	NextHopDirectorAddressIsHostname		boolean	Die nächste Hop Director-Adresse ist der Hostname des Computers, auf dem der Agent ausgeführt wird (d. h. die Adresse, auf der der Agent und der Director ausgeführt wird).
Nächste Hop Director-Adresse ist FQDN	NextHopDirectorAddressIsFQDN		boolean	Die nächste Hop Director-Adresse ist der vollqualifizierte Domänenname (FQDN) des Computers, auf dem der Agent ausgeführt wird (d. h. die, die den Agent und den Director ausführt).
Nächster Hop Director TCP-Port durch Sitzungs-ID erhöhen	IncrementNextHopDirectorTCPPortBySessionId		boolean	Um sicherzustellen, dass der nächste Hop Director TCP-Port eindeutig ist (wenn mehrere parallele Sitzungen mit next-hop vom gleichen Host verwendet werden), kann die Sitzungs-ID dem TCP-Port "Nächster Hop Director" hinzugefügt werden.
Deaktivieren vor dem Aktivieren	DisableBeforeEnable		boolean	Sollte doppelter Hop deaktiviert werden (sofern derzeit aktiv), bevor sie erneut aktiviert werden? Wenn dieser Wert auf "true" festgelegt ist (standard), werden alle neuen Doppelsprung-Aktivierungsanweisungen durch die vorherigen ersetzt. Wenn dieser Wert auf "false" festgelegt ist, wird dreifacher Hop aktiviert, da die Anweisungen vom Double-Hop-IA-Connect Agent empfangen werden.
Überprüfen, ob der nächste Hop Director ausgeführt wird	CheckNextHopDirectorIsRunning		boolean	Für den nächsten Hop ist ein ausgeführter IA-Connect Director auf demselben Computer wie der Agent erforderlich. Wenn diese Einstellung zutrifft, überprüft der Agent, ob der nächste Hop Director wie beschrieben ausgeführt wird, und kann den nächsten Hop nicht aktivieren, wenn der nächste Hop Director nicht ausgeführt wird. Wenn diese Einstellung falsch ist, führt der Agent keine Überprüfungen durch und aktiviert einfach den nächsten Hop.
Überprüfen, ob der nächste Hop-Agent ausgeführt wird	CheckNextHopAgentIsRunning		boolean	Für den nächsten Hop ist ein ausgeführter IA-Connect Director auf demselben Computer wie der Agent UND ein ausgeführter IA-Connect Agent in der nächsten Hopsitzung erforderlich. Wenn diese Einstellung "true" ist, überprüft der Agent den nächsten Hop-Agent wie beschrieben und kann den nächsten Hop nicht aktivieren, wenn der nächste Hop-Agent nicht ausgeführt wird. Wenn diese Einstellung falsch ist, führt der Agent keine Überprüfungen durch und aktiviert einfach den nächsten Hop.
Die Adresse des nächsten Hop Director lautet "Pipe".	NextHopDirectorAddressIsNamedPipe		boolean	Die nächste Hop Director-Adresse (relativ zum Agent) verwendet eine benannte Pipe anstelle eines TCP/IP-Webdiensts. Dies ist die Standardeinstellung, um die Verwendung von TCP/IP-Ports für den ersten Hop zu vermeiden.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Aktive Adresse des nächsten Hop Director	ActiveNextHopDirectorAddress	string	Die Adresse des aktiven nächsten Hop director, wenn eine verwendet wird.
Aktiver nächster Hop Director TCP-Port	ActiveNextHopDirectorTCPPort	integer	Der TCP-Port des aktiven nächsten Hop Director, wenn eins verwendet wird.
Aktiver nächster Hop Director verwendet HTTPS	ActiveNextHopDirectorUsesHTTPS	boolean	Gibt true zurück, wenn der aktive nächste Hop Director HTTPS verwendet.
Url des aktiven nächsten Hop Director	ActiveNextHopDirectorURL	string	Die URL des aktiven nächsten Hop Director.

Aktuelle Mauskoordinate abrufen

Vorgangs-ID:: GetCursorPos

Ruft die aktuelle Mauscursorposition in der IA-Connect Agent-Benutzersitzung mithilfe der setcursorpos-API ab.

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
X Pixel	X	integer	Der X-Koordinatenwert (in Pixel).
Y Pixel	Y	integer	Der Y-Koordinatenwert (in Pixel).

Alle anderen IA-Connect Agents töten

Vorgangs-ID:: KillAllOtherAgents

Kills any other instances of the IA-Connect Agent that are currently running in the user session. Dadurch wird sichergestellt, dass nur eine Instanz des IA-Connect Agent ausgeführt wird.

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
Anzahl der getöteten Agenten	NumberOfAgentsKilled	integer	Die Anzahl der IA-Connect Agentprozesse, die getötet wurden.
Anzahl der Agents konnte nicht getötet werden	NumberOfAgentsFailedToKill	integer	Die Anzahl der IA-Connect Agent-Prozesse, die nicht getötet werden konnten.

An die Ebene 1 IA-Connect Sitzung anfügen

Vorgangs-ID:: AttachToTier1IAConnectSession

Fügt an die IA-Connect Director-Sitzung des Director an, der die SOAP- und /oder REST-Nachrichten empfängt. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Virtueller Kanal muss verbunden sein	VirtualChannelMustBeConnected		boolean	Sollte der IA-Connect Director überprüfen, ob der virtuelle Kanal beim Anfügen an die Sitzung verbunden ist? Dadurch wird sichergestellt, dass der IA-Connect Agent in der angegebenen Sitzung ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Angefügter Sitzungsname der Ebene 1 IA-Connect	AttachedTier1IAConnectSessionName	string	Der Name der Sitzung der Ebene 1 IA-Connect, mit der eine Verbindung hergestellt wurde.

An die letzte IA-Connect-Sitzung anfügen

Vorgangs-ID:: AttachToMostRecentIAConnectSession

Fügt an die IA-Connect Director-Sitzung an, die zuletzt verbunden ist (optional eines angegebenen Typs). Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
SuchIA-Connect Sitzungstyp	SearchIAConnectSessionType		string	Der Sitzungstyp, nach dem gesucht werden soll, z. B. "Lokaler Agent", "Microsoft RDP", "Citrix ICA" oder "Remote" für einen beliebigen Remotesitzungstyp. Lassen Sie nichts, um nach einem beliebigen Sitzungstyp zu suchen.
Wartezeit in Sekunden	TimeToWaitInSeconds		integer	Wenn keine Sitzung des angegebenen Typs vorhanden ist (wenn ein bestimmter Typ angegeben wurde), wie lange sollte IA-Connect darauf warten?
Auslösen einer Ausnahme, wenn timeout	RaiseExceptionIfTimedout		boolean	Sollte IA-Connect eine Ausnahme auslösen, wenn eine neue Sitzung noch nicht verbunden ist, bevor der Timeoutzeitraum abgelaufen ist?
Virtueller Kanal muss verbunden sein	VirtualChannelMustBeConnected		boolean	Sollte der IA-Connect Director überprüfen, ob der virtuelle Kanal beim Anfügen an die Sitzung verbunden ist? Dadurch wird sichergestellt, dass der IA-Connect Agent in der angegebenen Sitzung ausgeführt wird.
Nur Anzahl von Sitzungen, die noch nicht angezeigt werden	OnlyCountSessionsNotSeenBefore		boolean	Wenn dieser Wert auf "true" festgelegt ist, werden alle Sitzungen, die von der zuvor ausgeführten Aktion "Verfügbare IA-Connect Sitzungen abrufen" (oder die IA-Connect Inspector-Anzeigesitzungen) im Index nicht gezählt. Dadurch können nur "neue" Sitzungen gezählt werden (z. B. an die erste neue Citrix-Sitzung anfügen).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Angefügter IA-Connect Sitzungsname	AttachedIAConnectSessionName	string	Der Name der IA-Connect Sitzung, der angefügt wurde.
An Sitzung angefügt	AttachedToSession	boolean	Gibt "true" zurück, wenn IA-Connect an eine Sitzung angefügt wurde, oder "false", wenn dies nicht der Fall ist.

An IA-Connect Sitzung mithilfe des Namens anfügen

Vorgangs-ID:: AttachToIAConnectSessionByName

Fügt die angegebene IA-Connect Directorsitzung anhand des Namens an. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
IA-Connect Sitzungsname	IAConnectSessionName	True	string	Der Name der IA-Connect Sitzung, mit der eine Verbindung hergestellt werden soll.
Virtueller Kanal muss verbunden sein	VirtualChannelMustBeConnected		boolean	Sollte der IA-Connect Director überprüfen, ob der virtuelle Kanal beim Anfügen an die Sitzung verbunden ist? Dadurch wird sichergestellt, dass der IA-Connect Agent in der angegebenen Sitzung ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

An IA-Connect Sitzung nach Index anfügen

Vorgangs-ID:: AttachToIAConnectSessionByIndex

Fügt die angegebene IA-Connect Director-Sitzung nach Index an (z. B. an die erste Citrix ICA-Sitzung anfügen). Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
SuchIA-Connect Sitzungstyp	SearchIAConnectSessionType		string	Der Sitzungstyp, nach dem gesucht werden soll, z. B. "Lokaler Agent", "Microsoft RDP", "Citrix ICA" oder "Remote" für einen beliebigen Remotesitzungstyp. Lassen Sie nichts, um nach einem beliebigen Sitzungstyp zu suchen.
Suchen IA-Connect Sitzungsindex	SearchIAConnectSessionIndex		integer	Der Index der Sitzung, mit der eine Verbindung hergestellt werden soll, z. B. 1 für den ersten übereinstimmenden Sitzungstyp, 2 für den zweiten übereinstimmenden Sitzungstyp.
Wartezeit in Sekunden	TimeToWaitInSeconds		integer	Wenn die Sitzung mit dem angegebenen Index nicht vorhanden ist, wie lange sollte IA-Connect darauf warten?
Auslösen einer Ausnahme, wenn timeout	RaiseExceptionIfTimedout		boolean	Sollte IA-Connect eine Ausnahme auslösen, wenn eine neue Sitzung noch nicht verbunden ist, bevor der Timeoutzeitraum abgelaufen ist?
Virtueller Kanal muss verbunden sein	VirtualChannelMustBeConnected		boolean	Sollte der IA-Connect Director überprüfen, ob der virtuelle Kanal beim Anfügen an die Sitzung verbunden ist? Dadurch wird sichergestellt, dass der IA-Connect Agent in der angegebenen Sitzung ausgeführt wird.
Nur Anzahl von Sitzungen, die noch nicht angezeigt werden	OnlyCountSessionsNotSeenBefore		boolean	Wenn dieser Wert auf "true" festgelegt ist, werden alle Sitzungen, die von der zuvor ausgeführten Aktion "Verfügbare IA-Connect Sitzungen abrufen" (oder die IA-Connect Inspector-Anzeigesitzungen) im Index nicht gezählt. Dadurch können nur "neue" Sitzungen gezählt werden (z. B. an die erste neue Citrix-Sitzung anfügen).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Angefügter IA-Connect Sitzungsname	AttachedIAConnectSessionName	string	Der Name der IA-Connect Sitzung, der angefügt wurde.
An Sitzung angefügt	AttachedToSession	boolean	Gibt "true" zurück, wenn IA-Connect an eine Sitzung angefügt wurde, oder "false", wenn dies nicht der Fall ist.

Anhalten der Sitzung am Leben

Vorgangs-ID:: StopKeepSessionAlive

Hält die IA-Connect Agent-Benutzersitzung aktiv.

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
Befehlsergebnis	StopKeepSessionAliveResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Ausführen alternativer IA-Connect Agent, der vom Director gesendet wurde

Vorgangs-ID:: RunAlternativeIAConnectSentFromDirector

Führt einen alternativen IA-Connect Agent (z. B. eine spätere Version) aus, indem der alternative Agent aus dem IA-Connect Director hochgeladen und dann die alternative Agent-ausführbare Datei geladen wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Lokaler Dateiname	LocalFilename	True	string	Der vollständige Pfad zu den alternativen IA-Connect Agent.exe, die vom IA-Connect Director zugänglich sind.
Remotedateiname	RemoteFilename		string	Der vollständige Pfad zum Speicherort, um die alternative IA-Connect Agent.exe (auf dem Remotesystem) zu kopieren. Wenn nicht angegeben, wird ein temporärer Dateiname ausgewählt. Wenn der alternative IA-Connect Agent in den Speicher geladen wird, wird diese Datei nicht erstellt (da sie nicht benötigt wird), es sei denn, Sie legen "Auf Datenträger speichern, auch wenn sie aus dem Arbeitsspeicher ausgeführt wird" auf "true" fest. Sie würden dies nur auf "true" festlegen, wenn Sie die Dynamischen Codeaktionen von IA-Connect verwenden möchten, die "Referenzausführungsassembly" erforderten (z. B. für den Zugriff auf IA-Connect internen Methoden).
Komprimieren	Compress		boolean	Sollte die alternative IA-Connect Agent-ausführbare Datei während des Uploads komprimiert werden?
Arguments	Arguments		string	Alle optionalen Argumente, die beim Ausführen an die IA-Connect Agent.exe übergeben werden sollen.
Downgrade zulassen	PermitDowngrade		boolean	Sollten frühere Versionen von IA-Connect Agent zulässig sein?
Versionsprüfung überspringen	SkipVersionCheck		boolean	Sollte die Version der IA-Connect Agents (vorhanden und neu) überhaupt nicht überprüft werden, was dazu führt, dass die neue Version in allen Szenarien (auch derselben Version) verwendet wird?
Laden in den Arbeitsspeicher	LoadIntoMemory		boolean	Sollte der alternative IA-Connect Agent im Arbeitsspeicher ausgeführt werden? Wenn dieser Wert auf "true" festgelegt ist, wird der neue Agent in den Arbeitsspeicher geladen und innerhalb einer Assembly des vorhandenen Agents ausgeführt. Bei Festlegung auf "false" wird der neue Agent als normaler Prozess ausgeführt, und die vorhandene Agent EXE wird beendet.
Speichern auf dem Datenträger auch dann, wenn sie aus dem Arbeitsspeicher ausgeführt wird	SaveToDiskEvenIfRunningFromMemory		boolean	Sollte der alternative IA-Connect Agent auf dem Datenträger gespeichert werden, auch wenn er im Arbeitsspeicher ausgeführt wird? Sie würden dies nur auf "true" festlegen, wenn Sie die Dynamischen Codeaktionen von IA-Connect verwenden möchten, die "Referenzausführungsassembly" erforderten (z. B. für den Zugriff auf IA-Connect internen Methoden).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Alternative Datei kopiert	AlternativeFileCopied	boolean	Meldet, ob der alternative IA-Connect Agent verwendet wurde.

Ausführen alternativer IA-Connect-Agents

Vorgangs-ID:: RunAlternativeIAConnect

Führt einen alternativen IA-Connect Agent (z. B. eine höhere Version) aus, indem die ausführbare Datei des Agents von einem Dateispeicherort geladen wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateiname	Filename	True	string	Der vollständige Pfad zur alternativen IA-Connect Agent.exe ausgeführt werden soll. Auf diesen Pfad muss über die Sitzung zugegriffen werden kann, in der der IA-Connect Agent derzeit ausgeführt wird.
Arguments	Arguments		string	Alle optionalen Argumente, die beim Ausführen an die IA-Connect Agent.exe übergeben werden sollen.
Laden in den Arbeitsspeicher	LoadIntoMemory		boolean	Sollte der alternative IA-Connect Agent im Arbeitsspeicher ausgeführt werden? Wenn dieser Wert auf "true" festgelegt ist, wird der neue Agent in den Arbeitsspeicher geladen und innerhalb einer Assembly des vorhandenen Agents ausgeführt. Bei Festlegung auf "false" wird der neue Agent als normaler Prozess ausgeführt, und die vorhandene Agent EXE wird beendet.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Ausführen des generischen IA-Connect-Agents-Befehls

Vorgangs-ID:: RunCommand

Führt einen generischen IA-Connect Agent-Befehl aus, der Argumente als JSON übergibt und Ausgabedaten als JSON zurückgibt. Wird zum Ausführen von Agent-Befehlen verwendet, wenn der Director und inspector ältere Versionen als der Agent sind und daher den Befehl nicht verstehen.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
IA-Connect Agent-Befehlsname	CommandName	True	string	Der interne Name des Befehls "IA-Connect Agent". Eine Liste der Befehlsnamen kann von der Aktion "GetAgentActionsInClass" bereitgestellt werden.
Eingabe-JSON	InputJSON		string	Die Eingabe für den Befehl "IA-Connect Agent" im JSON-Format.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Ausgabe-JSON	OutputJSON	string	Die Ausgabe des Befehls IA-Connect Agent im JSON-Format.

Ausführen des PowerShell-Prozesses

Vorgangs-ID:: RunPowerShellProcess

Starten Sie einen PowerShell-Prozess, indem Sie entweder ein vorhandenes Skript auf dem Datenträger ausführen oder den Inhalt des auszuführenden Skripts bereitstellen. Erwägen Sie stattdessen die Verwendung der Aktion "PowerShell-Skript ausführen", die viel leistungsstärker ist, und stellt eine Datentabelle der Ausgabe aus dem PowerShell-Skript bereit. Verwenden Sie diese Aktion, wenn Ihr PowerShell-Skript als Standardausgabe- oder Standardfehler ausgegeben wird (z. B. Write-Host verwendet, anstatt eine Tabelle zurückzugeben), PowerShell 7 erfordert oder Active Directory-Aktionen als alternativer Benutzer ausführt, und CredSSP über WinRM ist nicht verfügbar.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ausführbare PowerShell-Datei	PowerShellExecutable		string	Der Pfad zur ausführbaren PowerShell-Datei. Lassen Sie die Standardeinstellung von "PowerShell.exe" beibehalten, um die standardmäßige ausführbare PowerShell-Datei auszuführen, wie im Windows-Pfad definiert. Verwenden Sie "%SYSTEMROOT%\system32\WindowsPowerShell\v1.0\PowerShell.exe" für PowerShell 5.x. Verwenden Sie "C:\Program Files\PowerShell\7\pwsh.exe" für PowerShell 7. Der IA-Connect Agent erweitert alle Umgebungsvariablen im Pfad.
PowerShell-Skriptdateipfad	PowerShellScriptFilePath		string	Der Pfad zu einem vorhandenen PowerShell-Skript, das ausgeführt werden soll. Auf das PowerShell-Skript sollte vom IA-Connect-Agent zugegriffen werden (d. h. wenn der Agent in einer Remotesitzung ausgeführt wird, sollte sich das Skript auf dem Remotesystem befinden oder über das Remotesystem darauf zugreifen). Lassen Sie diese Eingabe alternativ leer, und geben Sie den Inhalt des PowerShell-Skripts in der Eingabe "PowerShell-Skriptinhalte" an. Der IA-Connect Agent erweitert alle Umgebungsvariablen im Pfad.
PowerShell-Skriptinhalte	PowerShellScriptContents		string	Der Inhalt des auszuführenden PowerShell-Skripts, anstatt den Pfad zu einem vorhandenen PowerShell-Skript bereitzustellen.
Arbeitsordner	WorkingDirectory		string	Der Arbeitsordner/das Arbeitsverzeichnis für das PowerShell-Skript. Der IA-Connect Agent erweitert alle Umgebungsvariablen im Pfad.
Kein Fenster erstellen	CreateNoWindow		boolean	Bei Festlegung auf "true" (Standardeinstellung) wird das PowerShell-Skript nicht sichtbar ausgeführt. Wenn dieser Wert auf "false" festgelegt ist, wird das PowerShell-Skriptfenster angezeigt. Dies kann nützlich sein, wenn das PowerShell-Skript zur Eingabe auffordert und Sie beabsichtigen, UIA- und globale Maus- und Tastaturaktionen für die Interaktion mit ihr zu verwenden.
Fensterformat	WindowStyle		string	Stellen Sie den Fensterstil bereit (normal, maximiert, minimiert oder ausgeblendet), wenn das PowerShell-Skript so konfiguriert ist, dass es sichtbar ausgeführt wird.
Auf Prozess warten	WaitForProcess		boolean	Sollte der IA-Connect Agent warten, bis das PowerShell-Skript abgeschlossen ist? Dies ist standardmäßig auf "true" festgelegt, damit der IA-Connect Agent die Ausgabe des Skripts abrufen kann. Für "Feuer und Vergessen" auf "false" festgelegt.
Umleiten der Standardausgabe	RedirectStandardOutput		boolean	Bei Festlegung auf "true" (Standardeinstellung) wird die Standardausgabe des Skripts umgeleitet, sodass der Agent sie in der StandardOutput-Variablen zurückgeben kann. Dies ist nützlich, wenn Sie die Ausgabe des Skripts an den Agent zurückgeben möchten (z. B. Ausgabe von Write-Host).
Umleitungsstandardfehler	RedirectStandardError		boolean	Wenn dieser Wert auf "true" festgelegt ist, wird der Standardfehler des Skripts umgeleitet, sodass der Agent es in der StandardError-Variablen zurückgeben kann.
Standardfehler zur Ausgabe umleiten	RedirectStandardErrorToOutput		boolean	Wenn dieser Wert auf "true" festgelegt ist, wird der Standardfehler des Skripts an die Standardausgabe umgeleitet, wobei sie in eine einzelne Ausgabe zusammengeführt werden.
Standardausgabecodierung	StandardOutputEncoding		string	Stellen Sie die Standardausgabecodierung bereit (UTF8, UTF7, UTF16, ASCII oder UTF16BE).
Standardfehlercodierung	StandardErrorEncoding		string	Stellen Sie die Standardfehlercodierung bereit (UTF8, UTF7, UTF16, ASCII oder UTF16BE).
RunAs Domain name	RunAsDomain		string	Die Domäne der Ausführung als Benutzer. Wenn keine Domäne angegeben ist, sollte der Benutzername im Format username@domainFQDN sein.
RunAs Username	RunAsUsername		string	Der Benutzername der Ausführung als Benutzer.
RunAs Password	RunAsPassword		password	Das Kennwort der Ausführung als Benutzer.
RunAs Laden des Benutzerprofils	RunAsLoadUserProfile		boolean	Sollte das Windows-Benutzerprofil der Ausführung als Benutzer geladen werden?
RunAs-Erhöhten	RunAsElevate		boolean	Sollte das PowerShell-Skript mit erhöhten Rechten ausgeführt werden? Möglicherweise haben Sie extreme Schwierigkeiten beim Akzeptieren der Anforderung mit erhöhten Rechten.
Timeout in Sekunden	TimeoutInSeconds		integer	Die maximale Anzahl von Sekunden, bis das PowerShell-Skript abgeschlossen ist.
Temporärer PowerShell-Skriptordner	PowerShellScriptTempFolder		string	Wenn Sie standardmäßig ein PowerShell-Skript in der Eingabe "PowerShell-Skriptinhalte" bereitstellen, speichert der IA-Connect Agent das Skript über die -File Eingabe in der Datei "%TEMP%\IA-Connect\TempPowerShell-{Date}-{Time}.ps1', passes it to PowerShell.exe und löscht die Datei, wenn das Skript abgeschlossen wurde. Dieser Standardpfad ist möglicherweise nicht akzeptabel, wenn Sie einen RunAs-Benutzernamen verwenden, da der RunAs-Benutzer möglicherweise nicht auf das Profil des Kontos zugreifen kann, das den IA-Connect Agent ausführt. Verwenden Sie diese Eingabe, um einen alternativen Ordner bereitzustellen. Beispiel: "%SYSTEMDRIVE% emp". Der IA-Connect Agent erweitert alle Umgebungsvariablen im Pfad.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Prozess gestartet	ProcessStarted	boolean	Gibt true zurück, wenn der PowerShell-Skriptprozess (PowerShell.exe) gestartet wurde.
Exitcode	ExitCode	integer	Gibt den PowerShell-Skriptprozess (PowerShell.exe) Ausstiegscode zurück.
Timeout des Prozesses	ProcessTimedOut	boolean	Gibt true zurück, wenn der PowerShell-Skriptprozess (PowerShell.exe) ein Timeout aufweist.
Prozess-ID	ProcessId	integer	Die Prozess-ID des PowerShell-Skriptprozesses (PowerShell.exe), der gestartet wurde.
Standardausgabe	StandardOutput	string	Der Standardausgabeinhalt.
Standardfehler	StandardError	string	Der Standardfehlerinhalt.

Ausführungsprozess

Vorgangs-ID:: RunProcess

Starten Sie einen Prozess, einen Befehl oder eine Anwendung.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Prozessname	ProcessName	True	string	Der auszuführende Prozess. z. B. notepad.exe oder C:\windows\system32\notepad.exe. Der IA-Connect Agent erweitert alle Umgebungsvariablen im Pfad.
Arguments	Arguments		string	Alle Befehlszeilenargumente, die beim Starten der Anwendung verwendet werden sollen.
Arbeitsordner	WorkingDirectory		string	Der Arbeitsordner/das Arbeitsverzeichnis für den Prozess. Der IA-Connect Agent erweitert alle Umgebungsvariablen im Pfad.
Verwenden der Shellausführung	UseShellExecute		boolean	Sollte der Prozess mithilfe der Betriebssystemshell gestartet werden?
Kein Fenster erstellen	CreateNoWindow		boolean	Sollte der Prozess ohne Fenster gestartet werden?
Fensterformat	WindowStyle		string	Stellen Sie den Fensterstil bereit (normal, maximiert, minimiert oder ausgeblendet).
Auf Prozess warten	WaitForProcess		boolean	Sollten wir warten, bis der Vorgang abgeschlossen ist? Dies würde wahrscheinlich nur verwendet werden, wenn ein Programm oder Skript ausgeführt wird, das abgeschlossen werden muss, bevor wir fortfahren können.
Umleiten der Standardausgabe	RedirectStandardOutput		boolean	Sollte die Standardausgabe umgeleitet werden?
Umleitungsstandardfehler	RedirectStandardError		boolean	Sollte der Standardfehler umgeleitet werden?
Standardfehler zur Ausgabe umleiten	RedirectStandardErrorToOutput		boolean	Sollte der Standardfehler an die Ausgabe umgeleitet werden?
Standardausgabecodierung	StandardOutputEncoding		string	Stellen Sie die Standardausgabecodierung bereit (UTF8, UTF7, UTF16, ASCII oder UTF16BE).
Standardfehlercodierung	StandardErrorEncoding		string	Stellen Sie die Standardfehlercodierung bereit (UTF8, UTF7, UTF16, ASCII oder UTF16BE).
RunAs Domain name	RunAsDomain		string	Die Domäne der Ausführung als Benutzer. Wenn keine Domäne angegeben ist, sollte der Benutzername im Format username@domainFQDN sein.
RunAs Username	RunAsUsername		string	Der Benutzername der Ausführung als Benutzer.
RunAs Password	RunAsPassword		password	Das Kennwort der Ausführung als Benutzer.
RunAs Laden des Benutzerprofils	RunAsLoadUserProfile		boolean	Sollte das Windows-Benutzerprofil der Ausführung als Benutzer geladen werden?
RunAs-Erhöhten	RunAsElevate		boolean	Soll der Prozess mit erhöhten Rechten ausgeführt werden?
Timeout in Sekunden	TimeoutInSeconds		integer	Die maximale Anzahl von Sekunden, bis der Vorgang abgeschlossen ist.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Prozess gestartet	ProcessStarted	boolean	Gibt true zurück, wenn der Prozess gestartet wurde.
Exitcode	ExitCode	integer	Gibt den Prozessausgangscode zurück.
Timeout des Prozesses	ProcessTimedOut	boolean	Gibt "true" zurück, wenn der Vorgang ein Timeout aufweist.
Prozess-ID	ProcessId	integer	Die Prozess-ID des gestarteten Prozesses.
Standardausgabe	StandardOutput	string	Der Standardausgabeinhalt.
Standardfehler	StandardError	string	Der Standardfehlerinhalt.

Ausnahme auslösen

Vorgangs-ID:: RaiseException

Lösen Sie eine Ausnahme mit der angegebenen Nachricht aus, wenn die Eingabe ausnahme nicht leer ist. Dies ist hilfreich, um eine Ausnahmemeldung in Ihrem Fluss (HTTP 400) auszulösen, die dann von einer Fehlerbehandlungsphase abgefangen wird, wenn eine frühere Aktion einen Fehler hatte. Diese Ausnahme wird nicht in den Statistiken zur Ausführung IA-Connect Orchestrator-Ablaufs aufgezeichnet.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Eingabe ausnahme	InputException		string	Wenn diese Eingabe ausnahme keine leere Zeichenfolge ist, wird eine Ausnahme mit der bereitgestellten Ausnahmemeldung ausgelöst. Wenn diese Eingabe ausnahme leer ist, führt diese Aktion nichts aus.
Ausnahmemeldung	ExceptionMessage		string	Die ausnahmemeldung, die ausgelöst werden soll.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	RaiseExceptionResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Berechtigung zur Datei hinzufügen

Vorgangs-ID:: AddPermissionToFile

Fügt eine Berechtigung zu einer Datei auf dem Computer hinzu, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	FilePath	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Identität	Identity	True	string	Die Identität des Benutzers oder der Gruppe, dem die Berechtigung zugewiesen werden soll. Dies kann im Format "Benutzername", "DOMÄNE\Benutzername" oder "username@domainfqdn" sein.
Erlaubnis	Permission	True	string	Geben Sie die Berechtigung zum Zuweisen (Lesen, ReadAndExecute, Modify oder FullControl) an, oder lassen Sie die Berechtigung für den Standardwert leer (Lesen).
Deny	Deny		boolean	Wird die Berechtigung verweigert?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Besitzer für Ordner festlegen

Vorgangs-ID:: SetOwnerOnFolder

Legt den Besitzer auf einem Ordner auf dem Computer fest, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ordnerpfad	FolderPath	True	string	Der vollständige Pfad zum Ordner. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Benutzeridentität	UserIdentity	True	string	Die Identität des Benutzers, dem der Besitz zugewiesen werden soll. Dies kann im Format "Benutzername", "DOMÄNE\Benutzername" oder "username@domainfqdn" sein.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Bildschirmauflösung abrufen

Vorgangs-ID:: GetScreenResolution

Gibt die Bildschirmauflösung der IA-Connect Agent-Benutzersitzung zurück. Für den lokalen Agent IA-Connect, der auf einem physischen Desktop oder Laptop ausgeführt wird, enthält dies Informationen zu allen Anzeigegeräten und deren Skalierung. Auf einem virtuellen Computer wird in der Regel nur eine Anzeige gemeldet, es sei denn, der virtuelle Computer wurde so konfiguriert, dass mehrere Displays vorhanden sind (ungewöhnlich). In einer Remotesitzung wird in der Regel nur eine Anzeige gemeldet, auch wenn diese Anzeige mehrere lokale Displays umfasst, da Remotesitzungen in der Regel eine einzelne virtuelle Anzeige erstellen.

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
Horizontale Auflösung	HorizontalResolution	integer	Die horizontale physische Auflösung des primären Bildschirms. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Vertikale Auflösung	VerticalResolution	integer	Die vertikale physische Auflösung des primären Bildschirms. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Anzahl der Bildschirme	NumberOfScreens	integer	Die Anzahl der Bildschirme in dieser Sitzung.
Zweite horizontale Bildschirmauflösung	SecondDisplayHorizontalResolution	integer	Die horizontale physische Auflösung des zweiten Bildschirms, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Zweite vertikale Bildschirmauflösung	SecondDisplayVerticalResolution	integer	Die vertikale physische Auflösung des zweiten Bildschirms, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Dritte horizontale Bildschirmauflösung	ThirdDisplayHorizontalResolution	integer	Die horizontale physische Auflösung des dritten Bildschirms, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Dritte vertikale Auflösung	ThirdDisplayVerticalResolution	integer	Die vertikale physische Auflösung des dritten Bildschirms, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Vierte horizontale Bildschirmauflösung	FourthDisplayHorizontalResolution	integer	Die horizontale physische Auflösung des vierten Bildschirms, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Vierte vertikale Auflösung der Anzeige	FourthDisplayVerticalResolution	integer	Die vertikale physische Auflösung des vierten Bildschirms, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Linke Randpixel des virtuellen Bildschirms	VirtualScreenLeftEdgePixels	integer	Der linke Rand der gesamten virtuellen Anzeige (alle erkannten Anzeigen). Virtuelle Koordinaten werden skaliert.
Obere Randpixel des virtuellen Bildschirms	VirtualScreenTopEdgePixels	integer	Der obere Rand der gesamten virtuellen Anzeige (alle erkannten Anzeigen). Virtuelle Koordinaten werden skaliert.
Pixel für virtuelle Bildschirmbreite	VirtualScreenWidthPixels	integer	Die Breite der gesamten virtuellen Anzeige (alle erkannten Anzeigen). Virtuelle Koordinaten werden skaliert.
Pixel für virtuelle Bildschirmhöhe	VirtualScreenHeightPixels	integer	Die Höhe der gesamten virtuellen Anzeige (alle erkannten Anzeigen). Virtuelle Koordinaten werden skaliert.
Primäre Anzeigeskalierung	PrimaryDisplayScaling	double	Der DPI-Skalierungsmultiplikator der primären Anzeige als Dezimalzahl. Beispiel: 100% werden als 1,0 und 125% als 1.25 zurückgegeben.
Zweite Anzeigeskalierung	SecondDisplayScaling	double	Der DPI-Skalierungsmultiplikator der zweiten Anzeige als Dezimalzahl. Beispiel: 100% werden als 1,0 und 125% als 1.25 zurückgegeben.
Dritte Anzeigeskalierung	ThirdDisplayScaling	double	Der DPI-Skalierungsmultiplikator der dritten Anzeige als Dezimalzahl. Beispiel: 100% werden als 1,0 und 125% als 1.25 zurückgegeben.
Vierte Anzeigeskalierung	FourthDisplayScaling	double	Der DPI-Skalierungsmultiplikator der vierten Anzeige als Dezimalzahl. Beispiel: 100% werden als 1,0 und 125% als 1.25 zurückgegeben.
Physische Bildschirm- linken Randpixel	PhysicalScreenLeftEdgePixels	integer	Der linke Rand der gesamten physischen Anzeige (alle erkannten Anzeigen). Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Obere Randpixel des physischen Bildschirms	PhysicalScreenTopEdgePixels	integer	Der obere Rand der gesamten physischen Anzeige (alle erkannten Anzeigen). Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Pixel für physische Bildschirmbreite	PhysicalScreenWidthPixels	integer	Die Breite der gesamten physischen Anzeige (alle erkannten Anzeigen). Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Physische Bildschirmhöhe Pixel	PhysicalScreenHeightPixels	integer	Die Höhe der gesamten physischen Anzeige (alle erkannten Anzeigen). Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Primäre Anzeige von linken Randpixeln	PrimaryDisplayLeftEdgePixels	integer	Der linke physische Rand der primären Anzeige. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Primäre Anzeige der oberen Randpixel	PrimaryDisplayTopEdgePixels	integer	Der obere physische Rand der primären Anzeige. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Second display left edge pixels	SecondDisplayLeftEdgePixels	integer	Der linke physische Rand der zweiten Anzeige, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Second display top edge pixels	SecondDisplayTopEdgePixels	integer	Der obere physische Rand der zweiten Anzeige, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Dritte Anzeige von linken Randpixeln	ThirdDisplayLeftEdgePixels	integer	Der linke physische Rand der dritten Anzeige, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Dritte Anzeige der oberen Randpixel	ThirdDisplayTopEdgePixels	integer	Der obere physische Rand der dritten Anzeige, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Vierte anzeige linke Randpixel	FourthDisplayLeftEdgePixels	integer	Der linke physische Rand der vierten Anzeige, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.
Vierte Anzeige der oberen Randpixel	FourthDisplayTopEdgePixels	integer	Der obere physische Rand der vierten Anzeige, wenn eine erkannt wurde. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet.

Computerdomäne abrufen

Vorgangs-ID:: GetMachineDomain

Gibt die Domäne des Computers zurück, auf dem die IA-Connect Agent-Benutzersitzung ausgeführt wird.

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
Domänenname	DomainName	string	Der NetBIOS-Domänenname des Computers, auf dem die IA-Connect Agent-Benutzersitzung ausgeführt wird.
DNS-Domänenname	DNSDomainName	string	Der DNS-Domänenname des Computers, auf dem die IA-Connect Agent-Benutzersitzung ausgeführt wird.

Computername abrufen

Vorgangs-ID:: GetMachineName

Gibt den Namen des Computers zurück, auf dem die IA-Connect Agent-Benutzersitzung ausgeführt wird.

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
Maschinenname	MachineName	string	Der Name des Computers, auf dem die IA-Connect Agent-Benutzersitzung ausgeführt wird.

Datei in Zwischenablage kopieren

Vorgangs-ID:: CopyFileToClipboard

Kopiert die angegebene lokale Datei in die Zwischenablage in der IA-Connect Agent-Benutzersitzung.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateiname	Filepath	True	string	Der Dateipfad zur lokalen Datei, die in die Zwischenablage kopiert werden soll.
Ausschneiden	Cut		boolean	Wenn dieser Wert auf "true" festgelegt ist, wird die Datei nicht kopiert, sondern ausgeschnitten.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	CopyFileToClipboardResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Datei kopieren

Vorgangs-ID:: CopyFile

Kopiert eine Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Quelldateipfad	SourceFilePath	True	string	Der vollständige Pfad zur Quelldatei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Zieldateipfad	DestFilePath	True	string	Der vollständige Pfad zum Ziel, in das die Datei kopiert werden soll. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Datei löschen

Vorgangs-ID:: DeleteFile

Löscht eine Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	Filename	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Datei verschieben

Vorgangs-ID:: MoveFile

Verschiebt eine Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Quelldateipfad	SourceFilePath	True	string	Der vollständige Pfad zur Quelldatei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Zieldateipfad	DestFilePath	True	string	Der vollständige Pfad zum Ziel, in das die Datei verschoben werden soll. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Datei vom Client auf den Server kopieren

Vorgangs-ID:: CopyFileFromClientToServer

Kopiert eine Datei vom lokalen Computer (unter Ausführung des IA-Connect Director) auf den Remotecomputer (unter Ausführung des IA-Connect-Agents).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Clientdateipfad	ClientFilePath	True	string	Der Dateipfad zum Kopieren der Datei von (auf dem lokalen Computer, auf dem der IA-Connect Director ausgeführt wird).
Serverdateipfad	ServerFilePath	True	string	Der Dateipfad zum Kopieren der Datei in (auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird).
Komprimieren	Compress		boolean	Sollte die Datei beim Kopieren komprimiert werden?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Dateien löschen

Vorgangs-ID:: DeleteFiles

Löscht Dateien in einem angegebenen Ordner, der einem Muster auf dem Computer entspricht, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Verzeichnispfad	DirectoryPath	True	string	Der vollständige Pfad zum Verzeichnis (Ordner). Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Muster	Pattern		string	Ein Muster, das mit zu löschenden Dateien abgeglichen werden soll, z . B. für alle Dateien oder *.txt für Dateien mit einer .txt Erweiterung.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Anzahl der gelöschten Dateien	NumberOfFilesDeleted	integer	Die Anzahl der Dateien, die erfolgreich gelöscht wurden.
Die Anzahl der Dateien konnte nicht gelöscht werden.	NumberOfFilesFailedToDelete	integer	Die Anzahl der Dateien, die nicht gelöscht werden konnten.

Dateigröße abrufen

Vorgangs-ID:: GetFileSize

Gibt die Größe (in Byte) einer Datei auf dem Computer zurück, auf der der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	Filename	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Dateigröße	FileSize	integer	Die Größe der Datei in Byte.

Doppelklick mit der Maus

Vorgangs-ID:: DoubleLeftClickMouse

Doppelklicken Sie in der IA-Connect Agent-Benutzersitzung auf die linke Maustaste.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Verzögerung in Millisekunden	DelayInMilliseconds		integer	Die Verzögerung zwischen jedem Klick in Millisekunden.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Doppelklick mit der Maus an der Koordinate

Vorgangs-ID:: DoubleLeftClickMouseAtCoordinate

Doppelklicken Sie in der IA-Connect Agent-Benutzersitzung an den angegebenen Koordinaten auf die linke Maustaste. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	XCoord	True	integer	Der X-Koordinatenwert (in Pixel).
Y Pixel	YCoord	True	integer	Der Y-Koordinatenwert (in Pixel).
Verzögerung in Millisekunden	DelayInMilliseconds		integer	Die Verzögerung zwischen jedem Klick in Millisekunden.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Entsperren der Sitzung

Vorgangs-ID:: UnlockSession

Entsperrt die Sitzung, in der der IA-Connect Agent ausgeführt wird. Dazu muss der IA-Connect Entsperrungsanbieter für Anmeldeinformationen auf dem Computer installiert werden, auf dem die Sitzung gehostet wird, da nur ein Anmeldeinformationsanbieter einen Computer entsperren kann.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kennwort entsperren	UnlockPassword	True	string	Das Kennwort zum Entsperren der aktuellen Sitzung. Dies ist das Windows-Benutzerkennwort für das Konto, das bei der aktuell gesperrten Sitzung angemeldet ist. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest.
Kennwort enthält gespeichertes Kennwort	PasswordContainsStoredPassword		boolean	Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss).
Erkennen, ob gesperrt	DetectIfLocked	True	boolean	Sollte der IA-Connect Agent versuchen, zu erkennen, ob die Sitzung gesperrt ist. Wenn "true" festgelegt ist und die Sitzung nicht als gesperrt erkannt wird, führt diese Aktion einfach nichts aus (da nichts zu tun ist). Wird nur auf "false" festgelegt, wenn IA-Connect falsch erkennt, ob die Sitzung gesperrt ist und Sie einen Entsperrungsversuch erzwingen möchten (was fehlschlägt, wenn die Sitzung nicht gesperrt ist).
Erkennen des Anmeldeinformationsanbieters	DetectCredentialProvider	True	boolean	Sollte der IA-Connect Agent versuchen, das Vorhandensein des IA-Connect Entsperrungs-Anmeldeinformationsanbieters zu erkennen, bevor eine Entsperrungsanforderung gesendet wird. Sie sollten dies nur deaktivieren, wenn der IA-Connect Anmeldeinformationsanbieter vorhanden und ausgeführt wird, aber aus irgendeinem Grund wird der IA-Connect Agent es nicht erkennt.
Sekunden, die auf die Entsperrung warten	SecondsToWaitForUnlock		integer	Wie lange (in Sekunden) sollte der IA-Connect Agent auf Nachweise warten, dass der Desktop erfolgreich entsperrt wurde (indem der Zustand der Desktopsperrung erkannt wird). Standardmäßig beträgt dies bis zu 5 Sekunden. Legen Sie auf 0 fest, um dieses Feature zu deaktivieren, und fahren Sie fort, ohne zu überprüfen, ob der Desktop entsperrt wurde.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Sitzungsentsperrung ausgeführt	SessionUnlockPerformed	boolean	Auf "true" festgelegt, wenn die Sitzung gesperrt wurde und eine Entsperrungsaktion ausgeführt wurde. Auf "false" festgelegt, wenn die Sitzung nicht gesperrt wurde und "Erkennen, ob gesperrt" auf "true" festgelegt wurde, was dazu führt, dass keine Aktion ausgeführt wird.

EntZIP-Datei

Vorgangs-ID:: UnZIPFile

Entzippt eine Datei, die mithilfe der ZIP-Komprimierung komprimiert wurde.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
ZIP-Dateipfad	ZIPFilename	True	string	Der vollständige Pfad zur ZIP-Datei, die entzippt werden soll. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Ordner extrahieren	ExtractFolder		string	Der Ordnerpfad des Ordners, in den die ZIP-Datei extrahiert werden soll. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Extrahieren aller Dateien in einen einzelnen Ordner	ExtractAllFilesToSingleFolder		boolean	Bei Festlegung auf "True" wird die Ordnerstruktur innerhalb der ZIP-Datei ignoriert, und alle Dateien werden in den angegebenen Ordner extrahiert.
Regulärer Dateiausdruck einschließen	IncludeFilesRegEx		string	Ein optionaler regulärer Ausdruck, mit dem Sie angeben können, welche Dateien extrahiert werden sollen. Stimmt nur mit dem Dateinamen überein.
Regulärer Ausdruck für Dateien ausschließen	ExcludeFilesRegEx		string	Ein optionaler regulärer Ausdruck, mit dem Sie angeben können, welche Dateien von der Extraktion ausgeschlossen werden sollen. Stimmt nur mit dem Dateinamen überein.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Anzahl der erfolgreich extrahierten Dateien	FilesExtractedSuccessfully	integer	Die Anzahl der Dateien, die erfolgreich aus der ZIP-Datei extrahiert wurden.
Die Anzahl der Dateien konnte nicht extrahiert werden.	FilesFailedToExtract	integer	Die Anzahl der Dateien, die nicht aus der ZIP-Datei extrahiert werden konnten.
Anzahl der ausgeschlossenen Dateien	FilesExcluded	integer	Die Anzahl der Dateien, die ausgeschlossen wurden (wenn die Eingabe "Regulärer Ausdruck für Dateien ausschließen" verwendet wird).

Ersetzen von Variablendaten in der INI-Datei

Vorgangs-ID:: ReplaceVariableDataInINIFile

Aktualisiert eine einzelne Variable in einer INI-Datei.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
INI-Dateipfad	InputFilename	True	string	Der vollständige Pfad zur INI-Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Ausgabe-INI-Dateipfad	OutputFilename		string	Wenn Sie die aktualisierte INI-Datei in eine alternative Datei schreiben möchten, geben Sie hier den vollständigen Pfad zur Ausgabedatei ein. Die EINGABE-INI-Datei wird nicht geändert – die INI-Ausgabedatei enthält die Änderungen.
INI-Suchabschnitt	SearchSection		string	Der optionale Name des Abschnitts, in dem die Variable geändert werden soll.
INI-Suchvariablenname	SearchVariable		string	Der Name der zu aktualisierenden Variablen.
Ersatzdaten	ReplaceData		string	Die Ersetzungsdaten, auf die die Variable aktualisiert werden soll.
INI-Dateicodierung	InputFilenameEncoding		string	Geben Sie die INI-Dateicodierung (Unicode, UTF8, UTF7 oder ASCII) an, oder geben Sie den Codierungswert an (z. B. 1252 für Westeuropa).
Neue Datei erstellen, wenn keine Eingabedatei vorhanden ist	CreateNewFileIfNotExists		boolean	Wenn die Eingabedatei nicht vorhanden ist, sollte eine neue erstellt werden?
Schreibbereich vor gleichheitsgleich	WriteSpaceBeforeEquals		boolean	Sollte vor dem Gleichheitszeichen ( = ) ein Leerzeichen geschrieben werden?
Schreiben von Leerzeichen nach gleichheitsgleich	WriteSpaceAfterEquals		boolean	Soll nach dem Gleichheitszeichen ( = ) ein Leerzeichen geschrieben werden?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Erstellen eines einmal geheimen Orchestrator-Schlüssels

Vorgangs-ID:: CreateOrchestratorOneTimeSecret

Ein einmaliges Geheimnis bietet eine Möglichkeit, einen geheimen Schlüssel zu speichern, der einmal über eine nichtguessierbare eindeutige URL abgerufen werden kann. Dies wird in der Regel verwendet, um geheime Schlüssel mit einem Drittanbieter zu teilen. Sie können einen einmaligen Geheimschlüssel mithilfe der Orchestrator-Benutzeroberfläche, der REST-API oder aus Ihrem Flow erstellen.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Freundlicher Name	FriendlyName	True	string	Dies ist ein beschreibender Name, der ausschließlich verwendet wird, um dieses einmalige Geheimnis zu identifizieren. Der einzige Zweck dieses Namens ist die Anzeige in der Liste der geheimen Schlüssel in der Orchestrator-Benutzeroberfläche.
Geheimer Wert	SecretValue		password	Der einmalige geheime Wert, den Sie freigeben und über eine einmalige URL zur Verfügung stellen möchten.
Abrufausdruck 1	RetrievalPhrase1		password	Dies ist ein Ausdruck, der zum Abrufen des einmaligen Geheimniss über die eindeutige URL erforderlich ist. Wenn sie leer gelassen wird, ist kein Abrufausdruck erforderlich. Bei Abrufphasen wird die Groß-/Kleinschreibung beachtet.
Abrufausdruck 2	RetrievalPhrase2		password	Dies ist ein zweiter Ausdruck, der zum Abrufen des einmaligen Geheimniss über die eindeutige URL erforderlich ist. Wenn sie leer gelassen wird, ist kein Abrufausdruck erforderlich. Bei Abrufphasen wird die Groß-/Kleinschreibung beachtet.
Maximale Abrufe vor dem Löschen	MaximumRetrievalsBeforeDeletion		integer	Wie oft kann dieser einmalige Geheimschlüssel abgerufen werden, bevor er aus dem Orchestrator gelöscht wird? Standardmäßig ist dies auf 1 (einmal) festgelegt. Wird nur auf einen höheren Wert festgelegt, wenn mehrere Personen auf diesen geheimen Schlüssel zugreifen müssen.
Geheimer Schlüssel hat ein Startdatum	SecretHasAStartDate		boolean	Aktivieren Sie, ob der geheime Schlüssel erst zum Abrufen verfügbar sein soll, bis ein bestimmtes Datum und eine bestimmte Uhrzeit.
Geheimes Startdatum und -uhrzeit	SecretStartDateTime		date-time	Das Datum und die Uhrzeit, zu dem dieser geheime Schlüssel zum Abrufen verfügbar wird. Datums- und Uhrzeitangaben werden im FORMAT TT/MM/JJJJ HH:mm eingegeben und in UTC / GMT+0 gespeichert und verarbeitet. Beispiel: "2022-01-24T07:00:00" würde den einmaligen Geheimschlüssel vor 07,00 Stunden UTC (GMT+0) am 24. Januar 2022 beenden (Sie erhalten einen 404). Alternativ können Sie die Eingabe "Stunden bis zur geheimen Startzeit" verwenden. Wenn Sie diese Eingabe verwenden, müssen Sie "Secret has a start date" auf "true" festlegen, oder die Eingabe wird ignoriert.
Stunden bis zur geheimen Startzeit	HoursUntilSecretStartTime		integer	Die Anzahl der Stunden, bis dieser geheime Schlüssel zum Abrufen verfügbar ist. Alternativ können Sie die Eingabe "Geheimes Startdatum und -uhrzeit" verwenden. Wenn Sie diese Eingabe verwenden, müssen Sie "Secret has a start date" auf "true" festlegen.
Geheimer Schlüssel hat ein Ablaufdatum	SecretHasAnExpiryDate		boolean	Aktivieren Sie, ob der geheime Schlüssel nach einem bestimmten Zeitraum automatisch gelöscht werden soll, unabhängig davon, ob er abgerufen wurde.
Datum und Uhrzeit des geheimen Ablaufs	SecretExpiryDateTime		date-time	Das Datum und die Uhrzeit, zu dem dieser geheime Schlüssel automatisch gelöscht wird, unabhängig davon, ob er abgerufen wurde. Datums- und Uhrzeitangaben werden im Format jjjj-MM-ttTHH:mm:ss eingegeben und in UTC / GMT+0 gespeichert und verarbeitet. Beispiel: "2022-01-24T07:00:00" würde das einmalige Geheimnis um 07.00 Stunden UTC (GMT+0) am 24. Januar 2022 löschen. Alternativ können Sie die Eingabe "Stunden bis zum Ablauf des geheimen Schlüssels" verwenden. Wenn Sie diese Eingabe verwenden, müssen Sie "Geheimnis hat ein Ablaufdatum" auf "true" festlegen, oder die Eingabe wird ignoriert.
Stunden bis zum Ablauf des geheimen Schlüssels	HoursUntilSecretExpiry		integer	Die Anzahl der Stunden, bis dieser geheime Schlüssel automatisch gelöscht wird, unabhängig davon, ob er abgerufen wurde. Verwenden Sie alternativ die Eingabe "Geheimes Ablaufdatum und -uhrzeit". Wenn Sie diese Eingabe verwenden, müssen Sie "Geheimes Datum hat ein Ablaufdatum" auf "true" festlegen.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Abruf-URL	RetrievalURL	string	Die einmalige URL, die zum Abrufen des einmaligen Schlüssels verwendet wird.
Abruf-ID	RetrievalId	string	Die eindeutige Abruf-ID. Diese einmalige URL wird aus dieser eindeutigen ID erstellt. Diese ID kann nützlich sein, wenn Sie ihre eigene URL in einem benutzerdefinierten Szenario erstellen müssen.

Fehlermeldung "Fehlgeschlagene Aktion abrufen" aus Ablaufergebnis-JSON

Vorgangs-ID:: GetFailedActionErrorMessageFromPowerAutomateResultJSON

Deserialisiert die JSON-Ausgabe eines oder mehrerer Flow result()-Ausdrücke und ruft die erste gefundene Fehlermeldung aus einer fehlgeschlagenen Aktion ab. Die Fehlermeldung kann in der JSON in einer Vielzahl von Formaten gespeichert werden. Diese Aktion verarbeitet bekannte Formate und gibt die erste gefundene Fehlermeldung zurück.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ablaufergebnis JSON	PowerAutomateResultJSON	True	array of string	Ein Array von JSON, das die Ausgaben aus einem oder mehreren Flow result()-Ausdrücken enthalten soll. Wenn Sie nur die Ausgabe eines einzelnen Flussergebnisses()-Ausdrucks verarbeiten, geben Sie dies einfach in das erste Arrayelement ein.
Suchstatus	SearchStatus		string	Der Status der Aktion, die die Fehlermeldung enthält. Dies sollte nur geändert werden, wenn Sie nach einem Status suchen, der sich vom Standardwert "Fehlgeschlagen" unterscheidet.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Aktionsfehlermeldung	ActionErrorMessage	string	Gibt die aus dem Ergebnis-JSON extrahierte Aktionsfehlermeldung zurück. Wenn eine Fehlermeldung nicht gefunden werden konnte, wird ein leerer Wert zurückgegeben.
Aktionsname	ActionName	string	Gibt den Namen der Aktion zurück, die der Fehlermeldung zugeordnet ist.
Aktionscode	ActionCode	string	Gibt den Ergebniscode der Aktion zurück, die der Fehlermeldung zugeordnet ist.

Festlegen der Mausbewegungsmethode

Vorgangs-ID:: SetMouseMoveMethod

Legt die aktuelle Mausbewegungsmethode entweder auf mouse_event oder setcursorpos fest.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Festlegen der Mausbewegungsmethode	MouseMoveMethod	True	string	Stellen Sie die Mausbewegungsmethode bereit (mouse_event oder setcursorpos).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen der Mauscursorposition

Vorgangs-ID:: SetCursorPos

Legt den Mauszeiger in der IA-Connect Agent-Benutzersitzung auf die angegebene Position fest. Die setcursorpos-API wird verwendet, um die Maus zu verschieben, unabhängig von der ausgewählten aktiven Mausbewegungs-API.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	X	True	integer	Der X-Koordinatenwert (in Pixel).
Y Pixel	Y	True	integer	Der Y-Koordinatenwert (in Pixel).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen der Zwischenablage

Vorgangs-ID:: SetClipboardData

Legt den Inhalt der Zwischenablage in der IA-Connect Agent-Benutzersitzung fest.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Neue Zwischenablagedaten	NewClipboardData		string	Die daten, die in der Zwischenablage festgelegt werden sollen.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen des Besitzers für die Datei

Vorgangs-ID:: SetOwnerOnFile

Legt den Besitzer auf einer Datei auf dem Computer fest, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	FilePath	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Benutzeridentität	UserIdentity	True	string	Die Identität des Benutzers, dem der Besitz zugewiesen werden soll. Dies kann im Format "Benutzername", "DOMÄNE\Benutzername" oder "username@domainfqdn" sein.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen des Mausmultiplikators

Vorgangs-ID:: SetMouseMultiplier

Legt den globalen Mausmultiplikator in der IA-Connect Agent-Benutzersitzung fest. Dies kann während der Entwicklung hilfreich sein, wenn Probleme mit der Remotedesktopskalierung auftreten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Multiplikator	MouseXMultiplier		double	Der horizontale (X) globale Mausmultiplikator, der festgelegt werden soll (für den Zeitpunkt, an dem der Agent die Maus bewegt). Der Multiplikator hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Y-Multiplikator	MouseYMultiplier		double	Der zu festlegende vertikale (Y)-Mausmultiplizierer (für den Zeitpunkt, an dem der Agent die Maus bewegt). Der Multiplikator hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Für mouse_event übernehmen	ApplyToMouseEvent		boolean	Dieses Argument gibt an, ob die globalen Mausmultiplikatorwerte auf die mouse_event-Methode angewendet werden sollen.
Anwenden auf SetCursorPos	ApplyToSetCursorPos		boolean	Dieses Argument gibt an, ob die globalen Mausmultiplikatorwerte auf die SetCursorPos-Methode angewendet werden sollen.
Apply to current mouse move method	ApplyToCurrentMouseMoveMethod		boolean	Dieses Argument gibt an, ob die globalen Mausmultiplikatorwerte auf die aktuelle Mausbewegungsmethode angewendet werden sollen (z. B. wenn SetCursorPos die aktuelle Mausverschiebungsmethode ist, wird der Multiplikator auf SetCursorPos angewendet). Wenn dies auf "true" festgelegt ist, werden die Eingaben "Für mouse_event übernehmen" und "Für SetCursorPos übernehmen" ignoriert.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen des Orchestrator-Arbeitswartungsmodus

Vorgangs-ID:: SetOrchestratorWorkerMaintenanceMode

Setzen Sie einen IA-Connect Worker, der im IA-Connect Orchestrator definiert ist, in den Wartungsmodus ein (sodass den Arbeitsflüssen nicht zugewiesen werden), oder nehmen Sie einen Mitarbeiter aus dem Wartungsmodus.

Parameter

Name	Schlüssel	Typ	Beschreibung
Arbeits-ID	WorkerId	integer	Die ID des Workers. Dies ist ein ganzzahliger Wert (1 oder höher), intern für den Orchestrator. Sie können die ID eines Mitarbeiters ermitteln, indem Sie die Arbeitsdetails in der Orchestrator-Benutzeroberfläche anzeigen und in der Browser-URL nach der ID suchen. Wenn Sie nach dem Namen des Mitarbeiters suchen möchten, legen Sie diesen Wert auf 0 fest, und geben Sie einen Namen in das Feld "Arbeitsname" ein.
Name der Arbeitskraft	WorkerName	string	Der Name des Workers. Dies führt dazu, dass der Orchestrator seine Liste der Mitarbeiter nach einem Arbeiter mit dem angegebenen Namen durchsucht. Wenn Sie nach Namen suchen, legen Sie "Arbeits-ID" auf 0 fest (um die Verwendung der Arbeits-ID zu deaktivieren).
Wartungsmodus	MaintenanceMode	boolean	Legen Sie auf "true" (Standardeinstellung) fest, um den Wartungsmodus zu aktivieren, sodass flüsse dem Worker nicht zugewiesen werden. Legen Sie auf "false" fest, um den Wartungsmodus zu verlassen, sodass dem Mitarbeiter Abläufe zugewiesen werden können (vorausgesetzt, der Mitarbeiter wird von anderen Regeln nicht verweigert).

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	SetOrchestratorWorkerMaintenanceModeResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Festlegen einer Sprachausgabe

Vorgangs-ID:: SetScreenReader

Aktiviert oder deaktiviert die Sprachausgabe in der IA-Connect Agent-Benutzersitzung.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Aktivieren der Sprachausgabe	EnableScreenReader		boolean	Wenn dieser Wert auf "true" festgelegt ist, wird die Sprachausgabe aktiviert. Wenn dieser Wert auf "false" festgelegt ist, wird die Sprachausgabe deaktiviert.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen IA-Connect Agent-Befehlstimeout

Vorgangs-ID:: SetRPACommandTimeout

Legt das Befehlstimeout fest, das der IA-Connect Agent für jeden ausgeführten Befehl verwendet.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Befehlstimeout in Sekunden	CommandTimeoutInSeconds	True	integer	Das Befehlstimeout, das der IA-Connect Agent verwendet. Wenn Sie große Datenmengen lesen oder schreiben, können Sie den Timeoutzeitraum erhöhen.
Beenden von Timedout-RPA-Befehlsthreads	TerminateTimedoutRPACommandThreads		boolean	Sollte der Befehlsthread beendet werden, wenn er ein Timeout ausgeführt hat?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen IA-Connect Agent-GUI-Deckkraft

Vorgangs-ID:: SetRSAGUIOpacity

Legt die Deckkraft des IA-Connect Agent von 1 (sichtbar) auf 0 (transparent) fest.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Undurchsichtigkeit	Opacity	True	double	Der festzulegende Deckkraftwert zwischen 1 (sichtbar) und 0 (transparent).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen IA-Connect Agent-GUI ganz oben

Vorgangs-ID:: SetRSAGUITopmost

Legt den IA-Connect Agent ganz oben fest. Dies bedeutet, dass der IA-Connect Agent immer auf dem Bildschirm sichtbar ist und nicht hinter anderen Anwendungsfenstern ausgeblendet werden kann.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Oberst	TopMost		boolean	Soll der IA-Connect Agent ganz oben (true) festgelegt werden oder sollte oberster Wert deaktiviert werden (false)?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen IA-Connect Agent-GUI-Position

Vorgangs-ID:: SetRSAGUIPosition

Legt die Position des IA-Connect Agent-GUI auf den angegebenen Speicherort fest.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X	X	True	integer	Die X-Koordinate, auf die der Agent in Pixel festgelegt werden soll.
J	Y	True	integer	Die Y-Koordinate, auf die der Agent in Pixel festgelegt werden soll.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen IA-Connect Agent-Protokollebene

Vorgangs-ID:: SetRemoteLoggingLevel

Legt die IA-Connect Agent-Protokollierungsebene auf den angegebenen Wert fest (1 ist die niedrigste Ebene und 4 ist die höchste).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Protokollebene	LoggingLevel	True	integer	Die Protokollierungsebene, auf die der IA-Connect Agent festgelegt werden soll.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen IA-Connect Director-Protokollebene

Vorgangs-ID:: SetLocalLoggingLevel

Legt die IA-Connect Director-Protokollierungsebene auf den angegebenen Wert fest. Die Protokollierungsebenen werden von 0 bis 4 festgelegt. 0 ist deaktiviert. 1 ist die niedrigste Protokollebene (und der Standardwert). 4 ist die höchste Protokollebene.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Protokollebene	LoggingLevel	True	integer	Die Protokollierungsebene, auf die der IA-Connect Director festgelegt werden soll.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Festlegen IA-Connect globalen Koordinatenkonfiguration des Agents

Vorgangs-ID:: SetAgentGlobalCoordinateConfiguration

Konfiguriert das globale Koordinatensystem IA-Connect Agent, das verwendet wird, um Elementpositionen (z. B. während der Mausüberprüfung) anzuzeigen und Mauspositionen zu berechnen (z. B. beim Ausführen von globalen Mausaktionen). Die Standardwerte stellen die neueste Funktionalität bereit, aber Sie können diese Aktion verwenden, um auf das Verhalten in früheren Versionen des Agents zurückgesetzt zu werden oder anzugeben, dass eine API ein anderes Koordinatensystem verwendet.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Funktionen für mehrere Monitore	MultiMonitorFunctionality		string	Legen Sie auf "Primäre Anzeige" (PrimaryMonitor) fest, um auf ein älteres Verhalten zurückgesetzt zu werden, das nur das Hervorheben von Elementen und das Ausführen von globalen Mausaktionen auf dem primären Anzeigegerät unterstützt (der einzige verfügbare Modus in IA-Connect 9.3 und früher). Legen Sie auf "Alle Displays" (MultiMonitor) fest, um das Hervorheben von Elementen und das Ausführen von globalen Mausaktionen auf allen Monitoren zu aktivieren und die DPI-Skalierung auf jedem Monitor automatisch zu erkennen (der Standardwert seit IA-Connect 9.4). Legen Sie den Wert "Nicht festgelegt" (NotSet) fest, um keine Änderung vorzunehmen.
Auto Set Mouse Inspection Multiplier	AutoSetMouseInspectionMultiplier		string	Legen Sie auf "Auto" (1) (die Standardeinstellung seit IA-Connect 9.4) fest, um automatisch den Mausüberprüfungsmultiplikator auf dem primären Anzeigegerät beim Start des Agents zu berechnen, und jedes Mal, wenn die Mausüberprüfung ausgeführt wird. Legen Sie auf "Manuell" (0) fest, damit der Inspektionsmultiplikator manuell festgelegt werden muss (die einzige verfügbare Option in IA-Connect 9.3 und früher). Legen Sie diesen Wert auf "Leer" oder "NotSet" fest, um diese Option unverändert zu lassen. Diese Option hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Automatisches Festlegen des globalen Mausmultiplikators	AutoSetGlobalMouseMultiplier		string	Legen Sie auf "Auto" (1) (die Standardeinstellung seit IA-Connect 9.4) fest, um automatisch den globalen Mausbewegungsmultiplikator auf dem primären Anzeigegerät beim Agent-Start und bei jeder Ausführung der Mausüberprüfung zu berechnen. Legen Sie auf "Manuell" (0) fest, damit der globale Mausbewegungsmultiplikator manuell festgelegt werden soll (die einzige verfügbare Option in IA-Connect 9.3 und früher). Legen Sie diesen Wert auf "Leer" oder "NotSet" fest, um diese Option unverändert zu lassen. Diese Option hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Mausinspektion X Multiplizierer	MouseInspectionXMultiplier		double	Der horizontale (X)-Mausüberprüfungsmultiplikator, der festgelegt werden soll (wenn der Agent hervorhebung, was sich unter der Maus befindet). Beispiel: Wenn IA-Connect das Inspektionsrechteck an der hälfte der tatsächlichen Position der Maus X anzeigt, legen Sie den Wert 0,5 fest. Legen Sie den Wert auf 0 fest, um den aktuellen Wert unverändert zu lassen. Diese Option hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist und "Auto Set mouse inspection multiplier" deaktiviert ist.
Mausinspektion Y-Multiplizierer	MouseInspectionYMultiplier		double	Der vertikale (Y)-Mausüberprüfungsmultiplikator, der festgelegt werden soll (für den Fall, dass der Agent hervorhebung, was sich unter der Maus befindet). Beispiel: Wenn IA-Connect das Inspektionsrechteck an der Hälfte der tatsächlichen Maus-Y-Position anzeigt, legen Sie den Wert 0,5 fest. Legen Sie den Wert auf 0 fest, um den aktuellen Wert unverändert zu lassen. Diese Option hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist und "Auto Set mouse inspection multiplier" deaktiviert ist.
Global mouse X multiplier	GlobalMouseXMultiplier		double	Die horizontale (X) globale Mausbewegung multiplizieren, die festgelegt werden soll (für den Zeitpunkt, an dem der Agent die Maus bewegt). Legen Sie den Wert auf 0 fest, um den aktuellen Wert unverändert zu lassen. Diese Option hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Globale Maus Y-Multiplizierer	GlobalMouseYMultiplier		double	Die vertikale (Y) globale Mausbewegung multiplizieren, die festgelegt werden soll (für den Zeitpunkt, an dem der Agent die Maus bewegt). Legen Sie den Wert auf 0 fest, um den aktuellen Wert unverändert zu lassen. Diese Option hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Für mouse_event übernehmen	GlobalMouseMultiplierApplyToMouseEvent		boolean	Dadurch wird angegeben, ob die globalen Mausmultiplikatorwerte auf die mouse_event-Methode angewendet werden sollen. Diese Option hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Anwenden auf SetCursorPos	GlobalMouseMultiplierApplyToSetCursorPos		boolean	Dieses Argument gibt an, ob die globalen Mausmultiplikatorwerte auf die SetCursorPos-Methode angewendet werden sollen. Diese Option hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Apply to current mouse move method	GlobalMouseMultiplierApplyToCurrentMouseMoveMethod		boolean	Dieses Argument gibt an, ob die globalen Mausmultiplikatorwerte auf die aktuelle Mausbewegungsmethode angewendet werden sollen (z. B. wenn SetCursorPos die aktuelle Mausverschiebungsmethode ist, wird der Multiplikator auf SetCursorPos angewendet). Wenn dies auf "true" festgelegt ist, werden die Eingaben "Für mouse_event übernehmen" und "Für SetCursorPos übernehmen" ignoriert. Diese Option hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Java-Koordinatensystem	JavaCoordinateSystem		string	Legen Sie auf "Virtual" fest (standard und die einzige verfügbare Option in IA-Connect 9.3 und früher), um den Agent darüber zu informieren, dass die Java Access Bridge virtuelle Koordinaten (DPI-skaliert) bereitstellt. Legen Sie diesen auf "Physisch" fest, um den Agent darüber zu informieren, dass die Java Access Bridge physische Koordinaten bereitstellt (die direkt Pixeln zugeordnet sind). Legen Sie den Wert "Nicht festgelegt" (NotSet) fest, um keine Änderung vorzunehmen.
SAP-GUI-Koordinatensystem	SAPGUICoordinateSystem		string	Legen Sie den Wert auf "Virtuell" fest (standard und die einzige verfügbare Option in IA-Connect 9.3 und früher), um den Agent darüber zu informieren, dass die SAP-GUI-Skript-API virtuelle Koordinaten (DPI-skalierte) Koordinaten bereitstellt. Legen Sie den Satz auf "Physisch" fest, um den Agent darüber zu informieren, dass die SAP-GUI-Skript-API physische Koordinaten bereitstellt (die direkt Pixeln zugeordnet sind). Legen Sie den Wert "Nicht festgelegt" (NotSet) fest, um keine Änderung vorzunehmen.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	SetAgentGlobalCoordinateConfigurationResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Festlegen IA-Connect Lizenzschlüssels

Vorgangs-ID:: SetLicenseString

Lizenziert den IA-Connect Agent mit einem Lizenzschlüssel. Hierbei kann es sich um eine Lizenzzeichenfolge oder den Anzeigenamen einer lizenz im IA-Connect Orchestrator handelt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Lizenzschlüssel	LicenseString	True	string	Die IA-Connect Lizenzschlüsselzeichenfolge oder der Anzeigename einer im IA-Connect Orchestrator gespeicherten Lizenz (wenn IA-Connect über den IA-Connect Orchestrator gesteuert wird).
Speichern in der Registrierung	StoreInRegistry		boolean	Sollte die IA-Connect-Lizenz vorübergehend in der Registrierung gespeichert werden? Dadurch wird sichergestellt, dass der IA-Connect Agent für die Dauer der Benutzersitzung lizenziert wird, auch wenn der Agent geschlossen und erneut gestartet wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Tage bis zum Ablauf der Lizenz	DaysUntilLicenseExpires	integer	Die Anzahl der verbleibenden Tage bis zum Ablauf der IA-Connect Lizenz.

Festlegen von Ausgabedaten für Orchestrator-Automatisierungsaufgaben

Vorgangs-ID:: TasksSetOutputData

Legt die Ausgabedaten für eine Orchestrator-Automatisierungsaufgabe fest. Wird häufig verwendet, wenn Sie eine Aufgabe abgeschlossen haben und Ausgabedaten bereitstellen möchten, die vom Prozess erfasst werden sollen, der die Aufgabe erstellt hat.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	TaskId	True	integer	Die ID der Orchestrator-Aufgabe, der die Notiz hinzugefügt werden soll.
Vorgangsausgabedaten	TaskOutputData		string	Die Ausgabedatenzeichenfolge. Dies kann als beliebiges Textformat Ihrer Wahl formatiert werden, z. B. JSON oder XML oder Unformatierter Text. Die Ausgabedatenzeichenfolge kann in der Orchestrator-Benutzeroberfläche angezeigt oder über die TasksGetTask-REST-API aufgerufen werden.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	TasksSetOutputDataResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Festlegen von IA-Connect Lizenzcode

Vorgangs-ID:: SetLicenseCode

Lädt eine Agent-Domänenlizenz im alten Stil (7.0 und 7.1) in den IA-Connect Agent hoch.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
NetBIOS-Domänenname des Kunden	CustomerNETBIOSDomainName	True	string	Der NetBIOS-Domänenname des Computers, auf dem der IA-Connect Agent ausgeführt wird.
Anzeigename des Kunden	CustomerDisplayName	True	string	Der Kundenname, der in der Titelleiste des IA-Connect Agenten angezeigt werden soll.
Lieferantenname	VendorName	True	string	Der Name des IA-Connect Anbieters.
Ablaufdatum der Lizenz	LicenseExpiryDate	True	string	Das Ablaufdatum der IA-Connect-Lizenz.
Aktivierungscode	ActivationCode	True	string	Der Aktivierungscode für die IA-Connect-Lizenz.
Speichern in der Registrierung	StoreInRegistry		boolean	Sollte die IA-Connect-Lizenz vorübergehend in der Registrierung gespeichert werden? Dadurch wird sichergestellt, dass der IA-Connect Agent für die Dauer der Benutzersitzung lizenziert wird, auch wenn der Agent geschlossen und erneut gestartet wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Get mouse move method

Vorgangs-ID:: GetMouseMoveMethod

Ruft die aktuelle Mausbewegungsmethode ab.

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
Mausbewegungsmethode	MouseMoveMethod	string	Gibt die aktuelle Mausbewegungsmethode zurück (entweder mouse_event oder setcursorpos).

Gibt die Datei an

Vorgangs-ID:: FileExists

Meldet wahr oder falsch, ob eine Datei auf dem Computer vorhanden ist, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	Filename	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Die Datei ist vorhanden	FileExists	boolean	Gibt true zurück, wenn die Datei vorhanden ist, oder false, wenn dies nicht der Fall ist.

Gibt IA-Connect Sitzung anhand des Namens an

Vorgangs-ID:: DoesIAConnectSessionExistByName

Gibt zurück, wenn die angegebene IA-Connect Director-Sitzung vorhanden ist. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden. Der Name wird aus einer früheren Aktion "Anfügen" bekannt sein.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
IA-Connect Sitzungsname	IAConnectSessionName	True	string	Der Name der zu überprüfenden IA-Connect Sitzung.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
IA-Connect Sitzung ist vorhanden.	IAConnectSessionExists	boolean	Gibt "true" zurück, wenn eine Sitzung mit dem angegebenen Namen vorhanden ist, oder "false", wenn dies nicht der Fall ist.

Hinzufügen einer Datei zu ZIP

Vorgangs-ID:: AddFileToZIP

ZIPs einer Datei (speichert die Datei in einem Komprimierungsarchiv).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Pfad der Quelldatei zum Hinzufügen zu ZIP	SourceFilenameToAddToZIP	True	string	Der Dateipfad zur Datei, die der ZIP-Datei hinzugefügt werden soll. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Ausgabe-ZIP-Dateipfad	OutputZIPFilename	True	string	Der Dateipfad, an den die ZIP-Datei ausgegeben werden soll. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Hinzufügen von Dateinamen zu Ordnern in ZIP	AddFilenameToFolderInZIP		string	Wenn Sie die Quelldatei einem Ordner in der ZIP-Datei hinzufügen möchten, geben Sie hier den Ordnernamen ein.
Quelldateiname, der dem ZIP-Kommentar hinzugefügt werden soll	SourceFilenameToAddToZIPComment		string	Ein optionaler Kommentar für diese Datei, der der ZIP-Datei hinzugefügt wurde.
Komprimieren	Compress		boolean	Sollte die Datei beim Zippen komprimiert werden?
Zur vorhandenen ZIP-Datei hinzufügen	AddToExistingZIPFile		boolean	Auf True festgelegt, um einer vorhandenen ZIP-Datei hinzuzufügen.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Hinzufügen einer neuen Orchestrator-Automatisierungsaufgabe

Vorgangs-ID:: TasksAddNewTask

Fügen Sie eine neue Orchestrator-Automatisierungsaufgabe zu einer Warteschlange hinzu, die über einen Flow überwacht werden kann. Aufgaben können entweder sofort ausgeführt werden oder zur späteren Ausführung zurückgestellt werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Festlegen des Automatisierungsnamens	SetAutomationName		string	Wählen Sie "Auto" aus, wenn Sie den Flussnamen als Vorgangsnamen verwenden möchten, oder wählen Sie "Manuell" aus, und geben Sie einen Namen in das Feld "Automatisierungsname" ein, um diesen Namen zu verwenden.
Automatisierungsname	AutomationName		string	Dies wird nur verwendet, wenn "Manuell" im Feld "Automatisierungsname festlegen" ausgewählt wird. Ein Anzeigename, der angegeben wird, um die Aufgabe später zu identifizieren oder ihm einen bestimmten Fluss zuzuordnen. Mehrere Aufgaben können denselben Automatisierungsnamen verwenden. Ein bestimmter Vorgangsname ist erforderlich, wenn die Aufgabe von einem externen Poller oder einem Orchestrator-Trigger verarbeitet wird.
Vorgangseingabedaten	TaskInputData		string	Optionale Daten, die dem Vorgang beim Start zur Verfügung gestellt werden sollen. Sie können Daten in einem beliebigen Format speichern, JSON ist jedoch ein häufig verwendetes Format.
Prozessphase	ProcessStage		string	Der Punkt, an dem der Automatisierungsprozess/Ablauf gestartet werden soll. Dies ist ein optionaler Zeichenfolgenwert, der für den spezifischen Prozess/Fluss eindeutig ist. Dies wird von einer Bedingung innerhalb des Prozesses/Flusses verwendet, um zu entscheiden, welcher Schritt als Nächstes ausgeführt werden soll. Beispiel: Wenn der Prozess/Ablauf in der Phase "Exchange" gestartet werden soll, geben Sie den Wert "Exchange" ein.
Priority	Priority		integer	Legen Sie die Prioritätsebene dieser Automatisierungsaufgabe fest (1 ist höchste Ebene).
SLA in Minuten	SLA		integer	Legen Sie die für Ihre SLA erforderliche Anzahl von Minuten fest. Legen Sie dies auf 0 fest, wenn Sie keine SLA haben. Standardmäßig werden Automatisierungsaufgaben am Ende des SLA vorrang vor anderen Aufgaben haben.
Aufgabe im Haltebereich platzieren	TaskOnHold		boolean	Geben Sie den Status "Im Haltebereich" der Aufgabe an. Eine Aufgabe, die auf "Im Haltebereich" festgelegt ist, wird nicht von der Aktion "Nächste Orchestrator-Automatisierungsaufgabe abrufen" abgerufen und wird daher nicht in einem typischen Aufgabenworkflow verarbeitet.
Organisation	Organisation		string	Geben Sie optional die Organisation an, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Abteilung	Department		string	Geben Sie optional die Abteilung an, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Description	Description		string	Geben Sie optional die Beschreibung für diese Aufgabe an. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Stichwörter	Tags		string	Eine optionale Liste mit einem oder mehreren Tags, die dieser Aufgabe zugewiesen werden sollen. Wird in der Regel verwendet, um eine Aufgabe zum Suchen und Filtern zu kategorisieren. Keine Unterscheidung zwischen Groß-/Kleinbuchstaben 1 pro Zeile.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Vorgangs-ID	TaskId	integer	Die ID der Orchestrator-Automatisierungsaufgabe, die erstellt wurde. Diese Vorgangs-ID kann verwendet werden, um den Vorgang zu einem späteren Zeitpunkt abzurufen.

Hinzufügen einer Notiz zu einer Orchestrator-Automatisierungsaufgabe

Vorgangs-ID:: TasksAddNote

Fügt einer ausgewählten Orchestrator-Automatisierungsaufgabe eine Notiz hinzu. Diese Notiz wird an das Quellsystem übergeben, das mit dieser Automatisierungsaufgabe verknüpft ist (z. B. ServiceNow), und wird am häufigsten verwendet, um Details zu einem Ticket hinzuzufügen. Wenn die Orchestrator-Automatisierungsaufgabe nicht mit einer Quelle verknüpft ist, wird eine Ausnahme ausgelöst.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	TaskId	True	integer	Die ID der Orchestrator-Aufgabe, der die Notiz hinzugefügt werden soll.
Hinweistext	NoteText	True	string	Die Notiztextnachricht.
Notiztyp	NoteType		string	Wenn das Quellsystem unterschiedliche Notiztypen unterstützt (z. B. eine Arbeitsnotiz, eine Schließungsnotiz oder einen Kommentar), geben Sie hier den Notiztyp ein. Dies wird je nach Quellsystem unterschiedlich interpretiert. Derzeit unterstützte Typen sind "WorkNote" (Standard), "CloseNote", "Comment". Wenn nur ein Notiztyp vorhanden ist, geben Sie "WorkNote" ein. Wenn Sie über eine benutzerdefinierte Arbeitsnotiz verfügen, geben Sie "Sonstige" ein.
Andere Notiztyp	NoteTypeOther		string	Wenn Sie über einen benutzerdefinierten Notiztyp verfügen, wählen Sie einen "Notiztyp" von "Sonstige" aus, und geben Sie den benutzerdefinierten Typ in dieses Feld ein.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	TasksAddNoteResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Hinzufügen eines neuen Orchestrator-Automatisierungsvorgangs

Vorgangs-ID:: TasksAddNewTaskOperation

Fügen Sie eine neue Orchestrator-Automatisierungsaufgabe hinzu, und erhalten Sie eine Vorgangs-ID. Ein bestimmter Vorgangsname ist erforderlich, wenn die Aufgabe von einem externen Poller oder einem Orchestrator-Trigger verarbeitet wird. Diese Aktion unterscheidet sich von "Neue Orchestrator-Automatisierungsaufgabe hinzufügen" (TasksAddNewTaskOperation) darin, dass sie mit einer unguessablen Vorgangs-ID reagiert, anstelle einer erratenden Vorgangs-ID.

Parameter

Name	Schlüssel	Typ	Beschreibung
Automatisierungsname	AutomationName	string	Ein Anzeigename, der angegeben wird, um die Aufgabe später zu identifizieren oder ihm einen bestimmten Fluss zuzuordnen. Mehrere Aufgaben können denselben Automatisierungsnamen verwenden.
Vorgangseingabedaten	TaskInputData	string	Optionale Daten, die dem Vorgang beim Start zur Verfügung gestellt werden sollen. Sie können Daten in einem beliebigen Format speichern, JSON ist jedoch ein häufig verwendetes Format.
Prozessphase	ProcessStage	string	Der Punkt, an dem der Automatisierungsprozess/Ablauf gestartet werden soll. Dies ist ein optionaler Zeichenfolgenwert, der für den spezifischen Prozess/Fluss eindeutig ist. Dies wird von einer Bedingung innerhalb des Prozesses/Flusses verwendet, um zu entscheiden, welcher Schritt als Nächstes ausgeführt werden soll. Beispiel: Wenn der Prozess/Ablauf in der Phase "Exchange" gestartet werden soll, geben Sie den Wert "Exchange" ein.
Priority	Priority	integer	Legen Sie die Prioritätsebene dieser Automatisierungsaufgabe fest (1 ist höchste Ebene).
SLA in Minuten	SLA	integer	Legen Sie die für Ihre SLA erforderliche Anzahl von Minuten fest. Legen Sie dies auf 0 fest, wenn Sie keine SLA haben. Standardmäßig werden Automatisierungsaufgaben am Ende des SLA vorrang vor anderen Aufgaben haben.
Organisation	Organisation	string	Geben Sie optional die Organisation an, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Abteilung	Department	string	Geben Sie optional die Abteilung an, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Description	Description	string	Geben Sie optional die Beschreibung für diese Aufgabe an. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Stichwörter	Tags	string	Eine optionale Liste mit einem oder mehreren Tags, die dieser Aufgabe zugewiesen werden sollen. Wird in der Regel verwendet, um eine Aufgabe zum Suchen und Filtern zu kategorisieren. Keine Unterscheidung zwischen Groß-/Kleinbuchstaben 1 pro Zeile.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Vorgangs-ID	OperationId	string	Die Vorgangs-ID der Orchestrator-Automatisierungsaufgabe, die erstellt wurde. Diese Vorgangs-ID kann verwendet werden, um die Aufgabe zu einem späteren Zeitpunkt abzurufen. Die Vorgangs-ID ist eine eindeutige, nicht zulässige Zeichenfolge, die die Fähigkeit eines Drittanbieters beschränkt, die ID eines Vorgangs zu erraten, den sie nicht erstellt haben.

Hinzufügen eines neuen Orchestrator-Vorgangs für verzögerte Aufgaben

Vorgangs-ID:: TasksAddNewDeferralOperation

Fügen Sie eine neue verzögerte Orchestrator-Aufgabe hinzu, und erhalten Sie eine Vorgangs-ID. Der Vorgang wird in Zukunft auf einen bestimmten Zeitpunkt zurückgestellt. Verwenden Sie diese Aktion, um einen Vorgang vorübergehend für einen bestimmten Zeitraum anzusetzen (z. B. wenn Sie auf etwas warten). Ein bestimmter Vorgangsname ist erforderlich, wenn die Aufgabe von einem externen Poller oder einem Orchestrator-Trigger verarbeitet wird. Diese Aktion unterscheidet sich von "Neue Orchestrator-verzögerte Aufgabe hinzufügen" (TasksAddNewDeferral), da sie mit einer unguessablen Vorgangs-ID antwortet, anstelle einer erratenen Vorgangs-ID.

Parameter

Name	Schlüssel	Typ	Beschreibung
Automatisierungsname	AutomationName	string	Ein Anzeigename, der angegeben wird, um die Aufgabe später zu identifizieren oder ihm einen bestimmten Fluss zuzuordnen. Mehrere Aufgaben können denselben Automatisierungsnamen verwenden.
Verzögerungszeit in Minuten	DeferralTimeInMinutes	integer	Wie viele Minuten sollte der Automatisierungsvorgang verzögert werden.
Vorgangseingabedaten	TaskInputData	string	Optionale Daten, die dem Vorgang beim Start zur Verfügung gestellt werden sollen. Sie können Daten in einem beliebigen Format speichern, JSON ist jedoch ein häufig verwendetes Format.
Zurückstellung gespeicherter Daten	DeferralStoredData	string	Optionale Daten, die mit dieser Aufgabe gespeichert werden sollen. Er wird für den Prozess /Ablauf verfügbar, wenn er von einer Verzögerung fortgesetzt wird. Dies wird in der Regel verwendet, um Daten zu speichern, die Sie während des Prozesses/Ablaufs berechnet haben, die Sie nach der Verzögerung wieder verfügbar machen müssen. Sie können Daten in einem beliebigen Format speichern, JSON ist jedoch ein häufig verwendetes Format.
Prozessphase	ProcessStage	string	Der Punkt, an dem der Automatisierungsprozess/Ablauf gestartet werden soll. Dies ist ein optionaler Zeichenfolgenwert, der für den spezifischen Prozess/Fluss eindeutig ist. Dies wird von einer Bedingung innerhalb des Prozesses/Flusses verwendet, um zu entscheiden, welcher Schritt als Nächstes ausgeführt werden soll. Beispiel: Wenn der Prozess/Ablauf in der Phase "Exchange" gestartet werden soll, geben Sie den Wert "Exchange" ein.
Priority	Priority	integer	Legen Sie die Prioritätsebene dieser Automatisierungsaufgabe fest (1 ist höchste Ebene).
Organisation	Organisation	string	Geben Sie optional die Organisation an, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Abteilung	Department	string	Geben Sie optional die Abteilung an, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Description	Description	string	Geben Sie optional die Beschreibung für diese Aufgabe an. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Stichwörter	Tags	string	Eine optionale Liste mit einem oder mehreren Tags, die dieser Aufgabe zugewiesen werden sollen. Wird in der Regel verwendet, um eine Aufgabe zum Suchen und Filtern zu kategorisieren. Keine Unterscheidung zwischen Groß-/Kleinbuchstaben 1 pro Zeile.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Vorgangs-ID	OperationId	string	Die Vorgangs-ID der verzögerten Aufgabe Orchestrator, die erstellt wurde. Diese Vorgangs-ID kann verwendet werden, um die Aufgabe zu einem späteren Zeitpunkt abzurufen. Die Vorgangs-ID ist eine eindeutige, nicht zulässige Zeichenfolge, die die Fähigkeit eines Drittanbieters beschränkt, die ID eines Vorgangs zu erraten, den sie nicht erstellt haben.

Hinzufügen von Berechtigungen zu Ordnern

Vorgangs-ID:: AddPermissionToFolder

Fügt einen Ordner auf dem Computer, in dem der IA-Connect Agent ausgeführt wird, eine Berechtigung hinzu.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ordnerpfad	FolderPath	True	string	Der vollständige Pfad zum Ordner. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Identität	Identity	True	string	Die Identität (z. B. ein Benutzer, eine Gruppe oder einen Computer), der die Berechtigung zugewiesen werden soll. Dies kann im Format "Benutzername", "DOMÄNE\Benutzername" oder "username@domainfqdn" sein.
Erlaubnis	Permission	True	string	Geben Sie die Berechtigung zum Zuweisen (Lesen, ReadAndExecute, Modify oder FullControl) an, oder lassen Sie die Berechtigung für den Standardwert leer (Lesen).
Auf Ordner anwenden	ApplyToFolder		boolean	Sollte die Berechtigung für den Ordner selbst gelten?
Auf Unterordner anwenden	ApplyToSubFolders		boolean	Sollte die Berechtigung an Unterordner weitergegeben werden?
Auf Dateien anwenden	ApplyToFiles		boolean	Sollte die Berechtigung für die Dateien innerhalb des Ordners gelten?
Deny	Deny		boolean	Wird die Berechtigung verweigert?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

HTTP-Datei herunterladen

Vorgangs-ID:: DownloadHTTPFile

Lädt eine Datei auf den Computer herunter, auf dem der IA-Connect Agent mit HTTP(S) ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
URL herunterladen	DownloadURL	True	string	Die HTTP- oder HTTPS-Download-URL.
Dateipfad speichern	SaveFilename		string	Der vollständige Pfad zum Dateinamen zum Speichern. Wenn dieses Feld leer ist und Sie "Return contents as string" als True angegeben haben, wird die Datei nicht auf dem Computer gespeichert.
Vorhandene Datei überschreiben	OverwriteExistingFile		boolean	Wenn eine Datei bereits mit dem namen vorhanden ist, der in der Eingabe "Dateipfad speichern" angegeben ist, sollte sie überschrieben werden?
Passthrough-Authentifizierung	PassthroughAuthentication		boolean	Sollen die Anmeldeinformationen des Benutzers an den Webserver übergeben werden? Dies würde in der Regel nur für interne Intranetwebsites verwendet.
Benutzer-Agent	UserAgent		string	Auf diese Weise können Sie den an die Webseite gemeldeten Benutzer-Agent festlegen. In der Regel ist dies nicht erforderlich und sollte nur geändert werden, wenn eine Webseite eine bestimmte Agent-Zeichenfolge erfordert.
Akzeptieren	Accept		string	Dieser Parameter gibt an, welche Inhaltstypen unterstützt werden. Dies sollte nur geändert werden, wenn der inhalt, den Sie herunterladen, einen anderen Inhaltstyp erfordert.
Unterstützen von TLS10	SupportTLS10		boolean	Auf "True" festgelegt, um das TLS 1.0-Verschlüsselungsprotokoll zu unterstützen.
Unterstützen von TLS11	SupportTLS11		boolean	Auf "True" festgelegt, um das TLS 1.1-Verschlüsselungsprotokoll zu unterstützen.
Unterstützen von TLS12	SupportTLS12		boolean	Auf "True" festgelegt, um das TLS 1.2-Verschlüsselungsprotokoll zu unterstützen.
Automatische Dekomprimierungsverzögerung	AutoDecompressDeflate		boolean	Einige Webinhalte werden mithilfe der Komprimierung "Deflate" komprimiert. Wenn Sie diesen Wert auf "True" festlegen, wird der Webserver darüber informiert, dass "Deflate" unterstützt wird, und wenn der Inhalt mithilfe dieser Komprimierung gesendet wird, wird er automatisch dekomprimiert.
Automatische Dekomprimierung GZip	AutoDecompressGZIP		boolean	Einige Webinhalte werden mithilfe der GZIP-Komprimierung komprimiert. Wenn Sie diesen Wert auf "True" festlegen, wird der Webserver darüber informiert, dass "GZIP" unterstützt wird. Wenn der Inhalt mit dieser Komprimierung gesendet wird, wird er automatisch dekomprimiert.
Zurückgeben von Inhalten als Zeichenfolge	ReturnContentsAsString		boolean	Soll der Dateiinhalt als Zeichenfolge zurückgegeben werden?
Zurückgeben der Inhaltscodierung	ReturnContentEncoding		string	Die Codierung des heruntergeladenen Inhalts. Dies wird nur verwendet, wenn "Rückgabeinhalt als Zeichenfolge" "True" ist und die Codierung des heruntergeladenen Inhalts definiert, damit er richtig interpretiert werden kann.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Dateiinhalte herunterladen	DownloadFileContents	string	Der Inhalt der heruntergeladenen Datei.

IA-Connect Agent-GUI an den Anfang bringen

Vorgangs-ID:: BringRSAGUIToFront

Bringt die IA-Connect Agent-GUI in den Vordergrund, sodass sie auf dem Bildschirm sichtbar ist.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Fokus	Focus		boolean	Sollte die IA-Connect Agent-GUI fokussiert sein?
Globaler linker Mausklick	GlobalLeftMouseClick		boolean	Soll ein globaler linker Mausklick verwendet werden, um den Agent in den Vordergrund zu bringen? Dies garantiert ein Bring-To-to-The-Front-Ereignis in einem Szenario, in dem die Fokusmethode durch das Betriebssystem eingeschränkt werden könnte, um anwendungen daran zu hindern, sich in den Vordergrund zu bringen.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

IA-Connect nächsten Hop deaktivieren

Vorgangs-ID:: DisableNextHop

Deaktiviert den nächsten Hop, sodass alle zukünftigen Befehle vom Agent verarbeitet werden, der sie empfängt (im Gegensatz zur Weiterleitung an den nächsten Hop-Agent).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Identität aus Dateisicherheit entfernen

Vorgangs-ID:: RemoveIdentityFromFileSecurity

Entfernt eine Identität (z. B. Benutzer, Gruppe oder Computer) aus den Sicherheitsberechtigungen für eine Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	FilePath	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Zu entfernende Identität	IdentityToRemove	True	string	Die Identität des zu entfernenden Benutzers oder der Gruppe. Dies kann im Format "Benutzername", "DOMÄNE\Benutzername" oder "username@domainfqdn" sein.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Berechtigung wurde entfernt.	PermissionWasRemoved	boolean	Gibt true zurück, wenn die Berechtigung erfolgreich entfernt wurde.

Identität aus Ordnersicherheit entfernen

Vorgangs-ID:: RemoveIdentityFromFolderSecurity

Entfernt eine Identität (z. B. einen Benutzer, eine Gruppe oder einen Computer) aus den Sicherheitsberechtigungen für einen Ordner auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ordnerpfad	FolderPath	True	string	Der vollständige Pfad zum Ordner. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Zu entfernende Identität	IdentityToRemove	True	string	Die Identität des zu entfernenden Benutzers oder der Gruppe. Dies kann im Format "Benutzername", "DOMÄNE\Benutzername" oder "username@domainfqdn" sein.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Berechtigung wurde entfernt.	PermissionWasRemoved	boolean	Gibt true zurück, wenn die Berechtigung erfolgreich entfernt wurde.

In CSV-Datei schreiben

Vorgangs-ID:: WriteCollectionToCSVFile

Erstellt eine CSV-Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird. Die CSV-Datei wird aus einer Auflistung (Tabelle) oder aus einer Tabelle im JSON-Format erstellt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Eigenschaften	Properties		object
JSON der Eingabetabelle	InputTableJSON		string	Eine Tabelle mit Daten, die in die CSV-Datei geschrieben werden sollen, im JSON-Format.
Ausgabe-CSV-Dateipfad	CSVFilePath	True	string	Der vollständige Pfad zur CSV-Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Ausgabecodierung	OutputEncoding		string	Das beim Schreiben in die CSV-Datei zu verwendende Textcodierungsformat. Unterstützte Codierungen sind UTF8, UTF7, Unicode und ASCII.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	WriteCollectionToCSVFileResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Ist auf das Verzeichnis zugegriffen werden kann

Vorgangs-ID:: DirectoryIsAccessible

Gibt zurück, ob auf ein Verzeichnis (Ordner) zugegriffen werden kann und ob Berechtigungen den Zugriff auf das Verzeichnis auf dem Computer einschränken, auf dem der IA-Connect Agent zugreifen kann.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Verzeichnispfad	DirectoryPath	True	string	Der vollständige Pfad zum Verzeichnis (Ordner). Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Verzeichniszugriff	DirectoryAccessible	boolean	Gibt "true" zurück, wenn auf das Verzeichnis zugegriffen werden kann, oder "false", wenn dies nicht der Fall ist.
Verzeichniszugriff nicht autorisiert	DirectoryAccessUnauthorised	boolean	Gibt true zurück, wenn der Zugriff auf das Verzeichnis nicht möglich ist, da Berechtigungen den Zugriff darauf einschränken, oder "false", wenn dies nicht der Fall ist.

Ist das Verzeichnis vorhanden

Vorgangs-ID:: DirectoryExists

Meldet wahr oder falsch, ob ein Verzeichnis (Ordner) auf dem Computer vorhanden ist, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Verzeichnispfad	DirectoryPath	True	string	Der vollständige Pfad zum Verzeichnis (Ordner). Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Verzeichnis ist vorhanden	DirectoryExists	boolean	Gibt true zurück, wenn das Verzeichnis (Ordner) vorhanden ist, oder false, wenn dies nicht der Fall ist.

Ist die Sprachausgabe aktiviert

Vorgangs-ID:: IsScreenReaderEnabled

Gibt zurück, ob die Sprachausgabe in der IA-Connect Agent-Benutzersitzung aktiviert wurde.

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
Bildschirmsprachausgabe aktiviert	ScreenReaderEnabled	boolean	Gibt true zurück, wenn die Sprachausgabe aktiviert wurde.

Ist sitzungssperrt

Vorgangs-ID:: IsSessionLocked

Gibt an, ob die Sitzung, in der der IA-Connect Agent ausgeführt wird, gesperrt ist.

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
Sitzung ist gesperrt	SessionIsLocked	boolean	Wird auf "true" festgelegt, wenn die Sitzung, in der der IA-Connect Agent ausgeführt wird, gesperrt ist.

Kalibrieren mouse_event

Vorgangs-ID:: CalibrateMouseEvent

Kalibriert die mouse_event-Methode, indem sie die Maus um die angegebene Anzahl von Pixeln bewegt und dann die neue Mausposition liest.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kalibrierungsgröße in Pixeln	CalibrationSizeInPixels		integer	Die Anzahl der Pixel, die die Maus verschoben wird, um sie zu kalibrieren. Je niedriger der Wert ist, desto weniger genau ist die Kalibrierung.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Maus X-Multiplizierer	MouseXMultiplier	double	Der Maus-X-Multipliziererwert. Ein Wert von 1,0 gibt keinen Multiplikator an.
Maus-Y-Multiplikator	MouseYMultiplier	double	Der Y-Multipliziererwert der Maus. Ein Wert von 1,0 gibt keinen Multiplikator an.

Kennwort generieren

Vorgangs-ID:: GeneratePassword

Generiert ein Kennwort mit Wörterbuchwörtern, Zahlen, Symbolen, Zeichen, wie in einem Vorlagenformat definiert.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kennwortformat	PasswordFormat	True	string	Das Format des generierten Kennworts, das mithilfe von Symbolen beschrieben wird. Das Symbol "w" stellt ein Wörterbuchwort dar, "u" stellt ein Wörterbuchwort in Großbuchstaben dar, "n" stellt eine Zahl dar, "s" stellt ein Symbol dar, "l" steht für einen Kleinbuchstaben, "L" steht für einen Großbuchstaben, "z" steht für nichts (nützlich in Kombinationen). Beispielsweise kann wnnwsl Pluto35Marmite!b generieren. Eine Zahl gefolgt von zwei oder mehr Symbolen in geschweiften Klammern erstellt eine zufällige Kombination dieser Anzahl von Symbolen. Beispielsweise kann 8(Lln) Produkt 6hP2AxP0 und 4(Lsz) möglicherweise S!-A (LssL-Symbole) erzeugen oder J$ (Lszz-Symbole) erzeugen. Zeichen in einfachen Anführungszeichen werden as-isverwendet. Beispielsweise kann w'-'w'_'nn Jersey--Mountain_64 erzeugen.
Mindestlänge	MinimumLength		integer	Die Mindestlänge des generierten Kennworts. Wenn das generierte Kennwort zu kurz ist, werden zusätzliche Wörterbuchwörter hinzugefügt, bis die Länge erfüllt ist. Wird auf 0 festgelegt, wenn keine Mindestlänge erforderlich ist.
Als Nur-Text zurückgeben	ReturnAsPlainText		boolean	Legen Sie "true" fest, um das Kennwort als Nur-Text zurückzugeben.
Speichern des Kennworts als Bezeichner	StorePasswordAsIdentifier		string	Wenn ein Bezeichner angegeben wird, wird dieses Kennwort im Orchestrator oder Agent (siehe "Generieren bei") für einen späteren Abruf /die Verwendung durch alle Befehle gespeichert, die gespeicherte Anmeldeinformationen verwenden können, gespeichert werden. Wenn vom Agent generiert wird, werden diese Kennwörter nur im Arbeitsspeicher gespeichert und gehen verloren, wenn der Agent geschlossen wird. MyExchangePassword kann beispielsweise mithilfe von {IAConnectPassword:MyExchangePassword} abgerufen werden.
Unterstützte Symbole	SupportedSymbols		string	Ermöglicht es Ihnen, eine Liste von Symbolen bereitzustellen, die zufällig verwendet werden, wenn das Symbol 's' im Format eines generierten Kennworts verwendet wird. Wenn nicht angegeben, wird eine integrierte Liste verwendet. Beispiel: !$()*.
Versuchen Sie eindeutige Kennwörter	AttemptUniquePasswords		boolean	Legen Sie den Wert auf "true" (standard) für den Orchestrator oder Agent fest (siehe "Generieren bei"), um zu vermeiden, dass zufällige Zahlensequenzen dupliziert werden, und stellen Sie daher sicher, dass generierte Kennwörter nach Möglichkeit innerhalb einer bestimmten Sitzung eindeutig sind. Wenn der Agent generiert wird, garantiert dies keine eindeutigen Kennwörter zwischen separaten Agents oder wenn der Agent geschlossen oder neu gestartet wird, daher sollten Sie immer sicherstellen, dass Ihre Kennwörter durch verwendung komplexer Kennwörter sehr zufällig sind (z. B. wnnws ist zufälliger als wnw).
Generieren unter	GenerateAt		string	Geben Sie an, welche IA-Connect Komponente das Kennwort generiert.
Mindestbuchstaben	MinimumLowercase		integer	Die Mindestanzahl von Kleinbuchstaben, die im Kennwort vorhanden sein müssen. Wenn dies nicht möglich ist (z. B. wenn das Kennwortformat nicht über genügend l-, w- oder u-Symbole verfügt), wird eine Ausnahme ausgelöst. Legen Sie für kein Minimum auf 0 fest.
Mindestbuchstaben	MinimumUppercase		integer	Die Mindestanzahl von Großbuchstaben, die im Kennwort vorhanden sein müssen. Wenn dies nicht möglich ist (z. B. wenn das Kennwortformat nicht über genügend L-, w- oder u-Symbole verfügt), wird eine Ausnahme ausgelöst. Legen Sie für kein Minimum auf 0 fest.
Mindestnummern	MinimumNumbers		integer	Die Mindestanzahl der Zahlen, die im Kennwort vorhanden sein müssen. Wenn dies nicht möglich ist (z. B. wenn das Kennwortformat nicht über genügend n Symbole verfügt), wird eine Ausnahme ausgelöst. Legen Sie für kein Minimum auf 0 fest.
Mindestsymbole	MinimumSymbols		integer	Die Mindestanzahl der Symbole, die im Kennwort vorhanden sein müssen. Wenn dies nicht möglich ist (z. B. wenn das Kennwortformat nicht über genügend Symbole verfügt), wird eine Ausnahme ausgelöst. Legen Sie für kein Minimum auf 0 fest.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Nur-Text-Kennwort	PlainTextPassword	string	Das Kennwort bei Bedarf im Nur-Text-Format. Das Kennwort kann als Nur-Text angefordert werden, da es sich bei dem Kennwort um ein einmaliges Kennwort handelt, das per SMS oder E-Mail (z. B. per E-Mail) übertragen werden soll und daher as-isangezeigt werden muss.

Kennwortschlüssel senden

Vorgangs-ID:: SendPasswordKeys

Sendet globale Tastendrücke an die IA-Connect Agent-Benutzersitzung, insbesondere zum Eingeben eines Kennworts. Dadurch wird ein Benutzer simuliert, der diese Tasten auf der Tastatur drückt. Stellen Sie sicher, dass das Zielfensterelement fokussiert ist, oder dass die Tastendrücke von der falschen Anwendung empfangen werden oder ignoriert werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kennwort	Password	True	password	Das eingegebene Kennwort mithilfe simulierter Tastendrücke in der IA-Connect Agent-Benutzersitzung. Die Schlüsselcodes sind in der Syntax "Schlüssel senden" im Benutzeroberflächenhandbuch dokumentiert. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest.
Intervall in Millisekunden	Interval		integer	Die Anzahl der Millisekunden zwischen jedem Drücken der Taste.
Symbole nicht interpretieren	DontInterpretSymbols		boolean	Sollten Symbole im Kennwort nicht als Sondertasten interpretiert werden (z. B. +für UMSCHALT, ^ für STRG)? Dies sollte auf "true" festgelegt werden, wenn Sie versuchen, die tatsächlichen Symbole einzugeben.
Kennwort enthält gespeichertes Kennwort	PasswordContainsStoredPassword		boolean	Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Kennwortzeichenfolge erweitern

Vorgangs-ID:: ExpandPasswordString

Akzeptiert eine Eingabezeichenfolge, die Verweise auf IA-Connect gespeicherte Kennwörter enthält und diese Zeichenfolge mit den durch die gespeicherten Kennwörter ersetzten Verweisen zurückgibt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Eingabezeichenfolge	InputString		string	Die Eingabezeichenfolge, die IA-Connect gespeicherten Kennwortbezeichner enthält. Beispiel: "Willkommen neuer Start, Ihr neues Kontokennwort ist {IAConnectPassword:GeneratedPassword}", wobei "GeneratedPassword" der Name eines gespeicherten IA-Connect Kennworts ist.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Ausgabezeichenfolge	OutputString	string	Die Ausgabezeichenfolge, die die Eingabezeichenfolge mit Kennwortbezeichnern enthält, die durch die tatsächlichen Kennwörter ersetzt werden. Beispiel: "Willkommen neuer Starter, Ihr neues Kontokennwort ist Fantastic12Monkeys!".

Kill IA-Connect session by name

Vorgangs-ID:: KillIAConnectSessionByName

Kills the specified IA-Connect Director session if it exists. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden. Der Name wird aus einer früheren Aktion "Anfügen" bekannt sein.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
IA-Connect Sitzungsname	IAConnectSessionName	True	string	Der Name der zu beendenden IA-Connect Sitzung.
An Die Sitzung der Ebene 1 IA-Connect bei Erfolg anfügen	AttachToTier1IAConnectSessionOnSuccess		boolean	Sollte IA-Connect eine Verbindung mit der Sitzung der Ebene 1 IA-Connect herstellen (die IA-Connect Directorsitzung des Director, der die SOAP- und /oder REST-Nachrichten empfängt), wenn die Sitzung erfolgreich geschlossen wurde?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
IA-Connect Sitzung getötet	IAConnectSessionKilled	boolean	Gibt true zurück, wenn die Sitzung mit dem angegebenen Namen getötet wurde, oder false, wenn dies nicht der Fall ist.
Angefügter Sitzungsname der Ebene 1 IA-Connect	AttachedTier1IAConnectSessionName	string	Der Name der Sitzung der Ebene 1 IA-Connect, mit der eine Verbindung hergestellt wurde.

Kill process ID

Vorgangs-ID:: KillProcessID

Kills a running process in the IA-Connect Agent user session which has the specified process ID. Process IDs are unique so only one process can match the ID. Process IDs are dynamic and are different for every launch of an application.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Prozess-ID	ProcessID	True	integer	Die Prozess-ID des zu tötenden Prozesses.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Anzahl der getöteten Prozesse	NumberOfProcessesKilled	integer	Die Anzahl der Prozesse, die getötet wurden.

Kill-Prozess

Vorgangs-ID:: KillProcess

Beendet alle ausgeführten Prozesse in der IA-Connect Agent-Benutzersitzung, die den angegebenen Prozessnamen hat.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Prozessname	ProcessName	True	string	Der Zu tötende Prozess. z.B. Editor.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Anzahl der getöteten Prozesse	NumberOfProcessesKilled	integer	Die Anzahl der Prozesse, die getötet wurden.

Konfigurieren des nächsten Hops IA-Connect Director

Vorgangs-ID:: ConfigureNextHopDirector

Konfigurieren Sie den Director für den nächsten Hop in einem Double-Hop-Szenario. Dies ist nur erforderlich, wenn die Standardeinstellungen IA-Connect Next-Hop Director nicht geeignet sind.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
SOAP aktiviert	SOAPEnabled		boolean	Sollte die SOAP-Schnittstelle für den nächsten Hop Director aktiviert werden?
REST aktiviert	RESTEnabled		boolean	Soll die REST-Schnittstelle für den nächsten Hop Director aktiviert werden?
Webserver aktiviert	WebServerEnabled		boolean	Sollte der Webserver (für das Hosten des IA-Connect Inspector) für den nächsten Hop Director aktiviert sein?
Director ist nur localhost	DirectorIsLocalhostOnly		boolean	Sollten die Director-SOAP- und REST-Schnittstellen nur auf "localhost" lauschen? Dies sollte auf "true" festgelegt werden, da kein anderer Computer mit diesen Schnittstellen kommunizieren muss.
SOAP-TCP-Port	SOAPTCPPort		integer	Wenn die SOAP-Schnittstelle aktiviert wurde, auf welchem TCP-Port sollte er ausgeführt werden (Standardeinstellung ist 8002)?
REST TCP-Port	RESTTCPPort		integer	Wenn die REST-Schnittstelle aktiviert wurde, welchen TCP-Port sollte er ausführen (Standardeinstellung ist 8002)?
SOAP verwendet HTTPS	SOAPUsesHTTPS		boolean	Verwendet die SOAP-Schnittstelle HTTPS (anstelle von HTTP)? Wenn dieser Wert auf "True" festgelegt ist, ist auf dem First-Hop-Computer ein Zertifikat erforderlich, um HTTPS zu vereinfachen. Dies kann für das für REST verwendete Zertifikat freigegeben werden.
REST verwendet HTTPS	RESTUsesHTTPS		boolean	Verwendet die REST-Schnittstelle HTTPS (anstelle von HTTP)? Wenn dieser Wert auf "True" festgelegt ist, ist auf dem First-Hop-Computer ein Zertifikat erforderlich, um HTTPS zu vereinfachen. Dies kann für das für SOAP verwendete Zertifikat freigegeben werden.
Inkrementierung des Director-TCP-Ports nach SessionId	IncrementDirectorTCPPortBySessionId		boolean	Um sicherzustellen, dass der Tcp-Port des Director eindeutig ist (wenn mehrere parallele Sitzungen mit Double-Hop vom gleichen First-Hop-Host verwendet werden), kann die First-Hop-Sitzungs-ID dem Director TCP-Port hinzugefügt werden. Dies ist nur erforderlich, wenn SOAP oder REST im First-Hop Director aktiviert ist und diese in der Regel nicht aktiviert sind, da benannte Rohre standardmäßig verwendet werden.
SOAP verwendet die Benutzerauthentifizierung.	SOAPUsesUserAuthentication		boolean	Legen Sie diesen Wert auf "True" fest, wenn der HTTP-SOAP-TCP-Port die Benutzerauthentifizierung verwenden soll. Informationen zum Einrichten finden Sie im IA-Connect Installationshandbuch.
REST verwendet die Benutzerauthentifizierung	RESTUsesUserAuthentication		boolean	Legen Sie diesen Wert auf "True" fest, wenn der HTTP-REST-TCP-Port die Benutzerauthentifizierung verwenden soll. Informationen zum Einrichten finden Sie im IA-Connect Installationshandbuch.
Befehl mit aktivierter Benannter Pipe	CommandNamedPipeEnabled		boolean	Sollte der First-Hop-Agent benannte Pipes verwenden, um mit dem First-Hop Director zu kommunizieren? Dies ist die Standardkommunikationsmethode.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Konvertieren von Rechteckkoordinaten

Vorgangs-ID:: ConvertRectangleCoordinates

Konvertiert eine Rechteckpixelkoordinate von einer virtuellen in eine physische oder physische Koordinate. Wenn Sie einen Punkt konvertieren möchten, legen Sie einfach "Right=Left" und "Bottom=Top" fest. Physische Koordinaten werden direkt pixeln auf dem Monitor zugeordnet. Virtuelle Koordinaten werden skaliert. Wenn die zugrunde liegende Anzeigeskalierung aller Anzeigegeräte 100%beträgt, sind sowohl physische als auch virtuelle Koordinaten identisch.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Koordinate des linken Randbildschirms	RectangleLeftPixelXCoord	True	integer	Der linke Pixelrand des zu konvertierenden Rechtecks. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.
Pixel Y-Koordinate des oberen Randbildschirms	RectangleTopPixelYCoord	True	integer	Der obere Pixelrand des zu konvertierenden Rechtecks. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.
Rechteck rechter Randbildschirm Pixel X-Koordinate	RectangleRightPixelXCoord	True	integer	Der rechte Pixelrand des zu konvertierenden Rechtecks. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.
Pixel-Y-Koordinate des unteren Randbildschirms	RectangleBottomPixelYCoord	True	integer	Der untere Pixelrand des zu konvertierenden Rechtecks. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.
Konvertierungstyp	ConversionType	True	string	Der Typ der Konvertierung: Von physisch zu virtuell (PhysicalToVirtual oder P2V) oder virtuell zu physisch (VirtualToPhysical oder V2P).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
X-Koordinate des konvertierten Rechtecks am linken Randbildschirm	ConvertedRectangleLeftPixelXCoord	integer	Der linke Pixelrand des konvertierten Rechtecks. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.
Konvertierte Rechteck-Pixel-Y-Koordinate am oberen Randbildschirm	ConvertedRectangleTopPixelYCoord	integer	Der obere Pixelrand des konvertierten Rechtecks. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.
X-Koordinate des konvertierten Rechtecks am rechten Rand des Bildschirms	ConvertedRectangleRightPixelXCoord	integer	Der rechte Pixelrand des konvertierten Rechtecks. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.
Konvertiertes Rechteck am unteren Randbildschirm pixel Y-Koordinate	ConvertedRectangleBottomPixelYCoord	integer	Der untere Pixelrand des konvertierten Rechtecks. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.
Konvertierte Rechteckbreite	ConvertedRectangleWidth	integer	Die Breite des konvertierten Rechtecks in Pixel. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.
Konvertierte Rechteckhöhe	ConvertedRectangleHeight	integer	Die Höhe des konvertierten Rechtecks in Pixel. Kann je nach Konvertierungstyp in virtuellen oder physischen Pixeln angegeben werden.

Lesen des gesamten Texts aus datei

Vorgangs-ID:: ReadAllTextFromFile

Liest den Textinhalt einer Datei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	Filename	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Dateitextinhalte	FileTextContents	string	Der Textinhalt der Datei.

Lesen von Benutzeranmeldeinformationen

Vorgangs-ID:: CredentialRead

Liest einen Benutzernamen und ein Kennwort aus einer Anmeldeinformation im Profil des Benutzers in der IA-Connect Agent-Sitzung. Anmeldeinformationen können über die Windows-Systemsteuerung angezeigt werden. Sowohl der Benutzername als auch das Kennwort können aus generischen Anmeldeinformationen abgerufen werden, während nur der Benutzername aus einer Windows-Anmeldeinformation abgerufen werden kann.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Anmeldeinformationsadresse	CredentialAddress	True	string	Der Name/die Adresse der Anmeldeinformationen.
Anmeldeinformationstyp	CredentialType	True	string	Der Anmeldeinformationstyp: Windows oder Generisch.
Symmetrischer Verschlüsselungsschlüssel	SymmetricKey		string	Ein optionaler symmetrischer Verschlüsselungsschlüssel, der zum Entschlüsseln des Kennworts für Anmeldeinformationen verwendet wird (verwenden Sie, wenn die Anmeldeinformationen mit einem Schlüssel verschlüsselt wurden). Kann nur mit generischen Anmeldeinformationen verwendet werden, da das Kennwort für windows-Anmeldeinformationen nicht abgerufen werden kann.
Speichern des Kennworts als Bezeichner	StorePasswordAsIdentifier		string	Wenn ein Bezeichner angegeben wird, wird das abgerufene Anmeldeinformationskennwort innerhalb des Agents für einen späteren Abruf/die Verwendung durch alle Befehle gespeichert, die gespeicherte Anmeldeinformationen verwenden können, verschlüsselt. Diese Kennwörter werden nur im Arbeitsspeicher gespeichert und gehen verloren, wenn der Agent geschlossen wird. Kann nur mit generischen Anmeldeinformationen verwendet werden, da das Kennwort für windows-Anmeldeinformationen nicht abgerufen werden kann. Beispiel: MyExchangePassword.
Kennwort zurückgeben	DontReturnPassword		boolean	Wenn dieser Wert auf "true" festgelegt ist, wird das Kennwort für Anmeldeinformationen nicht zurückgegeben. Dies ist nützlich, wenn Sie das Kennwort innerhalb des Agents zur Verwendung durch weitere Befehle speichern (d. h. "Kennwort als Bezeichner speichern" ist wahr), aber Sie müssen das Kennwort in Ihrem Workflow nicht kennen.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Benutzername	UserName	string	Der Benutzername der Anmeldeinformationen.
Kennwort	Password	string	Das Kennwort für Anmeldeinformationen.

Letzte Eingabeinformationen abrufen

Vorgangs-ID:: GetLastInputInfo

Ruft die Zeit seit dem Empfang der letzten Benutzereingabe in der IA-Connect Agent-Benutzersitzung ab.

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
Letzte Eingabesumme Sekunden	LastInputTotalSeconds	integer	Die Anzahl der Sekunden, die seit der letzten Eingabe verstrichen sind.
Letzte Eingabeminuten	LastInputTotalMinutes	integer	Die Anzahl der Minuten, die seit der letzten Eingabe verstrichen sind.
Letzte Eingabe-Gesamtstunden	LastInputTotalHours	integer	Die Anzahl der Stunden, die seit der letzten Eingabe abgelaufen sind.

Letzte fehlgeschlagene Aktion aus Orchestrator-Flussstatistiken abrufen

Vorgangs-ID:: GetLastFailedActionFromOrchestratorFlowStats

Ruft Details der letzten Aktion ab, die durch den IA-Connect Orchestrator an einen Worker übergeben wurde, wenn diese Aktion fehlgeschlagen war. Diese Aktion wird am häufigsten während der Fehlerbehandlung verwendet.

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
Arbeitskraft, der für die Ausführung des Flusses zugewiesen ist	WorkerAllocatedToFlowRun	boolean	Gibt "true" zurück, wenn ein Worker diesem Flusslauf zugeordnet ist, und daher können Informationen zum letzten Aktionsfehler bereitgestellt werden. Gibt "false" zurück, wenn dieser Ablaufausführung kein Worker zugeordnet ist (entweder wurde keiner zugewiesen, oder der Worker wurde jetzt einem anderen Flusslauf zur Verfügung gestellt) und daher können keine Informationen zum letzten Fehler bereitgestellt werden.
Fehler bei der letzten Aktion.	LastActionFailed	boolean	Gibt true zurück, wenn die letzte Aktion in diesem Flusslauf (die für einen Worker ausgeführt wird, der diesem Fluss zugewiesen wurde) fehlgeschlagen ist: Die anderen Ausgaben dieser Aktion enthalten die Details. Gibt "false" zurück, wenn die letzte Aktion in dieser Ablaufausführung nicht fehlschlug: Die anderen Ausgaben sind leer.
Letzte fehlgeschlagene Aktionsanforderungspfad	LastFailedActionRequestPath	string	Wenn die letzte Aktion in diesem Flusslauf (die für einen Worker ausgeführt wird, der diesem Fluss zugewiesen wurde) fehlgeschlagen ist, enthält diese Ausgabe den Aktionsanforderungspfad. Dies kann verwendet werden, um zu bestimmen, welche Aktion fehlgeschlagen ist. Wenn die letzte Aktion in diesem Fluss nicht fehlschlug, ist dieser Wert leer.
Fehlermeldung zur letzten fehlgeschlagenen Aktion	LastFailedActionErrorMessage	string	Wenn die letzte Aktion in diesem Flusslauf (die für einen Worker ausgeführt wird, der diesem Fluss zugewiesen wurde) fehlgeschlagen ist, enthält diese Ausgabe die Fehlermeldung. Wenn die letzte Aktion in diesem Fluss nicht fehlschlug, ist dieser Wert leer.

Linke Maustaste nach oben

Vorgangs-ID:: LeftMouseButtonUp

Gibt die linke Maustaste in der IA-Connect Agent-Benutzersitzung frei.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Linke Maustaste nach unten

Vorgangs-ID:: LeftMouseButtonDown

Drückt die linke Maustaste in der IA-Connect Agent-Benutzersitzung (und lässt sie nicht los). Um die Maus loszulassen, verwenden Sie die linke Maustaste nach oben.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Linksklick mit der Maus

Vorgangs-ID:: LeftClickMouse

Klickt in der IA-Connect Agent-Benutzersitzung auf die linke Maustaste.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Linksklick mit der Maus an der Koordinate

Vorgangs-ID:: LeftClickMouseAtCoordinate

Klickt in der IA-Connect Agent-Benutzersitzung an den angegebenen Koordinaten auf die linke Maustaste. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	XCoord	True	integer	Der X-Koordinatenwert (in Pixel).
Y Pixel	YCoord	True	integer	Der Y-Koordinatenwert (in Pixel).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Liste der Drucker abrufen

Vorgangs-ID:: GetListOfPrinters

Gibt eine Liste aller verfügbaren Drucker in der IA-Connect Agent-Sitzung zurück.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Lokale Drucker auflisten	ListLocalPrinters		boolean	Sollten lokale Drucker zurückgegeben werden?
Auflisten von Netzwerkdruckern	ListNetworkPrinters		boolean	Sollen Netzwerkdrucker zurückgegeben werden?
Detaillierte Informationen zurückgeben	ReturnDetailedInformation		boolean	Sollten detaillierte Informationen wie Standort, Portname, Treibername und Status jedes Druckers zurückgegeben werden?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Drucker JSON	PrintersJSON	string	Eine Liste aller gefundenen Drucker im JSON-Format.
Anzahl der Drucker	NumberOfPrinters	integer	Die Anzahl der gefundenen Drucker.

Liste der Laufwerke abrufen

Vorgangs-ID:: GetListOfDrives

Gibt eine Liste der Laufwerke auf dem Computer zurück, auf dem der IA-Connect Agent ausgeführt wird.

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
Laufwerke JSON	DrivesJSON	string	Eine Liste der Laufwerke auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird, im JSON-Format.

Liste der Orchestrator-Mitarbeiter abrufen

Vorgangs-ID:: GetListOfOrchestratorWorkers

Rufen Sie eine Liste der Mitarbeiter ab, die mit dem IA-Connect Orchestrator registriert sind, und deren Livestatus.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Nur Rückkehr von Livemitarbeitern	OnlyReturnLiveWorkers		boolean	Auf "true" festgelegt, um nur Live-Mitarbeiter zurückzugeben (Arbeiter, die aktiv mit dem Orchestrator verbunden sind).

Gibt zurück

Name	Pfad	Typ	Beschreibung
Orchestrator-Mitarbeiter	OrchestratorWorkers	array of object	Die Liste der Mitarbeiter, die bei der IA-Connect Orchestrator registriert sind, und deren Livestatus.
Id	OrchestratorWorkers.Id	integer
Name	OrchestratorWorkers.Name	string
CurrentFlowDisplayName	OrchestratorWorkers.CurrentFlowDisplayName	string
LiveStatus	OrchestratorWorkers.LiveStatus	boolean
LiveStatusLastContactTicks	OrchestratorWorkers.LiveStatusLastContactTicks	integer
SecondsSinceLastContact	OrchestratorWorkers.SecondsSinceLastContact	integer
MaintenanceMode	OrchestratorWorkers.MaintenanceMode	boolean
Priority	OrchestratorWorkers.Priority	integer
AgentIsLicensed	OrchestratorWorkers.AgentIsLicensed	boolean
IsAvailableForWork	OrchestratorWorkers.IsAvailableForWork	boolean
Anzahl der Arbeitnehmer	NumberOfOrchestratorWorkers	integer	Die Anzahl der Orchestrator-Mitarbeiter in der Antwort.

Löschen des Kennworts im Agent-Speicher

Vorgangs-ID:: DeletePasswordInAgentMemory

Löschen Sie ein im Agent-Speicher gespeichertes Kennwort, oder löschen Sie alle gespeicherten Kennwörter des Agents.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Alle Kennwörter löschen	DeleteAllPasswords		boolean	Legen Sie "true" fest, um alle Kennwörter zu löschen, die im Agent-Speicher gespeichert sind. Legen Sie diesen Wert auf "false" (Standardeinstellung) fest, um ein einzelnes Kennwort zu löschen, das dem angegebenen Bezeichner entspricht.
Kennung	Identifier		string	Ein eindeutiger Bezeichner für das zu löschende Kennwort. Beispiel: SAPGUILogon.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	DeletePasswordInAgentMemoryResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Löschen des Orchestrator-Automatisierungsvorgangs

Vorgangs-ID:: TasksDeleteTaskOperation

Löschen Sie eine bestimmte Orchestrator-Automatisierungsaufgabe, indem Sie die eindeutige Vorgangs-ID angeben.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	OperationId	True	string	Die Vorgangs-ID der zu löschenden Orchestrator-Aufgabe.
Quellsystem aktualisieren	UpdateSourceSystem		boolean	Wenn dieser Wert auf "true" festgelegt ist (standard), und die Orchestrator-Aufgabe mit einem Quellsystem (z. B. ServiceNow) verknüpft ist, führt der Orchestrator alle aktionen aus, die in der Quellsystemkonfiguration im Orchestrator angegeben sind (z. B. schließen Sie das Ticket). Wenn dieser Wert auf "false" festgelegt ist oder die Aufgabe nicht mit einem Quellsystem verknüpft ist, wird die Aufgabe nur aus dem Orchestrator gelöscht.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	TasksDeleteTaskOperationResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Löschen eines Agentthreads

Vorgangs-ID:: DeleteAgentThread

Löscht einen Agent-Thread oder alle Agent-Threads, wenn er noch ausgeführt wird, zuerst den Thread zu töten (beenden, abzubrechen). Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können. Prozesse oder Abläufe, die den Agent-Thread überwachen, erhalten einen Fehler "Agentthread-ID ist nicht vorhanden".

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Thread-ID	ThreadId		integer	Wenn Sie zuvor eine Agent-Aktion als Thread ausgeführt haben, geben Sie die Thread-ID an, um den Thread zu beenden und zu löschen. Diese Thread-ID wurde als Ausgabe der vorherigen Ausführung der Aktion als Thread bereitgestellt. Wenn die angegebene Agent-Thread-ID nicht vorhanden ist, wird eine Ausnahme ausgelöst.
Löschen aller Agent-Threads	DeleteAllAgentThreads		boolean	Auf "true" festlegen, um alle Agent-Threads zu löschen. Legen Sie diesen Wert auf "false" (Standardeinstellung) fest, um einen einzelnen Agent-Thread zu löschen, der durch die Eingabe "Thread-ID" angegeben ist.
Auslösen einer Ausnahme, wenn der Agentthread nicht gelöscht werden kann	RaiseExceptionIfAgentThreadFailsToDelete		boolean	Wird auf "true" festgelegt, um eine Ausnahme auszuheben, wenn ein Agentthread nicht gelöscht werden kann. Beachten Sie, dass dies dazu führen kann, dass eine Ausnahme ausgelöst wird, wenn ein Agent-Thread beim Ausgeben dieser Aktion abgeschlossen wird (da er zum Zeitpunkt des Löschens nicht mehr vorhanden ist). Legen Sie den Wert auf "false" (Standardeinstellung) fest, um Fehler beim Löschen von Agent-Threads zu ignorieren. Die Ausgabe "Anzahl der gelöschten Agent-Threads" gibt an, wie viele Agent-Threads gelöscht wurden.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Anzahl der gelöschten Agent-Threads	NumberOfAgentThreadsDeleted	integer	Wenn "Alle Agent-Threads löschen" wahr ist, enthält diese Ausgabe die Anzahl der gelöschten Agent-Threads (0 oder höher). Wenn "Alle Agent-Threads löschen" falsch ist und eine Agent-Thread-ID angegeben wurde, wird diese Ausgabe auf 0 oder 1 festgelegt.

Löscht benutzeranmeldeinformationen

Vorgangs-ID:: CredentialDelete

Löscht eine Anmeldeinformation im Profil des Benutzers in der IA-Connect Agent-Sitzung. Anmeldeinformationen können über die Windows-Systemsteuerung angezeigt werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Anmeldeinformationsadresse	CredentialAddress	True	string	Der Name/die Adresse der Anmeldeinformationen.
Anmeldeinformationstyp	CredentialType	True	string	Der Anmeldeinformationstyp: Windows oder Generisch.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	CredentialDeleteResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Maus an der Koordinate links halten

Vorgangs-ID:: LeftHoldMouseAtCoordinate

Hält die linke Maustaste an den angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	XCoord	True	integer	Der X-Koordinatenwert (in Pixel).
Y Pixel	YCoord	True	integer	Der Y-Koordinatenwert (in Pixel).
Sekunden, die aufbewahrt werden sollen	SecondsToHold	True	double	Die Anzahl der Sekunden, die die linke Maustaste gedrückt halten soll.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Maus in Koordinate verschieben

Vorgangs-ID:: MoveMouseToCoordinate

Verschiebt die Maus in der IA-Connect Agent-Benutzersitzung zu den angegebenen Pixelkoordinaten. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	XCoord	True	integer	Der X-Koordinatenwert (in Pixel), um die Maus zu verschieben.
Y Pixel	YCoord	True	integer	Der Y-Koordinatenwert (in Pixel), um die Maus zu verschieben.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Maus mit mittlerem Halteraum

Vorgangs-ID:: MiddleHoldMouse

Hält die mittlere Maustaste in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Sekunden, die aufbewahrt werden sollen	SecondsToHold	True	double	Die Anzahl der Sekunden, die die mittlere Maustaste gedrückt halten soll.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Maus mit mittlerem Klick

Vorgangs-ID:: MiddleClickMouse

Klickt in der IA-Connect Agent-Benutzersitzung auf die mittlere Maustaste.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Maus mit mittlerem Klick an der Koordinate

Vorgangs-ID:: MiddleClickMouseAtCoordinate

Klickt in der IA-Connect Agent-Benutzersitzung an den angegebenen Koordinaten auf die mittlere Maustaste. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	XCoord	True	integer	Der X-Koordinatenwert (in Pixel).
Y Pixel	YCoord	True	integer	Der Y-Koordinatenwert (in Pixel).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Maus mit mittlerer Haltetaste an der Koordinate

Vorgangs-ID:: MiddleHoldMouseAtCoordinate

Hält die mittlere Maustaste an den angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	XCoord	True	integer	Der X-Koordinatenwert (in Pixel).
Y Pixel	YCoord	True	integer	Der Y-Koordinatenwert (in Pixel).
Sekunden, die aufbewahrt werden sollen	SecondsToHold	True	double	Die Anzahl der Sekunden, die die mittlere Maustaste gedrückt halten soll.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Maus nach links halten

Vorgangs-ID:: LeftHoldMouse

Hält die linke Maustaste in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Sekunden, die aufbewahrt werden sollen	SecondsToHold	True	double	Die Anzahl der Sekunden, die die linke Maustaste gedrückt halten soll.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Maus relativ verschieben

Vorgangs-ID:: MoveMouseRelative

Verschiebt die Maus in der IA-Connect Agent-Benutzersitzung um die angegebene Anzahl von Pixeln relativ zur aktuellen Position. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	XCoord	True	integer	Die Anzahl der X-Pixel, um die Maus zu verschieben, beginnend mit der aktuellen Position.
Y Pixel	YCoord	True	integer	Die Anzahl der Y-Pixel, um die Maus zu verschieben, beginnend mit der aktuellen Position.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Maus Wiggle

Vorgangs-ID:: WiggleMouse

Verschiebt die Maus um die angegebene Anzahl von Koordinaten hin und her. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Wiggle	XWiggle		integer	Die Anzahl der Pixel, mit der die Maus horizontal verschoben werden soll.
Y-Wackel	YWiggle		integer	Die Anzahl der Pixel, mit der die Maus vertikal verschoben werden soll.
Verzögerung des Perwiggle in Sekunden	WiggleDelayInSeconds		double	Die Anzahl der Sekunden zwischen den Mausbewegungen.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Maus zwischen Koordinaten verschieben

Vorgangs-ID:: MoveMouseBetweenCoordinates

Verschiebt die Maus zwischen zwei angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt. Ein optionaler Jitter wird in der Mausbewegung unterstützt, um es eher wie eine menschliche Handbewegung zu gestalten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Pixel starten	StartXCoord	True	integer	Der X-Anfangskoordinatenwert (in Pixel).
Y Pixel starten	StartYCoord	True	integer	Der Anfangs-Y-Koordinatenwert (in Pixel).
X-Endpixel	EndXCoord	True	integer	Der X-Endkoordinatenwert (in Pixel).
End Y Pixel	EndYCoord	True	integer	Der End-Y-Koordinatenwert (in Pixel).
Anzahl der Schritte	NumberOfSteps		integer	Die Anzahl der Schritte, in die die Bewegungsaktion aufgeteilt werden soll.
Gesamtzeit in Sekunden	TotalTimeInSeconds		double	Die Gesamtzeit, die die Bewegungsaktion von Anfang bis Ende ausführen soll.
Pixel-Jitter für maximale Bewegung	MaximumMovementPixelJitter		integer	Der maximale Pixel-Jitter beim Ausführen der Ziehaktion. Ein Wert von 1 oder höher ermöglicht Bewegungs-Jitter. Jitter wird über jeden Schritt geglättet, um Spitzen in Bewegung zu vermeiden. Der Wert dieser Eingabe steuert das Maximum, das der Jitter an einem bestimmten Punkt sein kann, wodurch beschränkt wird, wie weit die Maus vom Pfad abweichen kann. Je höher der Wert ist, desto weniger "glatt" wird die Ziehaktion angezeigt. Der Jitter an jedem Punkt kann nur von dem vorherigen Jitterwert zwischen -2 und 2 (standardmäßig) abweichen, sodass der maximal mögliche Jitter 2 x NumberOfSteps ist, unabhängig davon, auf was Sie das Maximum festlegen.
Maximale Endpixel-Jitter	MaximumEndPixelJitter		integer	Der maximale Pixel-Jitter am Ende der Ziehaktion. Je höher der Wert ist, desto präziser ist der Ziehvorgang, wenn er die Endkoordinate erreicht.
Pixel-Jitter-Delta für maximale Bewegung	MaximumMovementPixelJitterDelta		integer	Bei Verwendung des Mausbewegungs-Jitters (maximaler Bewegungspixel-Jitter beträgt 1 oder höher), kann der Jitter an jedem Punkt vom vorherigen Punkt abweichen. Dies wird verwendet, um sicherzustellen, dass der Jitter reibungslos ist. Ein größerer Wert führt zu einer geringeren Glättung.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Mausmultiplikator abrufen

Vorgangs-ID:: GetMouseMultiplier

Ruft den globalen Mausmultiplikator in der IA-Connect Agent-Benutzersitzung ab. Dies ist standardmäßig auf (1, 1) festgelegt, konnte aber durch die Aktion "Mausmultiplikator festlegen" geändert werden.

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
X-Multiplikator	MouseXMultiplier	double	Der aktuelle horizontale (X) globale Mausmultiplikator (für den Zeitpunkt, an dem der Agent die Maus bewegt). Der Multiplikator hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Y-Multiplikator	MouseYMultiplier	double	Der aktuelle vertikale (Y)-Mausmultiplizierer (für den Zeitpunkt, an dem der Agent die Maus bewegt). Der Multiplikator hat nur auswirkungen, wenn "Multi monitor functionality" deaktiviert ist.
Mausbewegungsmethode	MouseMoveMethod	string	Gibt die aktuelle globale Mausbewegungsmethode zurück (entweder mouse_event oder setcursorpos).

Mausrad drehen

Vorgangs-ID:: TurnMouseWheel

Dreht das Mausrad (positive oder negative Notches) in der IA-Connect Agent-Benutzersitzung.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Raddrehungen	WheelTurns	True	integer	Die Anzahl der Raddrehungen, die ausgeführt werden sollen.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Mauszeiger ziehen zwischen Koordinaten

Vorgangs-ID:: LeftMouseDragBetweenCoordinates

Führt eine linke Maustaste zwischen den beiden angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung aus. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt. Ein optionaler Jitter wird in der Mausbewegung unterstützt, um es eher wie eine menschliche Handbewegung zu gestalten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Pixel starten	StartXCoord	True	integer	Der X-Anfangskoordinatenwert (in Pixel).
Y Pixel starten	StartYCoord	True	integer	Der Anfangs-Y-Koordinatenwert (in Pixel).
X-Endpixel	EndXCoord	True	integer	Der X-Endkoordinatenwert (in Pixel).
End Y Pixel	EndYCoord	True	integer	Der End-Y-Koordinatenwert (in Pixel).
Anzahl der Schritte	NumberOfSteps		integer	Die Anzahl der Schritte, in die die Ziehaktion aufgeteilt werden soll.
Gesamtzeit in Sekunden	TotalTimeInSeconds		double	Die Gesamtzeit, die die Ziehaktion von Anfang bis Ende ausführen soll.
Pixel-Jitter für maximale Bewegung	MaximumMovementPixelJitter		integer	Der maximale Pixel-Jitter beim Ausführen der Ziehaktion. Ein Wert von 1 oder höher ermöglicht Bewegungs-Jitter. Jitter wird über jeden Schritt geglättet, um Spitzen in Bewegung zu vermeiden. Der Wert dieser Eingabe steuert das Maximum, das der Jitter an einem bestimmten Punkt sein kann, wodurch beschränkt wird, wie weit die Maus vom Pfad abweichen kann. Je höher der Wert ist, desto weniger "glatt" wird die Ziehaktion angezeigt. Der Jitter an jedem Punkt kann nur von dem vorherigen Jitterwert zwischen -2 und 2 (standardmäßig) abweichen, sodass der maximal mögliche Jitter 2 x NumberOfSteps ist, unabhängig davon, auf was Sie das Maximum festlegen.
Maximale Endpixel-Jitter	MaximumEndPixelJitter		integer	Der maximale Pixel-Jitter am Ende der Ziehaktion. Je höher der Wert ist, desto präziser ist der Ziehvorgang, wenn er die Endkoordinate erreicht.
Pixel-Jitter-Delta für maximale Bewegung	MaximumMovementPixelJitterDelta		integer	Bei Verwendung des Mausbewegungs-Jitters (maximaler Bewegungspixel-Jitter beträgt 1 oder höher), kann der Jitter an jedem Punkt vom vorherigen Punkt abweichen. Dies wird verwendet, um sicherzustellen, dass der Jitter reibungslos ist. Ein größerer Wert führt zu einer geringeren Glättung.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Mittlere Maustaste nach oben

Vorgangs-ID:: MiddleMouseButtonUp

Gibt die mittlere Maustaste in der IA-Connect Agent-Benutzersitzung frei.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Mittlere Maustaste nach unten

Vorgangs-ID:: MiddleMouseButtonDown

Drückt die mittlere Maustaste in der IA-Connect Agent-Benutzersitzung (und lässt sie nicht los). Um die Maus loszulassen, verwenden Sie die mittlere Maustaste nach oben.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Nachricht an Web-API senden

Vorgangs-ID:: SendMessageToWebAPI

Senden Sie eine Nachricht an eine Web-API, und empfangen Sie eine Antwort. Dies kann mit jeder Web-API verwendet werden, aber eine häufige Verwendung wäre eine REST-API. IA-Connect unterstützt das Senden von Nachrichten an Web-APIs von einem virtuellen Computer (d. h. für den Zugriff auf lokale Ressourcen) oder über Citrix- oder Microsoft Remote Desktop-Sitzungen (z. B. für den Zugriff auf APIs nur über isolierte Umgebungen).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
URL	URL		string	Die vollständige URL der API, an die eine Nachricht gesendet werden soll. Beispiel: https://myapi.remotesystem.com/path/action.
Methode	Method		string	Die zu verwendende HTTP-Methode. Dies muss mit dem übereinstimmen, was von der Remote-API erwartet wird.
Timeout in Sekunden	TimeoutInSeconds		integer	Die Anzahl der Sekunden, die auf die Antwort gewartet werden soll. Wenn das Timeout erreicht ist, bevor die HTTP-Antwort empfangen wird, wird eine Ausnahme ausgelöst.
Inhaltstyp	ContentType		string	Der Inhaltstyp für die übertragenen Daten im Nachrichtentext (sofern vorhanden). Dies muss mit dem übereinstimmen, was von der Remote-API erwartet wird. Wenn sie eine REST-API aufrufen, die eine JSON-Nutzlast im Text erwartet, wäre der Inhaltstyp wahrscheinlich anwendung/json; charset=utf-8.
Akzeptieren	Accept		string	Die zulässigen Formate für die Antwortdaten. Dies muss mit dem übereinstimmen, was von der Remote-API erwartet wird. Wenn eine REST-API aufgerufen wird, die eine JSON-Nutzlast zurückgibt, würde der Annahmewert wahrscheinlich "application/json" sein. Um eine Antwort zu akzeptieren, geben Sie die Eingabetaste /ein.
Nachrichtentext	MessageBody		string	Wenn Sie eine Web-API aufrufen, die Daten im Nachrichtentext erwartet (häufig mit PUT, POST, PATCH), geben Sie den Inhalt des Textkörpers in diese Eingabe ein. Wenn Sie eine REST-API aufrufen, enthält dies wahrscheinlich JSON-Daten. Wenn Sie eine REST-API aufrufen, die JSON-Daten erwartet, aber keine Daten gesendet werden, müssen Sie diese Eingabe möglicherweise eingeben {} . Standardmäßig wird UTF-8-Codierung verwendet, Sie können dies jedoch mithilfe der Eingabe "Codierung" ändern.
Codierung übertragen	TransmitEncoding		string	Die Codierung für den übertragenen Nachrichtentext (sofern vorhanden). UTF-Codierungen werden verwendet, um Unicode-Daten zu übertragen. BE ist big-endian.
Antwortcodierung	ResponseEncoding		string	Die Codierung der Antwortdaten im Antworttext (sofern vorhanden). Es ist sehr wahrscheinlich, dass die Antwortcodierung mit der Übertragungscodierung übereinstimmt. UTF-Codierungen werden verwendet, um Unicode-Daten zu übertragen. BE ist big-endian.
Puffergröße	BufferSize		integer	Die Größe der einzelnen Lesevorgänge aus dem Ausgabedatenstrom. Sehr unwahrscheinlich, dass dies geändert werden muss. Dies beschränkt nicht die Größe der Antwort; Es handelt sich um eine Blockgröße.
Eigentum	Property		string
Wert	Value		string
Aushandeln von TLS 1.0	NegotiateTLS10		boolean	Wird auf "true" festgelegt, wenn https- und TLS 1.0-Sicherheit mit dem Remotesystem ausgehandelt werden soll. Sie können mehr als eine TLS-Sicherheitsstufe aushandeln, und die höchste gemeinsame Aushandlungsebene zwischen Client und Remotesystem wird verwendet. Warnung: TLS 1.0 ist veraltet, sodass Sie dies nicht aktivieren sollten, es sei denn, das Remotesystem unterstützt keine höhere Ebene (möglicherweise alt und potenziell unpatched), und Sie verstehen und akzeptieren die Sicherheitsrisiken.
Aushandeln von TLS 1.1	NegotiateTLS11		boolean	Wird auf "true" festgelegt, wenn https- und TLS 1.1-Sicherheit mit dem Remotesystem ausgehandelt werden soll. Sie können mehr als eine TLS-Sicherheitsstufe aushandeln, und die höchste gemeinsame Aushandlungsebene zwischen Client und Remotesystem wird verwendet. Warnung: TLS 1.1 ist veraltet, daher sollten Sie dies nur aktivieren, wenn das Remotesystem keine höhere Ebene unterstützt (möglicherweise alt und potenziell unpatched), und Sie verstehen und akzeptieren die Sicherheitsrisiken.
Aushandeln von TLS 1.2	NegotiateTLS12		boolean	Wird auf "true" festgelegt, wenn https- und TLS 1.2-Sicherheit mit dem Remotesystem ausgehandelt werden soll. Sie können mehr als eine TLS-Sicherheitsstufe aushandeln, und die höchste gemeinsame Aushandlungsebene zwischen Client und Remotesystem wird verwendet. TLS 1.2 ist die empfohlene Mindestsicherheitsstufe.
Aushandeln von TLS 1.3	NegotiateTLS13		boolean	Wird auf "true" festgelegt, wenn https- und TLS 1.3-Sicherheit mit dem Remotesystem ausgehandelt werden soll. Sie können mehr als eine TLS-Sicherheitsstufe aushandeln, und die höchste gemeinsame Aushandlungsebene zwischen Client und Remotesystem wird verwendet. TLS 1.3 wird nur von Windows 11 und höher und Server 2022 und höher unterstützt.
Am Leben bleiben	KeepAlive		boolean	Auf "true" festgelegt, wenn Keep-Alive aktiviert werden soll. Dadurch wird die TCP-Verbindung erneut verwendet, wenn Sie mehrere API-Anforderungen innerhalb eines kurzen Zeitraums (weniger als eine Minute) an denselben Endpunkt senden und somit die Leistung verbessern. Legen Sie diesen Wert auf "false" fest, wenn Sie nur einen einzelnen API-Aufruf durchführen möchten, oder die Zeit zwischen API-Aufrufen mehr als eine Minute beträgt. Es gibt minimale Schäden, wenn dies falsch konfiguriert wird, da sie sich nur auf die Leistung auswirkt.
100 Fortsetzung erwarten	Expect100Continue		boolean	Legen Sie diesen Wert auf "true" fest, wenn Sie eine POST-Anforderung verwenden, eine große Datenmenge senden und ermitteln möchten, ob der Server die Anforderung akzeptiert, bevor Sie die Daten senden. False funktioniert in den meisten Szenarien am besten, da die Anzahl der an den Server gesendeten Pakete reduziert und die Reaktionszeit verbessert wird.
Antwortheader zurückgeben	ReturnResponseHeaders		boolean	Legen Sie diesen Wert auf "true" fest, wenn der IA-Connect Agent HTTP-Header zurückgeben soll, die vom Remotesystem empfangen werden, in der Antwort. Die Antwort wird im JSON-Format vorliegen. Verwenden Sie dieses Feature nur, wenn Sie die Antwortheader für Informationen verarbeiten möchten (z. B. ein zurückgegebenes Cookie), da sie die Größe der Antwort erhöht.
Als Thread ausführen	RunAsThread		boolean	Wenn dieser Wert auf "false" festgelegt ist, führt der IA-Connect Agent die Aktion sofort aus und gibt die Ergebnisse zurück, wenn die Aktion abgeschlossen ist, schlägt jedoch fehl, wenn das Timeout des Arbeits-/RPA-Befehls länger dauert. Wenn dieser Wert auf "true" festgelegt ist, führt der IA-Connect Agent diese Aktion als Agent-Thread aus und überwacht sie, bis er abgeschlossen ist. Dadurch kann die Aktion länger als das Timeout des Arbeits-/RPA-Befehls ausgeführt werden.
Auf Thread warten	WaitForThread		boolean	Wird nur verwendet, wenn "Als Thread ausführen" auf "true" festgelegt ist. Legen Sie diese Eingabe auf "true" fest, um auf den Abschluss des Agent-Threads zu warten. Der Agent wartet so lange wie durch "Timeout in Sekunden" angegeben. Auf "false" festgelegt, um die Wartezeit zu umgehen; Der Agent führt die Aktion weiterhin im Hintergrund aus, ist aber auch für die nächste Aktion verfügbar. Sie können die Ergebnisse zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Warten, bis agent-Thread erfolgreich abgeschlossen wurde" verwenden, um auf den Abschluss des Agent-Threads zu warten, und dann diese Aktion erneut ausführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agent-Thread-ID festgelegt ist.
Abrufen von Ausgabedaten für thread-ID	RetrieveOutputDataFromThreadId		integer	Wenn Sie zuvor "Auf Thread warten" auf "false" festgelegt haben (was bewirkt, dass der Agent die Wartezeit in einem Hintergrundthread ausführt), geben Sie die Agent-Thread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Andernfalls wird "0" (Standardeinstellung) festgelegt.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Antwortstatuscode	ResponseStatusCode	integer	Der HTTP-Antwortcode. Häufige erfolgreiche Antworten sind 200 (OK), 201 (Erstellt), 202 (Akzeptiert). 3xx-Antwortcodes sind Umleitungsnachrichten. 4xx-Antwortcodes sind Clientfehlermeldungen (z. B. wenn bei der Anforderung ein Fehler aufgetreten ist). 5xx-Antwortcodes sind Serverfehlermeldungen. 4xx- und 5xx-Antwortcodes werden in der Regel nicht in dieser Ausgabe angezeigt, da stattdessen eine Ausnahme ausgelöst wurde.
Antwortnachricht	ResponseMessage	string	Der Inhalt der Antwortnachricht vom HTTP-Antworttext.
Antwortinhaltstyp	ResponseContentType	string	Der Inhaltstyp des Antworttexts, wenn ein Antworttext vorhanden ist und der Typ bereitgestellt wurde.
JSON-Antwortheader	ResponseHeadersJSON	string	Wenn die Eingabe "Antwortheader zurückgeben" auf "true" festgelegt wurde, enthält diese Ausgabe die HTTP-Antwortheader im JSON-Format. Verwenden Sie dieses Feature nur, wenn Sie die Antwortheader für Informationen verarbeiten möchten (z. B. ein zurückgegebenes Cookie), da sie die Größe der Antwort erhöht.
Thread-ID	ThreadId	integer	Wenn Sie "Auf Thread warten" auf "false" festgelegt haben (was bewirkt, dass der Agent die Wartezeit in einem Hintergrundthread ausführt), enthält diese Ausgabe die Agentthread-ID, mit der der Prozess der Aktion überwacht und die Ergebnisse später abgerufen werden kann, wenn der Thread abgeschlossen wurde.

Neue verzögerte Orchestrator-Aufgabe hinzufügen

Vorgangs-ID:: TasksAddNewDeferral

Fügen Sie eine neue verzögerte Orchestrator-Aufgabe zu einer Warteschlange hinzu, die von einem Flow überwacht werden kann. Der Vorgang wird in Zukunft auf einen bestimmten Zeitpunkt zurückgestellt. Verwenden Sie diese Aktion, um einen Vorgang vorübergehend für einen bestimmten Zeitraum anzusetzen (z. B. wenn Sie auf etwas warten).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Festlegen des Automatisierungsnamens	SetAutomationName		string	Wählen Sie "Auto" aus, wenn Sie den Flussnamen als Vorgangsnamen verwenden möchten, oder wählen Sie "Manuell" aus, und geben Sie einen Namen in das Feld "Automatisierungsname" ein, um diesen Namen zu verwenden.
Automatisierungsname	AutomationName		string	Dies wird nur verwendet, wenn "Manuell" im Feld "Automatisierungsname festlegen" ausgewählt wird. Ein Anzeigename, der angegeben wird, um die Aufgabe später zu identifizieren oder ihm einen bestimmten Fluss zuzuordnen. Mehrere Aufgaben können denselben Automatisierungsnamen verwenden.
Verzögerungszeit in Minuten	DeferralTimeInMinutes		integer	Wie viele Minuten sollte der Automatisierungsvorgang verzögert werden.
Vorgangseingabedaten	TaskInputData		string	Optionale Daten, die dem Vorgang beim Start zur Verfügung gestellt werden sollen. Sie können Daten in einem beliebigen Format speichern, JSON ist jedoch ein häufig verwendetes Format.
Zurückstellung gespeicherter Daten	DeferralStoredData		string	Optionale Daten, die mit dieser Aufgabe gespeichert werden sollen. Er wird für den Prozess /Ablauf verfügbar, wenn er von einer Verzögerung fortgesetzt wird. Dies wird in der Regel verwendet, um Daten zu speichern, die Sie während des Prozesses/Ablaufs berechnet haben, die Sie nach der Verzögerung wieder verfügbar machen müssen. Sie können Daten in einem beliebigen Format speichern, JSON ist jedoch ein häufig verwendetes Format.
Prozessphase	ProcessStage		string	Der Punkt, an dem der Automatisierungsprozess/Ablauf nach der Verzögerung fortgesetzt werden soll. Dies ist ein optionaler Zeichenfolgenwert, der für den spezifischen Prozess/Fluss eindeutig ist. Dies wird von einer Bedingung innerhalb des verzögerten Prozesses/Flusses verwendet, um zu entscheiden, welcher Schritt als Nächstes ausgeführt werden soll. Beispiel: Wenn der Prozess/Ablauf in der Phase "Exchange" fortgesetzt werden soll, wenn er nach der Verzögerung fortgesetzt wird, geben Sie den Wert "Exchange" ein.
Priority	Priority		integer	Legen Sie die Prioritätsebene dieses Vorgangs fest (1 ist höchste Ebene).
Aufgabe im Haltebereich platzieren	TaskOnHold		boolean	Geben Sie den Status "Im Haltebereich" der Aufgabe an. Eine Aufgabe, die auf "Im Haltebereich" festgelegt ist, wird nicht von der Aktion "Nächste Orchestrator-Automatisierungsaufgabe abrufen" abgerufen und wird daher nicht in einem typischen Aufgabenworkflow verarbeitet.
Organisation	Organisation		string	Geben Sie optional die Organisation an, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Abteilung	Department		string	Geben Sie optional die Abteilung an, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Description	Description		string	Geben Sie optional die Beschreibung für diese Aufgabe an. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Stichwörter	Tags		string	Eine optionale Liste mit einem oder mehreren Tags, die dieser Aufgabe zugewiesen werden sollen. Wird in der Regel verwendet, um eine Aufgabe zum Suchen und Filtern zu kategorisieren. Keine Unterscheidung zwischen Groß-/Kleinbuchstaben 1 pro Zeile.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Vorgangs-ID	TaskId	integer	Die ID der zurückstellenden Aufgabe, die erstellt wurde.

Nächste Orchestrator-Automatisierungsaufgabe abrufen

Vorgangs-ID:: TasksGetNextTask

Ruft die nächste Orchestrator-Automatisierungsaufgabe ab, die den angegebenen Suchkriterien entspricht. Es können nur "Neue" und "Verzögerte" Vorgänge (die das Verzögerungsdatum erreicht haben) abgerufen werden. Haltevorgänge werden nicht abgerufen.

Parameter

Name	Schlüssel	Typ	Beschreibung
Automatisierungsname	AutomationName	string	Lassen Sie nichts, um Orchestrator-Automatisierungsaufgaben mit einem beliebigen Namen zurückzugeben. Geben Sie einen Wert ein, um nur Aufgaben mit diesem Automatisierungsnamen abzurufen.
Automatisierungsnamen	AutomationNames	array of string	Wenn Sie Orchestrator-Aufgaben zurückgeben müssen, die einem von mindestens zwei Automatisierungsnamen entsprechen, geben Sie die Namen in dieser Liste ein, anstatt die Eingabe "Automatisierungsname" einzugeben.
Mindestprioritätsstufe	MinimumPriorityLevel	integer	Gibt nur Orchestrator-Automatisierungsaufgaben zurück, die die angegebene Prioritätsstufe oder höher aufweisen. Beispiel: Das Festlegen von 2 gibt Vorgänge mit einer Prioritätsebene von 1 und 2 zurück.
Status ändern in	StatusChange	string	Wenn dieser Befehl auf "Abgerufen" festgelegt ist: Beim Abrufen einer Aufgabe ändert sich der Vorgangsstatus in "Abgerufen", um zu verhindern, dass andere Aktionen versuchen, dieselbe Aufgabe auszuführen. Wenn der Vorgangsstatus auf "Nichts tun" festgelegt ist, wird der Vorgangsstatus nicht geändert.
Minuten bis zum Zurückstellungsdatum	MinutesUntilDeferralDate	integer	Gibt nur Orchestrator-Automatisierungsaufgaben zurück, die innerhalb der angegebenen Anzahl von Minuten ausgeführt werden können. Legen Sie auf 0 fest, wenn Sie nur Automatisierungsaufgaben benötigen, die jetzt ausgeführt werden können.
SLA ignorieren	IgnoreSLA	boolean	Legen Sie diesen Wert auf "true" fest, um alle SLAs zu ignorieren, die für den Vorgang festgelegt wurden. Standardmäßig hat eine Aufgabe mit einer SLA, die bald eine Verletzung hat Vorrang vor allem anderen.
Vorgangs-IDs ausschließen	ExcludeTaskIds	array of integer	Eine Liste der Aufgaben-IDs, die von der Verarbeitung entfernt werden sollen.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Abgerufene Aufgabe	TaskRetrieved	boolean	Auf "true" festgelegt, wenn eine Aufgabe abgerufen wurde. Auf "false" festgelegt, wenn keine Aufgaben vorhanden sind, die den Suchkriterien entsprechen.
Vorgangs-ID	TaskId	integer	Die ID der abgerufenen Orchestrator-Automatisierungsaufgabe.
Vorgangs-ID	OperationId	string	Die Vorgangs-ID der abgerufenen Orchestrator-Aufgabe. Diese Vorgangs-ID (oder die Vorgangs-ID) kann verwendet werden, um den Vorgang zu einem späteren Zeitpunkt abzurufen. Die Vorgangs-ID ist eine eindeutige, nicht zulässige Zeichenfolge, die die Fähigkeit eines Drittanbieters beschränkt, die ID eines Vorgangs zu erraten, den sie nicht erstellt haben.
Automatisierungsname	AutomationNameOutput	string	Der Name der abgerufenen Automatisierungsaufgabe.
Zurückstellungsdatum und -uhrzeit	DeferralDateTime	string	Das Datum und die Uhrzeit, zu dem die abgerufene Orchestrator-Aufgabe bereit sein soll. Dies wird als Zeichenfolge in UTC zurückgegeben.
Zurückstellung gespeicherter Daten	DeferralStoredData	string	Optionale Daten, die beim Verzögerten Verschieben des Vorgangs gespeichert wurden. Dies sind in der Regel Daten, die Sie zum Fortsetzen des Prozesses/Flusses benötigen, aber Sie können dieses Feld für jeden Zweck verwenden.
Verzögerungsanzahl	DeferralCount	integer	Wie oft dieser Vorgang zurückgestellt wurde. Dies ist in der Regel 0 für einen neuen Vorgang, der nie zurückgestellt wurde, oder 1 oder mehr für einen verzögerten Vorgang. Jedes Mal, wenn eine verzögerte Aufgabe erneut zurückgestellt wurde, erhöht der Orchestrator diese Zahl automatisch.
Vorgangseingabedaten	TaskInputData	string	Optionale Daten, die beim Erstellen der Aufgabe gespeichert wurden. Dies sind in der Regel Daten, die zum Starten des Prozesses/Flusses verwendet wurden, aber Sie können dieses Feld für jeden Zweck verwenden. Dies kann als beliebiges Textformat Ihrer Wahl formatiert werden, z. B. JSON oder XML oder Unformatierter Text.
Vorgangsausgabedaten	TaskOutputData	string	Optionale Daten, die von der Automatisierung gespeichert wurden, als die Aufgabe verarbeitet wurde. Dies kann als beliebiges Textformat Ihrer Wahl formatiert werden, z. B. JSON oder XML oder Unformatierter Text.
Priority	Priority	integer	Die Prioritätsebene dieser Orchestrator-Aufgabe (1 ist höchste Ebene).
Automatisierungsaufgabenstatus	AutomationTaskStatus	string	Der Status der abgerufenen Orchestrator-Aufgabe.
Prozessphase	ProcessStage	string	Der Punkt, an dem der verzögerte Prozess/Ablauf nach der Verzögerung fortgesetzt werden soll. Dies ist ein optionaler Zeichenfolgenwert, der für den spezifischen Prozess/Fluss eindeutig ist. Dies wird von einer Bedingung innerhalb des verzögerten Prozesses/Flusses verwendet, um zu entscheiden, welcher Schritt als Nächstes ausgeführt werden soll.
Empfangsdatum und -uhrzeit	ReceivedDateTime	string	Das Datum und die Uhrzeit, zu dem die Aufgabe ursprünglich vom Orchestrator empfangen wurde. Dies wird als Zeichenfolge in UTC zurückgegeben.
Minuten bis zum Zurückstellungsdatum	MinutesUntilDeferralDateOutput	integer	Die Anzahl der Minuten bis zum Zurückstellungsdatum dieses Vorgangs (z. B. wenn diese Aufgabe zur Ausführung bereit ist). Wenn diese Aufgabe bereit ist, die Minuten auszuführen, ist 0.
Quelltypname	SourceTypeName	string	Der Name der Quelle des Vorgangs. "Web-UI" stellt eine Aufgabe dar, die manuell über die Benutzeroberfläche eingegeben wird. "REST-API" stellt eine Aufgabe dar, die über die REST-API des Orchestrators erstellt wurde. "ServiceNow" stellt eine Aufgabe dar, die aus der internen ServiceNow-Integration von Orchestrator erstellt wurde.
Anzeigename der Quelle	SourceFriendlyName	string	Wenn die Aufgabe aus einer internen Orchestrator-Quellenintegration (z. B. ServiceNow) erstellt wurde, enthält dies den Anzeigenamen dieser Quelle.
Quellticket-ID	SourceTicketId	string	Wenn die Aufgabe aus einer internen Orchestrator-Quellenintegration (z. B. ServiceNow) erstellt wurde, enthält dies die ID des Quelltickets. Für ServiceNow würde dies die Katalogaufgabe sys_id enthalten.
Quellticket-Unter-ID	SourceTicketSubId	string	Wenn die Aufgabe aus einer internen Orchestrator-Quellenintegration (z. B. ServiceNow) erstellt wurde, enthält dies die ID des Quelltickets. Für ServiceNow würde dies das Anforderungselement sys_id enthalten.
Organisation	Organisation	string	Die Organisation, mit der diese Aufgabe verbunden ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Abteilung	Department	string	Die Abteilung, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Description	Description	string	Die Beschreibung für diesen Vorgang. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Stichwörter	Tags	string	Eine optionale Liste mit einem oder mehreren Tags, die dieser Aufgabe zugewiesen sind. Wird in der Regel verwendet, um eine Aufgabe zum Suchen und Filtern zu kategorisieren. Keine Unterscheidung zwischen Groß-/Kleinbuchstaben 1 pro Zeile.

Orchestrator-Automatisierungsaufgabe abrufen

Vorgangs-ID:: TasksGetTask

Ruft eine bestimmte Orchestrator-Automatisierungsaufgabe ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	TaskId	True	integer	Die ID der Orchestrator-Aufgabe, die Sie abrufen möchten.
Status ändern in	StatusChange		string	Wenn dieser Befehl auf "Abgerufen" festgelegt ist: Beim Abrufen einer Aufgabe ändert sich der Vorgangsstatus in "Abgerufen", um zu verhindern, dass andere Aktionen versuchen, dieselbe Aufgabe auszuführen. Wenn der Vorgangsstatus auf "Nichts tun" festgelegt ist, wird der Vorgangsstatus nicht geändert.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Automatisierungsname	AutomationName	string	Der Name der abgerufenen Orchestrator-Aufgabe.
Vorgangs-ID	OperationId	string	Die Vorgangs-ID der abgerufenen Orchestrator-Aufgabe. Diese Vorgangs-ID (oder die Vorgangs-ID) kann verwendet werden, um den Vorgang zu einem späteren Zeitpunkt abzurufen. Die Vorgangs-ID ist eine eindeutige, nicht zulässige Zeichenfolge, die die Fähigkeit eines Drittanbieters beschränkt, die ID eines Vorgangs zu erraten, den sie nicht erstellt haben.
Zurückstellungsdatum und -uhrzeit	DeferralDateTime	string	Das Datum und die Uhrzeit, zu dem die abgerufene Orchestrator-Aufgabe bereit sein soll. Dies wird als Zeichenfolge in UTC zurückgegeben.
Zurückstellung gespeicherter Daten	DeferralStoredData	string	Optionale Daten, die beim Verzögerten Verschieben des Vorgangs gespeichert wurden. Dies sind in der Regel Daten, die Sie zum Fortsetzen des Prozesses/Flusses benötigen.
Verzögerungsanzahl	DeferralCount	integer	Wie oft dieser Vorgang zurückgestellt wurde. Dies ist in der Regel 0 für einen neuen Vorgang, der nie zurückgestellt wurde, oder 1 oder mehr für einen verzögerten Vorgang. Jedes Mal, wenn eine verzögerte Aufgabe erneut zurückgestellt wurde, erhöht der Orchestrator diese Zahl automatisch.
Vorgangseingabedaten	TaskInputData	string	Optionale Daten, die beim Erstellen der Aufgabe gespeichert wurden. Dies sind in der Regel Daten, die zum Starten des Prozesses/Flusses verwendet wurden, aber Sie können dieses Feld für jeden Zweck verwenden. Dies kann als beliebiges Textformat Ihrer Wahl formatiert werden, z. B. JSON oder XML oder Unformatierter Text.
Vorgangsausgabedaten	TaskOutputData	string	Optionale Daten, die von der Automatisierung gespeichert wurden, als die Aufgabe verarbeitet wurde. Dies kann als beliebiges Textformat Ihrer Wahl formatiert werden, z. B. JSON oder XML oder Unformatierter Text.
Priority	Priority	integer	Die Prioritätsebene dieser Orchestrator-Aufgabe (1 ist höchste Ebene).
Automatisierungsaufgabenstatus	AutomationTaskStatus	string	Der Status der abgerufenen Orchestrator-Aufgabe.
Prozessphase	ProcessStage	string	Der Punkt, an dem der Automatisierungsprozess/Ablauf nach der Verzögerung fortgesetzt werden soll. Dies ist ein optionaler Zeichenfolgenwert, der für den spezifischen Prozess/Fluss eindeutig ist. Dies wird von einer Bedingung innerhalb des verzögerten Prozesses/Flusses verwendet, um zu entscheiden, welcher Schritt als Nächstes ausgeführt werden soll. Beispiel: Wenn der Prozess/Ablauf in der Phase "Exchange" fortgesetzt werden soll, wenn er nach der Verzögerung fortgesetzt wird, geben Sie den Wert "Exchange" ein.
Empfangsdatum und -uhrzeit	ReceivedDateTime	string	Das Datum und die Uhrzeit, zu dem die Aufgabe ursprünglich vom Orchestrator empfangen wurde. Dies wird als Zeichenfolge in UTC zurückgegeben.
Minuten bis zum Zurückstellungsdatum	MinutesUntilDeferralDate	integer	Die Anzahl der Minuten bis zum Zurückstellungsdatum dieses Vorgangs (z. B. wenn diese Aufgabe zur Ausführung bereit ist). Wenn diese Aufgabe bereit ist, die Minuten auszuführen, ist 0.
Zurückgestellt	OnHold	boolean	Ist auf "true" festgelegt, wenn der Vorgang im Haltebereich ist. Eine "On-Hold"-Aufgabe wird nie von der Aktion "Nächste Orchestrator-Automatisierungsaufgabe abrufen" abgerufen und wird daher nicht in einem typischen Aufgabenworkflow verarbeitet.
Quelltypname	SourceTypeName	string	Der Name der Quelle des Vorgangs. "Web-UI" stellt eine Aufgabe dar, die manuell über die Benutzeroberfläche eingegeben wird. "REST-API" stellt eine Aufgabe dar, die über die REST-API des Orchestrators erstellt wurde. "ServiceNow" stellt eine Aufgabe dar, die aus der internen ServiceNow-Integration von Orchestrator erstellt wurde.
Anzeigename der Quelle	SourceFriendlyName	string	Wenn die Aufgabe aus einer internen Orchestrator-Quellenintegration (z. B. ServiceNow) erstellt wurde, enthält dies den Anzeigenamen dieser Quelle.
Quellticket-ID	SourceTicketId	string	Wenn die Aufgabe aus einer internen Orchestrator-Quellenintegration (z. B. ServiceNow) erstellt wurde, enthält dies die ID des Quelltickets. Für ServiceNow würde dies die Katalogaufgabe sys_id enthalten.
Quellticket-Unter-ID	SourceTicketSubId	string	Wenn die Aufgabe aus einer internen Orchestrator-Quellenintegration (z. B. ServiceNow) erstellt wurde, enthält dies die ID des Quelltickets. Für ServiceNow würde dies das Anforderungselement sys_id enthalten.
Organisation	Organisation	string	Die Organisation, mit der diese Aufgabe verbunden ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Abteilung	Department	string	Die Abteilung, der diese Aufgabe zugeordnet ist. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Description	Description	string	Die Beschreibung für diesen Vorgang. Wird in der Regel zum Suchen und Filtern von Aufgaben verwendet.
Stichwörter	Tags	string	Eine optionale Liste mit einem oder mehreren Tags, die dieser Aufgabe zugewiesen sind. Wird in der Regel verwendet, um eine Aufgabe zum Suchen und Filtern zu kategorisieren. Keine Unterscheidung zwischen Groß-/Kleinbuchstaben 1 pro Zeile.

Orchestrator-Automatisierungsaufgabe löschen

Vorgangs-ID:: TasksDeleteTask

Löschen Sie eine Orchestrator-Automatisierungsaufgabe, die zurückgestellt wurde.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	TaskId	True	integer	Die ID der zu löschenden Orchestrator-Automatisierungsaufgabe.
Quellsystem aktualisieren	UpdateSourceSystem		boolean	Wenn dieser Wert auf "true" festgelegt ist (standard), und die Orchestrator-Aufgabe mit einem Quellsystem (z. B. ServiceNow) verknüpft ist, führt der Orchestrator alle aktionen aus, die in der Quellsystemkonfiguration im Orchestrator angegeben sind (z. B. schließen Sie das Ticket). Wenn dieser Wert auf "false" festgelegt ist oder die Aufgabe nicht mit einem Quellsystem verknüpft ist, wird die Aufgabe nur aus dem Orchestrator gelöscht.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	TasksDeleteTaskResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Orchestrator-Status abrufen

Vorgangs-ID:: OrchestratorGetStatus

Rufen Sie den grundlegenden Orchestrator-Status ab. Dies kann verwendet werden, um zu bestätigen, dass der Orchestrator verfügbar ist und reagiert.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Orchestrator-Version	OrchestratorVersion	string	Die Orchestrator-Softwareversion.
Orchestrator-Startfehler	NumberOfStartupErrors	integer	Die Anzahl der Orchestrator-Startfehler.
Orchestrator-Betriebszeit in Sekunden	UptimeInSeconds	integer	Die Anzahl der Sekunden, die der Orchestrator ausgeführt hat.

Orchestrator-Worker abrufen

Vorgangs-ID:: GetOrchestratorWorker

Rufen Sie Details und den Livestatus eines einzelnen Mitarbeiters ab, der beim IA-Connect Orchestrator registriert ist.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Id des Sucharbeitsmitarbeiters	SearchWorkerId		integer	Die ID des abzurufenden Workers. Legen Sie diesen Wert auf einen Wert von 1 oder höher fest, um die Details eines Mitarbeiters mit dieser bestimmten ID abzurufen. Legen Sie diesen Wert auf 0 fest, wenn Sie einen Mitarbeiter nicht anhand der ID abrufen möchten.
Name des Sucharbeitsmitarbeiters	SearchWorkerName		string	Der Name des abzurufenden Workers. Legen Sie diesen Wert auf "leer" oder "null" fest, wenn Sie einen Worker nicht anhand des Namens abrufen möchten.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Arbeits-ID	WorkerId	integer	Die interne Orchestrator-ID für diesen Worker.
Arbeitsname	WorkerName	string	Der interne Orchestratorname für diesen Worker.
Arbeitsbeschreibung	WorkerDescription	string	Die interne Orchestrator-Beschreibung für diesen Worker.
Anzeigename des aktuellen Flusses	CurrentFlowDisplayName	string	Der Anzeigename für den Ablauf, der von dieser Arbeit verarbeitet wird, oder leer, wenn der Worker im Leerlauf ist.
Livestatus des Mitarbeiters	LiveStatus	boolean	True, wenn der Worker zurzeit mit dem Orchestrator verbunden ist und auf Umfragen reagiert. False, wenn der Worker nicht verbunden ist.
Letzte Kontaktteilstriche	LiveStatusLastContactTicks	integer	Die Zeit, in Ticks, als der Orchestrator zuletzt Kontakt mit dem Arbeiter hatte. Dies ist die Anzahl der 100-Nanosekunden-Intervalle, die seit 12:00:00 Uhr, dem 1. Januar 0001 UTC verstrichen sind. Dies ist gängiges, universelles Zeitformat.
Sekunden seit dem letzten Kontakt	SecondsSinceLastContact	integer	Die Zeit in Sekunden, die seit dem Orchestrator letzten Kontakt mit dem Arbeiter bestanden hat. Dies stellt den gleichen Zeitpunkt wie "Letzte Kontaktteilstriche" dar, wird jedoch in relativen Sekunden ausgedrückt.
Mitarbeiter im Wartungsmodus	MaintenanceMode	boolean	True, wenn sich der Worker derzeit im Wartungsmodus befindet. False, wenn sich der Worker nicht im Wartungsmodus befindet.
Arbeitspriorität	Priority	integer	Ein ganzzahliger Wert von 1 oder höher, der die Dem Worker zugewiesene Priorität darstellt. Priorität 1 ist die höchste Priorität. Flüsse werden an einen verfügbaren Worker mit der höchsten Priorität gesendet. Mehrere Mitarbeiter können dieselbe Priorität haben, und der Orchestrator verwendet die Methode "Arbeitslastenausgleich" (siehe "Websiteeinstellungen"), um einen verfügbaren Worker auszuwählen.
Arbeitstimeout in Sekunden	TimeoutInSeconds	integer	Wie lange in Sekunden sollte der Orchestrator vor dem Timeout auf eine REST-API-Antwort des IA-Connect Director warten.
Worker ist lizenziert	AgentIsLicensed	boolean	True, wenn der Worker zurzeit lizenziert ist. False, wenn der Worker nicht lizenziert ist. Null, wenn der Orchestrator nicht weiß, ob der Worker lizenziert ist (möglicherweise nicht reagiert, ist möglicherweise ein sehr alter Agent, der keine Livelizenzupdates in der Umfrage bereitstellt).
Agent-Lizenzfeatures	AgentLicenseFeatures	string	Spezifische Agent-Lizenzfeatures. Beispiel: JML für joiner, Mover, Leaver license.
Arbeitskraft steht für Arbeit zur Verfügung	IsAvailableForWork	boolean	True, wenn der Arbeitnehmer für die Arbeit verfügbar ist, was bedeutet, dass der Arbeitnehmer eingehende Arbeit annehmen kann. False, wenn der Worker nicht ist. Verfügbar für Arbeit wird durch a) Ist der Arbeitsstatus live, b) Ist der Arbeitnehmer im Wartungsmodus, c) Ist der Arbeitnehmer lizenziert, d) Ist der Arbeitnehmer zurzeit einen Fluss verarbeitet.
Arbeitsverbindungstyp-ID	WorkerConnectionTypeId	integer	Die ID des konfigurierten Arbeitsverbindungstyps, der zum Verbinden des Workers mit dem Orchestrator verwendet wird. Dies kann 1 für 'Azure WCF Relay', 2 für 'Azure Hybrid Connection', 3 für 'Azure Virtual Network (VNet)', 4 für 'Direct' sein.
Name des Arbeitsverbindungstyps	WorkerConnectionTypeName	string	Der Name des konfigurierten Arbeitsverbindungstyps, der zum Verbinden des Workers mit dem Orchestrator verwendet wird. Dies kann AzureWCFRelay, AzureHybridConnection, AzureVNet, Direct sein.
Director-REST-API-URL	DirectorRestApiUrl	string	Wenn der konfigurierte Verbindungstyp Hybridverbindungen, VNet oder direct ist, enthält diese Eigenschaft die REST-API-URL des Workers, was normalerweise HTTP ist, da der HTTP-Datenverkehr innerhalb eines HTTPS-Tunnels verschlüsselt ist (z. B. Hybridverbindung oder lokales Datengateway). Wenn der konfigurierte Verbindungstyp Azure WCF-Relay ist, enthält diese Eigenschaft die WCF-Relay-URL.
Azure Service Bus-Namespace	AzureServiceBusNamespace	string	Wenn der konfigurierte Verbindungstyp Azure WCF Relay ist, enthält dies den Azure Service Bus-Namespace.
Azure WCF-Relayname	AzureWCFRelayName	string	Wenn der konfigurierte Verbindungstyp Azure WCF Relay ist, enthält diese Eigenschaft den Azure WCF-Relaynamen.
Name des Agent-Verbindungstyps	IAConnectAgentConnectionTypeName	string	Der Name des Agent-Verbindungstyps. Dies kann "Local Agent", "Citrix ICA" oder "Microsoft RDP" sein.
Angefügt an Next-Hop Director	AttachedToNextHopDirector	boolean	Wenn der Director, der mit dem Orchestrator verbunden ist (in der Regel der Director, der vom lokalen Agent gehostet wird) Aktionen an einen Next-Hop Director (in der Regel einen Citrix ICA oder Microsoft RDP Director) weitergeleitet wird, wird diese Eigenschaft auf "True" festgelegt. Wenn der Director Aktionen direkt an den Agent sendet, mit dem er verbunden ist (in der Regel der lokale Agent), wird diese Eigenschaft auf "False" festgelegt.
Sitzungstyp "Next-Hop Director"	NextHopDirectorSessionType	string	Wenn der Director, der mit dem Orchestrator verbunden ist (in der Regel der Director, der vom lokalen Agent gehostet wird) Aktionen an einen Next-Hop Director (normalerweise ein Citrix ICA oder Microsoft RDP Director) weiterleitete, enthält diese Eigenschaft den Namen des Verbindungstyps, der "Citrix ICA" oder "Microsoft RDP" lautet.
Directorversion	DirectorVersion	string	Die interne Version des IA-Connect Director, die die REST-API-Schnittstelle verarbeitet, und stellt den IA-Connect Inspector für den IA-Connect-Agent bereit, der auf dem IA-Connect Worker ausgeführt wird.
Agentversion	AgentVersion	string	Die interne Version des IA-Connect-Agents, die auf dem IA-Connect Worker ausgeführt wird.
Director-Version	DirectorReleaseVersion	double	Die IA-Connect Releaseversion des IA-Connect Director, die die REST-API-Schnittstelle verarbeitet, und stellt den IA-Connect Inspector für den IA-Connect Agent bereit, der auf dem IA-Connect Worker ausgeführt wird.
Agent release version	AgentReleaseVersion	double	Die IA-Connect Releaseversion des IA-Connect Agents, die auf dem IA-Connect Worker ausgeführt wird.
Director hostname	DirectorHostname	string	Der Hostname des Betriebssystems, das den IA-Connect Director hosten soll. Dies ist der Hostname des Workers, der in der Regel mit dem Arbeitsnamen identisch ist.
Director NETBIOS-Domänenname	DirectorNetBIOSDomainName	string	Der NETBIOS-Domänenname des Betriebssystems, das den IA-Connect Director hostet, bei dem es sich um eine Komponente des IA-Connect Agents handelt, die auf dem IA-Connect Worker ausgeführt wird. Bei einer Arbeitsgruppe ist dies in der Regel der Hostname des Arbeitsarbeiters. Bei einer Active Directory-Domäne ist dies der Name der Domäne NetBIOS. Beispiel: MYDOMAIN.
Director DNS-Domänenname	DirectorDNSDomainName	string	Der DNS-Domänenname des Betriebssystems, das den IA-Connect Director hosten, bei dem es sich um eine Komponente des IA-Connect-Agents handelt, die auf dem IA-Connect Worker ausgeführt wird. Bei einer Arbeitsgruppe ist dies in der Regel leer. Bei einer Active Directory-Domäne ist dies der Dns-Domänenname. Beispiel: mydomain.local.
Anzahl der unterstützten Flussumgebungs-IDs	SupportedFlowEnvironmentIdsCount	integer	Wenn der Worker so konfiguriert ist, dass nur Abläufe aus angegebenen Flussumgebungs-IDs verarbeitet werden, enthält diese Eigenschaft die Anzahl der unterstützten Flussumgebungs-IDs in der Liste. Wenn der Arbeitsprozess von einer beliebigen Umgebung aus verarbeitet werden kann, enthält diese Eigenschaft 0.
Anzahl der unterstützten Flussnamen	SupportedFlowNamesCount	integer	Wenn der Worker so konfiguriert ist, dass nur Abläufe mit bestimmten Namen verarbeitet werden, enthält diese Eigenschaft die Anzahl der unterstützten Flussnamen in der Liste. Wenn der Worker Abläufe mit einem beliebigen Namen verarbeiten kann, enthält diese Eigenschaft 0.
Anzahl nicht unterstützter Flussnamen	UnsupportedFlowNamesCount	integer	Wenn der Worker so konfiguriert ist, dass die Verarbeitung von Flüssen mit bestimmten Namen verweigert wird, enthält diese Eigenschaft die Anzahl der nicht unterstützten Flussnamen in der Liste. Wenn der Worker nicht so konfiguriert ist, dass bestimmte Flüsse abgelehnt werden, enthält diese Eigenschaft 0.
Anzahl der Arbeitstags	WorkerTagsCount	integer	Wenn der Worker mit einigen Tags konfiguriert ist, enthält diese Eigenschaft die Anzahl der Tags in der Liste. Wenn der Worker keine Tags enthält, enthält diese Eigenschaft 0.
Anzahl der obligatorischen Tags für Mitarbeiter	WorkerMandatoryTagsCount	integer	Wenn der Worker mit einigen obligatorischen Tags konfiguriert ist, enthält diese Eigenschaft die Anzahl der obligatorischen Tags in der Liste. Wenn der Worker keine obligatorischen Tags enthält, enthält diese Eigenschaft 0.

Ordner zu ZIP hinzufügen

Vorgangs-ID:: AddFolderToZIP

ZIPs-Dateien in einem Ordner in einer ZIP-Datei (speichert die Dateien in einem Komprimierungsarchiv).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Quellordner, der zip hinzugefügt werden soll	SourceFolderToAddToZIP	True	string	Der Pfad zum Ordner, der der ZIP-Datei hinzugefügt werden soll. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Ausgabe-ZIP-Dateipfad	OutputZIPFilename	True	string	Der Dateipfad, an den die ZIP-Datei ausgegeben werden soll. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Hinzufügen von Dateien zum Ordner in ZIP	AddFilesToFolderInZIP		string	Wenn Sie die Quelldateien einem Ordner in der ZIP-Datei hinzufügen möchten, geben Sie hier den Ordnernamen ein.
Komprimieren	Compress		boolean	Sollte der Ordner beim Zippen komprimiert werden?
Zur vorhandenen ZIP-Datei hinzufügen	AddToExistingZIPFile		boolean	Auf True festgelegt, um einer vorhandenen ZIP-Datei hinzuzufügen.
Unterordner einschließen	IncludeSubfolders		boolean	Sollen auch Unterordner innerhalb des Quellordners zur ZIP-Datei hinzugefügt werden?
Regulärer Dateiausdruck einschließen	IncludeFilesRegEx		string	Ein optionaler regulärer Ausdruck, mit dem Sie angeben können, welche Dateien extrahiert werden sollen. Stimmt nur mit dem Dateinamen überein.
Regulärer Ausdruck für Dateien ausschließen	ExcludeFilesRegEx		string	Ein optionaler regulärer Ausdruck, mit dem Sie angeben können, welche Dateien von der Extraktion ausgeschlossen werden sollen. Stimmt nur mit dem Dateinamen überein.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Anzahl der erfolgreich hinzugefügten Dateien	FilesAddedSuccessfully	integer	Die Anzahl der Dateien, die der ZIP-Datei erfolgreich hinzugefügt wurden.
Anzahl der ausgeschlossenen Dateien	FilesExcluded	integer	Die Anzahl der Dateien, die ausgeschlossen wurden (wenn die Eingabe "Regulärer Ausdruck für Dateien ausschließen" verwendet wird).

Pixelfarbe an Koordinate abrufen

Vorgangs-ID:: GetPixelColourAtCoordinate

Gibt die RGB-Farbe eines Pixels an einer bestimmten Koordinate zurück.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Pixel links	LeftXPixels	True	integer	Die X-Position des zu lesenden Pixels. Bei einem einzelnen Display beträgt das x-Pixel links 0. Bei einer Anzeige mit mehreren Monitoren kann das x-Pixel links negativ sein (je nachdem, welche Anzeige als primär markiert ist und wo es relativ zu den anderen Displays ist).
Obere Y-Pixel	TopYPixels	True	integer	Die Y-Position des zu lesenden Pixels. Auf einer einzelnen Anzeige beträgt das Y-Pixel oben 0. Bei einer Anzeige mit mehreren Monitoren kann das oberste Y-Pixel negativ sein (je nachdem, welche Anzeige als primär markiert ist und wo sie relativ zu den anderen Displays ist).
Agent ausblenden	HideAgent		boolean	Legen Sie "true" fest, um den Agent (sofern sichtbar) automatisch auszublenden, um sicherzustellen, dass das zu lesende Pixel nicht verdeckt wird.
Verwenden von physischen Koordinaten	UsePhysicalCoordinates		boolean	Legen Sie "true" fest, um anzugeben, dass die bereitgestellten Koordinaten physisch sind (nicht skaliert und entspricht daher den physischen Pixeln auf dem Display). Legen Sie auf "false" (Standardeinstellung) fest, um anzugeben, dass die bereitgestellten Koordinaten virtuell sind (DPI-Skalierung). UIA-, Java- und Webaktionen verwenden in der Regel virtuelle Koordinaten.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Roter Wert	RedValue	integer	Gibt den roten Wert des Pixels von 0 (kein Rot) bis 255 (vollrot) zurück.
Grüner Wert	GreenValue	integer	Gibt den grünen Wert des Pixels von 0 (kein Grün) bis 255 (vollgrün) zurück.
Blauer Wert	BlueValue	integer	Gibt den blauen Wert des Pixels von 0 (kein Blau) bis 255 (vollblau) zurück.
Alphawert	AlphaValue	integer	Gibt den Alphawert des Pixels von 0 (vollständig transparent) bis 255 (vollständig undurchsichtig) zurück.
RRGGBB-Hexwert	RRGGBBHexValue	string	Gibt den RRGGBB-Hexwert des Pixels zurück. Beispiel: FF0000 ist vollrot, 00FF00 ist vollgrün, 0000FF ist blau, 0000000 ist schwarz, FFFFFF ist vollweiß.
AARRGGBB-Hexwert	AARRGGBBHexValue	string	Gibt den Hexadenzwert AARRGGBB des Pixels zurück, der mit RRGGBB identisch ist, aber mit dem hexadenten Alphawert, der am Anfang enthalten ist. Bei vollständig undurchsichtigen Pixeln (am häufigsten) enthält dies den Wert FFRRGGBB. Beispiel: FFFF0000 ist vollständig undurchsichtig rot.

Prozess nach Prozess-ID abrufen

Vorgangs-ID:: GetProcessByPID

Gibt zurück, ob ein Prozess mit der angegebenen Prozess-ID in der IA-Connect Agent-Benutzersitzung ausgeführt wird. Prozess-IDs sind eindeutig, sodass nur ein Prozess mit der ID übereinstimmen kann. Prozess-IDs sind dynamisch und unterscheiden sich für jeden Start einer Anwendung.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Prozess-ID	ProcessId	True	integer	Die Prozess-ID des abzurufenden Prozesses.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Ausgeführter Prozess	ProcessRunning	boolean	Gibt true zurück, wenn ein Prozess mit der bereitgestellten Prozess-ID gefunden wurde.

Reagiert der TCP-Port

Vorgangs-ID:: IsTCPPortResponding

Meldet, ob ein Tcp-Netzwerkport auf einen Verbindungsversuch des IA-Connect-Agents reagiert. Dies kann ein TCP-Port auf dem Computer sein, auf dem der IA-Connect Agent ausgeführt wird (geben Sie "localhost" für den Remotehost ein) oder auf einem beliebigen Remotecomputer. Wenn der IA-Connect Agent erfolgreich eine Verbindung mit einem TCP-Port herstellt, wird die TCP-Verbindung sofort geschlossen.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Remotehost	RemoteHost	True	string	Die IPv4-Adresse, DIE DNS-Adresse oder der Hostname des Computers, mit dem eine Verbindung hergestellt werden soll. Geben Sie "localhost" ein, um einen TCP-Port auf dem Computer zu überprüfen, auf dem der IA-Connect Agent ausgeführt wird. Beispiele: 192.168.1.10 oder www.test.com oder vm-server19.
TCP-Port	TCPPort	True	integer	Die TCP-Portnummer, mit der eine Verbindung mit dem angegebenen Remotehost (oder dem lokalen) Host hergestellt werden soll. Ein TCP-Port muss 1 oder höher und 65535 oder niedriger sein. Beispiele für gängige bekannte Ports sind 80 (HTTP), 443 (HTTPS), 445 (SMB / Dateifreigabe).
Timeout in Sekunden	TimeoutInSeconds		integer	Die maximale Anzahl von Sekunden, die auf die TCP-Verbindung warten. Dies ist standardmäßig 10 Sekunden, die meisten arbeitsfähigen Verbindungen werden jedoch innerhalb weniger Sekunden (über das Internet) oder weniger als eine Sekunde (lokales Netzwerk) verbunden.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
TCP-Port verbunden	TCPPortConnected	boolean	Wird auf "true" festgelegt, wenn der TCP-Port verbunden oder falsch ist, wenn der TCP-Port keine Verbindung herstellen konnte.
Verbindungsfehlermeldung	ConnectionErrorMessage	string	Die Fehlermeldung, wenn der TCP-Port keine Verbindung herstellen konnte. Dies ist in der Regel ein DNS-/Name-Nachschlagefehler oder ein Timeout.

Rechte Maustaste nach oben

Vorgangs-ID:: RightMouseButtonUp

Gibt die rechte Maustaste in der IA-Connect Agent-Benutzersitzung frei.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Rechte Maustaste nach unten

Vorgangs-ID:: RightMouseButtonDown

Drückt die rechte Maustaste in der IA-Connect Agent-Benutzersitzung (und lässt sie nicht los). Verwenden Sie die rechte Maustaste, um die Maus loszulassen.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Rechter Mauszeiger zwischen Koordinaten

Vorgangs-ID:: RightMouseDragBetweenCoordinates

Führt eine rechte Maustaste zwischen den beiden angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung aus. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt. Ein optionaler Jitter wird in der Mausbewegung unterstützt, um es eher wie eine menschliche Handbewegung zu gestalten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Pixel starten	StartXCoord	True	integer	Der X-Anfangskoordinatenwert (in Pixel).
Y Pixel starten	StartYCoord	True	integer	Der Anfangs-Y-Koordinatenwert (in Pixel).
X-Endpixel	EndXCoord	True	integer	Der X-Endkoordinatenwert (in Pixel).
End Y Pixel	EndYCoord	True	integer	Der End-Y-Koordinatenwert (in Pixel).
Anzahl der Schritte	NumberOfSteps		integer	Die Anzahl der Schritte, in die die Ziehaktion aufgeteilt werden soll.
Gesamtzeit in Sekunden	TotalTimeInSeconds		double	Die Gesamtzeit, die die Ziehaktion von Anfang bis Ende ausführen soll.
Pixel-Jitter für maximale Bewegung	MaximumMovementPixelJitter		integer	Der maximale Pixel-Jitter beim Ausführen der Ziehaktion. Ein Wert von 1 oder höher ermöglicht Bewegungs-Jitter. Jitter wird über jeden Schritt geglättet, um Spitzen in Bewegung zu vermeiden. Der Wert dieser Eingabe steuert das Maximum, das der Jitter an einem bestimmten Punkt sein kann, wodurch beschränkt wird, wie weit die Maus vom Pfad abweichen kann. Je höher der Wert ist, desto weniger "glatt" wird die Ziehaktion angezeigt. Der Jitter an jedem Punkt kann nur von dem vorherigen Jitterwert zwischen -2 und 2 (standardmäßig) abweichen, sodass der maximal mögliche Jitter 2 x NumberOfSteps ist, unabhängig davon, auf was Sie das Maximum festlegen.
Maximale Endpixel-Jitter	MaximumEndPixelJitter		integer	Der maximale Pixel-Jitter am Ende der Ziehaktion. Je höher der Wert ist, desto präziser ist der Ziehvorgang, wenn er die Endkoordinate erreicht.
Pixel-Jitter-Delta für maximale Bewegung	MaximumMovementPixelJitterDelta		integer	Bei Verwendung des Mausbewegungs-Jitters (maximaler Bewegungspixel-Jitter beträgt 1 oder höher), kann der Jitter an jedem Punkt vom vorherigen Punkt abweichen. Dies wird verwendet, um sicherzustellen, dass der Jitter reibungslos ist. Ein größerer Wert führt zu einer geringeren Glättung.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Rechts gedrückter Maus

Vorgangs-ID:: RightHoldMouse

Hält die rechte Maustaste in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Sekunden, die aufbewahrt werden sollen	SecondsToHold	True	double	Die Anzahl der Sekunden, die die rechte Maustaste gedrückt halten soll.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Rechts gedrückter Maus an der Koordinate

Vorgangs-ID:: RightHoldMouseAtCoordinate

Hält die rechte Maustaste an den angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung für die angegebene Anzahl von Sekunden. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	XCoord	True	integer	Der X-Koordinatenwert (in Pixel).
Y Pixel	YCoord	True	integer	Der Y-Koordinatenwert (in Pixel).
Sekunden, die aufbewahrt werden sollen	SecondsToHold	True	double	Die Anzahl der Sekunden, die die rechte Maustaste gedrückt halten soll.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Rechtsklick mit der Maus

Vorgangs-ID:: RightClickMouse

Klicken Sie in der IA-Connect Agent-Benutzersitzung auf die rechte Maustaste.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Rechtsklick mit der Maus an der Koordinate

Vorgangs-ID:: RightClickMouseAtCoordinate

Klickt in der IA-Connect Agent-Benutzersitzung an den angegebenen Koordinaten auf die rechte Maustaste. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X Pixel	XCoord	True	integer	Der X-Koordinatenwert (in Pixel).
Y Pixel	YCoord	True	integer	Der Y-Koordinatenwert (in Pixel).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Remotedesktopsitzung (RDS)-Startdatei erstellen

Vorgangs-ID:: GenerateRDPFile

Erstellen Sie eine RdS-Startdatei (Remote Desktop Session), die verwendet werden kann, um automatisch eine Remotedesktopsitzung mit angegebenen Parametern zu starten, anstatt die Remotedesktopclient-Benutzeroberfläche zu automatisieren. Eine RDS-Startdatei hat die Erweiterung ".rdp" und wird häufig als RDP-Datei bezeichnet.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Remoteadresse	RemoteAddress	True	string	Die Adresse des Remotesystems, mit dem eine Verbindung hergestellt werden soll. Dies kann eine IP-Adresse, ein Hostname oder ein vollqualifizierter Domänenname (Fully Qualified Domain Name, FQDN) sein.
Ausgabeordnerpfad	OutputFolderPath	True	string	Der Ordner, in dem die RDP-Datei gespeichert werden soll.
RDP-Dateiname	RDPFileName	True	string	Der Name der RDP-Datei, die im Ausgabeordnerpfad erstellt wird.
RDP-Datei überschreiben, falls bereits vorhanden	OverwriteRDPFileIfAlreadyExists		boolean	Legen Sie "true" fest, um alle RDP-Dateien automatisch mit demselben Ordner/Dateinamen zu überschreiben. Auf "false" festlegen, wenn keine neue RDP-Datei erstellt werden soll, wenn bereits eine vorhandene RDP-Datei mit demselben Ordner/Dateinamen vorhanden ist.
Remotecomputer vertrauen	TrustRemoteComputer		boolean	Legen Sie "true" fest, um die Remoteadresse als vertrauenswürdig (in der Windows-Registrierung) zu markieren, hauptsächlich für Geräteumleitungszwecke, wodurch ein Popup entfernt wird, das Beim Starten der RDP-Datei möglicherweise angezeigt wird.
Speichern von Anmeldeinformationen	StoreCredentials		boolean	Legen Sie "true" fest, um anmeldeinformationen für Benutzer zu erstellen, um die Details der Remotedesktopauthentifizierung zu enthalten. Auf diese Weise können Sie eine Verbindung mit dem Remotedesktopsystem herstellen, ohne zur Authentifizierung aufgefordert zu werden.
Nutzername	UserName		string	Wenn Sie anmeldeinformationen speichern, um die Details der Remotedesktopauthentifizierung zu speichern, können Sie dadurch den Benutzernamen angeben, der in den Anmeldeinformationen gespeichert werden soll.
Kennwort	Password		string	Wenn Sie anmeldeinformationen zum Speichern der Remotedesktopauthentifizierungsdetails speichern, können Sie damit das Kennwort angeben, das in den Anmeldeinformationen gespeichert werden soll.
Anmeldeinformationstyp	CredentialType		string	Wenn Sie anmeldeinformationen speichern, um die Details der Remotedesktopauthentifizierung zu speichern, können Sie den Anmeldeinformationstyp angeben: Windows oder Generisch. Zum Speichern von RDP-Anmeldeinformationen erstellen Sie in der Regel eine Windows-Anmeldeinformationen.
Persistenz von Anmeldeinformationen	CredentialPersistence		string	Wenn Sie die Anmeldeinformationen zum Speichern der Remotedesktopauthentifizierungsdetails speichern, können Sie die Persistenz der Anmeldeinformationen angeben: Sitzung (dauert nur für diese Anmeldesitzung), LocalMachine (wird nur für diesen Benutzer über Sitzungen und Neustarts auf diesem Computer hinweg beibehalten) oder Enterprise (kann für dieses Roaming zwischen Computern ausgeführt werden). Der Standardwert beim Erstellen von RDP-Dateien ist "Session".
Umleiten von Druckern	RedirectPrinters		boolean	Sollten Drucker in der lokalen Sitzung der Remotedesktopsitzung zugeordnet werden? Diese Einstellung kann am Remoteende erzwungen werden und wird daher nicht wirksam.
Alle Laufwerke umleiten	RedirectAllDrives		boolean	Sollen alle Laufwerkbuchstaben (z. B. C:) in der lokalen Sitzung der Remotedesktopsitzung zugeordnet werden? Diese Einstellung kann am Remoteende erzwungen werden und wird daher nicht wirksam.
Zwischenablage umleiten	RedirectClipboard		boolean	Sollte die Zwischenablage zwischen dem lokalen und dem Remotesystem gemeinsam genutzt werden, sodass das Kopieren und Einfügen zwischen den beiden Systemen möglich ist? Diese Einstellung kann am Remoteende erzwungen werden und wird daher nicht wirksam.
Vollbild	Fullscreen		boolean	Sollte die Remotedesktopsitzung vollbilden.
Desktopbreite	DesktopWidth		integer	Die Breite der Remotedesktopsitzung in Pixeln, wenn die Remotedesktopsitzung nicht vollbildig ist.
Desktophöhe	DesktopHeight		integer	Die Höhe der Remotedesktopsitzung in Pixeln, wenn die Remotedesktopsitzung nicht vollbildig ist.
Verwenden von mehreren Monitoren	UseMultiMonitor		boolean	Wird auf "false" festgelegt, wenn eine Remotedesktopsitzung im Vollbildmodus nur einen einzigen Monitor verwenden soll. Wird auf "true" festgelegt, wenn eine Vollbild-Remotedesktopsitzung alle Monitore verwenden soll. Hat keine Auswirkungen auf ein System mit einem Monitor (und somit die meisten virtuellen Computer).
Sitzungsfarbtiefe	SessionBPP		integer	Die Farbtiefe der Remotedesktopsitzung in Bits pro Pixel (BPP). Eine höhere Zahl führt zu mehr Farben. Unterstützte Werte sind 15, 16, 24, 32.
Intelligente Größenanpassung	SmartSizing		boolean	Legen Sie "true" fest, damit der lokale Computer den Inhalt der Remotesitzung automatisch an die Fenstergröße anpassen kann. Auf "false" festgelegt, um nicht automatisch skaliert zu werden.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
RDP-Dateipfad	RDPFilePath	string	Der vollständige Pfad der generierten RDP-Datei.

Remotedesktopsitzung starten (RDS)

Vorgangs-ID:: LaunchRemoteDesktopSession

Starten Sie eine Remotedesktopsitzung (RDS) mit einer RDP-Startdatei.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
RDP-Dateipfad	RDPFilePath	True	string	Der vollständige Pfad zu einer RDP-Datei (die entweder bereits vorhanden oder mithilfe der Aktion erstellt werden kann: 'Remotedesktopsitzung (RDS)-Startdatei erstellen').
Remotecomputer vertrauen	TrustRemoteComputer		boolean	Legen Sie "true" fest, um die Remoteadresse (in der RDP-Datei festgelegt) als vertrauenswürdig (in der Windows-Registrierung) zu markieren, hauptsächlich für Geräteumleitungszwecke, wodurch ein Popup entfernt wird, das Beim Starten der RDP-Datei möglicherweise empfangen wird.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	LaunchRemoteDesktopSessionResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Remotesitzung trennen

Vorgangs-ID:: DisconnectSession

Wenn der IA-Connect Agent in einer Remotesitzung ausgeführt wird, trennt diese Aktion die Remotesitzung. Dies ist nicht mit der Abmeldung identisch und belässt die Remotesitzung, die in einem getrennten Zustand ausgeführt wird. Diese Aktion kann verwendet werden, wo Sie später eine Verbindung mit der Remotesitzung herstellen möchten, und von demselben Zustand fortfahren möchten, anstatt eine neue Sitzung zu starten. Wenn der IA-Connect Agent lokal ausgeführt wird, sperrt diese Aktion die Sitzung.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Sekunden, die gewartet werden sollen	SecondsToWait		integer	Die Zeit, zu warten, bevor der Befehl zum Trennen an das Betriebssystem übergeben wird, damit der IA-Connect Agent den Abschluss des Befehls melden kann, bevor der Kontakt verloren geht (was nur in einer Remotesitzung auftritt).
Trennen Sie die Verbindung nicht, wenn der lokale Agent	DoNotDisconnectIfLocalAgent		boolean	Wenn dieser Wert auf "true" festgelegt ist und der IA-Connect Agent in einer lokalen Sitzung ausgeführt wird (d. h. direkt auf dem Worker), wird diese Aktion automatisch ignoriert. Dies ist nützlich, da das Trennen eines lokalen Agents die Sitzung sperren würde und daher RPA-Funktionen einschränken würde, bis die Sitzung entsperrt ist.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Schließen IA-Connect Agent

Vorgangs-ID:: CloseRSAServer

Schließt den IA-Connect Agent. Dies wirkt sich nicht auf die Benutzersitzung aus, in der der IA-Connect Agent ausgeführt wurde.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Sekunden, die gewartet werden sollen	SecondsToWait		integer	Die Zeit, bis der Befehl geschlossen wird, damit der IA-Connect Agent den Abschluss des Befehls melden kann.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Schlüssel senden

Vorgangs-ID:: SendKeys

Sendet globale Tastendrücke an die IA-Connect Agent-Benutzersitzung. Dadurch wird ein Benutzer simuliert, der diese Tasten auf der Tastatur drückt. Stellen Sie sicher, dass das Zielfensterelement fokussiert ist, oder dass die Tastendrücke von der falschen Anwendung empfangen werden oder ignoriert werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Text	Text	True	string	Die Tasten drücken, die in der IA-Connect Agent-Benutzersitzung simuliert werden sollen. Die Schlüsselcodes sind in der Syntax "Schlüssel senden" im Benutzeroberflächenhandbuch dokumentiert. Um Alphanumerik einzugeben, geben Sie einfach den Text as-isan. Beispiel zum Drücken von STRG+C: ^c. Beispiel zum Drücken von ALT+F: %f.
Intervall in Millisekunden	Interval		integer	Die Anzahl der Millisekunden zwischen jedem Drücken der Taste.
Ist Kennwort	IsPassword		boolean	Ist die Eingabe ein Kennwortwert? Wenn ja, sollte die alternative Aktion "Kennwortschlüssel senden" verwendet werden.
Symbole nicht interpretieren	DontInterpretSymbols		boolean	Sollten Symbole im Text nicht als Sondertasten interpretiert werden (z. B. +für UMSCHALT, ^ für STRG)? Dies sollte auf "true" festgelegt werden, wenn Sie versuchen, die tatsächlichen Symbole einzugeben.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Schreiben einer Textdatei

Vorgangs-ID:: WriteTextFile

Erstellt eine Textdatei auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird, und schreibt Text in die Datei.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Dateipfad	Filename	True	string	Der vollständige Pfad zur Datei. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Zu schreibenden Text	TextToWrite		string	Der Textinhalt, der in die Datei geschrieben werden soll.
Vorhandene Datei anfügen	AppendExistingFile		boolean	Wenn die Datei bereits vorhanden ist, sollte der zu schreibende neue Text am Ende der vorhandenen Datei angefügt werden?
Codierung	Encoding		string	Geben Sie die Dateicodierung (Unicode, UTF8, UTF7 oder ASCII) an, oder lassen Sie für den Standardwert (UTF8) leer.
Erstellen eines Ordners bei Bedarf	CreateFolderIfRequired		boolean	Wenn der Ordner, in dem die Datei gespeichert werden soll, die im Parameter "Dateipfad" angegeben wurde, nicht vorhanden ist, sollte dieser Ordner erstellt werden?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Schreiben in Benutzeranmeldeinformationen

Vorgangs-ID:: CredentialWrite

Schreibt einen Benutzernamen und ein Kennwort in eine Anmeldeinformation im Profil des Benutzers in der IA-Connect Agent-Sitzung, sodass diese Anmeldeinformationen erstellt werden, wenn sie nicht vorhanden ist. Anmeldeinformationen können über die Windows-Systemsteuerung angezeigt werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Anmeldeinformationsadresse	CredentialAddress	True	string	Der Name/die Adresse der Anmeldeinformationen.
Benutzername	UserName	True	string	Der Benutzername der Anmeldeinformationen.
Kennwort	Password	True	string	Das Kennwort für Anmeldeinformationen.
Anmeldeinformationstyp	CredentialType	True	string	Der Anmeldeinformationstyp: Windows oder Generisch.
Persistenz von Anmeldeinformationen	CredentialPersistence		string	Die Persistenz der Anmeldeinformationen: Sitzung (dauert nur für diese Anmeldesitzung), LocalMachine (wird für diesen Benutzer nur über Sitzungen und Neustarts auf diesem Computer hinweg beibehalten) oder Enterprise (kann für dieses Roaming zwischen Computern ausgeführt werden).
Symmetrischer Verschlüsselungsschlüssel	SymmetricKey		string	Ein optionaler symmetrischer Verschlüsselungsschlüssel, der zum Verschlüsseln der Anmeldeinformationen verwendet wird. Sie können diese Anmeldeinformationen nur abrufen, wenn Sie den Schlüssel kennen. Nur mit generischen Anmeldeinformationen verwendbar.
Speichern des Kennworts als Bezeichner	StorePasswordAsIdentifier		string	Wenn ein Bezeichner angegeben wird, wird dieses Kennwort auch innerhalb des Agents für den späteren Abruf/die Verwendung durch alle Befehle gespeichert, die gespeicherte Anmeldeinformationen verwenden können. Diese Kennwörter werden nur im Arbeitsspeicher gespeichert und gehen verloren, wenn der Agent geschlossen wird. Beispiel: MyExchangePassword.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	CredentialWriteResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Screenshot erstellen

Vorgangs-ID:: TakeScreenshot

Erstellt einen Screenshot der IA-Connect Agent-Benutzersitzung und gibt sie als Base64-codierte Zeichenfolge zurück.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vollbild	Fullscreen		boolean	Sollte der Screenshot den gesamten Bildschirm enthalten?
X-Pixel links	LeftXPixels		integer	Wenn kein Screenshot des gesamten Bildschirms erstellt wird, sollte der X-Wert (in Pixel) von dem aus der Screenshot gestartet werden soll. Bei einem einzelnen Display beträgt das x-Pixel links 0. Bei einer Anzeige mit mehreren Monitoren kann das x-Pixel links negativ sein (je nachdem, welche Anzeige als primär markiert ist und wo es relativ zu den anderen Displays ist).
Obere Y-Pixel	TopYPixels		integer	Wenn sie keinen Screenshot des gesamten Bildschirms erstellen, sollte der Y-Wert (in Pixel) von dem aus der Screenshot beginnen soll. Auf einer einzelnen Anzeige beträgt das Y-Pixel oben 0. Bei einer Anzeige mit mehreren Monitoren kann das oberste Y-Pixel negativ sein (je nachdem, welche Anzeige als primär markiert ist und wo sie relativ zu den anderen Displays ist).
Breite Pixel	WidthPixels		integer	Wenn sie keinen Screenshot des gesamten Bildschirms erstellen, wird die Breite des Screenshots von der Startposition aus angezeigt.
Höhe Pixel	HeightPixels		integer	Wenn Sie keinen Screenshot des gesamten Bildschirms erstellen, wird die Höhe des Screenshots von der Startposition aus angezeigt.
Bildformat	ImageFormat		string	Stellen Sie das Bildformat bereit (PNG, JPG, BMP oder GIF).
Verwenden des Anzeigegeräts	UseDisplayDevice		boolean	Sollte der IA-Connect Agent die Anzeigegeräteinformationen berücksichtigen? Dies funktioniert besser bei der DPI-Skalierung und bietet Unterstützung für mehrere Displays.
Ausnahme beim Fehler auslösen	RaiseExceptionOnError		boolean	Wenn "true" festgelegt ist: Der IA-Connect Agent löst eine Ausnahme aus, wenn der Screenshot fehlschlägt (z. B. wenn die Sitzung gesperrt ist). Wenn "false" festgelegt wird: Die IA-Connect gibt eine leere Bitmap zurück, wenn der Screenshot fehlschlägt und die Ausgabe "Screenshot erfolgreich" und "Screenshot-Fehlermeldung" auffüllt.
Agent ausblenden	HideAgent		boolean	Legen Sie "true" fest, um den Agent (falls sichtbar) automatisch auszublenden, um sicherzustellen, dass der Screenshot nicht verdeckt wird.
Verwenden von physischen Koordinaten	UsePhysicalCoordinates		boolean	Legen Sie "true" fest, um anzugeben, dass die bereitgestellten Koordinaten physisch sind (nicht skaliert und entspricht daher den physischen Pixeln auf dem Display). Legen Sie auf "false" (Standardeinstellung) fest, um anzugeben, dass die bereitgestellten Koordinaten virtuell sind (DPI-Skalierung). UIA-, Java- und Webaktionen verwenden in der Regel virtuelle Koordinaten.
Geräte-ID anzeigen	DisplayDeviceId		integer	Diese Eingabe funktioniert nur, wenn die Eingabe "Anzeigegerät verwenden" auf "true" festgelegt ist. Legen Sie auf 0 (Standardeinstellung) fest, um alle Monitore einzuschließen. Auf 1 festgelegt, um nur den primären Monitor einzuschließen. Auf 2 oder höher festgelegt, um nur den relevanten sekundären Monitor einzuschließen.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Bildschirmbild als Base64	ScreenBitmapBase64	string	Das Bildschirmbild als base64-codierte Zeichenfolge. Dies kann mithilfe des bereitgestellten Hilfsprogramms "Base64 to bitmap" angezeigt werden.
Screenshot erfolgreich	ScreenshotSuccessful	boolean	Auf "true" festgelegt, wenn der Screenshot erfolgreich ist. Auf "false" festgelegt, wenn der Screenshot fehlgeschlagen ist und "Ausnahme beim Fehler auslösen" auf "false" festgelegt wurde. Eine Ausnahme wird ausgelöst, wenn der Screenshot fehlgeschlagen ist und "Ausnahme beim Fehler auslösen" auf "true" festgelegt wurde.
Screenshot-Fehlermeldung	ScreenshotErrorMessage	string	Wenn der Screenshot fehlgeschlagen ist und "Ausnahme beim Fehler auslösen" auf "false" festgelegt wurde, enthält dieses Ausgabefeld die Fehlermeldung. Dies ist eine Alternative zum Festlegen von "Ausnahme beim Fehler auslösen" auf "true", was zu einer Ausnahme führt, wenn ein Fehler beim Ausführen des Screenshots auftritt.

Senden von Kennwortschlüsselereignissen

Vorgangs-ID:: SendPasswordKeyEvents

Sendet globale Tastendruckereignisse an die IA-Connect Agent-Benutzersitzung, insbesondere zum Eingeben eines Kennworts, mithilfe des Tastaturtreibers auf niedriger Ebene. Dadurch wird ein Benutzer simuliert, der diese Tasten auf der Tastatur drückt. Stellen Sie sicher, dass das Zielfensterelement fokussiert ist, oder dass die Tastendrücke von der falschen Anwendung empfangen werden oder ignoriert werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kennwort	Password	True	password	Das Kennwort, das in die IA-Connect Agent-Benutzersitzung eingegeben werden soll, unter Verwendung des Tastaturtreibers auf niedriger Ebene. Die Schlüsselcodes sind in der Syntax "Schlüsselereignisse senden" im Benutzeroberflächenhandbuch dokumentiert. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest.
Intervall in Millisekunden	Interval		integer	Die Anzahl der Millisekunden zwischen jedem Tastendruckereignis.
Symbole nicht interpretieren	DontInterpretSymbols		boolean	Sollten Symbole im Kennwort nicht als Sondertasten interpretiert werden (z. B. {UMSCHALT} für UMSCHALT, {STRG} für STRG)? Dies sollte auf "true" festgelegt werden, wenn Sie versuchen, die tatsächlichen Symbole einzugeben.
Kennwort enthält gespeichertes Kennwort	PasswordContainsStoredPassword		boolean	Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Senden von Schlüsselereignissen

Vorgangs-ID:: SendKeyEvents

Sendet globale Tastendruckereignisse mithilfe des Tastaturtreibers auf niedriger Ebene an die IA-Connect Agent-Benutzersitzung. Dadurch wird ein Benutzer simuliert, der diese Tasten auf der Tastatur drückt. Stellen Sie sicher, dass das Zielfensterelement fokussiert ist, oder dass die Tastendrücke von der falschen Anwendung empfangen werden oder ignoriert werden.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Text	Text	True	string	Die Taste drückt, um in die IA-Connect Agent-Benutzersitzung eingegeben zu werden, mithilfe des Tastaturtreibers auf niedriger Ebene. Die Schlüsselcodes sind in der Syntax "Schlüsselereignisse senden" im Benutzeroberflächenhandbuch dokumentiert. Beispiel zum Drücken und Loslassen von Escapezeichen: {Escape}. Beispiel zum Drücken von WIN+D zum Anzeigen des Desktops (drücken Sie die linke Windows-Taste, drücken und loslassen, windows-Taste loslassen): <{LWin}d>{LWin}. Beispiel zum Drücken von STRG+C (gedrücktes linkes Steuerelement, Drücken und Loslassen von C, Loslassen des linken Steuerelements): <{STRG}c>{STRG}. Bitte denken Sie daran, deprimierte Tasten freizugeben, oder sie bleiben gedrückt (z. B. wenn Sie < eine Zusatztaste deprimieren, verwenden > Sie sie, um sie freizugeben).
Intervall in Millisekunden	Interval		integer	Die Anzahl der Millisekunden zwischen jedem Tastendruckereignis.
Ist Kennwort	IsPassword		boolean	Ist die Eingabe ein Kennwortwert? Wenn ja, sollte die alternative Aktion "Kennwortschlüsselereignisse senden" verwendet werden.
Symbole nicht interpretieren	DontInterpretSymbols		boolean	Sollten Symbole im Text nicht als Sondertasten interpretiert werden (z. B. {UMSCHALT} für UMSCHALT, {STRG} für STRG)? Dies sollte auf "true" festgelegt werden, wenn Sie versuchen, die tatsächlichen Symbole einzugeben.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Sitzung lebendig halten

Vorgangs-ID:: KeepSessionAlive

Hält die IA-Connect Agent-Benutzersitzung aktiv, indem die Maus im angegebenen Intervall bewegt wird, um zu verhindern, dass die Sitzung im Leerlauf bleibt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Wiggle	XWiggle		integer	Die Anzahl der Pixel, mit der die Maus horizontal verschoben werden soll.
Y-Wackel	YWiggle		integer	Die Anzahl der Pixel, mit der die Maus vertikal verschoben werden soll.
Verzögerung des Perwiggle in Sekunden	WiggleDelayInSeconds		double	Die Anzahl der Sekunden zwischen den Mausbewegungen beim Wischen.
Leerlaufschwellenwert in Sekunden	IdleThresholdInSeconds		integer	Die Anzahl der Sekunden, die seit der letzten Eingabe verstrichen sein sollen, bevor Sie die Maus bewegen.
Leerlaufüberprüfungszeitraum in Sekunden	IdleCheckPeriodInSeconds		integer	Die Anzahl der Sekunden zwischen der Überprüfung der letzten Eingabezeit (um zu überprüfen, ob der Leerlaufschwellenwert überschritten wurde).
Gesamtdauer der Keepalive-Laufzeit in Sekunden	TotalKeepaliveRuntimeInSeconds		integer	Die Gesamtzahl der Sekunden, für die die Sitzung aktiv bleibt.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	KeepSessionAliveResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Speichern des Kennworts im Agent-Speicher

Vorgangs-ID:: StorePasswordInAgentMemory

Speichern Sie ein Kennwort im Agent-Speicher (verschlüsselt), wo es von allen Aktionen verwendet werden kann, die gespeicherte Kennwörter unterstützen. Kennwörter werden nur im Arbeitsspeicher gespeichert und gehen verloren, wenn der Agent geschlossen wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Kennung	Identifier	True	string	Ein eindeutiger Bezeichner für das Kennwort. Wenn der Bezeichner bereits verwendet wird, wird er überschrieben. Beispiel: SAPGUILogon. Kennwörter werden mithilfe des Ausdrucks {IAConnectPassword:Identifier} abgerufen.
Kennwort	Password	True	password	Das zu speichernde Kennwort.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	StorePasswordInAgentMemoryResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Sperrsitzung

Vorgangs-ID:: LockSession

Sperrt die Sitzung, in der der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Sperren nach Minuten der Inaktivität von Aktionen	LockAfterMinutesOfActionInactivity		integer	Bei Festlegung auf einen Wert größer als 0 wird der Agent nicht sofort gesperrt, sondern stattdessen nach der angegebenen Anzahl von Aktionsinaktivitätsminuten gesperrt (der Agent empfängt keine Aktionen). Dadurch wird verhindert, dass der Agent kontinuierlich sperrt und entsperrt, wenn viele Flüsse zurück-zu-Hinten ausgeführt werden. Legen Sie auf 0 fest, um sofort zu sperren. Der Standardwert beträgt 5 Minuten.
Sekunden, die nach der Sperre gewartet werden sollen	SecondsToWaitAfterLock		integer	Warten Sie nach dem Sperren auf die angegebene Anzahl von Sekunden. Dadurch wird die Sitzungszeit vollständig gesperrt. Dies wird in der Regel verwendet, wenn Sie erwarten, dass ein Entsperrungsereignis (d. h. eine andere Sitzung beginnt) unmittelbar nach der Sperrung, was fehlschlagen könnte, wenn die vorherige Sitzung noch gesperrt ist. Wird nur verwendet, wenn "Lock after minutes of action inactivity" auf 0 festgelegt ist (was zu einer sofortigen Sperre führt).
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	LockSessionResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Standarddrucker abrufen

Vorgangs-ID:: GetDefaultPrinter

Ruft den Namen des Standarddruckers für den Benutzer in der IA-Connect Agent-Sitzung ab.

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
Standarddruckername	DefaultPrinterName	string	Der Name des Standarddruckers für den Benutzer.

Standarddrucker festlegen

Vorgangs-ID:: SetDefaultPrinter

Legt den Standarddrucker für den Benutzer in der IA-Connect Agent-Sitzung fest.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Standarddruckername	DefaultPrinterName	True	string	Der Name des Standarddruckers für den Benutzer.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Töten eines Agent-Threads

Vorgangs-ID:: KillAgentThread

Beendet (beendet, abgebrochen) einen Agent-Thread. Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können. Der Agent-Thread wird nicht gelöscht (verwenden Sie die Aktion "Agent-Thread löschen", um Threads zu löschen), um allen Prozessen oder Flüssen zu ermöglichen, die den Agent-Thread überwachen, um den Fehler "IA-Connect Agent-Thread wurde abgebrochen" zu erhalten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Thread-ID	ThreadId	True	integer	Wenn Sie zuvor eine Agent-Aktion als Thread ausgeführt haben, geben Sie die Thread-ID an, um den Thread zu beenden (beenden Sie den Thread dauerhaft, wenn der Thread ausgeführt wird). Diese Thread-ID wurde als Ausgabe der vorherigen Ausführung der Aktion als Thread bereitgestellt.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	KillAgentThreadResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Umgebungsvariable erweitern

Vorgangs-ID:: ExpandEnvironmentVariable

Erweitert eine Zeichenfolge mit Umgebungsvariablen (z. B. %USERPROFILE% oder %TEMP%) in der IA-Connect Agent-Benutzersitzung.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Eingabezeichenfolge	InputString	True	string	Die Eingabezeichenfolge, die Umgebungsvariablen enthält.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Ausgabezeichenfolge	OutputString	string	Die Zeichenfolge mit erweiterten Umgebungsvariablen.

Unterbrechen der Ordnersicherheitsvererbung

Vorgangs-ID:: BreakFolderSecurityInheritance

Hebt die Sicherheitsvererbung auf einem Ordner auf dem Computer auf, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ordnerpfad	FolderPath	True	string	Der vollständige Pfad zum Ordner. Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Konvertieren, geerbt in explizit	ConvertInheritedToExplicit		boolean	Sollten aktuell geerbte Berechtigungen in explizite Berechtigungen konvertiert werden?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Update Orchestrator Flow stats result

Vorgangs-ID:: UpdateOrchestratorFlowStatsResult

Aktualisieren Sie die Ergebnisstatistiken für den aktuellen Worker Flow im IA-Connect Orchestrator. Dies wird verwendet, um das Endergebnis eines Flussstates im IA-Connect Orchestrator zu ändern, der in der Regel für Berichtszwecke verwendet wird. Dies funktioniert nur für den aktuellen Flow (der Orchestrator erkennt die Ablaufausführungs-ID). Sie können die Statistiken für einen anderen Flow nicht ändern.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Ablauf letzte Aktion erfolgreich	FlowLastActionSuccess		boolean	Legen Sie "true" fest, um anzugeben, dass die letzte Aktion in einem Orchestrator-Flussstat ein Erfolg ist. Legen Sie auf "false" fest, um anzugeben, dass die letzte Aktion in einem Orchestrator-Flussstat ein Fehler ist. Lassen Sie dieses Feld leer, wenn Sie den Status der letzten Ablaufaktion nicht aktualisieren möchten (z. B.: Wenn Sie nur den letzten Aktionscode aktualisieren möchten.
Fehlermeldung zur letzten Flow-Aktion	FlowLastActionErrorMessage		string	Wenn angegeben wird, dass die letzte Aktion ein Fehler war, geben Sie hier eine Fehlermeldung an.
Ablauf letzter Aktionscode	FlowLastActionCode		integer	Optionaler Code, der dem Flussstat zugewiesen werden soll. Dies wird in der Regel als Fehlercode verwendet (z. B. um zwischen System- und Business-Ausnahmen zu unterscheiden), kann aber als Erfolgscode verwendet werden.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	UpdateOrchestratorFlowStatsResultResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Verzeichnis erstellen

Vorgangs-ID:: CreateDirectory

Erstellt ein Verzeichnis (Ordner) auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Verzeichnispfad	DirectoryPath	True	string	Der vollständige Pfad zum Verzeichnis (Ordner). Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Fehler, falls bereits vorhanden	ErrorIfAlreadyExists		boolean	Sollte IA-Connect einen Fehler auslösen, wenn das Verzeichnis (Ordner) bereits vorhanden ist?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Verzeichnis löschen

Vorgangs-ID:: DeleteDirectory

Löscht ein Verzeichnis (Ordner) auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Verzeichnispfad	DirectoryPath	True	string	Der vollständige Pfad zum Verzeichnis (Ordner). Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Rekursiv	Recursive		boolean	Sollen auch Unterverzeichnisse (Unterordner) und Dateien im Verzeichnis gelöscht werden?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Verzeichnis löschen

Vorgangs-ID:: PurgeDirectory

Löscht ein Verzeichnis (Ordner) auf dem Computer, auf dem der IA-Connect Agent ausgeführt wird, und entfernt alle Dateien, die im Verzeichnis gespeichert sind.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Verzeichnispfad	DirectoryPath	True	string	Der vollständige Pfad zum Verzeichnis (Ordner). Auf diese Muss über die Sitzung zugegriffen werden, in der der IA-Connect Agent ausgeführt wird.
Rekursiv	Recursive		boolean	Sollen auch alle Unterordner gelöscht werden?
Oberste Ebene löschen	DeleteTopLevel		boolean	Sollte der Ordner der obersten Ebene ebenfalls gelöscht werden?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Warten Sie, bis der Agent-Thread erfolgreich abgeschlossen wurde.

Vorgangs-ID:: WaitForAgentThreadToCompleteSuccessfully

Wartet auf den Abschluss eines Agent-Threads und ruft optional die Threadausgabedaten ab. Ein Agent-Thread kann verwendet werden, um bestimmte Aktionen in einem Thread auszuführen, soweit die Aktionen lange ausgeführt werden (länger als das RPA-Timeout) oder parallel zu anderen Aktionen ausgeführt werden können. Wenn der Agent-Thread abgeschlossen ist, aber in Einem Fehler wird eine Ausnahme ausgelöst.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Thread-ID	ThreadId	True	integer	Wenn Sie zuvor eine Agent-Aktion als Thread ausgeführt haben, geben Sie die Thread-ID an, um den Status des Threads abzurufen. Diese Thread-ID wurde als Ausgabe der vorherigen Ausführung der Aktion als Thread bereitgestellt.
Sekunden, die auf thread warten	SecondsToWaitForThread	True	integer	Wie viele Sekunden warten, bis der Thread abgeschlossen ist. Wenn der Thread in diesem Zeitraum nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst (es sei denn, "Ausnahme auslösen, wenn thread nicht abgeschlossen" ist auf "false" festgelegt).
Abrufen von Threadausgabedaten	RetrieveThreadOutputData		boolean	Legen Sie "true" fest, um die Threadausgabedaten im JSON-Format abzurufen. Es wird empfohlen, Threadausgabedaten abzurufen, indem sie dieselbe Aktion aufrufen, die zum Erstellen des Threads verwendet wird, indem sie die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Thread-ID festlegt, aber mit dieser Option können Sie die Threadausgabedaten direkt abrufen und optional die Daten nicht löschen.
Thread nach dem Abrufen der Ausgabedaten löschen	ClearOutputDataFromMemoryOnceRead		boolean	Wenn der Thread erfolgreich abgeschlossen wurde und die Ausgabedaten abgerufen wurden (siehe Eingabe 'Threadausgabedaten abrufen'), legen Sie diese Eingabe auf "true" fest, um den Thread zu löschen, nachdem die Ergebnisse zurückgegeben wurden. Dadurch werden die Threadausgabedaten und der Thread selbst gelöscht, sodass Sie den Thread nicht erneut abfragen können.
Auslösen einer Ausnahme, wenn der Thread nicht abgeschlossen ist	RaiseExceptionIfThreadNotCompleted		boolean	Wenn dieser Wert auf "true" festgelegt ist und der Thread in der angegebenen Zeit nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst. Wenn dieser Wert auf "false" festgelegt ist, wartet diese Aktion bis zur angeforderten Zeit (bis der Thread abgeschlossen ist) und meldet den Threadstatus (siehe die Ausgaben "Thread wird ausgeführt" usw.). Eine Ausnahme wird immer ausgelöst, wenn der Thread abgeschlossen ist, aber in Einem Fehler.
Ausnahme auslösen, wenn Threadfehler	RaiseExceptionIfThreadError		boolean	Wenn "true" (Standardverhalten) festgelegt ist und der Thread eine Fehlerbedingung aufweist (Thread abgeschlossen, aber nicht erfolgreich), wird eine Ausnahme ausgelöst, und der Thread wird gelöscht. Wenn dieser Wert auf "false" festgelegt ist, wird der Fehler in der Ausgabe "Threadfehlermeldung" gespeichert, und der Thread wird nicht gelöscht (Sie sollten den Thread bei Bedarf mit der Aktion "Agent-Thread löschen" löschen).
Sekunden, die pro Anruf gewartet werden sollen	SecondsToWaitPerCall		integer	Die "Sekunden, die auf den Thread warten" werden in kleinere Zeitsegmente unterteilt, um Timeouts zu vermeiden. Mit dieser optionalen Eingabe können Sie die Größe des kleineren Zeitsegments angeben. Legen Sie keinen Wert fest, der größer als 80% des RPA-Timeouts ist, oder Sie erhalten möglicherweise Timeoutfehler.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Thread wurde gestartet	ThreadStarted	boolean	True, wenn der Thread gestartet wurde. False, wenn der Thread noch nicht gestartet wurde, was vermuten würde, dass etwas schief gegangen ist, da der Thread sofort gestartet wird. Nur nützlich, wenn "Ausnahme auslösen, wenn thread nicht abgeschlossen" auf "false" festgelegt ist, da andernfalls eine Ausnahme ausgelöst wird, wenn der Thread in der angegebenen Wartezeit nicht abgeschlossen wurde.
Thread wird ausgeführt	ThreadRunning	boolean	True, wenn der Thread zurzeit ausgeführt wird. False, wenn der Thread nie gestartet wurde (höchst unwahrscheinlich) oder wenn der Thread jetzt abgeschlossen wurde. Nur nützlich, wenn "Ausnahme auslösen, wenn thread nicht abgeschlossen" auf "false" festgelegt ist, da andernfalls eine Ausnahme ausgelöst wird, wenn der Thread in der angegebenen Wartezeit nicht abgeschlossen wurde.
Thread ist abgeschlossen	ThreadCompleted	boolean	True, wenn der Thread abgeschlossen ist. False, wenn der Thread nie gestartet wurde (höchst unwahrscheinlich) oder wenn der Thread noch ausgeführt wird. Nur nützlich, wenn "Ausnahme auslösen, wenn thread nicht abgeschlossen" auf "false" festgelegt ist, da andernfalls eine Ausnahme ausgelöst wird, wenn der Thread in der angegebenen Wartezeit nicht abgeschlossen wurde.
Thread erfolgreich	ThreadSuccess	boolean	True, wenn der Thread erfolgreich abgeschlossen wurde. False, wenn der Thread nie gestartet wurde (höchst unwahrscheinlich), wird der Thread weiterhin ausgeführt oder wenn der Thread fehlgeschlagen ist. Nur nützlich, wenn "Ausnahme auslösen, wenn thread nicht abgeschlossen" auf "false" festgelegt ist, da andernfalls eine Ausnahme ausgelöst wird, wenn der Thread in der angegebenen Wartezeit nicht abgeschlossen wurde.
Threadlaufzeit in Sekunden	ThreadRuntimeInSeconds	integer	Die Gesamtzahl der Sekunden, die der Thread ausgeführt hat.
IA-Connect Aktionsname	IAConnectActionName	string	Der interne Name der IA-Connect Agent-Aktion, die als Thread ausgeführt wird.
Threadstatusmeldung	ThreadStatusMessage	string	Eine Textzeichenfolge, die den Status des Threads beschreibt. Diese Nachricht wird aus den Eigenschaften ThreadStarted,ThreadRunning,ThreadCompleted,ThreadSuccess berechnet. Diese Textzeichenfolge ist sprachunabhängig (sie ändert sich nicht entsprechend dem Gebietsschema).
Threadfehlermeldung	ThreadErrorMessage	string	Wenn der Thread fehlgeschlagen ist, enthält diese Ausgabe die Fehlermeldung. Nur nützlich, wenn "Ausnahme auslösen, wenn Threadfehler" auf "false" festgelegt ist, da andernfalls eine Ausnahme ausgelöst wird, wenn der Thread einen Fehler aufweist.
JSON-Threadausgabedaten	ThreadOutputJSON	string	Wenn "Threadausgabedaten abrufen" auf "true" festgelegt ist, enthält diese Ausgabe die rohen Threadausgabedaten im JSON-Format.

Warten Sie, bis IA-Connect nächste Hopsitzung eine Verbindung herstellt.

Vorgangs-ID:: WaitForNextHopSessionToConnect

Wartet auf die nächste Hopsitzung, um eine Verbindung herzustellen, und bis der IA-Connect Agent in der nächsten Hopsitzung ausgeführt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Adresse des nächsten Hop director	NextHopDirectorAddress		string	Die optionale Adresse für den nächsten Hop IA-Connect Director, an die Befehle weitergeleitet werden sollen, wenn keine der Parameter "Next hop Director address is localhost", "Next hop Director address is hostname", "Next hop Director address is FQDN" oder "Next hop Director address is named pipe" parameter are set to true.
Nächster Hop Director TCP-Port	NextHopDirectorTCPPort		integer	Der TCP-Port, auf dem der nächste Hop Director lauscht (der Director auf dem Computer, auf dem der Agent ausgeführt wird).
Nächster Hop Director verwendet HTTPS	NextHopDirectorUsesHTTPS		boolean	Wird auf "True" festgelegt, wenn der nächste Hop Director HTTPS verwendet, oder "false", wenn dies nicht der Fall ist.
Nächste Hop Director-Adresse ist localhost	NextHopDirectorAddressIsLocalhostname		boolean	Die nächste Hop Director-Adresse (relativ zum Agent) ist "localhost".
Adresse des nächsten Hop Director ist Hostname	NextHopDirectorAddressIsHostname		boolean	Die nächste Hop Director-Adresse ist der Hostname des Computers, auf dem der Agent ausgeführt wird (d. h. die Adresse, auf der der Agent und der Director ausgeführt wird).
Nächste Hop Director-Adresse ist FQDN	NextHopDirectorAddressIsFQDN		boolean	Die nächste Hop Director-Adresse ist der vollqualifizierte Domänenname (FQDN) des Computers, auf dem der Agent ausgeführt wird (d. h. die, die den Agent und den Director ausführt).
Nächster Hop Director TCP-Port durch Sitzungs-ID erhöhen	IncrementNextHopDirectorTCPPortBySessionId		boolean	Um sicherzustellen, dass der nächste Hop Director TCP-Port eindeutig ist (wenn mehrere parallele Sitzungen mit next-hop vom gleichen Host verwendet werden), kann die Sitzungs-ID dem TCP-Port "Nächster Hop Director" hinzugefügt werden.
Wartezeit in Sekunden	SecondsToWait		double	Die maximale Anzahl von Sekunden, um auf die nächste Hopsitzung zu warten, um eine Verbindung herzustellen.
Die Adresse des nächsten Hop Director lautet "Pipe".	NextHopDirectorAddressIsNamedPipe		boolean	Die nächste Hop Director-Adresse (relativ zum Agent) verwendet eine benannte Pipe anstelle eines TCP/IP-Webdiensts. Dies ist die Standardeinstellung, um die Verwendung von TCP/IP-Ports für den ersten Hop zu vermeiden.
Vorhandenen nächsten Hop deaktivieren	DisableExistingNextHop		boolean	Sollte doppelter Hop deaktiviert werden (sofern derzeit aktiv), bevor sie erneut aktiviert werden? Wenn dieser Wert auf "true" festgelegt ist (standard), werden alle neuen Doppelsprung-Aktivierungsanweisungen durch die vorherigen ersetzt. Wenn dieser Wert auf "false" festgelegt ist, wird dreifacher Hop aktiviert, da die Anweisungen vom Double-Hop-IA-Connect Agent empfangen werden.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Nächste Hopsitzung verbunden	NextHopSessionConnected	boolean	Gibt true zurück, wenn die nächste Hopsitzung verbunden ist, bevor die maximale Wartezeit überschritten wurde.

Warten Sie, bis IA-Connect Sitzung nach Namen geschlossen wird.

Vorgangs-ID:: WaitForIAConnectSessionToCloseByName

Wartet auf das Schließen der angegebenen IA-Connect Directorsitzung. Dies ist die Sitzung, in die Befehle an einen IA-Connect Agent gesendet werden. Der Name wird aus einer früheren Aktion "Anfügen" bekannt sein.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
IA-Connect Sitzungsname	IAConnectSessionName	True	string	Der Name der zu überprüfenden IA-Connect Sitzung.
Wartezeit in Sekunden	TimeToWaitInSeconds		integer	Wenn keine Sitzung des angegebenen Typs vorhanden ist (wenn ein bestimmter Typ angegeben wurde), wie lange sollte IA-Connect darauf warten?
Auslösen einer Ausnahme, wenn timeout	RaiseExceptionIfTimedout		boolean	Sollte IA-Connect eine Ausnahme auslösen, wenn eine neue Sitzung noch nicht verbunden ist, bevor der Timeoutzeitraum abgelaufen ist?
An Die Sitzung der Ebene 1 IA-Connect bei Erfolg anfügen	AttachToTier1IAConnectSessionOnSuccess		boolean	Sollte IA-Connect eine Verbindung mit der Sitzung der Ebene 1 IA-Connect herstellen (die IA-Connect Directorsitzung des Director, der die SOAP- und /oder REST-Nachrichten empfängt), wenn die Sitzung erfolgreich geschlossen wurde?
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
IA-Connect Sitzung geschlossen	IAConnectSessionClosed	boolean	Gibt "true" zurück, wenn die Sitzung mit dem angegebenen Namen geschlossen oder falsch ist, wenn dies nicht der Fall ist.
Angefügter Sitzungsname der Ebene 1 IA-Connect	AttachedTier1IAConnectSessionName	string	Der Name der Sitzung der Ebene 1 IA-Connect, mit der eine Verbindung hergestellt wurde.

Zeichnen eines Rechtecks auf dem Bildschirm

Vorgangs-ID:: DrawRectangleOnScreen

Zeichnet ein Rechteck auf dem Bildschirm, um die Identifizierung von Bildschirmkoordinaten oder die Ausgabe einer Aktion zu unterstützen, die Bildschirmkoordinaten meldet. Das Rechteck wird nach 5 Sekunden automatisch entfernt.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Koordinate des linken Randbildschirms	RectangleLeftPixelXCoord	True	integer	Der linke Pixelrand des anzuzeigenden Rechtecks. Kann in virtuellen oder physischen Pixeln sein, abhängig von den Eingaben "Koordinaten sind physisch".
Rechteck rechter Randbildschirm Pixel X-Koordinate	RectangleRightPixelXCoord	True	integer	Der rechte Pixelrand des anzuzeigenden Rechtecks. Kann in virtuellen oder physischen Pixeln sein, abhängig von den Eingaben "Koordinaten sind physisch".
Pixel Y-Koordinate des oberen Randbildschirms	RectangleTopPixelYCoord	True	integer	Der obere Pixelrand des anzuzeigenden Rechtecks. Kann in virtuellen oder physischen Pixeln sein, abhängig von den Eingaben "Koordinaten sind physisch".
Pixel-Y-Koordinate des unteren Randbildschirms	RectangleBottomPixelYCoord	True	integer	Der untere Pixelrand des anzuzeigenden Rechtecks. Kann in virtuellen oder physischen Pixeln sein, abhängig von den Eingaben "Koordinaten sind physisch".
Stiftfarbe	PenColour		string	Die Farbe des zu zeichnenden Rechtecks (z. B. Rot, Grün, Blau, Gelb, Lila oder Orange) oder ein Zeichenfolgen-Hexcode, z. B. #FF0000.
Stiftstärke Pixel	PenThicknessPixels		integer	Die Stärke (in Pixel) des Rands des Hervorhebungsrechtecks.
Anzuzeigende Sekunden	SecondsToDisplay		integer	Die Anzahl der Sekunden, mit der das Rechteck angezeigt werden soll.
Koordinaten sind physisch	CoordinatesArePhysical		boolean	Wird auf "true" festgelegt, wenn die bereitgestellten Koordinaten physische Bildschirmkoordinaten sind. Auf "false" festgelegt, wenn die bereitgestellten Koordinaten virtuell sind. Wenn die zugrunde liegende Anzeigeskalierung 100%ist, sind sowohl physische als auch virtuelle Koordinaten identisch.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	DrawRectangleOnScreenResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Ziehen der mittleren Maus zwischen Koordinaten

Vorgangs-ID:: MiddleMouseDragBetweenCoordinates

Führt eine mittlere Maustaste zwischen den beiden angegebenen Koordinaten in der IA-Connect Agent-Benutzersitzung aus. Die derzeit aktive Mausbewegungs-API (mouse_event oder Setcursorpos) wird verwendet, um die Maus zu verschieben. DPI-Skalierung und mehrere Displays werden bei der Berechnung von Koordinaten berücksichtigt. Ein optionaler Jitter wird in der Mausbewegung unterstützt, um es eher wie eine menschliche Handbewegung zu gestalten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
X-Pixel starten	StartXCoord	True	integer	Der X-Anfangskoordinatenwert (in Pixel).
Y Pixel starten	StartYCoord	True	integer	Der Anfangs-Y-Koordinatenwert (in Pixel).
X-Endpixel	EndXCoord	True	integer	Der X-Endkoordinatenwert (in Pixel).
End Y Pixel	EndYCoord	True	integer	Der End-Y-Koordinatenwert (in Pixel).
Anzahl der Schritte	NumberOfSteps		integer	Die Anzahl der Schritte, in die die Ziehaktion aufgeteilt werden soll.
Gesamtzeit in Sekunden	TotalTimeInSeconds		double	Die Gesamtzeit, die die Ziehaktion von Anfang bis Ende ausführen soll.
Pixel-Jitter für maximale Bewegung	MaximumMovementPixelJitter		integer	Der maximale Pixel-Jitter beim Ausführen der Ziehaktion. Ein Wert von 1 oder höher ermöglicht Bewegungs-Jitter. Jitter wird über jeden Schritt geglättet, um Spitzen in Bewegung zu vermeiden. Der Wert dieser Eingabe steuert das Maximum, das der Jitter an einem bestimmten Punkt sein kann, wodurch beschränkt wird, wie weit die Maus vom Pfad abweichen kann. Je höher der Wert ist, desto weniger "glatt" wird die Ziehaktion angezeigt. Der Jitter an jedem Punkt kann nur von dem vorherigen Jitterwert zwischen -2 und 2 (standardmäßig) abweichen, sodass der maximal mögliche Jitter 2 x NumberOfSteps ist, unabhängig davon, auf was Sie das Maximum festlegen.
Maximale Endpixel-Jitter	MaximumEndPixelJitter		integer	Der maximale Pixel-Jitter am Ende der Ziehaktion. Je höher der Wert ist, desto präziser ist der Ziehvorgang, wenn er die Endkoordinate erreicht.
Pixel-Jitter-Delta für maximale Bewegung	MaximumMovementPixelJitterDelta		integer	Bei Verwendung des Mausbewegungs-Jitters (maximaler Bewegungspixel-Jitter beträgt 1 oder höher), kann der Jitter an jedem Punkt vom vorherigen Punkt abweichen. Dies wird verwendet, um sicherzustellen, dass der Jitter reibungslos ist. Ein größerer Wert führt zu einer geringeren Glättung.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Zuordnen von Workern von Orchestrator

Vorgangs-ID:: AllocateWorkerFromOrchestrator

Weist einen Worker vom IA-Connect Orchestrator zu. Sie können einen Mitarbeiter anhand des Tags oder des Arbeitsnamens (oder auch nicht oder beides) anfordern, sodass Sie genauer auswählen können, welche Arbeit Sie benötigen. Sobald ein Mitarbeiter zugewiesen ist, wird er Ihrem Fluss zugewiesen und als ausgeführte Arbeit gemeldet. Beachten Sie, dass der Orchestrator weiterhin "Unterstützte Flussumgebungs-IDs", "Unterstützte Flussnamen" und "Nicht unterstützte Flussnamen" bei der Zuweisung berücksichtigt. Wenn mehrere Mitarbeiter mit der Suche übereinstimmen, gelten normale Lastenausgleichsregeln.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Worker-Tag	WorkerTag		string	Das optionale Tag des Zuteilungsmitarbeiters. Tags ermöglichen es Ihnen, Mitarbeiter in Gruppen zu kategorisieren. Bei Tagnamen wird die Groß-/Kleinschreibung nicht beachtet. Sie können mehrere Tags angeben, indem Sie sie in separate Zeilen eingeben, und der Zuordnungsmechanismus berücksichtigt dann jeden Mitarbeiter mit einem dieser Tags (nur ein Tag muss übereinstimmen). Sie können eine Wildcardsuche mit dem Format Wildcard: Tag* (z. B. Wildcard: JML*) und eine Reguläre Ausdruckssuche mit dem Format RegEx: TagExpression (z. B. RegEx: ^JML) durchführen.
Name der Arbeitskraft	WorkerName		string	Der optionale Name des Zuteilungsmitarbeiters. Bei Den Namen der Mitarbeiter wird die Groß-/Kleinschreibung nicht beachtet. Sie können mehrere Mitarbeiter angeben, indem Sie sie in separate Zeilen eingeben, und der Zuordnungsmechanismus berücksichtigt dann jeden Mitarbeiter mit einem übereinstimmenden Namen. Sie können eine Wildcardsuche mit dem Format Wildcard: Name* (z. B. Wildcard: vmrpa*) und eine Reguläre Ausdruckssuche mit dem Format RegEx: Expression (z. B. RegEx: ^vmrpa) durchführen.
Auslösen einer Ausnahme, wenn der Worker nicht sofort verfügbar ist	RaiseExceptionIfWorkerNotImmediatelyAvailable		boolean	Wenn "true" festgelegt ist und ein geeigneter Worker nicht zugeordnet werden konnte, wird eine Ausnahme ausgelöst. Wenn "false" (Standardeinstellung) und ein geeigneter Worker nicht zugewiesen werden konnte, gibt der Orchestrator DEN HTTP-Statuscode 500 zurück, was dazu führt, dass der PA-Fluss entsprechend der "Wiederholungsrichtlinie" wartet.
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Gibt zurück

Name	Pfad	Typ	Beschreibung
Zugewiesener Arbeitsname	WorkerNameAllocated	string	Der Name des zugewiesenen Arbeitskrafts. Leer, wenn kein Mitarbeiter zugewiesen wurde.

Zurücksetzen der Einstellungen für den nächsten Hop IA-Connect Director

Vorgangs-ID:: ResetNextHopDirectorSettings

Setzt alle benutzerdefinierten IA-Connect Director-Einstellungen zurück, die festgelegt wurden, und stellt die Standardeinstellungen wieder her.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Zurücksetzen IA-Connect Befehlsstatistiken

Vorgangs-ID:: ResetCommandStats

Setzt alle aktuell gespeicherten Statistiken zurück, für die der IA-Connect Agent in der aktuellen Sitzung ausgeführt wurde.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Zurückstellen eines vorhandenen Orchestrator-Automatisierungsvorgangs

Vorgangs-ID:: TasksDeferExistingTaskOperation

Verzögern Sie eine vorhandene Orchestrator-Aufgabe, die sich bereits in der Warteschlange befindet. Der Vorgang wird in Zukunft auf einen bestimmten Zeitpunkt zurückgestellt. Dies wird häufig verwendet, um einen vorhandenen Vorgang erneut zurückzusetzen (d. h. der Vorgang wurde zuvor zurückgestellt und muss jetzt erneut zurückgestellt werden). Verwenden Sie diese Aktion, um einen Vorgang vorübergehend für einen bestimmten Zeitraum anzusetzen (z. B. wenn Sie auf etwas warten).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	OperationId	True	string	Die Vorgangs-ID der Orchestrator-Aufgabe, die zurückverzögert werden soll (oder erneut zurückstellen).
Verzögerungszeit in Minuten	DeferralTimeInMinutes		integer	Wie viele Minuten sollte der Automatisierungsvorgang verzögert werden.
Zurückstellung gespeicherter Daten	DeferralStoredData		string	Optionale Daten, die mit dieser Aufgabe gespeichert werden sollen. Er wird für den Prozess /Ablauf verfügbar, wenn er von einer Verzögerung fortgesetzt wird. Dies wird in der Regel verwendet, um Daten zu speichern, die Sie während des Prozesses/Ablaufs berechnet haben, die Sie nach der Verzögerung wieder verfügbar machen müssen. Sie können Daten in einem beliebigen Format speichern, JSON ist jedoch ein häufig verwendetes Format.
Prozessphase	ProcessStage		string	Der Punkt, an dem der Automatisierungsprozess/Ablauf nach der Verzögerung fortgesetzt werden soll. Dies ist ein optionaler Zeichenfolgenwert, der für den spezifischen Prozess/Fluss eindeutig ist. Dies wird von einer Bedingung innerhalb des verzögerten Prozesses/Flusses verwendet, um zu entscheiden, welcher Schritt als Nächstes ausgeführt werden soll. Beispiel: Wenn der Prozess/Ablauf in der Phase "Exchange" fortgesetzt werden soll, wenn er nach der Verzögerung fortgesetzt wird, geben Sie den Wert "Exchange" ein.
Priority	Priority		integer	Legen Sie die Prioritätsebene dieses Vorgangs fest (1 ist höchste Ebene).

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	TasksDeferExistingTaskOperationResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Zurückstellen vorhandener Orchestrator-Automatisierungsaufgaben

Vorgangs-ID:: TasksDeferExistingTask

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	TaskId	True	integer	Die ID der vorhandenen Orchestrator-Automatisierungsaufgabe, die zurückverzögert werden soll (oder erneut zurückstellen).
Verzögerungszeit in Minuten	DeferralTimeInMinutes		integer	Wie viele Minuten sollte der Automatisierungsvorgang verzögert werden.
Zurückstellung gespeicherter Daten	DeferralStoredData		string	Optionale Daten, die mit dieser Aufgabe gespeichert werden sollen. Er wird für den Prozess /Ablauf verfügbar, wenn er von einer Verzögerung fortgesetzt wird. Dies wird in der Regel verwendet, um Daten zu speichern, die Sie während des Prozesses/Ablaufs berechnet haben, die Sie nach der Verzögerung wieder verfügbar machen müssen. Sie können Daten in einem beliebigen Format speichern, JSON ist jedoch ein häufig verwendetes Format.
Prozessphase	ProcessStage		string	Der Punkt, an dem der Automatisierungsprozess/Ablauf nach der Verzögerung fortgesetzt werden soll. Dies ist ein optionaler Zeichenfolgenwert, der für den spezifischen Prozess/Fluss eindeutig ist. Dies wird von einer Bedingung innerhalb des verzögerten Prozesses/Flusses verwendet, um zu entscheiden, welcher Schritt als Nächstes ausgeführt werden soll. Beispiel: Wenn der Prozess/Ablauf in der Phase "Exchange" fortgesetzt werden soll, wenn er nach der Verzögerung fortgesetzt wird, geben Sie den Wert "Exchange" ein.
Priority	Priority		integer	Legen Sie die Prioritätsebene dieses Vorgangs fest (1 ist höchste Ebene).
Aufgabe im Haltebereich platzieren	TaskOnHold		boolean	Wenn Sie diesen Wert auf "true" festlegen, wird die Aufgabe in den Haltebereich versetzt und daher nicht in einem typischen Aufgabenworkflow verarbeitet, auch wenn das Verzögerungsdatum erreicht ist. Sie können den Status "Im Haltebereich" zu einem späteren Zeitpunkt ändern, indem Sie die Aktion "Änderung des Orchestrator-Automatisierungsaufgabenstatus" verwenden.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	TasksDeferExistingTaskResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Zuweisen einer Orchestrator-Automatisierungsaufgabe

Vorgangs-ID:: TasksAssignTask

Weist einem bestimmten Benutzer oder einer bestimmten Gruppe eine ausgewählte Orchestrator-Automatisierungsaufgabe zu. Diese Zuordnung wird an das Quellsystem übergeben, das mit dieser Automatisierungsaufgabe verknüpft ist (z. B. ServiceNow), und wird am häufigsten verwendet, um ein Ticket an eine andere Person oder Eine andere Personengruppe zu übergeben, um weitere Verarbeitungen zu ermöglichen. Wenn die Orchestrator-Automatisierungsaufgabe nicht mit einer Quelle verknüpft ist, wird eine Ausnahme ausgelöst.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	TaskId	True	integer	Die ID der Orchestrator-Aufgabe, die zugewiesen werden soll.
Benutzer-ID zuweisen	AssignToUserId		string	Die ID des Benutzers, dem die Aufgabe zugewiesen werden soll. Verwenden Sie diese Eingabe, wenn Sie die Aufgabe einem Benutzer zuweisen und die Benutzer-ID kennen. Verwenden Sie die Benutzer-ID oder die Benutzernameneingabe, nicht beides oder wenn Sie einer Gruppe zuweisen, lassen Sie diese Eingabe leer.
Zu Benutzernamen zuweisen	AssignToUserName		string	Der Name des Benutzers, dem die Aufgabe zugewiesen werden soll. Verwenden Sie diese Eingabe, wenn Sie die Aufgabe einem Benutzer zuweisen, und Sie wissen den Benutzernamen. Verwenden Sie die Eingabe der Benutzer-ID oder des Benutzernamens, nicht beides oder wenn Sie einer Gruppe zuweisen, diese Eingabe leer.
Gruppen-ID zuweisen	AssignToGroupId		string	Die ID der Gruppe, der die Aufgabe zugewiesen werden soll. Verwenden Sie diese Eingabe, wenn Sie die Aufgabe einer Gruppe zuweisen und die Gruppen-ID kennen. Verwenden Sie die Gruppen-ID oder gruppennameneingabe, nicht beides oder wenn Sie einem Benutzer zuweisen, lassen Sie diese Eingabe leer.
Gruppenname zuweisen	AssignToGroupName		string	Der Name der Gruppe, der die Aufgabe zugewiesen werden soll. Verwenden Sie diese Eingabe, wenn Sie die Aufgabe einer Gruppe zuweisen und den Gruppennamen kennen. Verwenden Sie die Gruppen-ID- oder Gruppennameneingabe, nicht beides oder wenn sie einem Benutzer zugewiesen werden, diese Eingabe leer.
Entfernen einer Benutzerzuweisung, wenn leer	RemoveUserAssignmentIfBlank		boolean	Wenn die Benutzerzuweisungsfelder leer sind und dieses Feld auf "true" festgelegt ist, werden alle aktuell zugewiesenen Benutzer entfernt, andernfalls bleiben Benutzerzuweisungen unverändert.
Gruppenzuweisung entfernen, wenn leer	RemoveGroupAssignmentIfBlank		boolean	Wenn die Gruppenzuweisungsfelder leer sind und dieses Feld auf "true" festgelegt ist, werden alle aktuell zugewiesenen Gruppen entfernt, andernfalls bleiben Gruppenzuweisungen unverändert.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	TasksAssignTaskResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Zwischenablage abrufen

Vorgangs-ID:: GetClipboardData

Ruft den aktuellen Inhalt der Zwischenablage in der IA-Connect Agent-Benutzersitzung ab.

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
Zwischenablagedaten	ClipboardData	string	Die in der Zwischenablage enthaltenen Daten.

Zwischenablage löschen

Vorgangs-ID:: ClearClipboard

Löscht den Inhalt der Zwischenablage in der IA-Connect Agent-Benutzersitzung.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Arbeitsablauf	Workflow	True	string	Fügen Sie hier den folgenden Ausdruck hinzu: workflow()

Ändern des Vorgangsstatus der Orchestrator-Automatisierung

Vorgangs-ID:: TasksChangeTaskStatus

Ändert den ausgewählten Orchestrator-Automatisierungsaufgabenstatus oder andere Aufgabeneigenschaften.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Vorgangs-ID	TaskId	True	integer	Die ID der orchestrator-Aufgabe, die geändert werden soll.
Neuer Status der Automatisierungsaufgabe	AutomationTaskStatus		string	Der neue Vorgangsstatus für den angegebenen Automatisierungsvorgang oder leer lassen, wenn Sie den Status des vorhandenen Vorgangs nicht ändern möchten. Wenn Sie eine vorhandene Aufgabe zurückstellen möchten, verwenden Sie stattdessen die Aktion "Vorhandene Orchestrator-Automatisierungsaufgabe zurückstellen".
Aufgabe im Haltebereich platzieren	TaskOnHold		boolean	Geben Sie den Status "Im Haltebereich" der Aufgabe an. Es können nur neue oder verzögerte Vorgänge gehalten werden, sodass eine Ausnahme ausgelöst wird, wenn Sie versuchen, einen anderen Vorgangsstatus in den Haltebereich zu setzen.
Löschen von Vorgangseingabedaten	EraseTaskInputData		boolean	Wenn Sie diesen Wert auf "true" festlegen, werden alle Vorgangseingabedaten gelöscht. Dies wird in der Regel verwendet, um Speicherplatz für einen abgeschlossenen oder fehlgeschlagenen Vorgang zu sparen, da die Rohdaten nicht mehr erforderlich sind.
Löschen von zurückgestellten gespeicherten Daten	EraseDeferralStoredData		boolean	Wenn Sie diesen Wert auf "true" festlegen, werden alle zurückgestellten gespeicherten Daten gelöscht. Dies wird in der Regel verwendet, um Speicherplatz für einen abgeschlossenen oder fehlgeschlagenen Vorgang zu sparen, da die Rohdaten nicht mehr erforderlich sind.
Quellsystem aktualisieren	UpdateSourceSystem		boolean	Wenn Sie diesen Wert auf "true" festlegen und die Orchestrator-Aufgabe mit einem Quellsystem (z. B. ServiceNow) verknüpft ist, führt der Orchestrator alle aktionen aus, die in der Quellsystemkonfiguration im Orchestrator angegeben sind (z. B. schließen Sie das Ticket).
Vorgangsschließungsgrund	TaskClosureReason		string	Geben Sie einen Vorgangsabschlussgrund für "Abgeschlossene" oder "Fehlgeschlagene" Vorgänge an, die in der Aufgabe gespeichert werden. Wenn die Orchestrator-Aufgabe mit einem Quellsystem (z. B. ServiceNow) verknüpft ist, ändern Sie den Status, und "Quellsystem aktualisieren" ist auf "true" festgelegt, wird der Grund auch an das Quellsystem übergeben (z. B. als ServiceNow-Arbeitsnotiz). Nur abgeschlossene oder fehlgeschlagene Vorgänge können einen Abschlussgrund haben, sodass eine Ausnahme ausgelöst wird, wenn Sie versuchen, den Abschlussgrund für einen anderen Vorgangsstatus festzulegen.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Befehlsergebnis	TasksChangeTaskStatusResult	boolean	Das Ergebnis des Befehls (Erfolg oder Fehler).
Fehlermeldung	ErrorMessage	string	Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde.

Freigeben über

IA-Connect-Sitzung

Voraussetzungen

Verfügbare IA-Connect Connectors

So erhalten Sie Anmeldeinformationen

Erste Schritte mit Ihrem Connector

Support

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

Erstellen einer Verbindung

Vorgabe

Drosselungsgrenzwerte

Aktionen

Ablauf als abgeschlossen markieren

Parameter

Abmelden der Remotesitzung

Parameter

Abrufen aller IA-Connect Befehlsstatistiken

Parameter

Gibt zurück

Abrufen aller Orchestrator-Automatisierungsaufgaben

Parameter

Gibt zurück

Abrufen der Arbeitsablaufnutzung von Orchestrator

Parameter

Gibt zurück

Abrufen der id des übergeordneten Prozesses

Parameter

Gibt zurück

Abrufen der Prozessanzahl nach Name

Parameter

Gibt zurück

Abrufen des Anmeldeverlaufs von Orchestrator

Parameter

Gibt zurück

Abrufen des Clienthosts

Parameter

Gibt zurück

Abrufen des gespeicherten Kennworts

Parameter

Gibt zurück

Abrufen des Orchestrator-Automatisierungsaufgabenvorgangs

Parameter

Gibt zurück

Abrufen des Status eines Agent-Threads

Parameter

Gibt zurück

Abrufen des Verfügbarkeitsstatus von Orchestrator-Workern

Gibt zurück

Abrufen generischer Anmeldeinformationen von Orchestrator

Parameter

Gibt zurück

Abrufen IA-Connect Agent-Informationen

Parameter

Gibt zurück

Abrufen IA-Connect Agent-Protokollebene

Parameter

Gibt zurück

Abrufen IA-Connect Agent-Sitzungsinformationen

Parameter

Gibt zurück

Abrufen IA-Connect Agentprotokolls

Parameter

Gibt zurück

Abrufen IA-Connect Agentprozessanzahl

Parameter

Gibt zurück

Abrufen IA-Connect aktuellen Lizenzstatus des Agents

Parameter

Gibt zurück

Abrufen IA-Connect Director-Betriebszeit

Parameter

Gibt zurück

Abrufen IA-Connect Director-Informationen

Parameter

Gibt zurück

Abrufen IA-Connect Directorprotokollebene

Parameter

Gibt zurück

Abrufen IA-Connect globalen Koordinatenkonfiguration des Agents

Parameter