Skip to main content

Guía de actualización de Alteryx Server de versión a versión: versiones compatibles

Importante

Consulta la Lista de verificación de actualización de Server para ayudar a planificar y ejecutar una actualización de Server exitosa, incluido el flujo de trabajo de Comprobaciones previas a la actualización para identificar los problemas que causan que las actualizaciones fallen.

¿Cómo ayuda este documento?

En este documento se destacan las tareas y los cambios que debes tener en cuenta al actualizar las versiones de Alteryx Server. Los problemas son acumulativos, así que lee cada sección a medida que actualizas a través de múltiples versiones. Esto no reemplaza las notas de lanzamiento (ve los enlaces en cada sección).

Programación de lanzamiento

  • Las versiones semestrales añaden características, pero también pueden cambiar la administración de Server, lo que requiere que tú o tus usuarios cambien de comportamiento.

  • Las versiones/parches de mantenimiento dentro de cada trimestre abordan los problemas encontrados en la versión inicial. Por ejemplo, la primera versión de mantenimiento para 2022.3 sería 2022.3.2.

Leyenda

PARADA

Cambio significativo que requiere actualizar a esta versión antes de actualizar a una versión posterior.

Actualización de MongoDB

La versión de la base de datos de Mongo se actualiza.

Una actualización de Alteryx Server solo puede incluir UNA actualización de versión de MongoDB entre tu versión actual y la versión de actualización de destino.

CRÍTICO

Problema critico: los administradores deben abordar o estar al tanto de cuando se trasladan o pasan a esta versión.

Criterios para las entradas en esta lista

En esta lista, se condensan las notas de lanzamiento de cada versión para resaltar dónde:

  • El administrador o los usuarios están obligados a realizar una acción.

  • El elemento es importante a la hora de elegir una versión de actualización (es decir, un comportamiento modificado o un defecto).

  • Se realizó un cambio significativo en la administración de Server.

Enlaces rápidos

2022.3 y versiones anteriores

Para ver las versiones no compatibles (2022.3 o anteriores), consulta la Guía de actualización de Server de versión a versión: versiones no compatibles.

2024.1

Novedades/Notas de lanzamiento

Versión

Acciones a tomar al actualizar a esta versión (o posteriores).

2024.1

Función administrativa: capacidad de transferir la propiedad de activos a través de la interfaz de usuario y la API

Los administradores pueden transferir la propiedad de los flujos de trabajo y las programaciones entre los usuarios a través de la interfaz de usuario de Server o mediante puntos de conexión de la API de Server V3.

Impacto:

Nota

  • El historial de trabajo del flujo de trabajo no es visible para el nuevo propietario.

  • El flujo de trabajo se trasladará al estudio del nuevo propietario, lo que afectará la visibilidad de otros usuarios en el estudio de origen o destino.

  • Es necesario compartir elementos adicionales con el nuevo propietario para ejecutar correctamente el flujo de trabajo:

    • Conexión de DCM

    • Conexión de base de datos de galería compartida

    • Credencial de galería compartida

2024.1

Nueva característica: nueva opción de base de datos añadida (SQL DB)

Se puede usar la base de datos SQL Server administrada por el usuario en lugar de MongoDB. Actualmente, las únicas versiones de SQL oficialmente compatibles son MSSQL Server 2019 y 2022.

Impacto:

2024.1

CRÍTICO

Actualización de Python: actualizaciones de Python integradas de 3.8.16 a 3.10.13

Impacto:

Aparece el siguiente mensaje de error si se utiliza una versión incompatible de un conector en Designer: “No se encontró la versión 3.8 en nuestra distribución Alteryx. Selecciona otra versión. Ocurrió un error interno: se detectó un bloqueo”.

Tarea:

  • Todas las herramientas Conectores deben reemplazarse por una nueva versión.

  • Los usuarios deben volver a probar Python en flujos de trabajo. El motor todavía utiliza Python versión 3, por lo que debería haber poco impacto en los scripts.

2024.1

CRÍTICO

Cambio de campo fecha y hora de MongoDB (marcas de tiempo de servicio movidas al formato UTC en bases de datos de Server)

Impacto: trasladamos todos los campos de fecha y hora a UTC para mejorar el manejo de los cambios de zona horaria y horario de verano. Para obtener más información, ve a Notas de lanzamiento de Server 2024.1.

  • Todas las API de Server con un elemento de marca de tiempo se verán afectadas.

  • En caso de actualizar desde una versión anterior a la 2024.1, las marcas de tiempo de los activos existentes se convertirán al nuevo estándar UTC cuando se inicie AlteryxService.

Tarea: revisa cómo se manejan los campos de fecha en las aplicaciones que acceden a MongoDB o a la API. Es posible que sea necesario ajustarlos para la fecha y hora en UTC.

2024.1

Administración del Server de producción/desarrollo de DCM: el Server de Prod puede redirigir el Dev DCM a Conexiones de Prod

Impacto: conexiones de DCM y manejo de conexiones de DCM agregados al menú Administrador. Para obtener más información, visita las siguientes páginas de ayuda.

Tarea: agrega redirecciones de DCM al Server de Prod para permitir que los flujos de trabajo migrados desde Dev accedan a las fuentes de datos de Prod sin cambios en el flujo de trabajo.

2024.1

Administración de DCM: nivel de detalle de permisos de usuario

Impacto: nuevos permisos de DCM añadidos. Para obtener más información, visita la página de ayuda Roles y permisos de usuario.

2024.1

Administración de DCM: se añadió un almacén externo genérico de DCM

Impacto: puedes configurar un almacén externo genérico que puede recuperar secretos de cualquier almacén con una interfaz programática utilizando autenticación básica.

2024.1

Cambio de administración: DCM compartido simultáneamente

Impacto: puedes compartir la misma conexión de DCM para la colaboración y, por separado, para la ejecución. Anteriormente solo podías elegir una opción de compartir. Para obtener más información, consulta Administrador de conexiones de datos: interfaz de usuario de Server.

2024.1

Fin de la vida útil de Insights

Impacto: Insights ya no están disponibles en Alteryx Server. Visita nuestra página de preguntas frecuentes para obtener más información.

2024.2

Novedades/Notas de lanzamiento

Versión

Acciones a tomar al actualizar a esta versión (o posteriores).

2024.2

PARADA

CRÍTICO

Actualización de MongoDB integrado a la versión 7

Impacto: como parte de la instalación de Server 2024.2, MongoDB integrado se actualizará a la versión 7.0. La versión mínima de Server para actualizar es 2023.2 (MongoDB versión 6.0).

Tarea: asegúrate de que la versión de Server sea 2023.2 o 2024.1; a continuación, sigue los pasos descritos en Notas del lanzamiento de Server 2024.2.

2024.2

PARADA

CRÍTICO

La versión 2024.2 es la última versión en incluir el código del migrador criptográfico.

Este punto de parada solo aplica para la actualización de MongoDB administrada por el usuario desde la versión 2022.1 o anterior, lo que requerirá que la base de datos se migre con criptografía durante la actualización.

Tarea: revisa el proceso de migración criptográfica que se explica en la sección 2022.3 de la Guía de actualización de Server de versión a versión: versiones no compatibles y la Herramienta de preparación para migración.

2024.2

Migrar conexiones de datos y flujos de trabajo a DCM

Ahora puedes migrar conexiones de datos de Server compartido a conexiones de DCM. Para ello, consulta Cómo migrar conexiones de datos de Server a DCM y Conexiones de datos.

2024.2

Posibilidad de limitar usuarios en un estudio a un usuario

Los administradores tienen la opción de desactivar los estudios compartidos limitando los usuarios de un estudio a uno. Como administrador, ahora puedes transferir fácilmente la propiedad de activos mediante la transferencia del flujo de trabajo de un estudio a otro.

Para limitar la cantidad de miembros en un estudio a un usuario, ve a Administrador > Configuración > Configuración > Usuarios. A continuación, selecciona la casilla de verificación Limitar el estudio a un usuario. Para obtener más información, ve a Configuración de Alteryx Server.

2024.2

Restricción para hacer públicos los flujos de trabajo: configuración global

Los administradores ahora pueden controlar la forma en que se publican los flujos de trabajo (de forma pública o no pública) seleccionando o desactivando la casilla Restringir flujo de trabajo público (global). Para ello, ve a Administrador > Configuración > Seguridad.

