pnp / cli-microsoft365

Manage Microsoft 365 and SharePoint Framework projects on any platform
https://aka.ms/cli-m365
MIT License
915 stars 323 forks source link

Enhancement: Add folder color to `spo folder get` #5896

Open milanholemans opened 7 months ago

milanholemans commented 7 months ago

Related to:

The idea for this issue is to read the current folder color.

I suggest that we add a new option.

Option Description
--withColor Also return the color of the folder.

This results in 2 extra properties in the output:

{
  "color": "5",
  "colorValue": "darkBlue"
}

Notice that these 2 properties don't exist natively and we have to create them ourselves.

Tech implementation

Some more research here should be needed. Retrieving the ColorHex field doesn't seem that easy using the REST API. One way I found is by using:

GET https://tenant.sharepoint.com/sites/Projects/_api/Web/GetFolderByServerRelativePath(DecodedUrl='/sites/Projects/Cortex')?$expand=properties&$select=*,properties/vti_x005f_colorhex

This returns the color hex but it isn't ideal. Let's try to look if there's a better way.

Adam-it commented 2 months ago

@milanholemans in general I agree with this idea and approach. We only need to research how to do that 😅