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.

A partir de la versión 24.10.0 de UiPath.UIAutomation.Activities, La compatibilidad con Safari UI Automation está disponible en vista previa. La extensión para Safari te permite:

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

Para crear y ejecutar tales automatizaciones, debes instalar la extensión de automatización del navegador de UiPath para 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

Al instalar la extensión de Safari también se instala el componente Host nativo. Esto significa que puedes ejecutar automatizaciones desde UiPath Assistant sin necesidad de instalaciones adicionales.

Instalar desde App Store

Pasos de instalación

1. Accede a la extensión de UiPath para Safari directamente en la 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. Continúa el proceso de instalación desde el paso 2 de la sección Instalar desde App Store .

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

Instalar desde UiPath Assistant

La instalación utilizando UiPath Assistant no requiere configuración adicional, siempre que UiPath Assistant ya esté instalado. Este método instala la última versión de la extensión publicada en la Tienda web solo para el usuario actual .

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. Selecciona Instalar para Safari.

   

Nota:

Alternativamente, selecciona Ver en la App Store para obtener la extensión de la App Store y luego continúa desde el paso 2 de la sección Instalar desde la App Store .

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 proporciona una herramienta para gestionar la instalación de extensiones: UiPath.ExtensionControl.Portable.dll. Esta herramienta se distribuye con UiPath Assistant, que también incluye la última aplicación de extensión empaquetada como archivo.

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

Pasos de desinstalación

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Selecciona Desinstalar para Safari.

   

Resultado: la extensión se desinstala y se elimina de la carpeta Aplicaciones .

Desinstalar desde Terminal

La desinstalación de la Terminal se realiza a través de UiPath.ExtensionControl.Portable.dll.

UiPath proporciona una herramienta para gestionar la instalación de extensiones: UiPath.ExtensionControl.Portable.dll. Esta herramienta se distribuye con UiPath Assistant.

Este método actualiza la configuración de Safari para que la extensión se desinstale. La extensión se desinstala 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 desinstalación

1. Abra una Terminal y ejecute el siguiente comando:

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

Resultado: la extensión se desinstala y se elimina de la carpeta Aplicaciones .

Desinstalar desde la configuración de Safari

Pasos de desinstalación

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.

   

Resultado: UiPath Assistant ahora está autorizado para utilizar el modo de entrada Eventos de hardware en las automatizaciones de Safari.

Configuración de acceso completo al disco

Para instalar la extensión de Safari utilizando UiPath Assistant, debes conceder específicamente a UiPath Assistant acceso a tus archivos 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 Acceso completo al disco seleccionando la flecha en el lado derecho.
5. Habilita el acceso completo al disco en la lista:
   • Si UiPath Assistant aparece en la lista, habilítalo.
   • Si UiPath Assistant no aparece en la lista, selecciona + en la parte inferior de la lista, busca UiPath Assistant, selecciona la aplicación y elige Abrir.

Nota:

Se solicitan las credenciales de Mac para este cambio.

Resultado: UiPath Assistant ahora está autorizado para editar los archivos en tu 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.