Speichern und Abfragen von Containermetadaten

Gilt für: Entwickler

Verwenden Sie Metadaten, wenn Ihre App strukturierte Felder für Dateien in einem SharePoint Embedded-Container benötigt. Metadaten werden als Spalten in und fileStorageContainer als Feldwerte auf den Elementen des Containerlaufwerks gespeichert. Ihre Anwendung ist für das Erstellen und Verwalten des Spaltenschemas für jeden Container instance verantwortlich. Eine vollständige Liste der Containerressourceneigenschaften finden Sie unter fileStorageContainer-Ressourcentyp.

Berechtigungen und unterstützte Aufrufer

Rufen Sie die Metadaten-APIs mit einem reinen App- oder delegierten Bearertoken auf. Wird für Anwendungs- und delegierte Aufrufe verwendet FileStorageContainer.Selected .

Containerbesitzer können Spalten erstellen, aktualisieren und löschen. Containermember können Spalten lesen und auflisten.

Auswählen von Spaltentypen

SharePoint Embedded-Metadaten unterstützen die folgenden Spaltentypeigenschaften: boolean, choice, currency, dateTime, hyperlinkOrPicture, numberpersonOrGroup, und text. Außerdem werden Spalteneinstellungen wie indexed, , isDeletable, isSealedname, readOnlyund typeunterstützt.

Spaltennamen müssen SharePoint-Regeln entsprechen. Verwenden Sie keine Namen, die enthalten !, beginnen mit einer Ziffer oder Interpunktion, enthalten Leerzeichen, sehen wie Tabellenzellenbezüge aus, stellen lokalisierte true- oder false-Werte dar oder verwenden reservierte Namen wie Author, Createdoder Description.

Erstellen einer Spalte

Erstellen Sie eine Spalte im Container, bevor Sie Feldwerte in Dateien schreiben.

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns
Content-Type: application/json

{
  "description": "test",
  "displayName": "Title",
  "enforceUniqueValues": false,
  "hidden": false,
  "indexed": false,
  "name": "Title",
  "text": {
    "allowMultipleLines": false,
    "appendChangesToExistingText": false,
    "linesForEditing": 0,
    "maxLength": 255
  }
}

Die Erstellungsanforderung unterstützt typenicht, und der Text maxLength muss kleiner oder gleich 255 sein.

Verwalten von Spalten

Verwenden Sie die Spalten-ID, die vom Erstellungs- oder Listenvorgang zurückgegeben wird.

GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}
PATCH https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}
DELETE https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}

Patchen Sie unterstützte Eigenschaften, wenn sich das Schema ändert. Sie können jede Eigenschaft einer Spalte mit Ausnahme der id -Eigenschaft aktualisieren.

{
  "required": true,
  "hidden": false,
  "description": "This is my new column description"
}

Lesen und Schreiben von Dateimetadaten

Feldwerte werden in den Listenelementfeldern des Laufwerkelements gespeichert. Lesen Sie alle Felder, oder wählen Sie die Felder aus, die Ihre Benutzeroberfläche benötigt.

GET https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields
GET https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields?$select=Name,Color

Patchfeldwerte, um Metadaten zu aktualisieren. Verwenden Sie null , um einen Feldwert zu löschen, wenn die Spalte leere Werte zulässt.

PATCH https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields
Content-Type: application/json

{
  "Color": "Fuchsia",
  "Quantity": 934
}

{
  "Color": null
}

Abfragen von Dateien nach Metadaten

Verwenden Sie OData-Abfrageoptionen für benutzerdefinierte Spalten, wenn Sie eine strukturierte Filterung oder Sortierung innerhalb eines Containerlaufwerks benötigen.

GET https://graph.microsoft.com/beta/drives/{drive-id}/items?$orderby=listitem/fields/TestField asc&$filter=startswith(listitem/fields/TestField, '3')&$expand=listitem($expand=fields)

Verwenden Sie $expand=listitem($expand=fields) , wenn das Ergebnis Feldwerte in der Antwort benötigt. Erstellen Sie indizierte Spalten für Filter mit hoher Kardinalität, die ihre App häufig ausführt.

Informationen zur Volltextsuche zwischen Containern und benutzerdefinierten Metadaten (mit dem OWSTEXT Eigenschaftssuffix) finden Sie unter Durchsuchen von Containern und Dateien. Verwenden Sie OData $filter für strukturierte Abfragen innerhalb eines einzelnen Containerlaufwerks. Verwenden Sie die Suche nach Freitextabfragen für viele Container.

Schemakonsistent halten

Erstellen Sie die erforderlichen Spalten während der Containerbereitstellung. Speichern Sie die erwartete Schemaversion in Ihren App-Daten, und führen Sie Migrationen aus, wenn neue Spalten eingeführt werden. Vermeiden Sie das Löschen von Spalten, bis Sie wissen, dass keine Workflows, Abfragen, Exporte oder Suchfunktionen von ihren Werten abhängen.

Nächste Schritte

• Freigeben von Dateien und Verwalten von Berechtigungen