Partager via

Configurer des fonctions définies par l’utilisateur dans Excel Online dans Office Online Server

Utilisez des fonctions définies par l’utilisateur (UDF) dans Excel Online dans Office Online Server pour appeler des fonctions personnalisées.

Les fonctions définies par l’utilisateur (UDF) dans Excel Online vous permettent d’appeler des fonctions personnalisées écrites en code managé à l’aide de formules dans des cellules. Vous pouvez utiliser des fonctions définies par l’utilisateur pour :

  • Call custom mathematical functions.

  • Get data from custom data sources into worksheets.

  • Appelez les services web.

Vous pouvez installer des fichiers binaires UDF dans l’un des deux emplacements suivants :

  • Répertoire local. Par exemple :

    C:\UDFs\MySampleUdf.dll

  • Global Assembly Cache. Par exemple :

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

Référencez l’emplacement lorsque vous créez une définition New-OfficeWebAppsExcelUserDefinedFunction sur le Office Online Server.

Remarque

Office Online Server ne prend pas en charge les fonctions définies par l’utilisateur situées sur les partages réseau.

Activer les fonctions définies par l’utilisateur sur Office Online Server

Lorsqu’un administrateur crée une batterie de serveurs Office Web Apps Server à l’aide de l’applet de commande New-OfficeWebAppsFarm Windows PowerShell, les assemblys UDF sont désactivés par défaut. La valeur par défaut de l’indicateur ExcelUdfsAllowed est false.

Pour activer les fonctions définies par l’utilisateur, exécutez la commande Windows PowerShell suivante sur le Office Online Server, une fois la batterie de serveurs Office Web Apps Server créée.

Set-OfficeWebAppsFarm - ExcelUdfsAllowed:$true

Créer des définitions de fonctions définies par l’utilisateur sur Office Online Server

Après avoir activé les fonctions définies par l’utilisateur, vous devez créer une définition pour le fichier binaire qui contient les fonctions définies par l’utilisateur. Pour créer une définition pour votre fichier binaire UDF sur le Office Online Server, utilisez l’applet de commande New-OfficeWebAppsExcelUserDefinedFunction. Cette applet de commande inclut les paramètres suivants :

  • Assembly

  • AssemblyLocation

  • Activer (défini sur False par défaut)

  • Description

Les exemples suivants montrent comment créer les définitions de fonctions définies par l’utilisateur.

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"

Après avoir créé la référence UDF, exécutez iisreset sur le serveur pour récupérer immédiatement la référence.

Commandes Windows PowerShell UDF supplémentaires Office Online Server

Utilisez les applets de commande Windows PowerShell suivantes pour travailler avec les fonctions définies par l’utilisateur :

  • Get-OfficeWebAppsExcelUserDefinedFunction (aucun paramètre requis) : renvoie une liste de définitions de fonctions définies par l’utilisateur configurées sur le Office Online Server.

  • Set - OfficeWebAppsExcelUserDefinedFunction (paramètre d’identité requis) : définit les propriétés des définitions de fonctions définies par l’utilisateur existantes.

  • Remove-OfficeWebAppsExcelUserDefinedFunction (paramètre d’identité requis) : supprime les définitions UDF existantes.

Exemple de fonction définie par l’utilisateur

L’exemple de fichier suivant fournit un exemple de classeur qui utilise une fonction définie par l’utilisateur et le fichier binaire UDF :

Voir aussi