Compartir a través de

Método NEWFIELD

  • Artículo

Última modificación: viernes, 30 de mayo de 2008

Hace referencia a: SharePoint Foundation 2010

Agrega un campo a una lista de SharePoint.

Nota

Método de servicio web Este método está desusado y es posible que no sea compatible con futuras versiones. En su lugar, use el siguiente método de servicio web:UpdateList(String, XmlNode, XmlNode, XmlNode, XmlNode, String).

<Method ID="Text">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">NEWFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field Name=&quot;fieldname&quot;
    MaxLength=&quot;Integer&quot; DisplayName=&quot;displayname&quot;
    Description=&quot;text&quot; Type=&quot;Text&quot;/&gt;</SetVar>
  <SetVar Name="AddToDefaultView">[ON|OFF]</SetVar>
  <SetVar Name="owshiddenversion">Integer</SetVar>
</Method>

Parámetros

Parámetro

Descripción

ID = "Text"

Cadena específica de la aplicación. En un editor HTML compatible con Windows SharePoint Services, como Microsoft Office SharePoint Server 2007, la cadena proporciona el número de secuencia y el nombre del método.

Scope = "Request"

Al establecerlo en Request, el atributo Scope establece la variable para el ámbito del elemento Method de cierre, a menos que otra etiqueta cambie la variable.

Name = "Cmd"

Debe establecerse en NEWFIELD.

Name = "FieldXML"

La descripción XML del nuevo campo. Para obtener el conjunto completo de atributos disponibles y los valores que se pueden incluir, consulte la definición del elemento Field en la referencia de Esquemas Core del Lenguaje de marcado de la aplicación de colaboración (CAML).

Name = "AddToDefaultView"

Una vista es un conjunto con nombre de reglas que describe cómo se muestran los elementos en una lista. Cada lista tiene una vista predefinida asociada a ella. Si AddToDefaultView se establece en ON, el campo se agrega a la vista predeterminada; si se establece en OFF, el campo no se agrega a esa vista.

Name = "owshiddenversion"

Éste es el número de la versión actual de la lista. El comando NEWFIELD sólo funciona si Windows SharePoint Services y la aplicación cliente están de acuerdo en el número de versión de la lista. De esta forma se garantiza que sólo un usuario pueda modificar a la vez el esquema de la lista.

Descodificado

<Method ID="0,NEWFIELDSample">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">NEWFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field Name=&quot;Sample&quot;
    MaxLength=&quot;255&quot; DisplayName=&quot;Sample&quot;
    Description=&quot;sample description&quot; 
        Type=&quot;Text&quot;/&gt;</SetVar>
  <SetVar Name="AddToDefaultView">ON</SetVar>
  <SetVar Name="owshiddenversion">6</SetVar>
</Method>

Vea también

Conceptos

Formato de los mensajes de error para SharePoint Foundation