Use case:
A user account is no longer needed and will be deleted but all of the data needs to be retained, how can I change the ownership of the data to another user?
Note - please make sure that you have a valid backup of the system before following the steps outlined below.
SImA 1.3 includes a new API endpoint which can be used to reassign the ownership of datasets. The API endpoints can be queried via the Swagger UI here:
https://<sima_domain>/datastore/docs/
Authorization within the Swagger UI must be "keycloak (OAuth2, password)" where you'd need to enter both the SImA admin username/password combination as well as the following client credentials:
client_id: gemma-client
client_secret: 6d25d5e6-4c76-4e87-82ff-bcfcaeaada5a
Thereafter, navigate to the PUT /change_owner/{old_owner_id}/{new_owner_id} endpoint and click "Try it out".
Enter the old_owner_id (existing owner) and the new_user_id (intended owner) as indicated, then click "Execute".
The owner ID is found in the SImA UI under the User Info table. Log in is as the SImA admin, select a given user from the data tree, then the User Info table will be displayed. The "ID" shown in the User Info table is the owner ID.
All datasets belonging to the old_owner_id will be reassigned to the new_user_id*. The process modifies the meta files to reflect the new owner ID, but it still may take a few moments to reflect correctly in the SImA UI, e.g. you may notice that the dataset folders remain grey for a short while even after they are reassigned.
Result files, analysis files, assay definition files and other types of annotations will still have the old owner information (owner name and ID), and their visibility/accessibility in the web-UI is defined by the parent resource (screen/plate/measurement) which should now be using the new_user_id.
*Please note that it is not currently possible to selectively reassign ownership of individual data sets.