Share via

Definir a chave do Bing Maps no nível da web e do farm no SharePoint

  • Artigo

Tópico de tutorial

Saiba como definir a chave Bing Mapas programaticamente no nível web (SharePoint Server e SharePoint Online) e farm(SharePoint Server) usando o modelo de objeto cliente do SharePoint e Windows PowerShell, para habilitar a funcionalidade Bing Mapas em listas do SharePoint e aplicativos web e móveis baseados em localização.

Pré-requisitos para definir a chave do Bing Maps

Para executar as etapas neste exemplo, você deve ter o seguinte:

Importante

[!IMPORTANTE] Observe que você é responsável pela conformidade com os termos e condições aplicáveis ao seu uso da chave Bing Maps e qualquer comunicados necessários aos usuários do seu aplicativo referente dados passados para o serviço Bing Maps.

Observação

O PnP PowerShell é uma solução de software livre com uma comunidade ativa de suporte. Não há nenhuma SLA para o suporte da ferramenta de software livre por parte da Microsoft.

Exemplo de código: definir a chave do Bing Maps em nível de farm ou web

A chave Bing Mapas pode ser definida no nível do farm ou da Web. Para definir a chave Bing Mapas no nível do farm, você precisa de direitos de administrador no servidor; em seguida, você pode adicionar a chave usando o Shell de Gerenciamento do SharePoint. Para definir a chave Bing Mapas no nível da Web, escreva um aplicativo de console que use o modelo de objeto cliente do SharePoint ou aproveite o PowerShell PnP do SharePoint.

Dica

[!DICA] A chave do Bing Maps definida no nível da web tem a ordem de precedência mais alta que a chave do Bing Maps definidas no nível do farm.

Para definir a chave do Bing Maps em nível de farm usando o Windows PowerShell

  1. Faça logon no servidor do SharePoint como administrador e abra o Shell de Gerenciamento do SharePoint.

  2. Execute o seguinte comando:

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

    A chave Bing Mapas agora está definida no nível do farm no SharePoint.

Observação

[!OBSERVAçãO] Quando você usa Windows PowerShell, a chave Bing Maps pode ser definida somente no nível do farm. Se você deseja definir a chave Bing Maps no nível da web, você pode definir a chave programaticamente, conforme mostrado na seção a seguir.

Para definir a chave Bing Mapas no nível da Web com o PowerShell PnP do SharePoint

  1. Abra o Shell de Gerenciamento do SharePoint Online
  2. Conectar-se ao site que você deseja adicionar/atualizar a chave Bing Mapas
Connect-PnPOnline -url "https://TENANT.sharepoint.com/sites/SITEURL"
  1. Adicione a chave Bing Mapas ao saco de propriedades do site (atualizar "YOURKEYVALUE")
Set-PnPPropertyBagValue -Key "BING_MAPS_KEY" -Value "YOURKEYVALUE"
  1. Se você receber um erro em relação à habilitação do NoScript, deverá desabilitá-lo no site. Em seguida, execute novamente a etapa 3.
Set-PnPSite -NoScriptSite $false

Observação

Verifique se você entende as implicações da alteração da Política NoScript de um site – Permitir ou impedir script personalizado.

Para definir a chave Bing Mapas no farm ou no nível da Web usando o modelo de objeto cliente com o Visual Studio

  1. Inicie o Visual Studio.

  2. Na barra de menus, escolha arquivo, Novo projeto. Abre a caixa de diálogo Novo projeto.

  3. Na caixa de diálogo Novo projeto, escolha c# na caixa Modelos instalados e, em seguida, escolha o modelo de Aplicativo de Console.

  4. Dê um nome de projeto e escolha o botão OK.

  5. Visual Studio cria o projeto. Adicione uma referência para os seguintes assemblies e escolha OK.

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

  1. No arquivo. cs padrão, adicione uma diretiva de using da seguinte maneira. using Microsoft.SharePoint.Client;

  2. Adicione o seguinte código para o método Main no arquivo. 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. Substitua a Url> do <Site e <a Chave> de Bing Mapas Válida por valores válidos.
  2. Definir a estrutura de destino nas propriedades do projeto como o .NET Framework 4.0 e executar o exemplo.
  3. Agora, a chave deve ser definida no nível da web.

Próximas etapas

Para saber mais sobre como trabalhar com a funcionalidade de localização e mapa no SharePoint, confira o seguinte: