Freigeben über

Verwenden von Metadaten mit SharePoint Embedded-Containern

In SharePoint Embedded können Spalten zu Containern hinzugefügt werden, um Szenarien zu behandeln, die benutzerdefinierte Metadaten über Microsoft Graph-APIs erfordern. Inhalt im Container kann dann die gewünschten Werte für die entsprechenden Metadaten festlegen. Metadaten sind schematisiert und können abgefragt werden. Beachten Sie, dass sich die APIs zum Erstellen und Verwalten von Spalten auf Containerinstanzebene befinden. Eine Anwendung ist für das Definieren und Verwalten der Spalten in ihren Containern verantwortlich.

Authentifizierung und Autorisierung

App+Benutzer (delegiert) oder Nur App (Anwendung) Bearer {token} ist im Autorisierungsheader erforderlich.

Hinweis

Containerbesitzer können Containerspalten erstellen, aktualisieren und löschen. Alle Containermitglieder können Containerspalten lesen und auflisten

microsoft.graph.fileStorageContainer Eigenschaften

Eigenschaft Typ Beschreibung Schlüssel Erforderlich ReadOnly
id Edm.String eindeutiger stabiler Bezeichner des Speichercontainers instance Ja Ja Ja
displayName Edm.String Anzeigename des Containers Nein Ja Nein
description Edm.String Beschreibung des Containers Nein Nein Nein
containerTypeId Edm.Guid Containertyp-ID Nein Ja Ja
containerTypeDisplayName Edm.String Anzeigename des Containertyps Nein Nein Ja
externalGroupId Edm.Guid externe Gruppen-ID Nein Nein Nein
permissions Collection<microsoft.graph.permission> Berechtigungen von Benutzern/Gruppen im Container Nein Nein Nein
customProperties microsoft.graph.fileStorageContainerCustomPropertyDictionary benutzerdefinierte Eigenschaften Nein Nein Nein
viewpoint microsoft.graph.fileStorageContainerViewpoint Daten, die für den aktuellen Benutzer spezifisch sind Nein Nein Nein
drive microsoft.graph.drive Laufwerksressource des Speichercontainers Nein Nein Ja
recycleBin microsoft.graph.recycleBin RecycleBin-Ressource des Speichercontainers Nein Nein Ja
status microsoft.graph.fileStorageContainerStatus Ein Enumerationswert, der die status des Containers darstellt Nein Nein Ja
createdDateTime microsoft.graph.dateTimeOffset createdDateTime Nein Nein Ja
storageUsedInBytes Edm.Int64 Verwendeter Speicher in Bytes Nein Nein Ja
assignedSensitivityLabel microsoft.graph.assignedLabel die vertraulichkeitsbezeichnung, die dem Container zugewiesen ist Nein Nein Nein
owners Collection<microsoft.graph.userIdentity> Die Liste der Benutzer, die besitzer des Containers sind Nein Nein Ja
columns Collection<microsoft.graph.columnDefinition> Die Sammlung von benutzerdefinierten Metadatenfeldern im Container Nein Nein Nein

Begrenzungen

Die folgenden Eigenschaften werden von SharePoint Embedded Metadata unterstützt:

Eigenschaftenname Typ
Boolescher Wert booleanColumn
Wahl choiceColumn
Währung currencyColumn
dateTime dateTimeColumn
hyperlinkOrPicture hyperlinkOrPictureColumn
isDeletable Boolesch
ID string
indiziert Boolesch
isSealed Boolesch
name string
number numberColumn
personOrGroup personOrGroupColumn
readOnly Boolesch
text textColumn
type columnTypes

Hinweis

Benennen Sie Spalten gemäß der entsprechenden Spaltenbenennungskonvention.

Spaltenbenennungskonventionen

