Extensión para Safari

Instale y configure la extensión de UiPath para Safari para habilitar la automatización de IU en Safari en macOS con Studio Web y macOS Robot local.

Starting with UiPath.UIAutomation.Activities version 24.10.0, Safari UI Automation support is available in preview. The extension for Safari lets you:

• Diseñar automatizaciones de IU en Studio Web dentro del navegador Safari en macOS.
• Ejecutar las automatizaciones del navegador en Safari utilizando un robot macOS local, instalado previamente y conectado a Orchestrator.
• Iniciar las automatizaciones del navegador attended en Safari a través del macOS Assistant.

To create and run such automations, you must install the UiPath Browser Automation extension for Safari.

Puedes empezar desde Studio Web añadiendo cualquier actividad de automatización de IU. Al acceder a Studio Web desde Safari, se te solicita que instales la extensión de UiPath para Safari desde la App Store. Sigue la guía de configuración para configurar la extensión y luego empieza a diseñar tus flujos de trabajo para la automatización del navegador en Safari.

Nota:

Para crear automatizaciones del navegador en Safari en máquinas que ejecutan macOS, la versión mínima compatible es macOS 12.

Instalar

Installing the Safari extension also installs the Native Host component. This means that you can run automations from UiPath Assistant without the need for additional installation.

Instalar desde App Store

Pasos de instalación

1. Access the UiPath extension for Safari directly in the App Store

2. Selecciona Obtener para instalar la extensión y luego Abrir.

   

3. Después de seleccionar Abrir, aparece una ventana de configuración.

   

4. Selecciona Abrir configuración de Safari para acceder a la ventana de Extensiones, donde puedes establecer los permisos adecuados para la extensión recién instalada.

   1. Habilita la extensión de automatización del navegador UiPath en el panel izquierdo.

   2. Selecciona Permitir siempre en cada sitio web y confirma esta opción.

   3. Si tienes la intención de utilizar la navegación privada, habilita la configuración Permitir navegación privada .

Resultado: un mensaje te informa de que la extensión está ahora disponible.

Instalar desde UiPath Studio Web

Pasos de instalación

1. En UiPath Automation Cloud™, accede a Studio Web.

2. Añade una actividad Usar navegador a tu proyecto. Se te solicita que instales la extensión de UiPath para Safari.

   

3. Selecciona el botón Instalar extensión.

4. La App Store se abre con la extensión automatización del explorador de UiPath.

5. Continue the installation process from step 2 of the Install from App Store section.

Resultado: un mensaje te informa de que la extensión está ahora disponible.

Instalar desde UiPath Assistant

Installation using UiPath Assistant requires no additional configuration, as long as UiPath Assistant is already installed. This method installs the latest extension version published to the Web Store for the current user only.

Pasos de instalación

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Select Install for Safari.

   

Nota:

Alternatively, select View on App Store to get the extension from the App Store, and then continue from step 2 of the Install from App Store section.

Resultado: la extensión se instala y se habilita en Safari.

Instalar desde Terminal

La instalación desde el Terminal se realiza a través de UiPath.ExtensionControl.Portable.dll.

UiPath provides a tool for managing extension installation: UiPath.ExtensionControl.Portable.dll. This tool is distributed with UiPath Assistant, which also includes the latest extension application packaged as an archive.

Este método actualiza la configuración de Safari para que la extensión se reconozca como instalada. La extensión se instala solo para el usuario actual.

ADVERTENCIA:

Este método no está destinado a entornos de producción, ya que depende de un mecanismo que Apple puede cambiar en actualizaciones futuras. Úsalo solo si no hay otra alternativa disponible.

Requisitos previos

• Todas las instancias de Safari están cerradas.

Pasos de instalación

1. Abra una Terminal y ejecute el siguiente comando:

    dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install safari
   

2. Inicia Safari para diseñar y ejecutar automatizaciones.

Resultado: la extensión se instala y se habilita en Safari.

Instalar utilizando un MDM

Para instalar a través de una aplicación de gestión de dispositivos móviles (MDM), la máquina debe estar registrada para poder gestionarla. Para obtener más detalles sobre cómo funciona la gestión de dispositivos en máquinas Apple, se puede encontrar más información en esta página: Gestión de dispositivos | Documentación para desarrolladores de Apple.

Ejemplos de MDM incluyen:

• Jamf
• Microsoft Intune
• Kandji
• MicroMDM (código abierto)

Este método depende del nuevo modelo de gestión declarativa para enviar los cambios de configuración a las máquinas gestionadas. La configuración para las extensiones de Safari se detalla aquí: SafariExtensionSettings | Documentación para desarrolladores de Apple.

Desinstalar

Desinstalar desde UiPath Assistant

Uninstall Steps

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Select Uninstall for Safari.

   

Result: The extension is uninstalled and removed from the Applications folder.

Desinstalar desde Terminal

The uninstallation from Terminal is performed via UiPath.ExtensionControl.Portable.dll.

UiPath provides a tool for managing extension installation: UiPath.ExtensionControl.Portable.dll. This tool is distributed with UiPath Assistant.

This method updates the Safari configuration so that the extension is uninstalled. The extension is uninstalled for the current user only.

ADVERTENCIA:

Este método no está destinado a entornos de producción, ya que depende de un mecanismo que Apple puede cambiar en actualizaciones futuras. Úsalo solo si no hay otra alternativa disponible.

Requisitos previos

• Todas las instancias de Safari están cerradas.

Uninstall Steps

1. Abra una Terminal y ejecute el siguiente comando:

    dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll uninstall safari
   

Result: The extension is uninstalled and removed from the Applications folder.

Desinstalar desde la configuración de Safari

Uninstall Steps

1. Accede a la configuración de Safari.

2. Navega a la pestaña Extensiones.

3. Selecciona el botón Desinstalar.

   

4. Selecciona el botón Mostrar en el Finder.Esto abre el Finder con la aplicación seleccionada.

   

5. Abre el menú contextual de la aplicación UiPath para Safari y selecciona Mover a la papelera.

   

   Si un mensaje emergente indica que la aplicación no se puede eliminar porque está en uso:

   

   1. Abre el Monitor de actividad y busca UiPath Native Host para Safari.

      

   2. Selecciona la aplicación, elige Detener y luego selecciona Salir.

   3. Regresa al Finder y selecciona Mover a la papelera de nuevo.

      

6. Introduce las credenciales de tu Mac y, a continuación, selecciona Aceptar para autorizar esta eliminación.

   

Resultado: se desinstala la extensión. Se elimina de la barra de extensiones de Safari y de la pestaña Extensiones de la configuración de Safari.

Configuración de accesibilidad

Para utilizar el modo de entrada de Eventos de hardware, debes conceder específicamente acceso a UiPath Assistant a tu Mac utilizando la configuración de Privacidad y Seguridad.

Para ello, sigue los siguientes pasos:

1. Selecciona el menú Apple.

2. Selecciona Configuración del sistema.

3. Selecciona Privacidad y seguridad en la barra lateral izquierda.

4. Ve a Accesibilidad seleccionando la flecha en el lado derecho.

5. Habilita UiPath Assistant desde la lista. Si no ves la aplicación, selecciona + en la parte inferior de la lista, busca UiPath Assistant, selecciona la aplicación y elige Abrir. Se solicitan credenciales de Mac para este cambio.

   

Result: UiPath Assistant is now authorized to use Hardware Events input mode in Safari automations.

Full Disk Access configuration

To install the Safari extension using UiPath Assistant, you must specifically grant UiPath Assistant access to your Mac files using the Privacy & Security settings.

Para ello, sigue los siguientes pasos:

1. Selecciona el menú Apple.
2. Selecciona Configuración del sistema.
3. Selecciona Privacidad y seguridad en la barra lateral izquierda.
4. Go to Full Disk Access by selecting the arrow on the right-hand side.
5. Enable Full Disk Access from the list:
   • If UiPath Assistant is listed, enable it.
   • If UiPath Assistant is not listed, select + at the bottom of the list, search for UiPath Assistant, select the application, and choose Open.

Nota:

Se solicitan las credenciales de Mac para este cambio.

Result: UiPath Assistant is now authorized to edit the files on your Mac.

Limitaciones conocidas

Ten en cuenta las siguientes limitaciones al crear automatizaciones del navegador para Safari:

• La extensión no puede acceder a las URL de archivo. Esta es una limitación de Safari, como se explica en este hilo de foro de desarrolladores de Apple (Permitir el acceso a las URL de archivos para extensiones web).
• La extensión no admite varios perfiles.