Erweiterung für Silverlight

Der erste Schritt besteht darin, alle vorherigen Silverlight Runtime-Instanzen zu deinstallieren und die Silverlight Developer Runtime Version 5.1.50918.0zu installieren.

Hinweis: Die Silverlight-Automatisierung funktioniert nur, wenn die Version Developer Runtime installiert ist.

Um fensterlose Silverlight-Anwendungen zu automatisieren, müssen Sie die UiPath-Erweiterung für Silverlight aktivieren. Die einfachste Möglichkeit, die Bridge-Erweiterung zu installieren, besteht darin, Studio zu öffnen, zu Tools > UiPath-Erweiterungen zu navigieren und Silverlight > Installieren auszuwählen.

Sie können die UiPath-Erweiterung für Silverlight auch installieren, indem Sie eine Eingabeaufforderung verwenden, die mit Administratorrechten geöffnet wurde, und einen der folgenden Befehle ausführen:

• C:\Program Files\UiPath Studio\v8\UiPath\SetupExtensions.exe /silverlight
• C:\Program Files\UiPath Studio\v8\UiPath\slinject.exe /install – Dieser Befehl zeigt weitere Informationen an der Konsole an.
• C:\Program Files\UiPath Studio\v8\UiPath\slinject.exe /uninstall: Mit diesem Befehl wird die Erweiterung deinstalliert. Dadurch werden auch alle Erweiterungseinträge im Abschnitt Programme hinzufügen/entfernen der Systemsteuerung entfernt.

Beachten Sie, dass in allen Fällen Administratorenrechte benötigt werden. Wenn UAC deaktiviert ist, könnte SetupExtensions.exe im Hintergrund fehlschlagen (zumindest in älteren Versionen von Studio).

Die automatische Windows-Aktualisierung kann die Silverlight-Laufzeit im Hintergrund aktualisieren. Es wird empfohlen, im letzten Schritt des Silverlight-Installers die Option Enable Microsoft Update zu deaktivieren oder Silverlight-Updates zu konfigurieren, indem Sie Folgendes verwenden:

C:\Program Files (x86)\Microsoft Silverlight\5.1.50918.0\Silverlight.Configuration.exe

Sie können den fensterlosen Parameter mit dem UiExplorer-Tool wie folgt überprüfen:

• Suchen Sie nach dem Tag <param name=”windowless” /> unter dem entsprechenden Element <object />.
• Verwenden Sie den DOM Explorer im Internet Explorer (drücken Sie F12, um ihn zu öffnen).

Fehlerbehebung für die Silverlight-Erweiterung

Silverlight-Browser-Anwendungen können nur im Internet Explorer geöffnet werden, da alle anderen Hauptbrowser NPAPI – eine vom Silverlight-Browser-Plugin verwendete API – nicht mehr verwenden. Es gibt auch eigenständige Silverlight-Anwendungen, die außerhalb des Browsers verwendet werden können.

Wichtig:

Ein größeres Windows-Update, das die Windows-Version zu 20H2 ändert, kann Silverlight-Interaktionen unterbrechen. Um dieses Problem zu beheben, führen Sie die folgenden Schritte aus:

• Deinstallieren Sie Silverlight Developer Runtime und die UiPath-Erweiterung für Silverlight.
• Installieren Sie Silverlight Developer Runtime Version 5.1.50918.0.
• Installieren Sie die UiPath-Erweiterung für Silverlight.

Silverlight-Anwendungen werden mithilfe des HTML-Tags <object>, das einen fensterlosen Parameter angeben kann, in Webseiten eingebettet. Ist für die Silverlight-Ziel-App der Parameter windowless=false (Standardwert) festgelegt, muss die UiPath-Erweiterung für Silverlight nicht aktiviert werden, weil Active Accessibility und UIA bereits verfügbar sind. Dies gilt auch für Silverlight-Anwendungen außerhalb des Browsers.

Sie können den fensterlosen Parameter wie folgt überprüfen:

• Bei Internet Explorer Silverlight-Anwendungen: Benutzen Sie den DOM Explorer im Internet Explorer, um nach dem Tag <param name=”windowless” /> unter dem entsprechenden Element <object /> zu suchen.

• Bei Silverlight-Anwendungen ohne Browser: Benutzen Sie den UIExplorer, um nach dem Tag <param name=”windowless” /> unter dem entsprechenden Element <object /> zu suchen.

  Hinweis: Die Silverlight-Automatisierung funktioniert nur, wenn die Version Developer Runtime installiert ist.

Treten bei der Automatisierung mit der Erweiterung für Silverlight Probleme auf, wird Folgendes empfohlen:

1. Stellen Sie sicher, dass Sie über Silverlight Developer Runtime und nicht über die normale Nicht-Entwicklerversion verfügen. Sie haben die Entwicklerlaufzeit, wenn eine der folgenden Dateien vorhanden ist:

   • C:\Program Files (x86)\Microsoft Silverlight\5.1.50918.0\agcore.debug.dll
   • C:\Program Files (x86)\Microsoft Silverlight\5.1.50918.0\dbgshim.dll

2. Überprüfen Sie die Silverlight Ausführungszeitversion. Die Version muss 5.1.50918.0 sein. Sie finden sie an den folgenden Speicherorten:

   • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Silverlight (64bit) - im Windows-Registrierungs-Editor;
   • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Silverlight (32bit) - im Windows-Registrierungs-Editor;
   • Das Fenster Einstellungen > Apps & Funktionen(Settings > Apps & features);
   • Die Registerkarte Details (Details) der Eigenschaft der Silverlight-Installer-Datei.
3. Navigieren Sie zum Registrierungsschlüssel HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Deskover\UiPath, und suchen Sie nach dem Wert SLInstalled, der von UiPath zum Nachverfolgen der Installation verwendet wird. Lautet der Wert 0, ist die Erweiterung für Silverlight deaktiviert.

4. Überprüfen Sie, ob der Befehl slinject.exe /install die erforderliche Konfigurationsdatei erstellt hat: C:\Program Files (x86)\Microsoft Silverlight\5.1.50918.0\System.Windows.ini. Sie muss die folgenden Einstellungen enthalten: GenerateTrackingInfo=1 und AllowOptimize=0

5. Mindestens eine Instanz des sllauncher.exe /overwrite /emulate:"SLBroker.xap" /origin:"https://www.uipath.com/SLBroker.xap"-Prozesses muss in Silverlight-Apps-Automatisierungsstartups vorhanden sein. Sie können den Prozess mithilfe des Tools Process Explorer finden.

6. Wenn einer der vorherigen Schritte bei der Installation der Erweiterung nicht automatisch ausgeführt wurde, können Sie versuchen, sie manuell abzuschließen.

7. Erfassen Sie Ablaufverfolgungen, während Sie Steuerelemente in der Silverlight-App auswählen, wie unter diesem Link erläutert. Für reguläre ETL-Ablaufverfolgungen können Sie auch die Umgebungsvariable UIPATH_SLHOOK_CONSOLE_LOGGING auf 1 oder true (keine Beachtung von Groß-/Kleinschreibung) festlegen. Dadurch können Protokollmeldungen und andere Debugging-Informationen im Browserkonsolenfenster angezeigt werden (Öffnen mit F12). Diese Meldungen werden von der Silverlight-Zielanwendung generiert und aufgrund von technischen und leistungsbezogenen Einschränkungen nur in der Browserkonsole protokolliert.

   Hinweis: Sie müssen die Umgebungsvariable festlegen, bevor Sie eine UI-Automatisierung durchführen. Stellen Sie sicher, dass Sie die UiPath- und die Silverlight-Zielanwendung neu starten.