Llegeix en anglès

Comparteix a través de

Configuración de UDF en Excel Online en Office Online Server

  • Article

Use funciones definidas por el usuario (UDF) en Excel Online en Office Online Server para llamar a funciones personalizadas.

Las funciones definidas por el usuario (UDF) en Excel Online permiten llamar a funciones personalizadas escritas en código administrado mediante fórmulas en celdas. Puede usar UDF para:

  • Llamar a funciones matemáticas personalizadas.

  • Obtener datos de orígenes de datos personalizados en hojas de cálculo.

  • Llame a servicios web.

Puede instalar archivos binarios de UDF en una de las dos ubicaciones:

  • Un directorio local. Por ejemplo:

    C:\UDFs\MySampleUdf.dll

  • Caché global de ensamblados. Por ejemplo:

    CompanyName.Hierarchichal.MyUdfNamespace.MyUdfClassName.dll, Version=1.1.0.0, Culture=en, PublicKeyToken=e8123117d7ba9ae38

Haga referencia a la ubicación al crear una definición New-OfficeWebAppsExcelUserDefinedFunction en el Office Online Server.

Nota

Office Online Server no admite UDF ubicadas en recursos compartidos de red.

Habilitación de UDF en Office Online Server

Cuando un administrador crea una nueva granja de servidores de Office Web Apps Server mediante el cmdlet New-OfficeWebAppsFarm Windows PowerShell, los ensamblados UDF se deshabilitan de forma predeterminada. El valor predeterminado de la marca ExcelUdfsAllowed es false.

Para habilitar las UDF, ejecute el siguiente comando de Windows PowerShell en el Office Online Server, una vez creada la granja de servidores de Office Web Apps Server.

Set-OfficeWebAppsFarm - ExcelUdfsAllowed:$true

Creación de definiciones de UDF en Office Online Server

Después de habilitar las UDF, debe crear una definición para el binario que contiene las UDF. Para crear una definición para el binario UDF en el Office Online Server, use el cmdlet New-OfficeWebAppsExcelUserDefinedFunction. Este cmdlet incluye los parámetros siguientes:

  • Ensamblado

  • AssemblyLocation

  • Habilitar (se establece en False de forma predeterminada)

  • Descripción

En los ejemplos siguientes se muestra cómo crear las definiciones de UDF.

New-OfficeWebAppsExcelUserDefinedFunction -Assembly c:\myudf.dll -AssemblyLocation LocalFile -Enable:$true -Description "My Server UDFs"

New-OfficeWebAppsExcelUserDefinedFunction -Assembly "CompanyName.Hierarchichal.MyUdfNamespace.MyUdfClassName.dll, Version=1.1.0.0, Culture=en, PublicKeyToken=e8123117d7ba9ae38" -AssemblyLocation GAC -Enable:$true -Description "My GAC Server UDFs"

Después de crear la nueva referencia de UDF, ejecute iisreset en el servidor para seleccionar la referencia inmediatamente.

Comandos de Windows PowerShell udf de Office Online Server adicionales

Use los siguientes cmdlets de Windows PowerShell para trabajar con UDF:

  • Get-OfficeWebAppsExcelUserDefinedFunction (sin parámetros necesarios): devuelve una lista de definiciones de UDF configuradas en el Office Online Server.

  • Set- OfficeWebAppsExcelUserDefinedFunction (se requiere el parámetro Identity): establece las propiedades en las definiciones de UDF existentes.

  • Remove-OfficeWebAppsExcelUserDefinedFunction (se requiere el parámetro Identity): quita las definiciones de UDF existentes.

Ejemplo de UDF

El siguiente archivo de ejemplo proporciona un libro de ejemplo que usa una UDF y el binario udf:

Vea también