Para obtener más información, ve a Configuración de Alteryx Server.

2024.2

Configuración expandida del proxy de Designer

En Designer, se agregaron Opciones > Configuración de usuario > Editar la configuración de usuario > Proxy y Habilitar nueva configuración de proxy (vista previa) para proporcionar un mejor control sobre la configuración del proxy y para permitir scripts PAC.

Nota: En esta versión inicial, la configuración se aplica a varias características (por ejemplo, herramienta Descargar), pero no a otras (por ejemplo, conectores u ODBC) en Designer. Consulta Configuración de usuario para obtener más detalles.

2024.2

La configuración del sistema “Cancelar trabajos que se ejecutan durante más de (segundos)” ahora se aplica a todos los trabajos

En versiones anteriores, esta configuración solo se aplicaba a trabajos programados. Para permitir que los trabajos manuales se ejecuten durante más tiempo que los trabajos programados, desactiva esta configuración y utiliza las dos nuevas opciones de interfaz de usuario de Server que se explican a continuación.

Para obtener más información, ve a Configuración de Alteryx Server.

Opción agregada para cancelar ejecuciones de trabajos manuales de larga duración

En Interfaz de usuario de Server > Administrador > Configuración > Activos, hay una nueva opción para cancelar las ejecuciones manuales de trabajos (incluidas las ejecuciones de trabajos de la API) que se ejecutan durante más tiempo que un período especificado. Esto se aplica a todos los trabajadores, a menos que el trabajador haya establecido Configuración del sistema de Alteryx > Trabajador > General > Cancelar trabajos que se ejecutan durante más de (segundos). La configuración de trabajador anula la configuración de interfaz de usuario de Server.

Opción agregada para cancelar ejecuciones de trabajos programados de larga duración

En Interfaz de usuario de Server > Administrador > Configuración > Activos, hay una nueva opción para cancelar las ejecuciones de trabajos programados que se ejecutan durante más tiempo que un período especificado. Esto se aplica a todos los trabajadores, a menos que el trabajador haya establecido Configuración del sistema de Alteryx > Trabajador > General > Cancelar trabajos que se ejecutan durante más de (segundos). La configuración de trabajador anula la configuración de interfaz de usuario de Server.

2024.2

Actualizaciones de API:

Filtrado de lAPI añadido para GET v3/workflows/{workflowID}/jobs

El punto de conexión GET v3/workflows/{workflowID}/jobs ahora puede filtrar opcionalmente por estado y resultCode, lo que devuelve una lista de ID de trabajo que coinciden con estos filtros. Para obtener más información, ve a Notas de lanzamiento de Server 2024.2 y Puntos de conexión de flujo de trabajo.

  • Todas las API de Server con un elemento de marca de tiempo se verán afectadas.

  • En caso de actualizar desde una versión anterior a la 2024.1, las marcas de tiempo de los activos existentes se convertirán al nuevo estándar UTC cuando se inicie AlteryxService.

Tarea: revisa cómo se manejan los campos de fecha en las aplicaciones que acceden a MongoDB o a la API. Es posible que sea necesario ajustarlos para la fecha y hora en UTC.

Nuevos puntos de conexión API para suscripciones (estudios)

Los administradores ahora pueden administrar las suscripciones (estudios) utilizando los puntos de conexión de la API de Server V3. Estos puntos de conexión te ayudarán a editar suscripciones en grandes cantidades y te proporcionarán la capacidad de mover usuarios individuales de nuevo a estudios individuales.

Para obtener más información sobre los puntos de conexión, consulta Puntos de conexión de suscripciones.

Actualizaciones de API para los puntos de conexión de flujo de trabajo

  • SourceAppId ahora se devuelve en el cuerpo de respuesta de las siguientes llamadas API:

    • GET/v3/workflows

    • GET/v3/workflow/{workflowID}

    • GET /admin/v1/workflows/migratable

  • Ahora los creadores pueden llamar a lo siguiente:GET v3/workflows/{workflowId}

  • Filtrar por estado y resultCode se han añadido paraGET v3/workflows/{workflowID}/jobs:

Para obtener más información, ve a Notas de lanzamiento de Server 2024.2 y Puntos de conexión de flujo de trabajo.

