Server 2023.1 Release Notes

Release Note Product Versions
Version	Date	Release	End of Support
2023.1.1.123	May 17, 2023	Major	May 17, 2025

 

New Features

Azure Active Directory Group Support with SAML Authentication

Admins can now sync users and group access to Server using Azure Active Directory (Azure AD) and the SCIM protocol. This allows admins to manage user and group permissions and Server access from their identity provider as single source of truth. Users and groups are automatically synced from Azure AD to Server, making it faster to onboard or offboard Server users and groups. 

This functionality is available if you are using SAML as your authentication method. Any identity provider that supports SCIM can use this functionality, but official support is limited to Azure AD, which is the only provider we tested. To read more about the Azure AD group with SAML authentication and SCIM support, go to Configure Alteryx Server Authentication and Alteryx Server Settings.

New API Endpoints

Added new API endpoints to add and delete an Active Directory (AD) group via the admin API.

• To add an AD group to a custom Server group, use the following admin API endpoint: POST/v3/usergroups/{id}/activedirectorygroups.
• To delete an AD group from a custom Server group, use the following admin API endpoint: DELETE/v3/usergroups/{userGroupId}/activedirectorygroups/{adGroupSid}.

For more information about these endpoints, visit the User Group Endpoints help page or access the Swagger documentation by selecting the question mark icon in the upper right corner of Server interface.

Updates to API Endpoint for Uploading New Workflow Versions 

We introduced the /v3/workflows/{workflowId}/versions API to allow admins and users to upload new versions of existing workflows. Additionally, we updated the Admin Upload Workflow so .yxzp workflows uploaded this way can now be versioned as changes are made in Designer or uploaded via the new API. For more information, go to Workflow Endpoints and Workflows: Admin Interface, or access the Swagger documentation by selecting the question mark icon in the upper right corner of Server interface.

Please note that any versions created using the old (v3) version API will continue to be unusable. For example, if you had a workflow and created a second version using the previously released version of /v3/workflows/{workflowid}/versions API, and then you created a third version using the NEW /v3/workflows/{workflowid}/versions API, only the original version and the third version will be usable.

Language and Region Updates

With 2023.1, we extended the language support to the entire Alteryx Server interface available in Chinese, French, Italian, Japanese, German, Spanish, and Portuguese. Additionally, Server Help documentation is available in the supported languages. For our global users, this improves your experience by making it easier for you to access and understand Alteryx Server in your native or preferred language. For information on how to select your preferred language and region, visit the My Profile help page.

Server UI Redesign

Redesigned the Server admin and user interfaces for the pages listed below. The functionality of these pages remains the same. We made these changes within the Alteryx Server interface:

• Login screen: This release we have given the login page a new look.
• Admin and Home screen: Starting with this release, Curators will now see the Home (user) and Admin tabs on the top bar of the application. This change streamlines administrative tasks and improves the user experience by reducing the number of clicks required to access these important administrative features.
• Analytic apps: When you run an analytic app, the option to name the job, set the priority, and assign a worker now appears in a pop-up window after you select the Run button. 
  • For non-chained analytic apps, the Re-Run option is only available for the last job run for workflows and analytic apps. Please note that if you refresh your browser, the Re-Run option will no longer be available.
  • For chained apps, you can navigate back and forth between tabs within each analytic app and edit the information on those tabs. However, you CAN'T navigate back to a previous app if there are multiple chained apps because that app has already been run.
• Notifications: Redesigned the Notifications experience for admins and users. To access them, select the bell from the menu bar in the upper right corner. It also includes an unread notifications counter. The Notifications dropdown summarizes the latest notifications, including their details, and allows you to quickly view them or redirect to the asset that was updated. For more information, go to Notifications.
• Global Search: The global search bar has moved to the top right corner of the application window to provide a more intuitive and user-friendly interface. You can search Workflows, Insights, Districts, Pages, and we’ve added the ability to search for Collections. You can search individual or multiple asset types at a time by selecting the asset type in the filter box. You can navigate through the search results using the pagination at the bottom of the page. For more information, go to Search for Assets.
  Additionally, we replaced Lucene search with a custom search provider. This improves search accuracy, expands search capabilities, and provides more thorough search results across the entire Server, while delivering equal or better performance. With this change, the AlteryxGallery_Lucene database and schema are now obsolete. See AlteryxGallery_Lucene MongoDB Schema for specific changes.
• Links: To find the Community and help page links, as well as API documentation for users with API access, select the question mark icon at the top right corner of the navigation bar.

These UI changes should improve your user experience with Alteryx and make it easier and more intuitive for you to stay on top of important updates and changes.

Block DCM Connections from Syncing from Server to Designer 

As an admin, you can now block the DCM connections synchronization from Server to Designer and from Designer to Server for the entire environment. This feature is useful to ensure that DCM connections in production environments connected to production data sets are not used to create new workflows in Designer. With this feature, you can restrict access to DCM connections for data sets in production environments, while allowing users to sync DCM connections between Server and Designer in development or test environments. To disable sync, go to System Settings > DCM and select the checkbox Block DCM Connections Synchronization between Server and Designer. To allow the synchronization, leave the checkbox unselected. For more information, go to DCM - Server. 

Allow Access to Workflows Without Shared Credentials

Added a new feature under Admin > Settings > Configuration > Assets. To allow users to run workflows they have access to, without access to shared credentials, enable the Allow Access to Workflows Without Shared Credentials setting. 

When enabled, users can create Designer workflows using Server connections and data sets shared with them. Similarly, analysts (non-admins) can run workflows using those connections. However, users cannot use those connections for other purposes or data sets. Visit the Alteryx Server Settings help page for more information.

Unique Connection Strings for Workers

Added the ability for each worker to define how it connects to the database. Remote worker nodes can optionally set a connection string independently from the controller. This allows a worker to set their own options or credentials. 

Worker nodes can now connect directly to MongoDB using an override connection string defined within runtimesettings.xml. This string differs from the controller connection string and other worker connection strings.​ It allows the worker to use a configurable connection when communicating directly with MongoDB so that workers can use unique credentials that admins can audit. Currently all connections are either sent through the controller or use the same connection the controller has.

For more information, visit the MongoDB Advanced Connection Strings help page.

Update of the Server UI Page in Alteryx System Settings

We updated Alteryx System Settings to put emphasize the Default Run Mode setting. You can now find this setting at the top of the Server UI > General page instead of at the bottom. We also updated the help information for this setting to clarify what this setting does and why it is important. For more information, go to Server UI. 

jQuery Removed

We’ve completely removed jQuery v1.9 from Alteryx Server interface.

 

Fixed and Known Issues

