Procédure : enregistrer sur le serveur pour préparer l'accès par programme

Cet exemple montre comment enregistrer un classeur Excel sur le serveur pour pouvoir y accéder après cela par programme. Les étapes sont les suivantes :

1. Créez un classeur avec des plages nommées.

2. Enregistrez le classeur à un emplacement de bibliothèques SharePoint approuvé.

   Notes

   Il est supposé que vous avez déjà créé une bibliothèque de documents SharePoint et que vous en avez fait un emplacement approuvé. Pour plus d'informations, voir Procédure : approuver un emplacement et Procédure : approuver les emplacements des classeurs à l'aide de scripts.

3. Spécifiez des valeurs par programme pour la feuille de calcul, la plage nommée et la valeur de la cellule à l'aide de la méthode Services Web Excel SetCellA1. Les valeurs sont passées en tant qu'arguments, args [1] et args [2] :

   status = xlServices.SetCellA1(sessionId, String.Empty, args[1], args[2]);
   

Vous pouvez spécifier les valeurs de args [1] et args [2] à l'aide d'un formulaire Web ou d'une ligne de commande :

GetSnapshot.exe http://MyServer002/MyTrustedDocumentLibrary/TestMyParam.xlsx MyParam 28 > MySnapshot.xlsx 

Dans cet exemple, args [1] est « MyParam », args [2] est « 28 » et « GetSnapshot.exe » est le nom de l'application que vous créez. Pour un exemple de programme, voir Procédure : obtenir un classeur entier ou une capture instantanée.

Pour créer une plage nommée

1. Démarrez Microsoft Office Excel 2007.

2. Renommez « Sheet1 » en « MyParamSheet ».

3. Dans la cellule B2, tapez 20.

4. Dans la cellule B3, tapez =2+B2.

5. Mettez la cellule B3 en gras.

6. Placez la cellule B2 dans une plage nommée. Cliquez sur Formules sur le menu. Cliquez ensuite sur la cellule B2 pour la sélectionner. Sur le menu Formules, cliquez sur Nommer une plage. Dans la boîte de dialogue Nouveau nom, dans la zone Nom, tapez MyParam.

7. Enregistrez le classeur à un emplacement de votre choix sur le lecteur local. Nommez le classeur « TestMyParam.xlsx ».

Pour enregistrer dans une bibliothèque SharePoint

1. Cliquez sur le Bouton Microsoft Office, pointez sur Publier, puis cliquez sur Excel Services.

2. Dans la boîte de dialogue Enregistrer sous, cliquez sur Options Excel Services.

3. Dans la boîte de dialogue Options Excel Services, sur l'onglet Afficher, vérifiez que Classeur entier est sélectionné.

4. Cliquez sur Paramètres.

5. Cliquez sur Ajouter.

6. Dans la liste Ajouter des paramètres, vous devez voir « MyParam ». Activez la case à cocher « MyParam ».

7. Cliquez sur OK. Vous devez maintenant voir « MyParam » dans la liste Paramètres.

8. Cliquez sur OK.

9. Dans la boîte de dialogue Enregistrer sous, désactivez la case à cocher Ouvrir dans Excel Services.

10. Dans la zone Nom de fichier, tapez le chemin d'accès vers la bibliothèque de documents SharePoint approuvée où vous voulez stocker ce classeur. Par exemple, http://MyServer002/MyDocumentLibrary/TestParam.xlsx.

11. Cliquez sur Enregistrer.

Pour spécifier des valeurs par programme

1. La signature pour la méthode SetCellA1 dans Services Web Excel est :

   public void SetCellA1 (
   string sessionId,
   string sheetName,
   string rangeName,
   Object cellValue,
   Out Status[] status
   )
   

   Définissez les valeurs pour la feuille de calcul, la plage nommée et la cellule pour la méthode SetCellA1 comme suit :

   // Set a value into a cell.
   status = xlSrv.SetCellA1(sessionId, String.Empty, args[1], args[2]);
   

2. Dans le code précédent :

   • args [1] est le nom de la plage nommée. Dans cet exemple, il s'agit de « MyParam ».

   • args [2] est la valeur que vous voulez placer dans la cellule. La cellule où la valeur sera placée est la plage nommée dans args [1], appelée « MyParam ».

3. Si vous utilisez une ligne de commande, vous pouvez passer les arguments comme suit :

   GetSnapshot.exe http://MyServer002/MyTrustedDocumentLibrary/TestMyParam.xlsx MyParam 28 > MySnapshot.xlsx

4. Si vous générez un instantané du classeur, vous verrez ceci :

   • La cellule B2 (avec la plage nommée « MyParam ») a maintenant une valeur attribuée par le programme, qui est « 28 ».

   • La cellule B3 a une nouvelle valeur calculée de « 30 ».

   • La cellule B3 ne montre pas le formule d'origine, qui était « =2+B2 ».

   • La cellule B3 conserve son format de police, qui est en gras.

Voir aussi

Autres ressources

Procédure : enregistrer sur le serveur à partir du client Excel
Procédure pas à pas : développement d'une application personnalisée à l'aide des services Web Excel
Accès à l'API SOAP
Appels SOAP de retour de boucle et liaison directe
Procédure : approuver les emplacements des classeurs à l'aide de scripts
Alertes Excel Services