Erstellen einer columnDefinition in einer Website

Namespace: microsoft.graph

Erstellen sie eine Spalte für eine Website. with a request that specifies a columnDefinition

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)	Sites.Manage.All, Sites.FullControl.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Sites.Manage.All, Sites.FullControl.All

HTTP-Anforderung

POST /sites/{site-id}/columns

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der hinzuzufügenden [columnDefinition-Ressource][] an.

Antwort

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

Beispiel

Anforderung

HTTP

POST https://graph.microsoft.com/v1.0/sites/{site-id}/columns
Content-Type: application/json

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

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var columnDefinition = new ColumnDefinition
{
    Description = "test",
    EnforceUniqueValues = false,
    Hidden = false,
    Indexed = false,
    Name = "Title",
    Text = new TextColumn
    {
        AllowMultipleLines = false,
        AppendChangesToExistingText = false,
        LinesForEditing = 0,
        MaxLength = 255
    }
};

await graphClient.Sites["{site-id}"].Columns
    .Request()
    .AddAsync(columnDefinition);

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

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const columnDefinition = {
   description: 'test',
   enforceUniqueValues: false,
   hidden: false,
   indexed: false,
   name: 'Title',
   text: {
      allowMultipleLines: false,
      appendChangesToExistingText: false,
      linesForEditing: 0,
      maxLength: 255
   }
};

await client.api('/sites/{site-id}/columns')
    .post(columnDefinition);

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/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/sites/{site-id}/columns"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphColumnDefinition *columnDefinition = [[MSGraphColumnDefinition alloc] init];
[columnDefinition setDescription:@"test"];
[columnDefinition setEnforceUniqueValues: false];
[columnDefinition setHidden: false];
[columnDefinition setIndexed: false];
[columnDefinition setName:@"Title"];
MSGraphTextColumn *text = [[MSGraphTextColumn alloc] init];
[text setAllowMultipleLines: false];
[text setAppendChangesToExistingText: false];
[text setLinesForEditing: 0];
[text setMaxLength: 255];
[columnDefinition setText:text];

NSError *error;
NSData *columnDefinitionData = [columnDefinition getSerializedDataWithError:&error];
[urlRequest setHTTPBody:columnDefinitionData];

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

        //Request Completed

}];

[meDataTask execute];

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();

ColumnDefinition columnDefinition = new ColumnDefinition();
columnDefinition.description = "test";
columnDefinition.enforceUniqueValues = false;
columnDefinition.hidden = false;
columnDefinition.indexed = false;
columnDefinition.name = "Title";
TextColumn text = new TextColumn();
text.allowMultipleLines = false;
text.appendChangesToExistingText = false;
text.linesForEditing = 0;
text.maxLength = 255;
columnDefinition.text = text;

graphClient.sites("{site-id}").columns()
    .buildRequest()
    .post(columnDefinition);

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

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewColumnDefinition()
description := "test"
requestBody.SetDescription(&description)
enforceUniqueValues := false
requestBody.SetEnforceUniqueValues(&enforceUniqueValues)
hidden := false
requestBody.SetHidden(&hidden)
indexed := false
requestBody.SetIndexed(&indexed)
name := "Title"
requestBody.SetName(&name)
text := msgraphsdk.NewTextColumn()
requestBody.SetText(text)
allowMultipleLines := false
text.SetAllowMultipleLines(&allowMultipleLines)
appendChangesToExistingText := false
text.SetAppendChangesToExistingText(&appendChangesToExistingText)
linesForEditing := int32(0)
text.SetLinesForEditing(&linesForEditing)
maxLength := int32(255)
text.SetMaxLength(&maxLength)
siteId := "site-id"
result, err := graphClient.SitesById(&siteId).Columns().Post(requestBody)

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

PowerShell

Import-Module Microsoft.Graph.Sites

$params = @{
    Description = "test"
    EnforceUniqueValues = $false
    Hidden = $false
    Indexed = $false
    Name = "Title"
    Text = @{
        AllowMultipleLines = $false
        AppendChangesToExistingText = $false
        LinesForEditing = 0
        MaxLength = 255
    }
}

New-MgSiteColumn -SiteId $siteId -BodyParameter $params

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

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