Spaltennamen müssen den folgenden Regeln entsprechen:

  • Darf "!" nicht enthalten.
  • Kann nicht mit einer Ziffer, einem Punkt, einem Minuszeichen oder einem Fragezeichen beginnen.
  • Darf kein Leerzeichen oder nichtalphanumerische Zeichen außer "_" oder "" enthalten.
  • Kann nicht wie ein Zellbezugstyp aussehen.
    • A1-Zellbezug mit 1 bis 3 Zeichen gefolgt von 1 bis 5 Ziffern (z. B. A3 F02563, ZZZ12).
    • Zellbezüge im R1C1-Modus, die wie r oder c oder r[#], c[#] oder r[#]c[#] aussehen.
  • Darf kein lokalisiertes Wort für "true" oder "false" sein.
  • Es dürfen keine bestimmten Namen sein, z. B. "Autor", "Erstellt", "Beschreibung" usw.

Erstellen einer Spalte in einem fileStorageContainer

Mit dieser API können Aufrufer eine neue Spalte instance in einem fileStorageContainer erstellen.

Erforderliche Berechtigungen (mindestens eine von)
ScopeName Typ
FileStorageContainer.Selected Application
FileStorageContainer.Selected Delegiert

REST-Vorgangsbeispiel: Erstellen einer Spalte in einem fileStorageContainer

Anforderung
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
  }
}

Hinweis

Hinweis Typ wird nicht unterstützt. maxLength sollte =< 255 sein.

Antwort
HTTP/1.1 201 Created
Content-type: application/json

{
  "description": "test",
  "displayName": "Title",
  "enforceUniqueValues": false,
  "hidden": false,
  "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
  "indexed": false,
  "name": "Title",
  "text": {
    "allowMultipleLines": false,
    "appendChangesToExistingText": false,
    "linesForEditing": 0,
    "maxLength": 255
  }
}

Abrufen einer Spalte in einem fileStorageContainer nach ID

Mit dieser API können Aufrufer eine fileStorageContainer-Spalte instance nach ID abrufen.

Erforderliche Berechtigungen (mindestens eine von)
ScopeName Typ
FileStorageContainer.Selected Application
FileStorageContainer.Selected Delegiert

REST-Vorgangsbeispiel: Abrufen einer Spalte in einer dateiSpeicherContainer nach ID

Anforderung
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}
Antwort
HTTP/1.1 200 OK
Content-type: application/json

{
  "description": "test",
  "displayName": "Title",
  "enforceUniqueValues": false,
  "hidden": false,
  "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
  "indexed": false,
  "name": "Title",
  "text": {
    "allowMultipleLines": false,
    "appendChangesToExistingText": false,
    "linesForEditing": 0,
    "maxLength": 255
  }
}

Aktualisieren einer Spalte in einem fileStorageContainer nach ID

Mit dieser API können Aufrufer eine fileStorageContainer-Spalte instance nach ID aktualisieren. Sie können jede Eigenschaft der Spalte außer der id-Eigenschaft aktualisieren.

Erforderliche Berechtigungen (mindestens eine von)
ScopeName Typ
FileStorageContainer.Selected Application
FileStorageContainer.Selected Delegiert

REST-Vorgangsbeispiel: Aktualisieren einer Spalte in einer dateiSpeicherContainer nach ID

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

{
  "required": true,
  "hidden": false,
  "description": "This is my new column description"
}
Antwort
HTTP/1.1 200 OK
Content-type: application/json

{
  "description": "",
  "displayName": "Custom Column",
  "enforceUniqueValues": false,
  "hidden": false,
  "id": "11dfef35-e2f7-4f17-82b0-6fba34445103",
  "indexed": false,
  "name": "Custom Column",
  "readOnly": false,
  "required": true,
  "text": {
    "allowMultipleLines": false,
    "appendChangesToExistingText": false,
    "linesForEditing": 0,
    "maxLength": 255
  }
}

Löschen einer Spalte aus einem fileStorageContainer

Mit dieser API können Aufrufer eine fileStorageContainer-Spalte instance nach ID löschen.

Erforderliche Berechtigungen (mindestens eine von)
ScopeName Typ
FileStorageContainer.Selected Application
FileStorageContainer.Selected Delegiert

REST-Vorgangsbeispiel: Löschen einer Spalte aus einem fileStorageContainer

Anforderung
DELETE https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}
Antwort
HTTP/1.1 204 No Content

Auflisten von Spalten in einem fileStorageContainer

Mit dieser API können Aufrufer die Spalten in einem fileStorageContainer auflisten.

