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

Rubrique de procédure

Découvrez comment définir la clé Bing Cartes par programme au niveau du web (SharePoint Server et SharePoint Online) et de la batterie (SharePoint Server) à l’aide du modèle objet client SharePoint et du 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 :

  • SharePoint - avec des privilèges d’administration au niveau de la batterie ou de la collection de sites
  • SharePoint Online Management Shell : https://www.microsoft.com/download/details.aspx?id=35588
  • SharePoint PowerShell PnP en ligne -https://github.com/SharePoint/PnP-PowerShell/
  • Visual Studio 2010 ou ultérieure
  • Une clé Bing Maps valide, que vous pouvez obtenir à partir de la Bing Maps Account Center.

Important

[!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.

Notes

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 web, écrivez une application console qui utilise le modèle objet client SharePoint ou tirez parti SharePoint PowerShell PnP.

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 SharePoint en tant qu’administrateur et ouvrez l’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.

Notes

[!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 PowerShell PnP

  1. Ouvrez l’outil SharePoint Online Management Shell
  2. Connecter au site que vous souhaitez ajouter/mettre à jour la Bing Cartes clé
Connect-PnPOnline -url "https://TENANT.sharepoint.com/sites/SITEURL"
  1. Ajouter la Bing Cartes au sac des propriétés du site (mettre à jour « YOURKEYVALUE »)
Set-PnPPropertyBagValue -Key "BING_MAPS_KEY" -Value "YOURKEYVALUE"
  1. Si vous recevez une erreur concernant l’activé de NoScript, vous devez le désactiver dans le site. Réexécutez ensuite l’étape 3.
Set-SPOsite <SiteURL> -DenyAddAndCustomizePages 0

Notes

Assurez-vous de comprendre les implications de la modification de la stratégie NoScript d’un site : autoriser ou empêcher les scripts personnalisés.

Pour définir la clé Bing Cartes au niveau de la batterie de serveurs 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. Replace the and with valid values.
  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’working with location and map functionality in SharePoint, consultez les informations suivantes :