# ftrack Studio 4.2 beta release notes

#### Release notes for 4.2 beta 1 – 30 April, 2019

#### Below you can find the full release notes for the launch of this beta. If you have any questions at all, [please get in touch with us](mailto:support@ftrack.com?subject=ftrack%204.2%20beta%20release%20notes). We’d be happy to talk you through things.

### Migration notes

**Developer notes:**

**Modifying UserSecurityRole deprecated**  
Adding and modifying `UserSecurityRole` directly is no longer supported. Instead the new actions `add_user_security_role`, `remove_user_security_role`, `grant_user_security_role_project` and `revoke_user_security_role_project` should be used.

`add_user_security_role` and `remove_user_security_role` accept user_id and role_id as parameters, while `grant_user_security_role_project` and `revoke_user_security_role_project` accept the additional parameters project_id or all_open_projects.

**Projects relation removed from UserSecurityRole**  
The projects relation on `UserSecurityRole` has been removed and replaced by the user_security_role_projects relation which references the new object `UserSecurityRoleProject`.

**Adding and removing security roles using legacy API**  
Support for adding and removing security roles to users and granting access to projects for users using legacy API has been removed. Please use new API instead.

### Release notes

**NEW**  
Overview, Timeline – Added support for filtering out events, tasks and milestones on Users and Projects timeline views.

**CHANGED**  
Overview, Cross project views – Changed default sort order of Versions to be latest published.

**NEW**  
Overview – Attributes can be changed for the card layout views for Project and User.

**NEW**  
Overview – Added support for User and Project cross-project views.

**CHANGED**  
Overview – Changed dashboards in Overview to have the new filter panel and new settings panel.

**FIXED**  
Overview – Filter count on cross-project views are not correct.

**NEW**  
Client review – Client review collaborator interface has been updated with new features and style. Some of the new features are timeline markers, improved annotation tools, note sorting by timecode, pdf support, support for mobile devices and more. Old interface can be re-activated via system settings if needed.

**NEW**  
Web interface – Added support for private projects.

**CHANGED**  
Web interface, System settings – The dialog for managing a users security roles have been updated with new look and design.

**NEW**  
Web interface, Team page – A project access section have been added to the project team page and can be used to add and remove user access to the project.

**FIXED**  
API – Some complex API queries may fail with internal server error.

**FIXED**  
Web interface – Loading web interface can be slow when having many object types.

**CHANGED**  
Client review – Updated design and messaging when visiting an expired review.

**FIXED**  
API – Deleting a project using the API will sometimes fail randomly.

**FIXED**  
Client review – Invitation email does not contain review description.

**FIXED**  
Overview, Cross-project views – Cross project views with lots of asset versions is slow to load when sorting on date.

**CHANGED**  
Client review, Export – Updated client review export with new design.

**CHANGED**  
Export – Exports may no longer contain any non-thumbnail images.

**CHANGED**  
Notification – Update notification emails to be more consistent when referring to collaborator updates in a review.

**NEW**  
Local installation – Added support for MariaDB 10.3.

**NEW**  
Theme – Added support for switching default theme in application from System Settings. Changing this setting will affect all users that has not already switched theme.

**CHANGED**  
Cloud hosted, Encoding – The thumbnail of a multi page PDF will now only show the first page.

**FIXED**  
Review, Cloud hosted – The review image generated when uploading images has the wrong name when being downloaded.

**NEW**  
Events – Added entity_type attribute to update events which matches the API schemas.

**NEW**  
Events – Added events for UserSecurityRole and UserSecurityRoleProject changes.

**FIXED**  
Spreadsheet – Count summary in spreadsheet header has incorrect label.

**NEW**  
API – Added support for exporting review session feedback from API with a `delayed_job` action.

**FIXED**  
Upload, Web interface – Not possible to upload versions to a Milestone.

**FIXED**  
Tasks page, Web Interface – Removing top item from spreadsheet results in server error.

**FIXED**  
Lists, Sidebar, Web Interface – List category is not rendered correct in List sidebar.

**FIXED**  
Event hub, Web Interface – Event hub not working if username contains certain characters.

**CHANGED**  
Legacy API – Support for adding and removing security roles to users and granting access to projects for users using legacy API has been removed. Please use new API instead.

**CHANGED**  
Legacy API – Support for bookings and phases in legacy API has been removed.

**NEW**  
API – Added support for private projects. A project can either be private or open. All existing projects are open, which means they can be accessed by users who can access all projects or have explicit access to a project. Private projects are only visible to the user who created it, or users who are explicitly given access to it after the project has been created.

**NEW**  
API – Added new permission to control who can grant users access to a project. The permission is automatically added on roles that are allowed to create new projects. The new permission does not allow giving users new roles, only grant access to projects for existing roles. This new permission make it possible for project managers to grant users access to a new project they have created without requiring access to system settings.

**CHANGED**  
API – Adding and modifying `UserSecurityRole` directly is no longer supported. Instead the new actions `add_user_security_role`, `remove_user_security_role`, `update_user_security_role`, `grant_user_security_role_project` and `revoke_user_security_role_project` should be used.

`add_user_security_role`, `update_user_security_role` and `remove_user_security_role` accept user_id and role_id as parameters, while `grant_user_security_role_project` and `revoke_user_security_role_project` accept the additional parameters project_id or all_open_projects. `update_user_security_role` also takes the additional parameter new_role_id.

**CHANGED**  
API – The projects relation on `UserSecurityRole` has been removed and replaced by the user_security_role_projects relation which references the new object `UserSecurityRoleProject`.

**CHANGED**  
API – The is_all_projects attribute on `UserSecurityRole` has been deprecated and replaced by is_all_open_projects attribute. The old attribute will continue to be available for now.

**NEW**  
API – Added support for `Manager` and `ManagerType`.

**FIXED**  
Review, Web Interface – Non ascii characters are stripped from uploaded file names.

**NEW**  
Web Interface, Review – Added setting to control if version numbers should be automatically detected from filename when uploading files in the web interface. The setting can be found in system settings under advanced settings.