Erforderliche Berechtigungen (mindestens eine von)
ScopeName Typ
FileStorageContainer.Selected Application
FileStorageContainer.Selected Delegiert

REST-Vorgangsbeispiel: Auflisten von Spalten in einem fileStorageContainer

Anforderung
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns
Antwort
HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "description": "",
      "displayName": "Title",
      "hidden": false,
      "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
      "indexed": false,
      "name": "Title",
      "readOnly": false,
      "required": false,
      "text": {
        "allowMultipleLines": false,
        "appendChangesToExistingText": false,
        "linesForEditing": 0,
        "maxLength": 255
      }
    },
    {
      "description": "",
      "displayName": "Address",
      "id": "11dfef35-e2f7-4f17-82b0-6fba34445103",
      "indexed": false,
      "name": "Address",
      "readOnly": false,
      "required": false,
      "text": {
        "allowMultipleLines": false,
        "appendChangesToExistingText": false,
        "linesForEditing": 0,
        "maxLength": 255
      }
    }
  ]
}

Abrufen der Spaltenwerte eines Elements in einem FileStorageContainer-Laufwerk

Dies ist eine vorhandene API, die verwendet wird, um unser neues Feature zum Abrufen der Spaltenwerte eines Elements in einem FileStorageContainer-Laufwerk zu präsentieren. Diese API unterstützt OData-$select Features für column.

Erforderliche Berechtigungen (mindestens eine von)
ScopeName Typ
FileStorageContainer.Selected Application
FileStorageContainer.Selected Delegiert

REST-Vorgangsbeispiel: Abrufen von Spaltenwerten eines Elements in einem FileStorageContainer-Laufwerk

Anforderung
GET https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields
Antwort
HTTP/1.1 200 OK
Content-type: application/json

{
  "Name": "Widget",
  "Color": "Blue",
  "Quantity": 2357
}
Anforderung
GET https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields?$select=Name,Color
Antwort
HTTP/1.1 200 OK
Content-type: application/json

{
  "Name": "Widget",
  "Color": "Blue"
}

Patchspaltenwerte eines Elements in einem FileStorageContainer-Laufwerk

Dies ist eine vorhandene API, die verwendet wird, um unser neues Feature zum Aktualisieren und Löschen der Spaltenwerte eines Elements in einem FileStorageContainer-Laufwerk zu präsentieren.

Erforderliche Berechtigungen (mindestens eine von)
ScopeName Typ
FileStorageContainer.Selected Application
FileStorageContainer.Selected Delegiert

REST-Vorgangsbeispiel: Aktualisieren der Spaltenwerte eines Elements in einem FileStorageContainer-Laufwerk

Anforderung
PATCH https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields

Content-Type: application/json

{
    "Color": "Fuchsia",
    "Quantity": 934
}
Antwort
HTTP/1.1 200 OK
Content-type: application/json

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

REST-Vorgangsbeispiel: Löschen von Spaltenwerten eines Elements in einem FileStorageContainer-Laufwerk

Anforderung
PATCH https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields

Content-Type: application/json

{
    "Color": null
}
Antwort
HTTP/1.1 200 OK
Content-type: application/json

{
  "Name": "Widget",
  "Quantity": 934
}

Abfragen von driveitems eines fileStorageContainer-Objekts mit Odata-Abfrageoptionen für benutzerdefinierte Spalten

Mit dieser API können Benutzer Laufwerkselemente in einem fileStorageContainer mit $expandden Abfrageoptionen , $filterund $orderby Odata für ihre benutzerdefinierten Spalten abfragen.

Erforderliche Berechtigungen (mindestens eine von)
ScopeName Typ
FileStorageContainer.Selected Application
FileStorageContainer.Selected Delegiert

REST-Vorgangsbeispiel: Filtern der driveitems von fileStorageContainer nach ihren benutzerdefinierten Spalten "TestField" und Sortieren der Ergebnisse nach "TestField"

Anforderung
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)
Antwort
HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {"name": "a.jpg", "size": 2048, "listitem/fields/TestField": "31" },
    {"name": "b.xlsx", "size": 197, "listitem/fields/TestField": "32" },
    {"name": "c.docx", "size": 391, "listitem/fields/TestField": "33" }
  ]
}
  • Last updated on