Documentos de Académico
Documentos de Profesional
Documentos de Cultura
División de Tecnología
Subgerencia de Arquitectura
2020/08/20
TABLA DE CONTENIDO
1 Control del Documento .......................................................................................................................... 3
1.1 Acerca del Documento .................................................................................................................. 3
1.2 Público Objetivo ............................................................................................................................. 3
1.3 Historia de Cambios ...................................................................................................................... 3
1.4 Revisiones ..................................................................................................................................... 3
1.5 Referencias.................................................................................................................................... 4
2 Introducción ........................................................................................................................................... 5
2.1 Objetivo.......................................................................................................................................... 5
2.2 Alcance .......................................................................................................................................... 5
3 Conceptos Básicos ................................................................................................................................ 6
3.1 Glosario ......................................................................................................................................... 6
4 Lineamientos ......................................................................................................................................... 7
4.1 Acceso al sistema .......................................................................................................................... 7
4.2 Permisos del sistema .................................................................................................................... 7
4.2.1 Definición de permisos .......................................................................................................... 7
4.3 Diseño ............................................................................................................................................ 7
4.4 Desarrollo ...................................................................................................................................... 8
4.4.1 Nombramiento Servicio TNSNames en servidor de DataGateway ....................................... 9
4.4.2 VNET (Virtual Network) Data gateway: ............................................................................... 10
4.4.3 Workspace ........................................................................................................................... 10
4.4.4 Canalizaciones (pipeline) - Esquema tradicional de TI – Capacidad Premium .................. 10
4.4.5 Datasets ............................................................................................................................... 11
4.4.6 Nombramiento Informes ...................................................................................................... 11
4.4.7 Versionamiento .................................................................................................................... 11
4.4.8 Roles relacionados con Power BI ........................................................................................ 12
4.4.9 Modelo de Versionamiento y Despliegue Automático ......................................................... 14
4.5 Adquisición de licencias .............................................................................................................. 15
SAT-LIN008-Power BI.docx 2 de 15
1 CONTROL DEL DOCUMENTO
El presente documento brinda las bases y lineamientos a considerar para el uso de Power BI.
• Todos aquellos usuarios del negocio que requieran representar de manera gráfica información en
dashboard, para la toma de decisiones, optimizando así la estrategia corporativa.
1.4 Revisiones
Versión Revisado por Cargo/Área Fecha
1.0 Carlos David Bernal Pérez Arquitecto de Estrategia – Subgerencia de 2020/09/17
Arquitectura
1.1 Carlos David Bernal Pérez Arquitecto de Estrategia – Subgerencia de 2021/01/20
Arquitectura
1.2 Carlos David Bernal Pérez Arquitecto de Estrategia – Subgerencia de 2021/05/05
Arquitectura
1.3 Carlos David Bernal Pérez Arquitecto de Estrategia – Subgerencia de 2021/05/21
Arquitectura
1.4 Carlos David Bernal Pérez Arquitecto de Estrategia – Subgerencia de 2021/08/03
Arquitectura
1.5 Carlos David Bernal Pérez Arquitecto de Estrategia – Subgerencia de 2021/09/23
Arquitectura
1.6 Carlos David Bernal Pérez Arquitecto de Estrategia – Subgerencia de 2022/01/13
Arquitectura
1.7 Carlos David Bernal Pérez Arquitecto de Estrategia – Subgerencia de 2022/05/17
Arquitectura
SAT-LIN008-Power BI.docx 3 de 15
1.8 Brandondyg Chamorro Anzola Analista de Desarrollo – Subgerencia de 2022/06/10
Arquitectura
1.5 Referencias
Título del Documento Ubicación en SharePoint Subgerencia de Arquitectura
Lineamientos Power BI ../01.Gobierno/06.Lineamientos/ SAT-LIN008-Power BI
Arquitectura de Referencia Power BI ../01.Gobierno/03.Definiciones/SAT-DEF002-Arquitectura de Referencia
Power BI
Mejores Prácticas Power BI ../01.Gobierno/03.Definiciones/SAT-DEF004-Mejores Prácticas Power BI
Administración de Power BI ../01.Gobierno/06.Lineamientos/ SAT-LIN009-Administración de Power BI
Prueba de Concepto Power BI ../01.Gobierno/06.Lineamientos/ SAT-LIN008-Anexo Prueba de Concepto
Power BI
Informes y Datasets Independientes Informes independientes de los modelos en Power BI Desktop
VNET (Virtual Network) Datagateway https://docs.microsoft.com/en-us/data-integration/vnet/overview
SAT-LIN008-Power BI.docx 4 de 15
2 INTRODUCCIÓN
2.1 Objetivo
2.2 Alcance
El presente documento brinda las bases y lineamientos a considerar para el uso de Power BI y sus
componentes.
SAT-LIN008-Power BI.docx 5 de 15
3 CONCEPTOS BÁSICOS
3.1 Glosario
Áreas de Trabajo (Workspaces): Las áreas de trabajo son lugares de colaboración con compañeros en
contenido específico. Los diseñadores de Power BI crean las áreas de trabajo para incluir colecciones de
paneles e informes. Todos los usuarios que usan el servicio Power BI tienen, un espacio denominado Mi
área de trabajo (My Workspace). Mi área de trabajo es su espacio aislado personal donde se puede crear
contenido.
Direct Query: es una conexión directa a la base de datos. Los datos no se importan a Power BI, siempre
estarán en el origen de datos.
On-Premises Data Gateway: La puerta de enlace de datos local actúa como un puente para proporcionar
una transferencia de datos rápida y segura entre los datos locales (datos que no están en la nube) y varios
servicios en la nube de Microsoft.
Power BI: Power BI es una colección de servicios de software, aplicaciones y conectores que funcionan
conjuntamente para convertir orígenes de datos sin relación entre sí en información coherente, interactiva
y atractiva visualmente. Sus datos pueden ser una hoja de cálculo de Excel o una colección de almacenes
de datos híbridos locales y basados en la nube. Power BI permite conectarse con facilidad a los orígenes
de datos, visualizar y descubrir qué es importante y compartirlo con cualquiera o con todos los usuarios
que desee.
Power Query: Power Query es una tecnología de conexión de datos que permite detectar, conectar,
combinar y refinar orígenes de datos para satisfacer necesidades de análisis. Las características de Power
Query están disponibles en Excel y Power BI Desktop.
VNET (Virtual Network) Datagateway: La puerta de enlace de datos de red virtual (VNet) le ayuda a
conectarse desde Servicios en la nube de Microsoft a sus servicios de datos de Azure dentro de una red
virtual sin la necesidad de una puerta de enlace de datos local. La puerta de enlace de datos de VNet se
comunica de forma segura con origen de datos, ejecuta consultas y transmite los resultados al servicio.
SAT-LIN008-Power BI.docx 6 de 15
4 LINEAMIENTOS
4.3 Diseño
1. El diseño visual del informe debe ser de acuerdo a las necesidades del usuario de negocio,
manteniendo la marca o imagen corporativa del banco.
2. Modelo de Datos
2.1. Fuentes On-premise: Se debe seguir el esquema actual de solicitud de permisos a Bases de
Datos, estos permisos los debe solicitar únicamente usuario con rol Self-service (Desarrollador) y
Desarrollador (esquema tradicional TI).
Al ser procesos independientes la compra de una licencia NO significa dar aprobación para conectarse a
una base de datos, esto es algo que debe ser tenido en cuenta por todas las áreas del banco antes de
iniciar cualquiera de los dos procesos.
Los usuarios que sólo van a tener acceso de lectura en los informes o dashboards No requieren permisos
en las Bases De Datos, sólo deben tener permisos para leer el informe, debe inhabilitar las opciones de
permisos de compilación y compartir el informe.
SAT-LIN008-Power BI.docx 7 de 15
4.4 Desarrollo
1. Para desarrollo en esquema self-service se deben cargar los dashboards en el Área de Trabajo
personal, está prohibido cargarlos a otra área de Trabajo o workspaces
https://docs.microsoft.com/en-us/learn/paths/manage-workspaces-datasets-power-bi/ .
2. En el esquema de self-service, el mantenimiento de los informes y dashboards es responsabilidad
del usuario creador.
3. Si algún informe creado en el esquema self-service, se desea entregar para soporte a TI, se debe
revisar y acordar la entrega; este informe seguirá el esquema de TI para publicación en Power BI.
4. En escenarios de Self-Service únicamente podrán tener 1 workspace por usuario (Workspace
personal creado por default), donde deberá manejar un Workspace para almacenar informes y/o
dashboards y Datasets.
5. En escenarios de Self-Service, el usuario creador y dueño de los informes y/o dashboards, deberá
dar permiso de lectura en el Workspace que los contenga, a los usuarios con los que desee
compartir su contenido.
6. Toda estimación para el uso del Workspace debe realizarse en conjunto con desarrollo e
infraestructura para ver si hay necesidad de crecimiento y presupuesto por parte de quien requiera
usar Power BI premium.
7. Para el esquema tradicional de TI, deberá crearse un parámetro dentro del informe con el cual el
administrador del workspace hará cambio de conexión entre las fuentes por cada ambiente. Estos
parámetros únicamente pueden ser creados por la herramienta cliente Power BI Desktop, ver
creación de parámetros.
8. El uso del import y el direct Query para obtener los datos de las fuentes, debe ser evaluado de
acuerdo a la necesidad a continuación, se explican las 2 formas de obtener los datos:
SAT-LIN008-Power BI.docx 8 de 15
lo que significa que siempre está viendo los datos actuales. Este modo afecta el rendimiento
de las Bases de Datos.
Para este caso se debe obtener aprobación de Arquitectura.
9. Un usuario con rol desarrollador no debe publicar ningún informe, dashboard o dataset en internet.
10. No se deben compartir informes con extensión .pbix con información (dataset), para esto el informe
deberá guardarse como una plantilla (creación de plantillas), y el usuario con el que se comparte
deberá contar con un dataset de la misma estructura e indicar la ubicación del mismo para poder
visualizar datos en el informe desde Power BI Desktop.
❖ A tener en cuenta:
o Para cambios de conexión a fuentes de datos, parámetros, estructura y modelado de los
informes, debe hacerse uso de la herramienta cliente Power BI Desktop. Esto debido a
que el componente web de Power BI (Service), no permite realizar dichas modificaciones.
1. Todos los informes que tengan como fuente una Base de Datos On-Premise deberán utilizar el
Datagateway para su acceso.
2. Se deben crear los nombres de servicios de red o alias, para cada servidor de base de datos al
que necesita conectarse (Desarrollo, Calidad y Producción).
Los siguientes son los datos requeridos para la creación de los alias:
# <data source alias> = Nombre para usar en la cadena de conexión Fuente de datos
# <hostname or IP> = nombre o IP de la máquina del servidor de la base de datos
# <port> = puerto de la máquina del servidor de la base de datos a usar
# <database service name> = nombre del servicio de la base de datos en el servidor
Ejemplo:
ODPSUPFIN_PWBI
SAT-LIN008-Power BI.docx 9 de 15
3. El administrador del Datagateway, deberá generar un documento público con los alias de cada
conexión y los datos de cada una, para que el desarrollador conozca las conexiones existentes.
4. El desarrollador deberá crear los nombres de servicio de red o alias de acuerdo a los servidores
de Bases de Datos que desee conectarse, deben coincidir con los alias creados en el servidor de
Datagateway.
4.4.3 Workspace
1. Se debe hacer uso exclusivamente de los nuevos Workspace. Los Workspaces clásicos que eran
creados automáticamente por los grupos de Sharepoint y/o Teams deben eliminarse, ver
documentación en el enlace. Previo a la eliminación de los Workspace Clásicos, se debe revisar si
en alguno de ellos existen datasets, informes o dashboards que estén en uso por cualquier usuario
de negocio y validar con estos si es relevante mantener o mover los elementos para un nuevo
Workspace.
2. Se debe crear un único Workspace por cada Vicepresidencia y fase / ambiente (Desarrollo,
Pruebas y Producción) de Power BI, donde cada uno deberá tener un Administrador.
Se debe crear Workspace por Vicepresidencia, teniendo en cuenta la siguiente estructura y el ambiente o
fase al que corresponda:
1. Se debe crear una canalización por cada Vicepresidencia (VP), cada canalización crea tres (3)
fases por defecto desarrollo, pruebas y producción.
2. Se debe asociar a cada fase un (1) Workspace creado con capacidad premium para la
Vicepresidencia y fase o ambiente correspondiente
SAT-LIN008-Power BI.docx 10 de 15
Ejemplo, para la canalización de la VP de Operaciones y Tecnología en la fase de Desarrollo,
debe asociar el Workspace WS_DEV VP_Operaciones y Tecnología
Debe crear una canalización por cada Vicepresidencia (VP), teniendo en cuenta la siguiente estructura:
VP+ Nombre de la Vicepresidencia.
Ejemplo:
VP Operaciones y Tecnología
4.4.5 Datasets
1. Para la configuración de Dataset en las fases de Pruebas y Producción, debe realizarse con un
usuario inter aplicación de Base de Datos.
Debe tener en cuenta que únicamente los archivos con extensión .PBIX serán publicados en Power BI
Service para su despliegue.
4.4.7 Versionamiento
1. El desarrollador debe tomar el archivo .PBIT y hacer push a la rama de Git Hub del ambiente de
desarrollo, a la rama QA y Main deberá hacer un pull request para mezclar sus cambios una vez
el probador(a) confirme su paso a la misma.
2. Se debe crear una carpeta por cada proyecto, en esta se deben almacenar los archivos .PBIT,
siguiendo esta estructura, PY_ + Nombre del Proyecto_+ PW BI, ejemplo:
SAT-LIN008-Power BI.docx 11 de 15
PY_Conglomerados_ PW BI
A continuación, se describen los roles habilitados para el banco y el alcance de cada uno.
Los roles le permiten administrar quién puede hacer qué en los Workspace, para que los equipos puedan
colaborar. A continuación, las capacidades que ofrece cada rol:
SAT-LIN008-Power BI.docx 12 de 15
Funcionalidad Administrador Miembro Colaborador Visor
Actualizar y eliminar el área de trabajo.
Las siguiente son las capacidades que se asignaran a los roles en el banco:
Rol Permiso
Administrador Power BI Service Administrador (Admin)
Administrador Workspace Administrador (Admin)
Administrador Datagateway Colaborador (Contributor)
Desarrollador Colaborador (Contributor)
Administrador Capacidad Premium Administrador (Admin)
SAT-LIN008-Power BI.docx 13 de 15
4.4.9 Modelo de Versionamiento y Despliegue Automático
1. Desarrollador crea el informe (este debe incluir parámetro para cambio de origen de datos entre ambientes
y almacenar los detalles de conexión, como los nombres de instancia y los nombres de base de datos),
guarda el archivo como .pbix y plantilla .pbit con parámetro apuntando a BD de Desarrollo y hace
push a la rama Feature de Git Hub.
2. Desarrollador hace Pull Request desde Rama Featture hacia DEV Github, quedando en espera de
aprobación.
3. Aprobador aprueba Pull Request en DEV GitHub, solicitado por Desarrollador y se activa proceso
Git Actions.
4. Git Actions publica .pbix en fase Desarrollo de Power BI Service.
5. Git Actions mantiene archivo .pbit y elimina únicamente archivo .pbix de la Rama Feature.
6. Git Actions, hace Merge hacia la rama Develop, llevando el archivo .pbit.
7. Desarrollador hace Pull Request desde Rama Feature hacia Q.A. Github, quedando en espera de
aprobación.
8. Aprobador aprueba Pull Request en Q.A GitHub, solicitado por Desarrollador y se activa proceso
Git Actions.
9. Git Actions, promueve .pbix de la fase de Desarrollo a Fase de Calidad en Power Bi Service.
10. Git Actions, hace Merge hacia la rama Q.A, llevando el archivo .pbit.
11. Persona de calidad cambia parámetro y credenciales en el dataset y prueba el informe en la fase
de pruebas. Adicional el Administrador de Power BI monitorea consumo y rendiemiento del reporte
dentro de la capacidad del Workspace fase Calidad.
12. Desarrollador hace Pull Request desde Rama Q.A hacia Main Github, quedando en espera de
aprobación.
13. El Aprobador y Administrador de Power BI aprueban Pull Request en Main GitHub, solicitado por
Desarrollador y se activa proceso Git Actions.
SAT-LIN008-Power BI.docx 14 de 15
14. Git Actions, promueve .pbix de la fase de Calidad a Fase de Producción en Power Bi Service.
15. Git Actions, hace Merge hacia la rama Main, llevando el archivo .pbit.
16. El informe ya se encuentra desplegado, listo para compartir.
SAT-LIN008-Power BI.docx 15 de 15