ListItem-Ressource

  • Artikel

Diese Ressource stellt ein Element in einer SharePoint-Liste dar. Spaltenwerte in der Liste sind über das fieldValueSet-Wörterbuch verfügbar.

Aufgaben zu einem listItem

Die folgenden Aufgaben sind für listItem-Ressourcen verfügbar. Alle Beispiele unten beziehen sich auf eine Liste, z. B.: https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.

Häufige Aufgaben HTTP-Methode
Get GET /items/{item-id}
Abrufen von Spaltenwerten GET /items/{item-id}?expand=fields
Create POST /items
Delete DELETE /items/{item-id}
Update PATCH /items/{item-id}
Aktualisieren von Spaltenwerten PATCH /items/{item-id}/fields

JSON-Darstellung

Es folgt eine JSON-Darstellung einer listItem-Ressource.

{
  "contentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
  "fields": { "@odata.type": "microsoft.graph.fieldValueSet" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
  "versions": [{"@odata.type": "microsoft.graph.listItemVersion"}],

  /* inherited from baseItem */
  "id": "string",
  "name": "name of resource",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of resource",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference"},
  "webUrl": "url"
}

Eigenschaften

Die listItem-Ressource weist folgende Eigenschaften auf.

Eigenschaftsname Typ Beschreibung
contentType contentTypeInfo Der Inhaltstyp dieses Listenelements

Die folgenden Eigenschaften werden von baseItem geerbt.

Eigenschaftsname Typ Beschreibung
id string Der eindeutige Bezeichner des Elements. Schreibgeschützt.
name string Der Name/Titel des Elements.
createdBy identitySet Die Identität des Erstellers dieses Elements. Schreibgeschützt.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit der Erstellung des Elements. Schreibgeschützt.
description string Der beschreibende Text für das Element.
eTag string ETag für das Element. Schreibgeschützt.
lastModifiedBy identitySet Die Identität derPerson, die dieses Element zuletzt geändert hat. Schreibgeschützt.
lastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit der letzten Änderung des Elements. Schreibgeschützt.
parentReference itemReference Informationen zum übergeordneten Element, wenn das Element ein übergeordnetes Element hat. Lese-/Schreibzugriff.
sharepointIds sharepointIds Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.
webUrl String (URL) URL, über die das Element im Browser angezeigt werden kann. Schreibgeschützt.

Beziehungen

Die listItem-Ressource weist folgende Beziehungen zu anderen Ressourcen auf.

Beziehungsname Typ Beschreibung
Aktivitäten ItemActivity-Sammlung Die Liste der letzten Aktivitäten, die für dieses Element durchgeführt wurden.
driveItem driveItem Für Dokumentbibliotheken macht die DriveItem Beziehung das ListItem als DriveItem verfügbar
fields fieldValueSet Die Werte der für dieses Listenelement festgelegten Spalte.
Versionen listItemVersion-Sammlung Die Liste der früheren Versionen des Listenelements.