Recurso ColumnDefinition
Representação JSON
Aqui está uma representação JSON de um recurso ColumnDefinition.
{
"columnGroup": "string",
"description": "description",
"displayName": "friendly name",
"enforceUniqueValues": "true",
"hidden": false,
"id": "string",
"indexed": true,
"name": "staticNameForApi",
"readOnly": false,
"required": false,
"boolean": { "@odata.type": "microsoft.graph.booleanColumn" },
"calculated": { "@odata.type": "microsoft.graph.calculatedColumn" },
"choice": { "@odata.type": "microsoft.graph.choiceColumn" },
"currency": { "@odata.type": "microsoft.graph.currencyColumn" },
"dateTime": { "@odata.type": "microsoft.graph.dateTimeColumn" },
"defaultValue": { "@odata.type": "microsoft.graph.defaultColumnValue" },
"lookup": { "@odata.type": "microsoft.graph.lookupColumn" },
"number": { "@odata.type": "microsoft.graph.numberColumn" },
"personOrGroup": { "@odata.type": "microsoft.graph.personOrGroupColumn" },
"text": { "@odata.type": "microsoft.graph.textColumn" }
}
Propriedades
As colunas podem conter dados de vários tipos. As propriedades a seguir indicam qual tipo de dados uma coluna armazena, bem como configurações adicionais para esses dados. As propriedades relacionadas ao tipo (booliano, calculado, escolha, moeda, dateTime, pesquisa, número, personOrGroup, texto) são mutuamente exclusivas -- uma coluna só pode ter uma delas especificada.
| Nome da propriedade | Tipo | Descrição |
|---|---|---|
| columnGroup | string | Para colunas de site, o nome do grupo ao qual esta coluna pertence. Ajuda a organizar as colunas relacionadas. |
| description | string | A descrição voltado para o usuário da coluna. |
| displayName | string | O nome voltado para o usuário da coluna. |
| enforceUniqueValues | booliano | Se for verdadeiro, esse mesmo valor não constará em dois itens de lista nessa coluna. |
| hidden | booliano | Especifica se a coluna é exibida na interface do usuário. |
| id | string | O identificador exclusivo da coluna. |
| indexed | booliano | Especifica se os valores da coluna podem ser usados para classificação e pesquisa. |
| name | string | O nome voltado para a API da coluna, conforme ele aparece nos campos em uma listItem. Para o nome voltado ao usuário, consulte displayName. |
| readOnly | bool | Especifica se os valores da coluna podem ser modificados. |
| required | booliano | Especifica se o valor da coluna não é opcional. |
| boolean | booleanColumn | Esta coluna armazena valores boolianos. |
| calculated | calculatedColumn | Os dados dessa coluna são calculados com base em outras colunas. |
| choice | choiceColumn | Esta coluna armazena dados de uma lista de opções. |
| currency | currencyColumn | Esta coluna armazena valores monetários. |
| dateTime | dateTimeColumn | Esta coluna armazena valores de datetime. |
| defaultValue | defaultColumnValue | O valor padrão dessa coluna. |
| lookup | lookupColumn | Os dados dessa coluna são procurados por outra fonte no site. |
| number | numberColumn | Esta coluna armazena valores numéricos. |
| personOrGroup | personOrGroupColumn | Esta coluna armazena valores de Pessoa ou Grupo. |
| text | textColumn | Esta coluna armazena valores de texto. |
Observação: essas propriedades correspondem à enumeração SPFieldType do SharePoint. Embora os tipos de campo mais comuns estejam representados acima, ainda falta alguns a essa API beta. nestes casos, nenhuma das facetas do tipo de coluna serão preenchidas, e a coluna só terá as propriedades básicas.
Comentários
Os valores ColumnDefinitions e valores de campo para colunas hidden não são mostrados por padrão.
Para vê-los ao listar columnDefinitions, inclua hidden na instrução $select.
Para vê-los ao mostrar valores de campo em listItems, inclua as colunas desejadas pelo nome em sua $select instrução.