Fixed Major Release Version 2023.1.1.123
ID	Description	Version	Issue Status
TGAL-6264 GCSE-339	Users are not shown in the Add User dropdown of Data Connections when the username consists of Japanese characters only.	2023.1.1.123	Fixed
TGAL-6357 GCSE-412	Open Workflow From the Server UI window immediately exits.	2023.1.1.123	Fixed
TGAL-6749	When you update the Account Lockout Time under Admin > Settings > Configuration > Security, the Account Lockout Time value is reset to default after reloading this page.	2023.1.1.123	Fixed
TGAL-6751	Admin login page using SAML doesn't display the SAML login screen.	2023.1.1.123	Fixed
TGAL-6754	When you replace a workflow with another workflow, the version tracking doesn’t work if both workflows were uploaded via the API or from the Admin Server UI.	2023.1.1.123	Fixed
TGAL-6756	When a user  with Curator (admin) rights attempts to use the Replace Workflow button to replace a Designer-uploaded workflow with an API or Admin UI-uploaded workflow, the user gets an error.	2023.1.1.123	Fixed
TGAL-6761 GCSE-803	The PUT /v3/schedules/{id} endpoint fails when updating a custom schedule using Last in the Days parameter.	2023.1.1.123	Fixed
TGAL-6769	The connection is only shared with direct members of the User group on Alteryx Server, not with members of the AD group that is part of this User group on Alteryx Server.	2023.1.1.123	Fixed
TGAL-6794	When you save a new version of a workflow that already has a schedule, the new version runs only once and then the schedule switches back to the previous version of the workflow.	2023.1.1.123	Fixed
TGAL-6807	If the pre-migration process is interrupted, the created files are not deleted after the premigration is completed successfully.	2023.1.1.123	Fixed
TGAL-6825	The Migration Prep Tool accepts multiple inputs on the initial prompt for input, reading them in sequence. Thus “yy” can approve multiple commands without the user’s knowledge.	2023.1.1.123	Fixed
TGAL-6836	When a workflow is added via the v3 API endpoint and is public,  the DateMadePublic attribute is not being populated.	2023.1.1.123	Fixed
TGAL-6909	Corrected an issue where the installer wasn't recognizing the version of MongoDB properly during an upgrade if a patch had been applied to update MongoDB from 4.2.15 to 4.2.22. This caused the installer to incorrectly report an error indicating the user was attempting to upgrade from an unsupported version of MongoDB.	2023.1.1.123	Fixed
TGAL-6916	When editing a schedule via the PUT to /v3/schedules/id endpoint, it fails with the error "This workflow requires credentials".	2023.1.1.123	Fixed
TGAL-6934 TMEE-880	Server Admin interface: When you try to delete a workflow as an admin, the snackbar message "Workflow deleted" appears, but the same workflow reappears in the list. If you try to delete it again, you will see a red error banner stating that it failed to delete.	2023.1.1.123	Fixed
TGAL-6965 GCSE-954	The POST admin/v1/workflows/ endpoint breaks the ability to run a workflow if this workflow has a different name than the originally uploaded workflow.	2023.1.1.123	Fixed
TGAL-7009	When using the POST /v3/workflows endpoint, the sourceAppId argument behaves improperly - it doesn't work as an overwrite. Each time it's called, even if the sourceAppId doesn't change, it creates a new workflow and returns a new unique id.	2023.1.1.123	Fixed
TGAL-7017	Anonymous users (not logged in) are unable to run public workflows even when the “Unregistered Users Can Run Workflow on the Homepage” setting has been enabled.	2023.1.1.123	Fixed
TGAL-7036	Addressed a potential race condition when retrieving a key.	2023.1.1.123	Fixed
TGAL-7060 TPRI-912	For the workflows which are changed to public, the date is not displayed in the table in the column Made Public under Admin > Workflows.	2023.1.1.123	Fixed
TGAL-7078 GCSE-1069	The Limited Availability 2022.3 Server workflows fail to re-upload after encryption.	2023.1.1.123	Fixed
TGAL-7080	Unable to delete user via API.	2023.1.1.123	Fixed
TGAL-7291 GCSE-1121	Users cannot add a new data connection for Microsoft SQL Server with Windows Authentication via Server admin interface.	2023.1.1.123	Fixed
TGAL-7350	Workflow revisions display as version 0 in the Server UI.	2023.1.1.123	Fixed
TGAL-7411	Admin credentials: Unable to create credentials in FIPS environment.	2023.1.1.123	Fixed
TGAL-7425	Unable to create DCM Credential, DCM Vaults, and DCM Data Source in FIPS environment.	2023.1.1.123	Fixed
TGAL-7785	Designer can’t connect directly to a remote controller to create or manage schedules (Desktop Automation/Scheduler).	2023.1.1.123	Fixed
TPRI-713 GCSE-637	Output messages on Analytics Apps run in Server are not being displayed correctly.	2023.1.1.123	Fixed
TPRI-772 GCSE-726	When you edit a weekly schedule in 2022.1, it selects all days instead of the days you had previously selected. Also, the "No ending date" checkbox is not prepopulated.	2023.1.1.123	Fixed
TPRI-816 TGAL-6801	Sidebar: My Workspace tab item is not getting highlighted when selected, while being actually active.	2023.1.1.123	Fixed
TPRI-849 GBETA-330	Server UI/UX Improvements: Menu items are not translated to Japanese.	2023.1.1.123	Fixed
TPRI-859 GBETA-342	Server UI/UX Improvements: "Asset Management" message is not translated.	2023.1.1.123	Fixed
TPRI-860 GBETA-343	Server UI/UX Improvements: Excerpt text in Districts > Create District has an editing issue. When you add a character to the middle of the text, the cursor automatically goes back to the end of the text.	2023.1.1.123	Fixed
TPRI-933	In versions 2021.4+, only the workflow owner and curators can access Workflow Settings. In the previous releases, all users with access to the workflow could access Workflow Settings.	2023.1.1.123	Fixed
TPRI-935	Unable to add Users to a Subscription on a Server configured for Windows Authentication.	2023.1.1.123	Fixed
TPRI-1071	When you attempt to run a version of a workflow other than the latest (most current version), the workflow is not being run correctly. Server is not sending the correct version to be run.	2023.1.1.123	Fixed
TPRI-1487	When owners of a workflow or app manually run a workflow in Server immediately after changing the published version to a version that differs from the latest (or newest) version of that workflow, Server will run the published version on the first manual run as opposed to the latest version. Subsequent manual runs will execute the latest version as expected.	2023.1.1.123	Fixed

Known Major Release Version 2023.1.1.123
ID	Description	Version	Issue Status
TCPE-373 GCSE-589	Regression issue: PCXML previews are not rendering URLs in Server 2022.3+.	2023.1.1.123	Known
TCPE-672 GCSE-1329	Server UI Error on Japanese, Chinese, French, and Italian Operating Systems: An HTTP 500 error displays when you open the Server UI (for example, HTTP500 Internal Server Error: Cannot show this web page.) To work around this issue, change the language setting on the non-English operating system to English and install Alteryx Server. Change the language back to your preferred language after installation.	2023.1.1.123	Known
TDT-1842 TSPA-986	App re-run functionality is failing for Map tool.	2023.1.1.123	Known
TGAL-6394 GS-610	Daylight Saving Time (DST) alters future interval scheduling of jobs/workflows. They are being pushed to the top of the hour when scheduled during the DST window of 2AM - 2:59AM. For more information about the DST change, visit Schedules: Time Zone Support.	2023.1.1.123	Known
TGAL-6467 GCSE-464	Daylight Saving Time (DST) is causing schedules to run at incorrect time in Server - schedules are shifted an hour forward or backward during the Daylight Saving Time. For more information about the DST change, visit Schedules: Time Zone Support.	2023.1.1.123	Known
TGAL-6745 GCSE-723	Server API V3: Setting “application/xml” or “text/xml” in the Accept header of the API request returns an error or does not return the results in the XML format.	2023.1.1.123	Known
TGAL-6852	Insights are not rendering on multi-node environments. When you open an insight and run a workflow in Designer and then want to publish it in Server UI, the URL link shows that the insight is not rendering and an error message is displayed.	2023.1.1.123	Known
TGAL-6964	When you re-run a Chained App on Server with the Re-Run button, the first app in the chain is shown instead of the last app in the chain. Before the fix to the Re-Run button, the last app in the chain was displayed and changes could only be made to the final app.	2023.1.1.123	Known
TGAL-7052 TGAL-7018	When you add or delete insights, the results counter is displaying incorrect count in the table.	2023.1.1.123	Known
TGAL-7677	Global search fails if the workflow / insight / districts / collection name contains special characters.	2023.1.1.123	Known
TGAL-7825	Insights might not render in multi-node environments and display the message "Error rendering insight. If this problem persists, please contact your Systems Administrator." To work around this issue, please ensure the Insights worker is enabled on your controller.	2023.1.1.123	Known
TGAL-7846	When Administrators upload workflows using the "+New" button in the Admin UI, workflows are not being validated as they were in previous versions of Server.	2023.1.1.123	Known
TPRI-1298	The View in Browser functionality is breaking from Designer after saving the workflow to Server due to a problem with token-based authentication.	2023.1.1.123	Known
TPRI-1320	Admin Jobs page is empty with no tabs. When a job is kicked off in Server, the job doesn't automatically appear on the Admin Jobs page in real time. In order for the job to appear, you must manually refresh the page to see the new job added to the queue.	2023.1.1.123	Known
TPRI-1409 TGAL-7449	The table height on the Admin Subscriptions page doesn't adjust automatically.	2023.1.1.123	Known
TPRI-1481	Link and Image Properties options under Admin > Pages and Admin > Districts are not localized.	2023.1.1.123	Known
TPRI-1492	App re-run button displays on job runs other than the latest job run.	2023.1.1.123	Known
TPRI-1575 GCSE-1302	System messages do not appear when first logging in to Server.	2023.1.1.123	Known
TPRI-1695 TCPE-692	Regression issue: PCXML previews are not rendering URLs in Server 2022.3+.	2023.1.1.123	Known

 

Security Updates

Fixed Major Release Version 2021.3.1.1.123
ID	Description	Version	Issue Status
TGAL-2207	To be disclosed.*	2023.1	Fixed

*In accordance with security best practices and to prevent potential manipulation by bad actors, Alteryx does not disclose the details of any open vulnerability until all supported versions are updated with a fix. More information will be made available once the vulnerability has been fixed for all supported versions known to be affected.