TableRow erstellen

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Fügen Sie Zeilen am Ende einer Tabelle hinzu.

Beachten Sie, dass die API mit dieser API mehrere Zeilendaten akzeptieren kann. Das Gleichzeitige Hinzufügen einer Zeile kann zu leistungsbeeinträchtigungen führen. Der empfohlene Ansatz besteht darin, die Zeilen in einem einzigen Aufruf zu stapeln, anstatt eine einzelne Zeile einzugeben. Um optimale Ergebnisse zu erzielen, sammeln Sie die Zeilen, die auf der Anwendungsseite eingefügt werden sollen, und führen Sie einen Vorgang zum Hinzufügen einer einzelnen Zeile aus. Experimentieren Sie mit der Anzahl der Zeilen, um die ideale Anzahl von Zeilen zu ermitteln, die in einem einzelnen API-Aufruf verwendet werden sollen.

Diese Anforderung kann gelegentlich zu einem 504 HTTP Fehler führen. Sollte dieser Fehler auftreten, wiederholen Sie die Anforderung.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Files.ReadWrite
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

HTTP-Anforderung

POST /me/drive/items/{id}/workbook/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/rows
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name}/rows

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich.
Content-Type	application/json. Erforderlich.
Prefer	respond-async. Gibt an, dass es sich bei der Anforderung um eine asynchrone Anforderung handelt. Optional.
Arbeitsmappensitzungs-ID	{Workbook-Session-Id}. Erstellt anhand der createSession-Anforderung. Optional.

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Parameter	Typ	Beschreibung
Index	Int32	Optional. Gibt die relative Position der neuen Zeile an. Bei Null erfolgt die Erweiterung am Ende. Alle Zeilen unterhalb der eingefügten Zeile werden nach unten verschoben. Nullindiziert.
values	Json	Ein zweidimensionales Array von unformatierten Werten der Tabellenzeilen.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein workbookTableRow-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Hinzufügen von zwei Zeilen zu einer Tabelle

In diesem Beispiel werden zwei Datenzeilen am Ende der Tabelle eingefügt.

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

HTTP

POST https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows
Content-type: application/json

{
  "values": "[
    [1, 2, 3],
    [4, 5, 6]
  ]"
}

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const workbookTableRow = {
  values: "[
    [1, 2, 3],
    [4, 5, 6]
  ]"
};

await client.api('/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows')
    .version('beta')
    .post(workbookTableRow);

Wichtig

Microsoft Graph SDKs verwenden standardmäßig die Version 1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Betaversion verfügbar sind. Ausführliche Informationen zum Zugreifen auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph-SDKs mit der Beta-API.

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var workbookTableRow = new WorkbookTableRow
{
    Values = JsonDocument.Parse(@"""[\r\n    [1, 2, 3],\r\n    [4, 5, 6]\r\n  ]""")
};

await graphClient.Me.Drive.Items["{driveItem-id}"].Workbook.Tables["{workbookTable-id}"].Rows
    .Request()
    .Header("Prefer","respond-async")
    .Header("Workbook-Session-Id","{Workbook-Session-Id}")
    .AddAsync(workbookTableRow);

Wichtig

Microsoft Graph SDKs verwenden standardmäßig die Version 1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Betaversion verfügbar sind. Ausführliche Informationen zum Zugreifen auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph-SDKs mit der Beta-API.

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"respond-async" forHTTPHeaderField:@"Prefer"];
[urlRequest setValue:@"{Workbook-Session-Id}" forHTTPHeaderField:@"Workbook-Session-Id"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphWorkbookTableRow *workbookTableRow = [[MSGraphWorkbookTableRow alloc] init];
[workbookTableRow setValues:@"[\r\n    [1, 2, 3],\r\n    [4, 5, 6]\r\n  ]"];

NSError *error;
NSData *workbookTableRowData = [workbookTableRow getSerializedDataWithError:&error];
[urlRequest setHTTPBody:workbookTableRowData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Wichtig

Microsoft Graph SDKs verwenden standardmäßig die Version 1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Betaversion verfügbar sind. Ausführliche Informationen zum Zugreifen auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph-SDKs mit der Beta-API.

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

LinkedList<Option> requestOptions = new LinkedList<Option>();
requestOptions.add(new HeaderOption("Prefer", "respond-async"));
requestOptions.add(new HeaderOption("Workbook-Session-Id", "{Workbook-Session-Id}"));

WorkbookTableRow workbookTableRow = new WorkbookTableRow();
workbookTableRow.values = JsonParser.parseString("\"[\r\n    [1, 2, 3],\r\n    [4, 5, 6]\r\n  ]\"");

graphClient.me().drive().items("01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ").workbook().tables("Table1").rows()
    .buildRequest( requestOptions )
    .post(workbookTableRow);

Wichtig

Microsoft Graph SDKs verwenden standardmäßig die Version 1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Betaversion verfügbar sind. Ausführliche Informationen zum Zugreifen auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph-SDKs mit der Beta-API.

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

{
  "index": 99,
  "values": "[[1, 2, 3]]"
}

Beispiel 2: Asynchrones Hinzufügen von zwei Zeilen zu einer Tabelle

Asynchrone Anforderungen sind nützlich, wenn die Anforderung länger als erwartet dauert. Bitte beachten Sie, dass Workbook-Session-Id bei der Ausgabe asynchroner Anforderungen ein Header erforderlich ist. Der Benutzer muss eine Sitzung erstellen, bevor er asynchrone Rich-API-Features verwendet. Der Header Prefer:respond-async ist auch in den asynchronen Anforderungen erforderlich.

Bei asynchronen Features muss der Benutzer in der Regel 2 bis 3 Anforderungen ausgeben. Diese Anforderung, die Anforderung "workbookOperation abrufen" und optional die Anforderung "tableRowOperationResult".

Anforderung

Nachfolgend sehen Sie ein Beispiel für die asynchrone Anforderung. Beachten Sie, dass 202 Accepted dies nur geschieht, wenn die Antwort der Anforderung lange dauert. Wenn die Anforderung schnell abgeschlossen ist, funktioniert sie wie eine reguläre Synchronisierungsanforderung, die auf Beispiel 1zurückgeht.

POST https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows
Content-type: application/json
Prefer: respond-async
Workbook-Session-Id: {Workbook-Session-Id}

{
  "values": "[
    [1, 2, 3],
    [4, 5, 6]
  ]"
}

Antwort

Nachfolgend sehen Sie ein weiteres Beispiel für die Antwort, die zu einem asynchronen Vorgang führt. Ausführliche Informationen finden Sie unter "WorkbookOperation abrufen" und "Get tableRowOperationResult".

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/operations/0195cfac-bd22-4f91-b276-dece0aa2378b?sessionId=Y2x1c3Rlcj1QU0c0JnNlc3Npb249MTUuU0cyUEVQRjAwMDI4RjI1MS5BMTE2LjEuVTM2LmM4MGRiNjkwLTQwMTktNGNkNS1hYWJiLTJmYzczM2YxZTQ5ZjE0LjUuZW4tVVM1LmVuLVVTMjQuMTAwM2JmZmRhYzUyMzkzOS1Qcml2YXRlMS5TMjQuJTJmUEI0JTJmWjJqZmt1aXhJZHBjeE8xYmclM2QlM2QxNi4xNi4wLjE0NDEwLjM1MDUwMTQuNS5lbi1VUzUuZW4tVVMxLk0xLk4wLjEuUyZ1c2lkPWExOTMyNTU0LTlhNDAtNzYzNi1mNDU3LWEyNjExMmFkNDg2YQ==
Content-type: application/json

{
}