Nuevo punto de conexión de API para permitir la actualización de la configuración de programación individual

Usa el nuevo punto de conexión de API PATCH /v3/schedules/{scheduleId} a fin de actualizar una programación sin tener que rellenar varios campos obligatorios para realizar un solo cambio. Para obtener más información, ve a Puntos de conexión de programaciones.

Actualizaciones para puntos de conexión de trabajos

  • Nuevo punto de conexión de la APIGET /v3/jobs/{jobId}/messages

    Este punto de conexión es solo para administradores. Usa jobId como parámetro de entrada a fin de recuperar los mensajes correspondientes para ese trabajo.

  • Punto de conexión de API actualizadoGET /v3/jobs/{jobId}

    El punto de conexión GET /v3/jobs/{jobId} se ha actualizado para que los usuarios puedan ver los trabajos que se han compartido con ellos a través de las colecciones.

Para obtener más información, ve a Puntos de conexión de trabajos.

2025.1

Novedades/Notas de lanzamiento

Versión

Acciones a tomar al actualizar a esta versión (o posteriores).

2025.1

Nueva página de credenciales para usuarios no administradores

Los usuarios que no son administradores ahora tienen acceso a la página Credenciales en la interfaz de usuario de Server. Esta página permite ver, crear, editar y eliminar credenciales personalizadas. Para obtener más detalles, consulta en Credenciales: interfaz de usuario de Server.

2025.1

Se agregó la vista “Resultados del flujo de trabajo” para administradores

Los administradores ahora tienen la opción de ver los resultados del flujo de trabajo y los mensajes de trabajos en la vista Resultados del flujo de trabajo. Para obtener más detalles, ve a Resultados del flujo de trabajo: interfaz de administrador.

2025.1

Se agregó el registro de auditoría para Configuración del sistema Alteryx

Las actualizaciones de RuntimeSettings.xml a través de la aplicación Configuración del sistema Alteryx ahora se registran en C:\ProgramData\Alteryx.

2025.1

API de Server

Nuevo punto de conexión para cancelar un trabajo específico

Se agregó el punto de conexión DELETE /v3/jobs/{jobId} para cancelar cualquier trabajo en ejecución o en cola (manual o programado).

Para obtener más información, ve a Puntos de conexión de trabajos.

Nuevos puntos de conexión para credenciales compartidas de Server

Se agregaron los siguientes puntos de conexión para las credenciales de Server (no DCM):

  • Crear credenciales de Server: POST /v3/credentials

  • Actualizar la contraseña de las credenciales de Server existentes: PUT /v3/credentials/{credentialId}

Estos puntos de conexión solo están disponibles para administradores y requieren que TLS esté habilitado. Para obtener más información, ve a la página de ayuda Puntos de conexión de credenciales.

Se agregó la expresión Cron para los puntos de conexión de programación

Se agregó una flexibilidad de programación dinámica mediante el uso de entradas Cron. Ahora puedes utilizar una expresión Cron en estas APIs:

  • POST /v3/schedules

  • PUT /v3/schedules/{scheduleId}

  • PATCH /v3/schedules/{scheduleId}

  • GET /v3/schedules/{scheduleId}

Para obtener más información, visita la página de ayuda Programar puntos de conexión.

2025.1

Los administradores pueden invitar a usuarios a agregar credenciales

Esta característica permite a los administradores invitar a un usuario a agregar una Credencial compartida que el administrador puede administrar y compartir. Para obtener más información, consulta en Invitación para crear o editar una credencial.

2025.1

Se agregó la compatibilidad con cifrado de aserción SAML

Ahora, el cifrado de aserciones SAML es compatible, lo que permite cifrar y firmar aserciones. Esta característica está disponible tanto en entornos FIPS como no FIPS.

Para obtener detalles sobre la configuración, consulta la página de ayuda Configurar autenticación de Alteryx Server.

2025.2

Novedades/Notas de lanzamiento

Versión

Acciones a tomar al actualizar a esta versión (o posteriores).

2025.2

PARADA

CRÍTICO

Actualización de MongoDB integrado a la versión 8

Impacto: como parte de la instalación de Server 2025.2, MongoDB integrado se actualizará a la versión 8.0.

