Establecer la tecla de mapas de Bing a nivel de web y de granja en SharePoint

  • Artículo

Tema de procedimiento

Obtenga información sobre cómo establecer la clave de mapas de Bing mediante programación en el nivel web (SharePoint Server y SharePoint Online) y granja (SharePoint Server) mediante el modelo de objetos de cliente de SharePoint y Windows PowerShell, para habilitar la funcionalidad de mapas de Bing en listas de SharePoint y aplicaciones web y móviles basadas en ubicación.

Requisitos previos para configurar la clave de Mapas de Bing

Para poder seguir los pasos de este ejemplo, es necesario lo siguiente:

Importante

[!IMPORTANTE] Tenga en cuenta que usted es el responsable del cumplimiento de los términos y condiciones aplicables al uso de la clave de Mapas de Bing y de toda divulgación necesaria a los usuarios de su aplicación en cuanto a los datos pasados al servicio Mapas de Bing.

Nota:

PnP PowerShell es una solución de código abierto con una comunidad activa que ofrece su soporte. No hay ningún contrato de nivel de servicio para el soporte de la herramienta de código abierto de Microsoft.

Ejemplo de código: Configurar la clave de Mapas de Bing en el nivel de web o de granja de servidores

La clave de mapas de Bing se puede establecer en el nivel de granja o web. Para establecer la clave de mapas de Bing en el nivel de granja de servidores, necesita derechos de administrador en el servidor; a continuación, puede agregar la clave mediante el Shell de administración de SharePoint. Para establecer la clave de mapas de Bing en el nivel web, escriba una aplicación de consola que use el modelo de objetos de cliente de SharePoint o aproveche SharePoint PnP PowerShell.

Sugerencia

La clave de Mapas de Bing configurada en el nivel de web tiene preferencia sobre la configurada en el nivel de granja de servidores.

Para configurar la clave de Mapas de Bing en el nivel de granja de servidores con Windows PowerShell

  1. Inicie sesión en el servidor de SharePoint como administrador y abra el Shell de administración de SharePoint.

  2. Use el comando siguiente:

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

    La clave mapas de Bing ahora se establece en el nivel de granja de servidores en SharePoint.

Nota:

[!NOTA] Cuando usa Windows PowerShell, la clave de Mapas de Bing solo se puede configurar en el nivel de granja de servidores. Si desea configurar la clave en el nivel de web, puede hacerlo mediante programación tal como se muestra en la sección siguiente.

Para establecer la clave de mapas de Bing en el nivel web con PowerShell PnP de SharePoint

  1. Abra el Shell de administración de SharePoint Online
  2. Conéctese al sitio que desea agregar o actualizar la clave de mapas de Bing
Connect-PnPOnline -url "https://TENANT.sharepoint.com/sites/SITEURL"
  1. Agregue la clave mapas de Bing al contenedor de propiedades del sitio (actualice "YOURKEYVALUE")
Set-PnPPropertyBagValue -Key "BING_MAPS_KEY" -Value "YOURKEYVALUE"
  1. Si recibe un error relacionado con la habilitación de NoScript, debe deshabilitarlo en el sitio. A continuación, vuelva a ejecutar el paso 3.
Set-PnPSite -NoScriptSite $false

Nota:

Asegúrese de comprender las implicaciones de cambiar la directiva de NoScript de un sitio: permitir o impedir scripts personalizados.

Para establecer la clave de mapas de Bing en el nivel de granja o web mediante el modelo de objetos de cliente con Visual Studio

  1. Inicie Visual Studio.

  2. En la barra de menús, seleccione Archivo, Nuevo proyecto. Se abrirá el cuadro de diálogo Nuevo proyecto.

  3. En el cuadro de diálogo Nuevo proyecto, elija C# en el cuadro Plantillas instaladas y, después, escoja la plantilla Aplicación de consola.

  4. Dé un nombre al proyecto y haga clic en el botón Aceptar.

  5. Visual Studio crea el proyecto. Agregue una referencia a los siguientes ensamblados y haga clic en Aceptar.

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

  1. En el archivo .cs predeterminado, agregue una directiva using del siguiente modo. using Microsoft.SharePoint.Client;

  2. Agregue el código siguiente al método Main del archivo .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. Reemplace la dirección URL> del <sitio y <la clave> de mapas de Bing válida por valores válidos.
  2. Configure el marco de trabajo de destino en Propiedades del proyecto como .NET Framework 4.0 y ejecute el ejemplo.
  3. La clave debería estar configurada en el nivel de web.

Pasos siguientes

Para obtener más información sobre cómo trabajar con la funcionalidad de ubicación y asignación en SharePoint, consulte lo siguiente: