Skip to content

Commit 4b1b33a

Browse files
cindylaycindylay
committed
update limitations and heading
1 parent adb02bc commit 4b1b33a

File tree

1 file changed

+32
-49
lines changed

1 file changed

+32
-49
lines changed

‎docs/embedded/tutorials/metadata.md

Lines changed: 32 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: SharePoint Embedded Container Metadata
33
description: Add metadata in Containers and Files
4-
ms.date: 3/21/2024
4+
ms.date: 3/22/2024
55
ms.localizationpriority: high
66
---
77

@@ -10,7 +10,7 @@ ms.localizationpriority: high
1010
In SharePoint Embedded, columns can be added to [Containers](../concepts/app-concepts/containertypes.md) to address scenarios requiring custom metadata via Graph APIs. Content in the container can then set desired values for corresponding metadata. Metadata are schematized and can be queried. Note the APIs to create and manage columns are on container instances level – an application is responsible for defining and managing the columns across its containers.
1111

1212

13-
## Sections
13+
#### Sections
1414
1. [Authorization and Authentication](#authorization-and-authentication)
1515
1. [Limitations](#limitations)
1616
1. [POST: Create a column in a fileStorageContainer](#create-a-column-in-a-filestoragecontainer)
@@ -24,7 +24,7 @@ In SharePoint Embedded, columns can be added to [Containers](../concepts/app-con
2424

2525

2626

27-
### Authorization and Authentication
27+
## Authorization and Authentication
2828

2929
App+User (Delegated) or App-only (Application) Bearer {token} is required in Authorization header.
3030

@@ -54,45 +54,28 @@ App+User (Delegated) or App-only (Application) Bearer {token} is required in Aut
5454

5555
## Limitations
5656

57-
When working with Metadata APIs in SharePoint Embedded there are a few limitations to consider. This importance guidance to follow in the request body of each API call.
58-
59-
| Property name | Type | Property Needed | Reason |
60-
| ---------------------- | --------------------------- | --------------------- | ------------------------------------------------------------- |
61-
| boolean | booleanColumn | Yes | |
62-
| calculated | calculatedColumn | No | Type not supported |
63-
| choice | choiceColumn | Yes | |
64-
| columnGroup | string | No | Used for site column management UI |
65-
| contentApprovalStatus | contentApprovalStatusColumn | No | Type not supported |
66-
| currency | currencyColumn | Yes | |
67-
| dateTime | dateTimeColumn | Yes | |
68-
| defaultValue | defaultColumnValue | No | Defaults in doclibs don’t work |
69-
| description | string | No? | App expected to control schema, no description needed |
70-
| displayName | string | No | App expected to control schema, no description needed |
71-
| enforceUniqueValues | Boolean | No | Functionality not supported |
72-
| geolocation | geolocationColumn | No | Type not supported |
73-
| hidden | Boolean | No | UI related |
74-
| hyperlinkOrPicture | hyperlinkOrPictureColumn | Yes | |
75-
| isDeletable | Boolean | Yes | OOTB fields might be undeletable |
76-
| isReorderable | Boolean | No | App won’t care about order (UI would) |
77-
| id | string | Yes | Why isn’t this a guid? |
78-
| indexed | Boolean | Yes | |
79-
| isSealed | Boolean | Yes | OOTB fields might be sealed |
80-
| lookup | lookupColumn | No | Type not supported (odd because OOTB fields might be lookups) |
81-
| name | string | Yes | |
82-
| number | numberColumn | Yes | |
83-
| personOrGroup | personOrGroupColumn | Yes | |
84-
| propagateChanges | Boolean | No | Site column related |
85-
| readOnly | Boolean | Yes | OOTB fields might be read-only |
86-
| required | Boolean | No | Functionality not supported |
87-
| sourceContentType | contentTypeInfo | No | Content Types are not for now |
88-
| term | termColumn | No | Type not supported |
89-
| text | textColumn | Yes | |
90-
| thumbnail | thumbnailColumn | No | Type not supported |
91-
| type | columnTypes | Yes | Limited |
92-
| validation | columnValidation | No | Functionality not supported |
93-
94-
95-
### Create a column in a fileStorageContainer
57+
The following are the properties that SharePoint Embedded Metadata supports:
58+
59+
| Property name | Type |
60+
| ---------------------- | ------------------------- |
61+
| boolean | booleanColumn |
62+
| choice | choiceColumn |
63+
| currency | currencyColumn |
64+
| dateTime | dateTimeColumn |
65+
| hyperlinkOrPicture | hyperlinkOrPictureColumn |
66+
| isDeletable | Boolean |
67+
| id | string |
68+
| indexed | Boolean |
69+
| isSealed | Boolean |
70+
| name | string |
71+
| number | numberColumn |
72+
| personOrGroup | personOrGroupColumn |
73+
| readOnly | Boolean |
74+
| text | textColumn |
75+
| type | columnTypes |
76+
77+
78+
## Create a column in a fileStorageContainer
9679

9780
This API will let callers create a new column instance in a fileStorageContainer.
9881

@@ -150,7 +133,7 @@ Content-type: application/json
150133
}
151134
```
152135

153-
### Get a column in a fileStorageContainer by id
136+
## Get a column in a fileStorageContainer by id
154137

155138
This API will let callers get a fileStorageContainer column instance by id.
156139

@@ -192,7 +175,7 @@ Content-type: application/json
192175
}
193176
```
194177

195-
### Update a column in a fileStorageContainer by id
178+
## Update a column in a fileStorageContainer by id
196179

197180
This API will let callers update a fileStorageContainer column instance by id.
198181
You can update any property of the column other than the **id** property.
@@ -243,7 +226,7 @@ Content-type: application/json
243226
}
244227
```
245228

246-
### Delete a column from a fileStorageContainer
229+
## Delete a column from a fileStorageContainer
247230

248231
This API will let callers delele a fileStorageContainer column instance by id.
249232

@@ -268,7 +251,7 @@ DELETE https://graph.microsoft.com/beta/storage/fileStorage/containers/{containe
268251
HTTP/1.1 204 No Content
269252
```
270253

271-
### List columns in a fileStorageContainer
254+
## List columns in a fileStorageContainer
272255

273256
This API will let callers enumerate the columns in a fileStorageContainer.
274257

@@ -330,7 +313,7 @@ Content-type: application/json
330313
}
331314
```
332315

333-
### Get column values of an item in a fileStorageContainer's drive
316+
## Get column values of an item in a fileStorageContainer's drive
334317

335318
This is an existing API used to showcase our new feature of getting the column values of an item in a fileStorageContainer's drive.
336319
This API supports OData $select features for `column`.
@@ -382,7 +365,7 @@ Content-type: application/json
382365
}
383366
```
384367

385-
### Patch column values of an item in a fileStorageContainer's drive
368+
## Patch column values of an item in a fileStorageContainer's drive
386369

387370
This is an existing API used to showcase our new feature of updating and deleting the column values of an item in a fileStorageContainer's drive.
388371

@@ -447,7 +430,7 @@ Content-type: application/json
447430
}
448431
```
449432

450-
### Query a fileStorageContainer's driveitems with Odata query options on custom columns
433+
## Query a fileStorageContainer's driveitems with Odata query options on custom columns
451434

452435
This API will let users query drive items in a fileStorageContainer with `$expand`, `$filter`, and `$orderby` Odata query options on their custom columns.
453436

0 commit comments

Comments
 (0)