Partager via

Définir la clé Bing Cartes au niveau du web et de la batterie de serveurs dans SharePoint

  • Article

Rubrique de procédure

Découvrez comment définir la Bing Cartes clé par programmation au niveau du web (SharePoint Server et SharePoint Online) et de la batterie de serveurs (SharePoint Server) à l’aide du modèle objet client SharePoint et de la Windows PowerShell, pour activer la fonctionnalité Bing Cartes dans les listes SharePoint et les applications web et mobiles basées sur l’emplacement.

Conditions requises pour la définition de la clé Bing Maps

Pour suivre les étapes décrites dans cet exemple, vous devez disposer des éléments suivants :

Importante

[!IMPORTANTE] Veuillez noter que vous êtes responsable de la conformité avec les termes et conditions applicables à votre utilisation de la clé Bing Maps et les informations nécessaires à fournir aux utilisateurs de votre application en matière de données transmises au service Bing Maps.

Remarque

PnP PowerShell est une solution open source pour laquelle un support est assuré par la communauté active. Il n’existe pas de contrat SLA Microsoft pour le support technique relatif à cet outil open source.

Exemple de code : définissez la clé cartes Bing au niveau de la batterie de serveurs ou web

La clé Bing Maps peut être définie au niveau de la batterie de serveurs ou web. Pour définir la clé Bing Cartes au niveau de la batterie de serveurs, vous avez besoin de droits d’administrateur sur le serveur ; vous pouvez ensuite ajouter la clé à l’aide de SharePoint Management Shell. Pour définir la clé Bing Cartes au niveau du web, écrivez une application console qui utilise le modèle objet client SharePoint ou utilisez SharePoint PnP PowerShell.

Conseil

[!CONSEIL] La clé Bing Maps définie au niveau web a un ordre de priorité supérieur à celle de la clé Bing Maps définie au niveau de la batterie de serveurs.

Pour définir la clé cartes Bing au niveau de la batterie de serveurs à l'aide de Windows PowerShell

  1. Connectez-vous au serveur SharePoint en tant qu’administrateur et ouvrez SharePoint Management Shell.

  2. Exécutez la commande suivante :

    Set-SPBingMapsKey -BingKey "<Enter a valid Bing Maps key>"

    La clé Bing Cartes est désormais définie au niveau de la batterie de serveurs dans SharePoint.

Remarque

[!REMARQUE] Lorsque vous utilisez Windows PowerShell, la clé Bing Maps peut être définie uniquement au niveau de la batterie. Si vous souhaitez définir la clé cartes Bing au niveau du web, vous pouvez définir la clé par un programme, comme illustré dans la section suivante.

Pour définir la clé Bing Cartes au niveau web avec SharePoint PnP PowerShell

  1. Ouvrez l’outil SharePoint Online Management Shell
  2. Se connecter au site que vous souhaitez ajouter/mettre à jour la clé Bing Cartes
Connect-PnPOnline -url "https://TENANT.sharepoint.com/sites/SITEURL"
  1. Ajoutez la clé Bing Cartes au conteneur de propriétés du site (mettez à jour « YOURKEYVALUE »)
Set-PnPPropertyBagValue -Key "BING_MAPS_KEY" -Value "YOURKEYVALUE"
  1. Si vous recevez une erreur concernant l’activation de NoScript, vous devez la désactiver sur le site. Réexécutez ensuite l’étape 3.
Set-PnPSite -NoScriptSite $false

Remarque

Veillez à comprendre les implications de la modification de la stratégie NoScript d’un site - Autoriser ou empêcher le script personnalisé.

Pour définir la clé Bing Cartes au niveau de la batterie ou du web à l’aide du modèle objet client avec Visual Studio

  1. Démarrez Visual Studio.

  2. Dans la barre de menus, choisissez fichier, Nouveau projet. La boîte de dialogue Nouveau projet s'ouvre.

  3. Dans la boîte de dialogue Nouveau projet, sélectionnez Visual C# dans la zone Modèles installés, puis le modèle Application Console.

  4. Nommez le projet, puis cliquez sur le bouton OK.

  5. Visual Studio crée le projet. Ajoutez une référence aux assemblys suivants et cliquez sur OK.

  • Microsoft.SharePoint.Client.dll
  • Microsoft.SharePoint.Client.Runtime.dll

  1. Dans le fichier .cs par défaut, ajoutez une directive using comme suit. using Microsoft.SharePoint.Client;

  2. Ajoutez le code suivant à la méthode Main dans le fichier .cs.


class Program
    {
        static void Main(string[] args)
        {
            SetBingMapsKey();
            Console.WriteLine("Bing Maps set successfully");
        }
     static private void SetBingMapsKey()
        {

            ClientContext context = new ClientContext("<Site Url>");
            Web web = context.Web;
            web.AllProperties["BING_MAPS_KEY"] = "<Valid Bing Maps Key>"
            web.Update();
            context.ExecuteQuery();
        }
    }
  1. Remplacez l’URL du site et <la clé> Bing Cartes valide par des valeurs valides.<>
  2. Définir le framework cible dans les propriétés du projet en tant que .NET Framework 4.0 et exécuter l'exemple.
  3. La clé doit maintenant être définie au niveau du web.

Étapes suivantes

Pour en savoir plus sur l’utilisation des fonctionnalités de localisation et de carte dans SharePoint, consultez les rubriques suivantes :