feat(files): add --use-user-id option to transfer-ownership command

[cristianscheid]

• Resolves: Add --use-user-id flag to occ files:transfer-ownership command #54790

Summary

Adds the --use-user-id option to the occ files:transfer-ownership command, allowing administrators to use user IDs instead of display names when generating target folder names during ownership transfers.

This avoids ambiguity in environments where multiple users share the same display name, ensuring clear and consistent identification.

Changes

• Added the --use-user-id option to the occ files:transfer-ownership command
• Backward compatible: default behavior (using display names) remains unchanged

Behavior

Default (without flag):
Command: occ files:transfer-ownership source_user dest_user

With --use-user-id flag:
Command: occ files:transfer-ownership source_user dest_user --use-user-id

Checklist

• Code is properly formatted
• Sign-off message is added to all commits
• Tests (unit, integration, api and/or acceptance) are included
• Screenshots before/after for front-end changes
• Documentation (manuals or wiki) has been updated or is not required
• Backports requested where applicable (ex: critical bugfixes)
• Labels added where applicable (ex: bug/enhancement, 3. to review, feature component)
• Milestone added for target branch/version (ex: 32.x for stable32)

[kesselb]

Thanks for your pull request 👍

I wonder if we should always use the sourceId or maybe both "Displayname (userid)".

[cristianscheid]

Thanks for the feedback @kesselb!

Using both display name and user ID (e.g. Bob Smith (bob)) sounds like a good approach to me, as it maintains the user-friendly aspect while solving the ambiguity issue.

Either way, implementing it with both by default or using only the user ID should be straightforward from an implementation perspective.

Happy to adjust the implementation based on what works best.

[artonge]

Looks good

[provokateurin]

cs-fixer needs to be executed

[sorbaugh]

Congratulations @cristianscheid for the merge!

[cristianscheid]

Thank you @sorbaugh! It was great working on this. Thanks to everyone for the reviews and feedback!

[github-actions]

Hello there,
Thank you so much for taking the time and effort to create a pull request to our Nextcloud project.

We hope that the review process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR review process.

Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6

Thank you for contributing to Nextcloud and we hope to hear from you soon!

(If you believe you should not receive this message, you can add yourself to the blocklist.)