Tarea: revisa la tabla de compatibilidad entre versiones del esquema para asegurarte de que tu ruta de actualización pasa a la misma versión de MongoDB o solo a una versión superior. No puedes actualizar Server directamente en más de una versión de MongoDB a la vez. Para obtener más información, consulta las Notas de lanzamiento de Server 2025.2.

2025.2

De Server a Alteryx One

Alteryx Server ahora incluye una nueva característica “Conexiones – Alteryx One” en la página del controlador. Esta característica simplifica y protege el proceso de vinculación de tu entorno de Alteryx Server a la plataforma Alteryx One. Permite la transferencia directa de metadatos de linaje desde Server a catálogos de datos externos (como Atlan o Collibra) a través de Alteryx One.

Tareas:

  • Configura la conexión en la plataforma Alteryx One. Para obtener más información, consulta Conexión de linaje de datos.

  • Configura la conexión en la Configuración del sistema de Alteryx. Consulta el Controlador para obtener más información.

2025.2

Actualizaciones desacopladas de Designer y Server

Puedes actualizar Designer independientemente de Server, de forma que los usuarios puedan acceder de inmediato a las características más recientes de Designer sin esperar la aprobación de Server o las actualizaciones del entorno. Los activos creados en las versiones más recientes de Designer ya no tienen impedimentos para su publicación en entornos de Server más antiguos.

Para obtener información importante y actualizaciones continuas, ve a Compatibilidad de versiones entre Designer y Server.

Debido a este cambio, se agregó un nuevo parámetro a los puntos de conexión de la API del flujo de trabajo. Para obtener más detalles, consulta Nuevo parámetro agregado a los puntos de conexión del flujo de trabajo.

2025.2

Se actualizó el proceso de recuperación de host de Server

Elige entre dos opciones de recuperación:

  • Manual: completa todos los pasos tú mismo.

  • Mediante script: utiliza el nuevo script de recuperación para automatizar la preparación, instalación y restauración de RuntimeSettings y MongoDB y, a continuación, finaliza los pasos restantes manualmente.

Descarga el script desde el Portal de licencias. Para obtener más información sobre el nuevo proceso de recuperación, consulta la Guía de recuperación del host de Server.

2025.2

Programar aplicaciones analíticas en la interfaz de usuario de Server

Ahora puedes programar aplicaciones analíticas directamente desde la interfaz de usuario de Server. Para programar una aplicación analítica, selecciona la aplicación en la interfaz de usuario de Server, selecciona Programar, establece tus preferencias, completa los campos de entrada necesarios y guarda la programación. Para obtener más información, consulta Programar flujo de trabajo.

2025.2

API de Server

Nuevo punto de conexión de API para supervisar tareas

Se agregó el punto de conexión GET /v3/jobs/ para supervisar todas las tareas en Server.

Para obtener más información, ve a Puntos de conexión de trabajos.

Nuevo punto de conexión de la API para admitir conectores SDK

Se agregó el punto de conexión PUT /v3/dcm/connections/{id}/sharing/collaboration a los puntos de conexión de DCM.

Este punto de conexión solo está disponible para los administradores. Para obtener más información, ve a la página de ayuda Puntos de conexión de DCM.

Nuevo parámetro agregado a los puntos de conexión del flujo de trabajo

Para admitir actualizaciones desacopladas de Designer y Server, se agregó un nuevo parámetro, bypassWorkflowVersionCheck, a los siguientes puntos de conexión de flujos de trabajo:

  • POST /v3/workflows

  • POST /v3/workflows/{workflowId}/versions

Esto te permite omitir la barandilla de protección que normalmente bloquea las cargas si la versión de Server es anterior a la versión del flujo de trabajo. Para obtener más información sobre el uso, ve a Puntos de conexión de flujos de trabajo.

2025.2

Se completaron las características de uso compartido de credenciales de usuario

Ahora puedes utilizar credenciales duplicadas, incluso si no se comparten a través de la plataforma Alteryx Server. Esta actualización también resuelve problemas visuales y de facilidad de uso para una experiencia de administración de credenciales más fluida.

Para obtener más información sobre las credenciales, ve a Credenciales: interfaz de usuario de Server y Credenciales: interfaz de administrador.