Compartir a través de

Método Save (RPC)

  • Artículo

Última modificación: viernes, 09 de octubre de 2009

Hace referencia a: SharePoint Foundation 2010

Agrega o modifica un elemento de una lista, o modifica las propiedades de una carpeta o de un archivo de una biblioteca de documentos.

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:UpdateListItems(String, XmlNode).

<Method ID="Text">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">Save</SetVar>
  <SetVar Name="ID">[New|Integer]</SetVar>
  <SetVar Name="NextUsing">URL</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#
        Column_1_Name">Value</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#
        Column_2_Name">Value</SetVar>
  .
  .
  .
  <SetVar Name="owsfileref">URL</SetVar>
  <SetVar Name="owsnewfileref">Name</SetVar>
  <SetVar Name="fileupload0">URL</SetVar>
</Method>

Parámetros

Parámetro

Descripción

ID = "Text"

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

Scope = "Request"

Si se establece en Request, el atributo Scope establece la variable para el ámbito del elemento Method de inclusión, a menos que la variable se cambie mediante otra etiqueta.

Name = "Cmd"

Se debe establecer en Save.

Name = "NextUsing"

Opcional. La dirección URL a la que se redirige al usuario una vez completada la operación.

Name = "ID"

Se establece en New para crear un elemento nuevo o se establece en el identificador de número entero del elemento que se va a modificar.

Name = "urn:schemas-microsoft-com:office:office#Column_Name"

Especifica el nombre de una columna en la que se va a agregar o modificar un valor. Según la lista y la operación realizada, se pueden especificar varias columnas.

Las columnas siguientes se utilizan de forma predeterminada en las operaciones de varias listas.

Cree o modifique elementos en la lista Anuncios.

  • Title   Texto que especifica el título del elemento.

  • Body Texto que especifica el cuerpo del mensaje del elemento.

  • ExpiresValor de DateTimeen formato ISO8601 que especifica la fecha de caducidad. Por ejemplo, 2003-06-16T18:37:44Z.

Cree o modifique elementos en la lista Contactos.

  • Title Texto que especifica el apellido.

  • FirstName Texto que especifica el nombre.

  • Email Texto que especifica la dirección de correo electrónico.

  • Company Texto que especifica la compañía.

  • JobTitle Texto que especifica el puesto de trabajo.

  • WorkPhone Texto que especifica el número de teléfono de trabajo.

  • HomePhone Texto que especifica el número de teléfono particular.

  • CellPhone Texto que especifica el número de teléfono móvil.

  • WorkFax Texto que especifica el número de fax del trabajo.

  • WorkAddress Texto que especifica la dirección de trabajo.

  • WorkCity Texto que especifica la ciudad donde trabaja el contacto.

  • WorkState Texto que especifica el estado donde trabaja el contacto.

  • WorkZip Texto que especifica el código postal donde trabaja el contacto.

  • WebPage Texto que especifica la dirección URL de un sitio web.

  • Comments Texto con comentarios sobre el contacto.

Cree o modifique elementos en un panel de discusión.

  • ThreadID GUID que especifica el identificador de subproceso de la discusión.

  • Ordering   Texto que especifica la marca de tiempo de una discusión. La ordenación de un comentario inicial es una cadena, como 20031211164930, y la ordenación de una respuesta es una cadena que incluye la ordenación inicial, como 2003121116493020031211164951. Para modificar un elemento existente del panel de discusión, especifique el identificador del elemento con el parámetro ID, defina el identificador del subproceso con el parámetro ThreadID y especifique la ordenación del elemento mediante el parámetro Ordering. Para crear una respuesta en una discusión existente, especifique New como el valor del parámetro ID, especifique el identificador del subproceso con el parámetro ThreadID y use el parámetro Ordering para especificar la ordenación del comentario al que se responde. Para crear una discusión nueva, especifique New como el valor del parámetro ID y pase un parámetro Ordering vacío.

  • Title Texto que especifica el asunto del elemento de discusión.

  • Body Texto que especifica el cuerpo del mensaje del elemento de discusión.

Edite el nombre de un archivo o una carpeta.

  • Title Texto que especifica el título para el archivo o carpeta. Utilice el parámetro owsfileref para especificar la dirección URL para el archivo o carpeta y el parámetro owsnewfileref para especificar un nombre nuevo. Se debe especificar el identificador del archivo o la carpeta a través del parámetro ID.

Cree o modifique un elemento de evento.

Parámetros comunes a todos los elementos de evento:

  • Title   Texto que especifica el título del evento.

  • EventDate Valor de DateTime en formato ISO8601 que especifica la fecha y hora de inicio para el evento. Por ejemplo, 2004 - 06 - 15T09:00:00Z.

  • EndDate   Valor de DateTime en formato ISO8601 que especifica la fecha y la hora de finalización del evento. Por ejemplo, 2004-06-30T10:00:00Z.

  • Description   Texto que especifica la descripción del evento.

  • Location   Texto que especifica la ubicación del evento.

Parámetros comunes a los eventos periódicos:

  • RecurrencePattern#Type:fRecurrence Entero que especifica el tipo de evento periódico. Los valores posibles son:

    • 0: Ninguno

    • 2: Diariamente

    • 3: Semanalmente

    • 4: Mensualmente

    • 5: Anualmente

  • RecurrencePattern#windowStart:fRecurrence  Valor de DateTime en formato ISO8601 que especifica la fecha de inicio de un evento periódico. Por ejemplo, 2004-06-15T09:00:00Z.

  • RecurrencePattern#EndDateRangeType:fRecurrence Número entero que especifica el tipo de intervalo que determina la fecha final del evento. Los valores posibles son:

    • 0 Sin fecha de finalización.

    • 1 Finaliza después de un número especificado de apariciones. Requiere la especificación de RecurrencePattern#repeatInstances:fRecurrence.

    • 2 Finaliza en una fecha especificada. Requiere la especificación de RecurrencePattern#windowEnd:fRecurrence.

  • RecurrencePattern#repeatInstances:fRecurrence Número entero que especifica el número de instancias para un evento periódico.

  • RecurrencePattern#windowEnd:fRecurrence  Valor de DateTime en formato ISO8601 que especifica la fecha de finalización de un evento periódico. Por ejemplo, 2004-06-30T09:00:00Z.

Eventos periódicos diarios:

  • RecurrencePattern#daily_dayFrequency:fRecurrence Número entero que especifica la frecuencia diaria de un evento. Por ejemplo, 2 especifica cada 2 días.

Eventos periódicos mensuales:

  • RecurrencePattern#MonthlyRecurType:fRecurrence Número entero que especifica el tipo de periodicidad mensual. Los valores posibles son:

    • 0: El día Integer cada Integer mes(es). Requiere la especificación de RecurrencePattern#monthly_day:fRecurrence y RecurrencePattern#monthly_monthFrequency:fRecurrence.

    • 1: El [primer | segundo | tercero | cuarto | último] [domingo | lunes | martes | miércoles | jueves | viernes | sábado] cada Integer mes(es). Requiere la especificación de RecurrencePattern#monthlyByDay_weekOfMonth:fRecurrence, RecurrencePattern#monthlyByDay_day:fRecurrence, y RecurrencePattern#monthlyByDay_monthFrequency:fRecurrence.

  • RecurrencePattern#monthly_day:fRecurrence Número entero que especifica el día del mes para cada ocurrencia cuando RecurrencePattern#MonthlyRecurType:fRecurrence es igual a 0.

  • RecurrencePattern#monthly_monthFrequency:fRecurrenceNúmero entero que especifica la frecuencia mensual cuando RecurrencePattern#MonthlyRecurType:fRecurrence es igual a 0. Por ejemplo, 3 especifica cada tres meses.

  • RecurrencePattern#monthlyByDay_weekOfMonth:fRecurrence Número entero que especifica la semana del mes para la ocurrencia cuando RecurrencePattern#MonthlyRecurType:fRecurrence es igual a 1. Los valores posibles son:

    • 0: primera

    • 1: segunda

    • 2: tercera

    • 3: cuarta

    • 4: última

  • RecurrencePattern#monthlyByDay_day:fRecurrence Número entero que especifica el día o días de la semana para la ocurrencia cuando RecurrencePattern#MonthlyRecurType:fRecurrence es igual a 1. Los valores posibles son:

    • 0: Domingo

    • 1: Lunes

    • 2: Martes

    • 3: Miércoles

    • 4: Jueves

    • 5: Viernes

    • 6: Sábado

  • RecurrencePattern#monthlyByDay_monthFrequency:fRecurrence Número entero que especifica la frecuencia mensual cuando RecurrencePattern#MonthlyRecurType:fRecurrence es igual a 1. Por ejemplo, 4 especifica cada cuatro meses.

Eventos periódicos semanales:

  • RecurrencePattern#weekly_weekFrequency:fRecurrence Número entero que especifica la frecuencia semanal de un evento. Por ejemplo, 2 especifica cada 2 semanas.

  • RecurrencePattern#weekly_multiDays:fRecurrence Número entero que especifica el día de la semana en el que la ocurrencia semanal tiene lugar. Los valores posibles son:

    • 0: Domingo

    • 1: Lunes

    • 2: Martes

    • 3: Miércoles

    • 4: Jueves

    • 5: Viernes

    • 6: Sábado

Cree o modifique un elemento en una lista de problemas.

  • Title   Texto que especifica el título del problema.

  • Status Número entero que especifica el estado del problema. Los valores posibles son:

    • 1: Activo

    • 2: Resuelto

    • 3: Cerrado

  • Priority Número entero que especifica la prioridad del problema. Los valores posibles son:

    • 1: Alta

    • 2: Normal

    • 3: Baja

  • Category Número entero que especifica la categoría del problema. Los valores posibles son:

    • 1: Categoría 1

    • 2: Categoría 2

    • 3: Categoría 3

  • AssignedTo Número entero que especifica el identificador del usuario a quien se ha asignado el problema.

  • Comment Texto que especifica un comentario para el problema.

  • DueDate Valor de DateTime en formato ISO8601 que especifica la fecha de vencimiento para el problema. Por ejemplo, 2004 - 06 - 30T09:00:00Z.

  • RelatedIssue Número entero que especifica el identificador de un asunto relacionado.

Cree o modifique un vínculo en una lista de vínculos.

  • URL Texto que especifica la dirección URL absoluta del vínculo seguido una coma (,), un espacio y el texto que se va a mostrar para el vínculo. Si no se especifica el texto, se muestra la cadena de la dirección URL.

  • Comments Texto que especifica las notas para el vínculo.

Cree o modifique un elemento en una lista de tareas.

  • Title  Texto que especifica el título de la tarea.

  • Status Texto que especifica el estado de la tarea. Los valores posibles son:

    • Not Started

    • In Progress

    • Completed

    • Deferred

    • Waiting on someone else

  • Priority Texto que especifica la prioridad de la tarea. Los valores posibles son:

    • High

    • Normal

    • Low

  • PercentComplete   Número decimal que representa el porcentaje de finalización de la tarea.

  • AssignedTo Número entero que especifica el identificador del usuario al que se asignó la tarea.

  • Body Texto que especifica el cuerpo del mensaje del elemento de la tarea.

  • StartDate   Valor de DateTime en formato ISO8601 que especifica la fecha de inicio de la tarea. Por ejemplo, 2004-05-30T09:00:00Z.

  • DueDate Valor de DateTime en formato ISO8601 que especifica la fecha de vencimiento para la tarea. Por ejemplo, 2004 - 06 - 30T09:00:00Z.

Name = "owsfileref"

Opcional. Especifica la dirección URL relativa al servidor del archivo o la carpeta cuyo nombre se va a cambiar. Use el parámetro owsnewfileref para especificar el nuevo nombre. El identificador del archivo o la carpeta se debe especificar con el parámetro ID.

Name = "owsnewfileref"

Opcional. Especifica un nombre nuevo para el archivo o la carpeta que especifica el parámetro owsfileref.

Name = "fileupload0"

Especifica la ruta de acceso de los datos adjuntos que se van a agregar para un elemento.

Descodificado

  1. Agregue una respuesta a un elemento en el panel de discusión.

    <Method ID="0,DiscSave">
  <SetList Scope="Request">D1292FB0-20C9-4270-B5D9-5F2ECC6C597D</SetList>
  <SetVar Name="Cmd">Save</SetVar>
  <SetVar Name="ID">New</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#ThreadID">20031212-0429-16B3-919B-E69D9248868B</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Title">Text</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Ordering">2003121120293620031211204403</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Body">Text</SetVar>
</Method>

  2. Cree un evento nuevo que se produzca entre las 10 a.m. y las 12:30 p.m. del segundo martes del mes cada dos meses durante el año 2004.

    <Method ID="0,Save">
  <SetList Scope="Request">c3fb93d0-2632-4b72-a0e2-1f571b869814</SetList>
  <SetVar Name="Cmd">Save</SetVar>
  <SetVar Name="ID">New</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Title">Monthly Meeting</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#EventDate">2004-01-01T10:00:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#EndDate">2005-01-01T12:30:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#Type:fRecurrence">4</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#MonthlyRecurType:fRecurrence">1</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#monthlyByDay_weekOfMonth:fRecurrence">1</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#monthlyByDay_day:fRecurrence">2</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#monthlyByDay_monthFrequency:fRecurrence">2</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#EndDateRangeType:fRecurrence">2</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#windowStart:fRecurrence">2004-01-01T00:00:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#windowEnd:fRecurrence">2005-01-01T00:00:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Description">Text</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Location">Text</SetVar>
</Method>

  3. Agregue una tarea a la lista de tareas.

    <Method ID="0,Save">
<SetList Scope="Request">7DDA4B15-CFDE-4098-8288-EE139CC3796F</SetList>
  <SetVar Name="Cmd">Save</SetVar>
  <SetVar Name="ID">New</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Title">Text</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Status">In Progress</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Priority">High</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#PercentComplete">.2</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#AssignedTo">17</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Body">Text</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#StartDate">2004-01-01T00:00:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#DueDate">2004-01-14T00:00:00Z</SetVar>
</Method>