pbi_export_pbix
Convert a .pbip project into a real .pbix or .pbit by using Power BI Desktop's official Save As flow. It checks the model, controls refresh, and verifies the saved output.
Instructions
Exporta el proyecto .pbip a un archivo .pbix (o .pbit) de verdad.
Microsoft no publica ninguna API para convertir el formato, asi que
esto automatiza el flujo OFICIAL: abre el proyecto en Power BI Desktop
y usa Archivo > Guardar como. No se fabrica el .pbix a mano -un zip
cosido con TOM abre a veces y rompe otras-.
Antes de tocar Desktop se resuelve la ruta exacta, se valida el TMDL,
se comprueba que el destino cabe en Windows y, si existe y pasas
overwrite=true, se respalda. Si el destino existe y no lo pasas,
falla ANTES de abrir ninguna ventana.
refresh: 'auto' intenta refrescar y declara el resultado sin
adornarlo; 'required' no exporta si no pudo refrescar -para no
entregar un .pbix como si tuviera datos-; 'skip' guarda el estado que
el modelo tenga ahora.
Que el dialogo desaparezca NO es que se haya guardado: se comprueba
que el archivo existe, que es .pbix y no .pbit, que pesa mas de cero,
que su fecha es de esta ejecucion y que el lector de .pbix lo puede
abrir con informe y modelo dentro. Si saved_as_verified no es true,
la respuesta no es un exito.
leave_open=true (por defecto) deja abierto exactamente el .pbix
generado y lo selecciona como modelo activo. Nunca cierra una ventana
que no abrio esta operacion. La respuesta trae desktop_session
(desktop_pid + desktop_started): es lo que acepta
pbi_close_desktop para cerrar ESA ventana despues, porque ya no
responde a la ruta del .pbip original.
format: 'pbix' (por defecto) o 'pbit'. Con 'pbit' se elige el tipo
de PLANTILLA en el mismo Guardar como, se atiende el dialogo de
descripcion que Desktop abre despues y se verifica que el archivo
tenga forma de plantilla: informe y definicion del modelo, SIN datos.
No se fabrica quitando partes de un .pbix.
Antes de conducir la ventana se espera a que su titulo muestre el
documento pedido (hasta 90 s): Sin titulo es Desktop cargando, no
otra ventana. Un titulo estable de OTRO documento se rechaza.
project_path es un alias de pbip_path; si llegan distintos, la
tool devuelve un conflicto en vez de elegir uno.
Requiere Windows, Power BI Desktop instalado y el extra export
(pip install "horizun-pbi-mcp[export]"). El cuadro de guardado se
conduce por UI Automation desde un proceso aparte: los mensajes Win32
cambian lo que se LEE en el desplegable de tipo sin avisar a la
aplicacion, y Desktop sigue guardando un proyecto. pbi_capabilities
dice en pbix_export si esta disponible aqui y ahora.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | pbix | |
| refresh | No | auto | |
| timeout | No | ||
| out_path | No | ||
| overwrite | No | ||
| pbip_path | No | ||
| leave_open | No | ||
| request_id | No | ||
| project_path | No | ||
| confirm_reuse | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |