Поделиться через

Настройка ключа службы "Карты Bing" в SharePoint на уровне фермы и веб-сайта

Раздел

Узнайте, как программно задать ключ Карты Bing в Интернете (SharePoint Server и SharePoint Online) и на уровне фермы (SharePoint Server) с помощью клиентской объектной модели и Windows PowerShell SharePoint, чтобы включить функциональность Карты Bing в списках SharePoint и веб-приложениях на основе расположения и мобильных приложениях.

Необходимые условия для установки ключ Bing Maps

Для выполнения действия, описанные в этом примере, необходимо иметь следующее:

Важно!

[!Важно!] Обратите внимание, что вы несете ответственность за соблюдение сроками и условиями, которые применяются к использованию ключ Bing Maps и все необходимые условия для пользователей приложения о данных, передаваемых службы Bing Maps.

Примечание.

PnP PowerShell — это решение с открытым исходным кодом, поддержка которого предоставляется активным сообществом. Для инструментов с открытым исходным кодом не существует соглашения об уровне обслуживания в отношении поддержки корпорацией Майкрософт.

Пример кода: задать ключ карт Bing на уровне фермы или веб-узел

Ключ Карты Bing можно задать на уровне фермы или веб-сайта. Чтобы задать ключ Карты Bing на уровне фермы, вам потребуются права администратора на сервере. Затем вы можете добавить ключ с помощью командной консоли SharePoint. Чтобы задать ключ Карты Bing на веб-уровне, напишите консольное приложение, использующее клиентную объектную модель SharePoint, или используйте SharePoint PnP PowerShell.

Совет

[!Совет] Установка на уровне веб-ключ Bing Maps имеет высокий приоритет, чем ключ карт Bing на уровне фермы.

Чтобы задать ключ карт Bing на уровне фермы, с помощью Windows PowerShell

  1. Войдите на сервер SharePoint с правами администратора и откройте командную консоль SharePoint.

  2. Выполните следующую команду:

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

    Ключ Карты Bing теперь задается на уровне фермы в SharePoint.

Примечание.

[!Примечание] При использовании Windows PowerShell ключ Bing Maps можно задать только на уровне фермы. Если вы хотите задать ключ карт Bing на уровне веб-, можно установить ключ программно, как показано в следующем разделе.

Установка ключа Карты Bing на веб-уровне с помощью SharePoint PnP PowerShell

  1. Откройте командную консоль SharePoint Online
  2. Подключение к сайту, который требуется добавить или обновить ключ Карты Bing
Connect-PnPOnline -url "https://TENANT.sharepoint.com/sites/SITEURL"
  1. Добавьте ключ Карты Bing в контейнер свойств сайта (обновление "YOURKEYVALUE")
Set-PnPPropertyBagValue -Key "BING_MAPS_KEY" -Value "YOURKEYVALUE"
  1. Если появляется сообщение об ошибке, связанной с включением NoScript, ее необходимо отключить на сайте. Затем повторно выполните шаг 3.
Set-PnPSite -NoScriptSite $false

Примечание.

Убедитесь, что вы понимаете последствия изменения политики NoScript сайта — разрешить или запретить настраиваемый скрипт.

Установка ключа Карты Bing на уровне фермы или веб-сайта с помощью клиентской объектной модели в Visual Studio

  1. Запустите Visual Studio.

  2. В строке меню щелкните файл, Создать проект. Откроется диалоговое окно Новый проект.

  3. В диалоговом окне Создать проект выберите пункт C# в поле Установленные шаблоны и затем выберите шаблон Консольное приложение.

  4. Назовите проект и затем нажмите кнопку ОК.

  5. Visual Studio создает проект. Добавление ссылки на следующие сборки и нажмите кнопку ОК.

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

  1. В файле .cs по умолчанию добавьте директиву using следующим образом. using Microsoft.SharePoint.Client;

  2. Добавьте следующий код в метод Main в 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. Замените <URL-адрес> сайта и <Допустимый ключ> Карты Bing допустимыми значениями.
  2. Требуемая версия .NET framework, заданные в свойствах проекта как .NET Framework 4.0 и запустите пример.
  3. Ключ необходимо задать теперь на уровне веб.

Дальнейшие действия

Дополнительные сведения о работе с функциями расположения и сопоставления в SharePoint см. в следующих статьях: