Compartir a través de

Procedimiento para guardar el servidor para prepararlo para un acceso mediante programación

  • Artículo

Última modificación: miércoles, 14 de abril de 2010

Hace referencia a: SharePoint Server 2010

Este ejemplo describe cómo guardar un libro de Excel en el servidor para que esté disponible para el acceso mediante programación. Los pasos son los siguientes:

  1. Crear un libro con rangos con nombre.

  2. Guardar el libro en una ubicación de la biblioteca de SharePoint de confianza.

    Nota

    Se supone que ya ha creado una biblioteca de documentos de SharePoint y que la ha convertido en una ubicación de confianza. Para obtener más información, vea Procedimiento para confiar en una ubicación.

  3. Especifique mediante programación los valores para la hoja da cálculo, el rango con nombre y el valor de celda mediante el método Servicios web de Excel SetCellA1. Los valores se pasan como argumentos, es decir, args [1] y args [2]:

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

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

Puede especificar los valores de args [1] y args [2] mediante un formulario web o desde la línea de comandos:

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

En este ejemplo, args [1] es MyParam, args [2] es 28 y GetSnapshot.exe es el nombre de la aplicación que ha creado. Para obtener un programa de ejemplo, vea Procedimiento para obtener un libro completo o una instantánea.

Para crear un rango con nombre

  1. Inicie Excel.

  2. Cambie el nombre de Hoja1 a MyParamSheet.

  3. En la celda B2, escriba 20.

  4. En la celda B3, escriba =2+B2.

  5. Ponga la celda B3 en negrita.

  6. Convierta la celda B2 en un rango con nombre:

    1. En la cinta de opciones, haga clic en la pestaña Fórmulas y, a continuación, haga clic en la celda B2 para seleccionarla.

    2. En el grupo Nombres definidos, haga clic en Definir nombre.

    3. En el cuadro de texto Nombre del cuadro de diálogo Nombre nuevo, escriba MyParam.

  7. Guarde el libro en una ubicación que desee en la unidad local y asígnele el nombre TestMyParam.xlsx.

Para guardar una biblioteca de SharePoint

  1. En el menú Archivo, haga clic en Guardar y enviar y, a continuación, haga clic en Guardar en SharePoint.

  2. En el cuadro de diálogo Guardar en SharePoint, haga clic en Opciones de publicación.

  3. En la ficha Mostrar del cuadro de diálogo Opciones de publicación, asegúrese de que Libro completo está seleccionado.

  4. Haga clic en Parámetros.

  5. Haga clic en Agregar.

  6. En la lista Agregar parámetros, debe ver MyParam. Active la casilla MyParam.

  7. Haga clic en Aceptar. Ahora debe ver MyParam en la lista Parámetros.

  8. Haga clic en Aceptar.

  9. En el cuadro de diálogo Guardar en SharePoint, haga clic en Guardar como.

  10. En el cuadro de diálogo Guardar como, desactive la casilla Abrir libro con Excel en el explorador.

  11. En el cuadro Nombre de archivo, escriba la ruta de acceso a la biblioteca de documentos de SharePoint de confianza en la que desea almacenar este libro. Por ejemplo, http://MyServer002/MyDocumentLibrary/TestParam.xlsx.

  12. Haga clic en Guardar.

Para especificar valores mediante programación

  1. A continuación se indica la firma del método SetCellA1 en Servicios web de Excel:

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

    Public Sub SetCellA1(ByVal sessionId As String,
              ByVal sheetName As String, 
             ByVal rangeName As String, 
             ByVal cellValue As Object, 
             Out ByVal status() As Status)
End Sub

    Establezca los valores para la hoja de cálculo, el rango con nombre y el valor de celda en el método SetCellA1 de la siguiente forma:

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

  2. En el código anterior:

    • args [1] es el nombre del rango con nombre. En este ejemplo, es MyParam.

    • args [2] es el valor que desea establecer en la celda. La celda en la que se establecerá el valor es el rango con nombre de args [1] denominado MyParam.

  3. Si usa una línea de comandos, puede pasar los argumentos de siguiente forma:

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

  4. Si genera una instantánea del libro, verá lo siguiente:

    • La celda B2 (con el rango con nombre MyParam) tiene ahora un valor que suministró a través del programa, que es 28.

    • La celda B3 tiene un nuevo valor calculado de 30.

    • La celda B3 no muestra la fórmula original, que era "=2+B2".

    • La celda B3 mantiene su formato de fuente, que es negrita.

Nota

Para obtener más información acerca de las instantáneas, vea Procedimiento para obtener un libro completo o una instantánea. Para obtener más información acerca del método SetCellA1, vea la documentación de referencia de Servicios web de Excel. El espacio de nombres del servicio web es Microsoft.Office.Excel.Server.WebServices.

Vea también

Tareas

Procedimiento para guardar desde el cliente Excel en el servidor

Tutorial: Desarrollar una aplicación personalizada mediante Excel Web Services

Referencia

Microsoft.Office.Excel.Server.WebServices

Conceptos

Obtener acceso a la API de SOAP

Llamadas SOAP de bucle invertido y vinculación directa

Excel Services Alerts