Configuración del entorno para el desarrollo de un objeto visual de Power BI
En este artículo, aprenderá a configurar el entorno para desarrollar un objeto visual de Power BI.
Antes de empezar a desarrollar, deberá instalar node.js y el paquete pbiviz. También necesitará crear e instalar un certificado. Una vez configurado el entorno local, deberá configurar el servicio Power BI para desarrollar un objeto visual de Power BI.
En este artículo, aprenderá a:
- Instalar nodes.js.
- Instalar pbiviz.
- Crear e instalar un certificado.
- Configurar el servicio Power BI para desarrollar un objeto visual.
- Instalar bibliotecas adicionales (necesarias para desarrollar un objeto visual).
Instalación de node.js
Node.js es un entorno de ejecución de JavaScript basado en la versión 8 del motor de JavaScript de Chrome. Permite a los desarrolladores ejecutar cualquier aplicación creada en JavaScript.
Para instalar Node.js, haga lo siguiente:
En un explorador web, vaya a Node.js.
Descargue el instalador MSI recomendado más reciente.
Ejecute al instalador y, después, siga los pasos de instalación. Acepte los términos del contrato de licencia y todos los valores predeterminados.
Reinicie el equipo.
Instalación de pbiviz
La herramienta pbiviz, que se escribe con JavaScript, compila el código de origen del objeto visual del paquete pbiviz.
El paquete pbiviz es un proyecto de objeto visual de Power BI comprimido, con todos los scripts y recursos necesarios.
Abra Windows PowerShell y escriba el comando siguiente para instalar pbiviz.
npm i -g powerbi-visuals-tools
Nota
Es posible que reciba algunas advertencias al ejecutar este comando. No deben impedir la instalación de pbiviz.
Creación e instalación de un certificado
Para que un cliente (su equipo) y un servidor (el servicio Power BI) interactúen de forma segura, se requiere un certificado de Capa de sockets seguros (SSL). Sin un certificado para garantizar la seguridad de las interacciones, el explorador las bloqueará.
Este proceso describe la ejecución de un comando de PowerShell que inicia el Asistente para la importación de certificados. Siga los pasos que se indican a continuación para configurar el certificado en el asistente.
Importante
No cierre la ventana de PowerShell durante este procedimiento.
Abra Windows PowerShell y escriba el comando siguiente.
pbiviz --install-cert
Este comando hace dos cosas:
- Devuelve una frase de contraseña. En este caso, la frase de contraseña es 9765328806094.
- También inicia el Asistente para importar certificados.
Nota:
- Si no tiene permiso para ejecutar pbiviz, inicie PowerShell como administrador y ejecute el comando
Set-ExecutionPolicy RemoteSigned
; después, vuelva a intentarlo. - Si el Asistente para importar certificados no se abre automáticamente, vaya a la ubicación del certificado en Explorador de archivos, haga clic con el botón derecho en él y seleccione Instalar.
En el Asistente para importar certificados, compruebe que la ubicación del almacén se establece en el usuario actual y seleccione Siguiente.
En la ventana Archivo para importar, seleccione Siguiente.
En la ventana Protección de clave privada, en el cuadro de texto Contraseña, pegue la frase de contraseña que recibió al ejecutar el comando de PowerShell (paso 1) y seleccione Siguiente. En este ejemplo, la frase de contraseña es 9765328806094.
En la ventana Almacén de certificados, seleccione la opción Colocar todos los certificados en el siguiente almacén y seleccione Examinar.
En la ventana Seleccionar almacén de certificados, seleccione Entidades de certificación raíz de confianza y luego seleccione Aceptar.
Seleccione Siguiente en la ventana Almacén de certificados.
En la ventana Finalización del Asistente para importación de certificados, compruebe la configuración y seleccione Finalizar.
Nota
Si recibe una advertencia de seguridad, seleccione Sí.
(Opcional) Comprobación de que el entorno está configurado
Confirme que el paquete de herramientas de objetos visuales de Power BI está instalado. En PowerShell, ejecute el comando pbiviz
y revise la salida, incluida la lista de comandos admitidos.
Configuración del servicio Power BI para desarrollar un objeto visual
Para desarrollar un objeto visual de Power BI, deberá habilitar la depuración de objetos visuales personalizados en el servicio Power BI. Siga las instrucciones de esta sección para habilitar esta opción.
Inicie sesión en PowerBI.com.
Vaya a Configuración>Configuración>Configuración.
En la pestaña General, seleccione Desarrollador. En la configuración Desarrollador, active la casilla Habilitar modo de desarrollador y, después, seleccione Aplicar.
Instalación de bibliotecas de desarrollo
Para desarrollar su propio objeto visual de Power BI, deberá instalar bibliotecas adicionales. En esta sección se describe cómo instalar estas bibliotecas y comprobar que la instalación se ha realizado correctamente.
Para instalar las bibliotecas enumeradas en este artículo, abra PowerShell y escriba el comando de instalación de cada componente.
Nota
Una vez que estas bibliotecas estén instaladas en el equipo, podrá usarlas para cualquier proyecto de objetos visuales de Power BI. Se trata de un procedimiento de instalación que se lleva a cabo una sola vez por máquina.
Biblioteca de JavaScript D3
D3 es una biblioteca de JavaScript para producir visualizaciones de datos dinámicos e interactivos en exploradores web. Se basa los estándares ampliamente implementados Scalable Vector Graphics (SVG), HTML5 y CSS.
npm i d3@^5.0.0 --save
Definiciones de TypeScript
Instale las definiciones de TypeScript para poder desarrollar el objeto visual de Power BI en TypeScript, un superconjunto de JavaScript.
npm i @types/d3@^5.0.0 --save
core-js
core-js es una biblioteca estándar modular para JavaScript que incluye polyfill para ECMAScript.
npm i core-js@3.2.1 --save
powerbi-visual-api
Instale las definiciones de la API de objetos visuales de Power BI.
npm i powerbi-visuals-api --save-dev
(Opcional) Comprobación de que la biblioteca D3 está instalada
Visual Studio Code (VS Code) es un entorno de desarrollo integrado (IDE) ideal para desarrollar aplicaciones TypeScript. En esta sección, usaremos VS Code para comprobar que la biblioteca D3 que necesita para desarrollar el objeto visual de Power BI está correctamente instalada.
Nota
En el proceso de comprobación descrito en esta sección se supone que ya tiene un proyecto de objetos visuales de Power BI. Si no tiene un proyecto de objetos visuales de Power BI, puede crear uno siguiendo las instrucciones de creación de proyectos de Circle Card.
Abra VS Code.
Sugerencia
Puede abrir VS Code desde PowerShell ejecutando el comando siguiente desde dentro de la carpeta del proyecto:
code .
En VS Code, abra el menú Archivo y seleccione Abrir carpeta.
En la ventana Abrir carpeta, seleccione la carpeta que contiene el proyecto de objetos visuales de Power BI y, a continuación, seleccione Seleccionar carpeta.
En el panel Explorador, expanda la carpeta node_modules para comprobar que la biblioteca D3 se ha instalado.
En el panel Explorador , expanda node_modules >@types> d3 y compruebe que el archivo index.t.ds está instalado.