pbi_create_visual
Create a visual on a specified Power BI page, configuring its type, fields, options, and position to add charts, tables, or other elements to the report.
Instructions
Crea un visual PBIR en una pagina.
visual_type acepta: actionButton, areaChart, barChart, button, card,
cardVisual, clusteredBarChart, clusteredColumnChart, columnChart, donut,
donutChart, funnel, gauge, htmlContent,
htmlContent443BE3AD55E043BF878BED274D3A6855, image, kpi, lineChart,
matrix, multiRowCard, navigation, pageNavigator, pieChart, pivotTable,
rectangle, ribbonChart, scatterChart, shape, slicer, table, tableEx,
text, textbox, treemap, waterfall y waterfallChart.
Para visuales con datos, valida antes de escribir los roles obligatorios,
la cardinalidad maxima de cada rol y el tipo de campo admitido: dimension
(Grouping), medida (Measure) o cualquiera de ambos
(GroupingOrMeasure). Los elementos decorativos (texto, forma, imagen,
navegador y boton) rechazan fields porque no llevan consulta.
fields: rol -> campos, p.ej. {"category":"Tabla[Col]",
"values":["[Medida]"], "legend":"Tabla[Col]"}.
El rol se reconoce escrito como sea: el logico (values), el nombre
que usa PBIR y que devuelve pbi_list_visuals (Values, Y,
Category, Data) o un sinonimo (measure, axis). Cada campo puede
ser "Tabla[Campo]" o el objeto que devuelve pbi_list_visuals, para
poder leer una pagina y rehacerla sin traducir nada.
Un rol que ese tipo de visual no tiene se RECHAZA con la lista de los validos. Antes se descartaba en silencio y el visual salia sin datos.
options: formato adicional. Llaves reconocidas (una clave no
reconocida se ignora, no se rechaza; ver pbi_get_visual para
comprobar que quedo escrito):
background_color,border_color('#RRGGBB'),background_transparency(0-100),border_radius(px): el marco de CUALQUIER visual (panel General > Efectos de Desktop). Sinbackground_color/border_colorno se toca el marco.card/cardVisual:show_category_label,value_font_size,bold_value,value_color.shape:fill,transparency,text,font_size,text_color.textbox:text,font_size,color,bold,font,align. El texto va enoptions.text, NO enfieldsni en la raiz: {"type": "textbox", "options": {"text": "Resumen", "font_size": 20}}.image:resource(ItemName ya registrado conpbi_add_image_resource),name,scaling.pageNavigator:show_hidden,show_current.actionButton:action,icon,target_page,text.format: formato del VISUAL, no del contenedor.mode(segmentador: Dropdown, List, Between...),header(bool: el encabezado del campo del segmentador; false lo oculta),dataLabels(bool),legend(bool),legendPosition(Top, Bottom, Left, Right...). Una clave desconocida aqui SE RECHAZA con la lista de las validas: un formato que se pide y no se aplica deja el informe distinto de lo que se penso sin decir por que.
position: {x, y, width, height} (z opcional).
Clona un visual del mismo tipo como plantilla si existe. Hace backup.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| title | No | ||
| fields | Yes | ||
| options | No | ||
| position | Yes | ||
| request_id | No | ||
| visual_type | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |