Save, méthode (RPC, Remote Procedure Call)

Article
09/24/2014

Dernière modification : vendredi 9 octobre 2009

S’applique à : SharePoint Foundation 2010

Ajoute ou modifie un élément dans une liste, ou modifie les propriétés d'un dossier ou d'un fichier dans une bibliothèque de documents.

Méthode de service Web Cette méthode est obsolète et risque de ne plus être prise en charge dans les versions futures. Utilisez à la place la méthode de service Web suivante :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>

Paramètres

Paramètre	Description
ID = "Text"	Chaîne spécifique à une application. Dans un éditeur HTML compatible avec Microsoft SharePoint Foundation 2010, tel que Microsoft SharePoint Designer 2010, la chaîne indique le numéro de séquence et le nom de la méthode.
Étendue = « Request »	Lorsque la valeur Request est définie, l'attribut Scope définit la variable pour l'étendue de l'élément Method englobant, excepté si la variable est modifiée par une autre balise.
Nom = « Cmd »	Doit être défini sur Save.
Nom = « NextUsing »	Facultatif. L'URL vers laquelle l'utilisateur est redirigée une fois l'opération terminée.
Nom = « ID »	Définir sur New pour créer un nouvel élément, ou sur l'ID d'entier de l'élément à modifier.
Nom = « urn:schemas-microsoft-com:office:office#Nom_Colonne »	Spécifie le nom d'une colonne dans laquelle ajouter ou modifier une valeur. En fonction de la liste et de l'opération en cours d'exécution, différentes colonnes peuvent être spécifiées. Les colonnes suivantes sont utilisées par défaut dans les opérations sur différentes listes. Créer ou modifier des éléments dans la liste Annonces. Title Texte spécifiant le titre de l'élément. Body Texte spécifiant le corps de message de l'élément. Expires DateTime Valeur au format ISO8601 qui spécifie la date d'expiration. Par exemple, 2003-06-16T18:37:44Z. Créer ou modifier des éléments dans la liste de contacts . Title Texte spécifiant le nom de famille. FirstName Texte spécifiant le prénom. Email Texte spécifiant l'adresse de messagerie. Company Texte spécifiant la société. JobTitle Texte spécifiant la fonction. WorkPhone Texte spécifiant le numéro de téléphone professionnel. HomePhone Texte spécifiant le numéro de téléphone personnel. CellPhone Texte spécifiant le numéro de téléphone mobile. WorkFax Texte spécifiant le numéro de télécopie professionnel. WorkAddress Texte spécifiant l'adresse professionnelle. WorkCity Texte spécifiant la ville où travaille le contact. WorkState Texte spécifiant l'État, la région ou le département où travaille le contact. WorkZip Texte spécifiant le code postal professionnel du contact. WebPage Texte spécifiant l'URL d'un site Web. Comments Texte spécifiant des commentaires sur le contact. Créer ou modifier des éléments dans un forum de discussion. ThreadID GUID spécifiant l'ID du thread de la discussion. Ordering Texte spécifiant l'horodatage d'une discussion. Le classement d'un commentaire initial est une chaîne telle que 20031211164930 et le classement d'une réponse est une chaîne qui inclut le classement initial, par exemple 2003121116493020031211164951. Pour modifier un élément de forum de discussion existant, spécifiez l'ID de cet élément à l'aide du paramètre ID, l'ID du thread de la discussion à l'aide du paramètre ThreadID et le classement de l'élément à l'aide du paramètre Ordering. Pour créer une réponse dans une discussion existante, spécifiez New comme valeur du paramètre ID, spécifiez l'ID du thread à l'aide du paramètre ThreadID et utilisez le paramètre Ordering pour spécifier le classement du commentaire qui a fait l'objet d'une réponse. Pour créer une nouvelle discussion, spécifiez New comme valeur du paramètre ID et passez un paramètre Ordering vide. Title Texte spécifiant l'objet de l'élément de discussion. Body Texte spécifiant le corps de message de l'élément de discussion. Modifier le nom d'un fichier ou d'un dossier. Title Texte spécifiant le titre du fichier ou du dossier. Utilisez le paramètre owsfileref pour spécifier l'URL du fichier ou du dossier et le paramètre owsnewfileref pour spécifier un nouveau nom. L'ID du fichier ou du dossier doit être spécifié à l'aide du paramètre ID. Créer ou modifier un élément d'événement. Paramètres communs à tous les éléments d'événements : Title Texte spécifiant le titre de l'événement. EventDate DateTime Valeur au format ISO8601 qui spécifie la date et l'heure de début de l'événement. Par exemple, 2004-06-15T09:00:00Z EndDate DateTime Valeur au format ISO8601 qui spécifie la date et l'heure de fin de l'événement. Par exemple, 2004-06-30T10:00:00Z. Description Texte spécifiant la description de l'événement. Location Texte spécifiant l'emplacement de l'événement. Paramètres communs aux événements périodiques : RecurrencePattern#Type:fRecurrence Entier spécifiant le type d'événement répété. Les valeurs possibles sont les suivantes : 0 — Aucun 2 — Quotidien 3 — Hebdomadaire 4 — Mensuel 5 — Annuel RecurrencePattern#windowStart:fRecurrence DateTime Valeur au format ISO8601 qui spécifie la date de début de l'événement périodique. Par exemple, 2004-06-15T09:00:00Z. RecurrencePattern#EndDateRangeType:fRecurrence Entier spécifiant le type de plage qui détermine la date de fin de l'événement. Les valeurs possibles sont les suivantes : 0 Aucune date de fin. 1 Fin après un nombre spécifié d'occurrences. RecurrencePattern#repeatInstances:fRecurrence doit être spécifié. 2 Fin à une date spécifiée. RecurrencePattern#windowEnd:fRecurrence doit être spécifié. RecurrencePattern#repeatInstances:fRecurrence Entier spécifiant le nombre d'instances pour un événement répété. RecurrencePattern#windowEnd:fRecurrence DateTime Valeur au format ISO8601 qui spécifie la date de fin de l'événement périodique. Par exemple, 2004-06-30T09:00:00Z. Événements périodiques quotidiens : RecurrencePattern#daily_dayFrequency:fRecurrence Entier spécifiant la fréquence quotidienne d'un événement. Par exemple, 2 spécifie tous les jours 2. Événements périodiques mensuels : RecurrencePattern#MonthlyRecurType:fRecurrence Entier spécifiant le type de périodicité mensuelle. Les valeurs possibles sont les suivantes : 0 — Jour Entier de chaque mois Entier. RecurrencePattern#monthly_day:fRecurrence et RecurrencePattern#monthly_monthFrequency:fRecurrence doivent être spécifiés. 1 — Le [premier\| deuxième\| troisième\| quatrième\| dernier] [Dimanche \| Lundi \| Mardi \| Mercredi \| Jeudi \| Vendredi \| Samedi ] de chaque mois Entier. RecurrencePattern#monthlyByDay_weekOfMonth:fRecurrence, RecurrencePattern#monthlyByDay_day:fRecurrence et RecurrencePattern#monthlyByDay_monthFrequency:fRecurrence doivent être spécifiés. RecurrencePattern#monthly_day:fRecurrence Entier spécifiant le jour du mois pour chaque occurrence lorsque RecurrencePattern#MonthlyRecurType:fRecurrence est égal à 0. RecurrencePattern#monthly_monthFrequency:fRecurrence Entier spécifiant la fréquence mensuelle lorsque RecurrencePattern#MonthlyRecurType:fRecurrence est égal à 0. Par exemple, 3 spécifie tous les 3 mois. RecurrencePattern#monthlyByDay_weekOfMonth:fRecurrence Entier spécifiant la semaine du mois de l'occurrence lorsque RecurrencePattern#MonthlyRecurType:fRecurrence est égal à 1. Les valeurs possibles sont les suivantes : 0 — première 1 — deuxième 2 — troisième 3 — quatrième 4 — dernière RecurrencePattern#monthlyByDay_day:fRecurrence Entier spécifiant les jours de la semaine de l'occurrence lorsque RecurrencePattern#MonthlyRecurType:fRecurrence est égal à 1. Les valeurs possibles sont les suivantes : 0 — Dimanche 1 — Lundi 2 — Mardi 3 — Mercredi 4 — Jeudi 5 — Vendredi 6 — Samedi RecurrencePattern#monthlyByDay_monthFrequency:fRecurrence Entier spécifiant la fréquence mensuelle lorsque RecurrencePattern#MonthlyRecurType:fRecurrence est égal à 1. Par exemple, 4 spécifie tous les 4 mois. Événements périodiques hebdomadaires : RecurrencePattern#weekly_weekFrequency:fRecurrence Entier spécifiant la fréquence hebdomadaire d'un événement. Par exemple, 2 spécifie toutes les 2 semaines. RecurrencePattern#weekly_multiDays:fRecurrence Entier spécifiant le jour de la semaine auquel l'occurrence hebdomadaire a lieu. Les valeurs possibles sont les suivantes : 0 — Dimanche 1 — Lundi 2 — Mardi 3 — Mercredi 4 — Jeudi 5 — Vendredi 6 — Samedi Créer ou modifier un élément dans une liste de problèmes. Title Texte spécifiant le titre de l'élément du problème. Status Entier spécifiant l'état de ce problème. Les valeurs possibles sont les suivantse : 1 — Actif 2 — Résolu 3 — Fermé Priority Entier spécifiant la priorité de ce problème. Les valeurs possibles sont les suivantes : 1 — Haute 2 — Normale 3 — Faible Category Entier spécifiant la catégorie de ce problème. Les valeurs possibles sont les suivantes : 1 — Catégorie 1 2 — Catégorie 2 3 — Catégorie 3 AssignedTo Entier spécifiant l'ID de l'utilisateur à qui le problème est assigné. Comment Texte spécifiant un commentaire sur le problème. DueDate Valeur DateTime au format ISO8601 qui indique la date d'échéance du problème. Par exemple, 2004-06-30T09:00:00Z. RelatedIssue Entier spécifiant l'ID d'un problème connexe. Créer ou modifier un lien dans une liste de liens. URL Texte spécifiant l'adresse URL absolue du lien suivi d'une virgule (,), d'un espace et du texte à afficher pour le lien. Si le texte à afficher n'est pas spécifié, la chaîne de l'URL s'affiche. Comments Texte spécifiant des remarques sur le lien. Créer ou modifier un élément dans une liste de tâches. Title Texte spécifiant le titre de la tâche. Status Texte spécifiant l'état de la tâche. Les valeurs possibles sont les suivantes : Not Started In Progress Completed Deferred Waiting on someone else Priority Texte spécifiant la priorité de la tâche. Les valeurs possibles sont les suivantes : High Normal Low PercentComplete Nombre décimal représentant la progression de la tâche en pourcentage. AssignedTo Entier spécifiant l'ID de l'utilisateur à qui la tâche est assignée. Body Texte spécifiant le corps de l'élément de tâche. StartDate Valeur DateTime au format ISO8601 qui spécifie la date de début de la tâche. Par exemple, 2004-05-30T09:00:00Z. DueDate Valeur DateTime au format ISO8601 qui indique la date d'échéance pour traiter le problème. Par exemple, 2004-06-30T09:00:00Z.
Nom = « owsfileref »	Facultatif. Spécifie l'URL relative de serveur pour le fichier ou le dossier dont le nom doit être modifié. Utilisez le paramètre owsnewfileref pour spécifier le nouveau nom. L'ID du fichier ou dossier doit être spécifié à l'aide du paramètre ID.
Nom = « owsnewfileref »	Facultatif. Spécifie un nouveau nom pour le fichier ou dossier spécifié par le paramètre owsfileref.
Nom = « fileupload0 »	Spécifie le chemin d'accès de la pièce jointe à ajouter pour un élément.

Décodé

Ajouter une réponse à un élément dans un forum de discussion.

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

Créer un nouvel événement qui se produit entre 10:00 et 12h30, le deuxième mardi du mois, tous les deux mois au cours de l'année 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>

Ajouter une tâche à une liste de tâches.

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

Partager via

Save, méthode (RPC, Remote Procedure Call)

Paramètres

Décodé

Ressources supplémentaires