Procedimiento para implementar UDF mediante soluciones de SharePoint Foundation

Artículo
09/18/2014

Última modificación: viernes, 06 de agosto de 2010

Hace referencia a: SharePoint Server 2010

En este ejemplo se muestra la forma de implementar una DLL de funciones definidas por el usuario (UDF) mediante el marco de soluciones de Microsoft SharePoint Foundation.

El marco de soluciones de SharePoint Foundation permite incluir todos los componentes para ampliar SharePoint Foundation en un nuevo archivo denominado archivo de solución (un formato basado en CAB con extensión .WSP). Una solución es un paquete que se puede implementar y volver a usar que puede contener un conjunto de características, definiciones de sitios y ensamblados que se pueden aplicar en un sitio, y habilitar o deshabilitar de forma individual. Además, puede usar el archivo de solución para implementar el contenido de un paquete de elementos web, incluso ensamblados, recursos de clase, archivos .dwp y otros componentes del paquete. Para obtener más información acerca del marco de soluciones de SharePoint Foundation, consulte el nodo de SharePoint Foundation en Introducción al desarrollo para SharePoint Foundation (https://msdn.microsoft.com/es-es/library/ee539432(office.14).aspx).

El procedimiento para crear e implementar un ensamblado de UDF mediante el marco de soluciones de SharePoint Foundation es el siguiente:

Cree el archivo de manifiesto de solución, Manifest.xml.

El manifiesto de solución (siempre denominado Manifest.xml) se almacena en la raíz de un archivo de solución. Este archivo define la lista de características, las definiciones de sitios, los archivos de recursos, los archivos de elementos web y los ensamblados que se van a procesar. No define la estructura de archivos; si los archivos están incluidos en una solución pero no aparecen en el archivo XML de manifiesto, no se procesan de ninguna manera.

Nota

Para obtener más información acerca de la estructura del archivo XML de manifiesto, consulte la documentación de SharePoint Foundation.
Empaquete el ensamblado UDF y Manifest.xml en un archivo CAB.
Asegúrese de que se esté ejecutando el servicio Administración de SharePoint Foundation en el servidor.
Agregue la solución al servidor mediante stsadm.exe.
Implemente la solución mediante stsadm.exe.

Cada ubicación de confianza de Servicios de Excel tiene una marca AllowUdfs.

Nota

La marca AllowUdfs se indica con la opción User-defined functions allowed de la página Ubicaciones de archivos de confianza de Servicios de Excel. Para obtener información sobre cómo navegar a la página ubicaciones de archivo de confianza, vea Paso 3: Implementar y habilitar UDF.

Para permitir que se llamen a las UDF desde una ubicación específica de confianza, debe hacer lo siguiente:

Establezca el valor AllowUdfs en true. El valor predeterminado es false.
Agregue el ensamblado de UDF a la lista de UDF de confianza para permitir que se pueda llamar a UDF desde un libro.

Para obtener más información acerca de cómo habilitar UDF y agregarlas a la lista de UDF de confianza, consulte Procedimiento para habilitar las UDF.

Nota

Para evitar conflictos de nombres, asigne nombres seguros a los ensamblados UDF y a sus dependencias. Procure que los nombres sean únicos. Para obtener más información, consulte Procedimientos recomendados de Excel Services y Problemas conocidos y sugerencias de Servicios de Excel.

Procedimiento

Para crear el archivo Manifest.xml

Haga clic con el botón secundario en el Explorador de soluciones, elija Agregar y, a continuación, haga clic en Nuevo elemento.
Seleccione Archivo XML y asigne el nombre Manifest.xml al archivo.
Haga clic en Agregar.

Agregue el contenido siguiente al archivo:

<?xml version="1.0" encoding="utf-8" ?>
<Solution xmlns="https://schemas.microsoft.com/sharepoint/" SolutionId="{57568687-2CC0-45bf-B66A-2D50D57108CA}" DeploymentServerType="ApplicationServer">
  <Assemblies>
    <Assembly DeploymentTarget="GlobalAssemblyCache" Location="EcsUdfsCommonSet.dll"/>
  </Assemblies>
</Solution>

Nota

Se debe generar un GUID único para cada solución. Para obtener más información sobre el elemento Solution, vea SharePoint FoundationSoluciones y paquetes de elementos web (https://msdn.microsoft.com/es-es/library/ms413687.aspx).

Para crear un paquete de soluciones

Para obtener información acerca de cómo crear el archivo de solución, consulte el tema "Crear una solución" bajo el nodo "Soluciones y paquetes de elementos web" en el SDK de SharePoint Foundation.

Para comprobar si se está ejecutando Administración de SharePoint Foundation

Haga clic en Inicio, elija Herramientas administrativas y, a continuación, haga doble clic en Servicios.

Aparece el cuadro de diálogo Servicios.
Asegúrese de que el estado del servicio Administración de SharePoint Foundation tenga el valor Iniciado. Si no existe, haga clic con el botón secundario en Administración de SharePoint Foundation y, a continuación, seleccione Iniciar.

Para agregar la solución

Haga clic en Inicio, Ejecutar y, luego, escriba cmd.

Aparece la consola del símbolo del sistema.
Ejecute el siguiente script para agregar la solución al servidor de SharePoint:

stsadm.exe -o addsolution -filename <rutadelCAB>

Nota

Puede encontrar Stsadm.exe en:

C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\BIN.

Nota

Para obtener más información acerca de las opciones del comando Stsadm.exe, vea el tema sobre la asignación de Stsadm a Windows PowerShell (SharePoint Foundation 2010) (https://technet.microsoft.com/es-es/library/ff621081.aspx).

Para implementar la solución

Haga clic en Inicio, Ejecutar y, luego, escriba cmd.

Aparece la consola del símbolo del sistema.
Ejecute el siguiente script para implementar la solución en el servidor de SharePoint:

stsadm.exe -o deploysolution -name <nombre del CAB> -immediate -allowGacDeployment

Ahora debería ver la DDL de UDF en la memoria caché de ensamblados global.