Definir a chave do Bing Maps no nível da web e do farm no SharePoint
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:
- SharePoint – com privilégios administrativos no nível da coleção de sites do FARM OR
- Shell de Gerenciamento do SharePoint Online – https://www.microsoft.com/download/details.aspx?id=35588
- SharePoint Online PnP PowerShell - https://github.com/SharePoint/PnP-PowerShell/
- Visual Studio 2010 ou posterior
- Uma chave de Bing Mapas válida, que você pode obter do Bing Mapas Account Center.
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
Faça logon no servidor do SharePoint como administrador e abra o Shell de Gerenciamento do SharePoint.
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
- Abra o Shell de Gerenciamento do SharePoint Online
- Conectar-se ao site que você deseja adicionar/atualizar a chave Bing Mapas
Connect-PnPOnline -url "https://TENANT.sharepoint.com/sites/SITEURL"
- Adicione a chave Bing Mapas ao saco de propriedades do site (atualizar "YOURKEYVALUE")
Set-PnPPropertyBagValue -Key "BING_MAPS_KEY" -Value "YOURKEYVALUE"
- 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
Inicie o Visual Studio.
Na barra de menus, escolha arquivo, Novo projeto. Abre a caixa de diálogo Novo projeto.
Na caixa de diálogo Novo projeto, escolha c# na caixa Modelos instalados e, em seguida, escolha o modelo de Aplicativo de Console.
Dê um nome de projeto e escolha o botão OK.
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
No arquivo. cs padrão, adicione uma diretiva de using da seguinte maneira.
using Microsoft.SharePoint.Client;
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();
}
}
- Substitua a Url> do <Site e <a Chave> de Bing Mapas Válida por valores válidos.
- Definir a estrutura de destino nas propriedades do projeto como o .NET Framework 4.0 e executar o exemplo.
- 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: