Creación de un columnDefinition en un sitio
Artículo
02/01/2024
8 colaboradores
Comentarios
En este artículo
Espacio de nombres: microsoft.graph
Cree una columna para un sitio con una solicitud que especifique una columnDefinition .
Esta API está disponible en las siguientes implementaciones nacionales de nube .
Servicio global
Gobierno de EE. UU. L4
Us Government L5 (DOD)
China operada por 21Vianet
✅
✅
✅
✅
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere . Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos . Para obtener más información sobre estos permisos, consulte la referencia de permisos .
Tipo de permiso
Permisos con privilegios mínimos
Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)
Sites.Manage.All
Sites.FullControl.All
Delegado (cuenta personal de Microsoft)
No admitida.
No admitida.
Aplicación
Sites.Manage.All
Sites.FullControl.All
Solicitud HTTP
POST /sites/{site-id}/columns
Nombre
Descripción
Authorization
{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización .
Content-Type
application/json. Obligatorio.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON del recurso columnDefinition que se va a agregar.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta y un 201 Created
objeto columnDefinition en el cuerpo de la respuesta.
Ejemplo
Solicitud
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
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new ColumnDefinition
{
Description = "test",
EnforceUniqueValues = false,
Hidden = false,
Indexed = false,
Name = "Title",
Text = new TextColumn
{
AllowMultipleLines = false,
AppendChangesToExistingText = false,
LinesForEditing = 0,
MaxLength = 255,
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Sites["{site-id}"].Columns.PostAsync(requestBody);
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK .
mgc sites columns create --site-id {site-id} --body '{\
"description":"test",\
"enforceUniqueValues":false,\
"hidden":false,\
"indexed":false,\
"name":"Title",\
"text":{\
"allowMultipleLines":false,\
"appendChangesToExistingText":false,\
"linesForEditing":0,\
"maxLength":255\
}\
}\
'
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK .
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.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 := graphmodels.NewTextColumn()
allowMultipleLines := false
text.SetAllowMultipleLines(&allowMultipleLines)
appendChangesToExistingText := false
text.SetAppendChangesToExistingText(&appendChangesToExistingText)
linesForEditing := int32(0)
text.SetLinesForEditing(&linesForEditing)
maxLength := int32(255)
text.SetMaxLength(&maxLength)
requestBody.SetText(text)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
columns, err := graphClient.Sites().BySiteId("site-id").Columns().Post(context.Background(), requestBody, nil)
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK .
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
ColumnDefinition columnDefinition = new ColumnDefinition();
columnDefinition.setDescription("test");
columnDefinition.setEnforceUniqueValues(false);
columnDefinition.setHidden(false);
columnDefinition.setIndexed(false);
columnDefinition.setName("Title");
TextColumn text = new TextColumn();
text.setAllowMultipleLines(false);
text.setAppendChangesToExistingText(false);
text.setLinesForEditing(0);
text.setMaxLength(255);
columnDefinition.setText(text);
ColumnDefinition result = graphClient.sites().bySiteId("{site-id}").columns().post(columnDefinition);
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK .
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);
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK .
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\ColumnDefinition;
use Microsoft\Graph\Generated\Models\TextColumn;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ColumnDefinition();
$requestBody->setDescription('test');
$requestBody->setEnforceUniqueValues(false);
$requestBody->setHidden(false);
$requestBody->setIndexed(false);
$requestBody->setName('Title');
$text = new TextColumn();
$text->setAllowMultipleLines(false);
$text->setAppendChangesToExistingText(false);
$text->setLinesForEditing(0);
$text->setMaxLength(255);
$requestBody->setText($text);
$result = $graphServiceClient->sites()->bySiteId('site-id')->columns()->post($requestBody)->wait();
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK .
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
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK .
from msgraph import GraphServiceClient
from msgraph.generated.models.column_definition import ColumnDefinition
from msgraph.generated.models.text_column import TextColumn
graph_client = GraphServiceClient(credentials, scopes)
request_body = ColumnDefinition(
description = "test",
enforce_unique_values = False,
hidden = False,
indexed = False,
name = "Title",
text = TextColumn(
allow_multiple_lines = False,
append_changes_to_existing_text = False,
lines_for_editing = 0,
max_length = 255,
),
)
result = await graph_client.sites.by_site_id('site-id').columns.post(request_body)
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK .
Respuesta
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
}
}