powerapps-yaml

📁 rohbunny01/powerapps-skills 📅 2 days ago

总安装量

周安装量

#32517

全站排名

安装命令

npx skills add https://github.com/rohbunny01/powerapps-skills --skill powerapps-yaml

Agent 安装分布

amp 3

opencode 3

kimi-cli 3

codex 3

github-copilot 3

antigravity 3

Skill 文档

Power Apps YAML â GuÃa Completa para Vibe Coding

CuÃ¡ndo usar

Al generar cÃ³digo YAML para pegar en Power Apps Studio
Al crear o modificar pantallas de Power Apps
Al convertir diseÃ±os a controles Power Apps modernos
Al trabajar con SharePoint como backend

ð Estructura Base (pa.yaml Schema v3)

La estructura OBLIGATORIA para que Power Apps Studio acepte el YAML via “Paste code”:

Screens:
    NombrePantalla:
        Properties:
            Fill: =SurfaceAlt
            OnVisible: |-
                =Set(varEjemplo, "hola")
        Children:
            - NombreControl:
                Control: TipoControl
                Variant: VarianteOpcional
                Properties:
                    X: =0
                    Y: =0
                    Width: =Parent.Width
                    Height: =100
                Children:
                    - ControlHijo:
                        Control: Text
                        Properties:
                            Text: ="Hola mundo"

Reglas de estructura

Top-level: Siempre empieza con Screens:
Screen name: Debe coincidir EXACTAMENTE con el nombre de la pantalla en Power Apps Studio
No usar Control: Screen: Las pantallas se definen directamente bajo Screens:, SIN propiedad Control
Children es un array: Cada hijo comienza con - NombreControl:
Control y Variant: Se definen dentro de cada hijo, NO en la pantalla
Valores con =: TODAS las propiedades llevan = al inicio: Text: ="Hola", X: =0

ð¨ Propiedades de Controles Modernos (CRÃTICO)

Power Apps usa controles modernos que tienen nombres DIFERENTES a los clÃ¡sicos. Usar los nombres incorrectos produce error PA2108: Unknown property.

Control `Text` (Label)

â ClÃ¡sico (NO usar)	â Moderno (USAR)
`Color`	`FontColor`
`FontWeight`	`Weight`

- lblEjemplo:
    Control: Text
    Properties:
        X: =0
        Y: =0
        Width: =200
        Height: =40
        Text: ="Hola"
        FontColor: =RGBA(0, 0, 0, 1)
        Size: =14
        Weight: =FontWeight.Bold
        Align: =Align.Center
        VerticalAlign: =VerticalAlign.Middle

Control `Button`

â ClÃ¡sico (NO usar)	â Moderno (USAR)
`Fill`	`BasePaletteColor`
`Color`	`FontColor`
`Size`	`FontSize`
`RadiusTopLeft/Right/etc`	(no existe, usa Fluent theme)

- btnEjemplo:
    Control: Button
    Properties:
        X: =0
        Y: =0
        Width: =200
        Height: =44
        Text: ="Click"
        BasePaletteColor: =BrandAccent
        FontColor: =TextOnAccent
        FontSize: =14
        FontWeight: =FontWeight.Semibold
        Appearance: ='ButtonCanvas.Appearance'.Primary
        OnSelect: =Notify("Clickeado")

Valores de Appearance:

'ButtonCanvas.Appearance'.Primary â botÃ³n principal
'ButtonCanvas.Appearance'.Secondary â botÃ³n secundario
'ButtonCanvas.Appearance'.Transparent â transparente (ideal para overlays y back buttons)

Control `TextInput`

â ClÃ¡sico (NO usar)	â Moderno (USAR)
`Default`	`Value`
`HintText` / `PlaceholderText`	(no existe en moderno)
`Format`	(no existe en moderno)

- txtEjemplo:
    Control: TextInput
    Properties:
        X: =0
        Y: =0
        Width: =200
        Height: =44
        Value: =""
        Mode: =TextMode.MultiLine  # Opcional

Control `DatePicker`

â ClÃ¡sico (NO usar)	â Moderno (USAR)
`DefaultDate`	`SelectedDate`

- dpEjemplo:
    Control: DatePicker
    Properties:
        X: =0
        Y: =0
        Width: =200
        Height: =44
        SelectedDate: =Today()

Control `Dropdown`

- ddEjemplo:
    Control: Dropdown
    Properties:
        X: =0
        Y: =0
        Width: =200
        Height: =44
        Items: =["OpciÃ³n 1", "OpciÃ³n 2", "OpciÃ³n 3"]
        DefaultSelectedItems: =["OpciÃ³n 1"]
        OnChange: =Set(varSeleccion, Self.Selected.Value)

Para items numÃ©ricos:

Items: =Sequence(24, 0)              # 0 a 23
Items: =[0, 5, 10, 15, 20, 25, 30]   # Lista explÃcita

Control `GroupContainer`

â NO soportado	â Alternativa
`OnSelect`	Usar un Button overlay transparente dentro del container
`RadiusTopLeft/Right/etc`	(no existe en modernos)

- containerEjemplo:
    Control: GroupContainer
    Variant: ManualLayout
    Properties:
        X: =0
        Y: =0
        Width: =200
        Height: =100
        Fill: =Surface
        DropShadow: =DropShadow.Light

Para hacer un container clickeable:

Children:
    - lblContenido:
        Control: Text
        Properties:
            Text: ="Mi contenido"
    - btnOverlay:
        Control: Button
        Properties:
            X: =0
            Y: =0
            Width: =Parent.Width
            Height: =Parent.Height
            Text: =""
            Appearance: ='ButtonCanvas.Appearance'.Transparent
            OnSelect: =Navigate(OtraPantalla, ScreenTransition.None)

ð Gallery â Reglas CrÃticas

Regla #1: Variant es OBLIGATORIO

- galEjemplo:
    Control: Gallery
    Variant: BrowseLayout_Flexible_SocialFeed_ver5.0  # OBLIGATORIO

Error si falta: PA1011: The keyword 'Variant' is required but is missing or empty

Regla #2: Items de SharePoint directo â funciona bien

Items: =MiListaSP

Regla #3: Items de colecciÃ³n â usar ForAll con esquema explÃcito

â ï¸ PROBLEMA: Cuando Items apunta a una colecciÃ³n creada con GroupBy + AddColumns, los controles dentro de la gallery muestran errores â porque Power Apps no puede inferir el esquema.

â SOLUCIÃN: Usar ForAll con registros de forma explÃcita {campo: valor}:

OnVisible: |-
    =ClearCollect(
        colRanking,
        ForAll(
            GroupBy(colRegistros, Title, Email, Registros),
            {
                Nombre: ThisRecord.Title,
                EmailUsuario: ThisRecord.Email,
                Puntos: Sum(Registros, Puntos),
                Sesiones: CountRows(Registros)
            }
        )
    )

Regla #4: GroupBy â NO usar comillas en columnas

# â MAL â "Registros" se interpreta como texto
GroupBy(tabla, "Title", "Email", "Registros")

# â BIEN â identificadores sin comillas
GroupBy(tabla, Title, Email, Registros)

Regla #5: No agrupar por columnas que cambian

Si un usuario puede cambiar de equipo, NO agrupar por Equipo porque aparecerÃ¡ duplicado. Tomar el equipo del Ãºltimo registro:

EquipoUsuario: Last(Registros).Equipo

Regla #6: Acceder a tabla agrupada dentro de ForAll

# â MAL â ThisRecord.Registros no resuelve
Sum(ThisRecord.Registros, Puntos)

# â BIEN â acceso directo a la columna de grupo
Sum(Registros, Puntos)

Template completo para Gallery con colecciÃ³n:

- galRanking:
    Control: Gallery
    Variant: BrowseLayout_Flexible_SocialFeed_ver5.0
    Properties:
        X: =16
        Y: =188
        Width: =Parent.Width - 32
        Height: =Parent.Height - 204
        Items: =SortByColumns(colRanking, "Puntos", SortOrder.Descending)
        TemplatePadding: =6
        TemplateSize: =80
        Fill: =RGBA(0, 0, 0, 0)
    Children:
        - CardItem:
            Control: GroupContainer
            Variant: ManualLayout
            Properties:
                Width: =Parent.Width
                Height: =74
                Fill: =Surface
                DropShadow: =DropShadow.Light
            Children:
                - lblNombre:
                    Control: Text
                    Properties:
                        X: =16
                        Y: =12
                        Width: =Parent.Width - 140
                        Height: =24
                        Text: =ThisItem.Nombre

Problema

Cada pantalla hace queries independientes a SharePoint â lento y redundante.

# Screen_Inicio.OnVisible â carga datos UNA VEZ
OnVisible: |-
    =Set(varUsuarioActual, User().FullName);
    Set(varEmailActual, User().Email);
    ClearCollect(
        colRegistrosMes,
        Filter(
            MiListaSP,
            Month(Fecha) = Month(Today()),
            Year(Fecha) = Year(Today())
        )
    );
    Set(varMisRegistros, Filter(colRegistrosMes, Email = varEmailActual));
    Set(varMiEquipo, LookUp(Miembros, Email = varEmailActual, Equipo))

Reutilizar en otras pantallas

# Screen_Ranking â usa colRegistrosMes, NO re-consulta SharePoint
OnVisible: |-
    =ClearCollect(
        colRanking,
        ForAll(
            GroupBy(colRegistrosMes, Title, Email, Registros),
            { Nombre: ThisRecord.Title, Puntos: Sum(Registros, Puntos) }
        )
    )

# Screen_Equipos â usa varMiEquipo ya cacheado
OnVisible: |-
    =Set(varVistaEquipos, "Lista")
    # varMiEquipo ya estÃ¡ cargado desde Screen_Inicio

# En btnGuardar.OnSelect, despuÃ©s del Patch:
Patch(MiListaSP, Defaults(MiListaSP), { ... });
Collect(colRegistrosMes, { ...mismo registro... });
Navigate(Screen_Inicio, ScreenTransition.None)

Resultado: ~7 queries SP â 2 queries (1 ClearCollect + 1 LookUp)

ð¨ Colores del Tema (App.Formulas)

Definir paleta global en App > Formulas:

BrandPrimary = RGBA(30, 41, 59, 1);
BrandAccent = RGBA(255, 107, 53, 1);
BrandAccentLight = RGBA(255, 107, 53, 0.08);
Surface = RGBA(255, 255, 255, 1);
SurfaceAlt = RGBA(245, 247, 252, 1);
TextPrimary = RGBA(15, 23, 42, 1);
TextSecondary = RGBA(100, 116, 139, 1);
TextOnAccent = RGBA(255, 255, 255, 1);
StatusSuccess = RGBA(16, 185, 129, 1);
StatusWarning = RGBA(234, 179, 8, 1);
StatusError = RGBA(239, 68, 68, 1);

â° PatrÃ³n: Selector de Hora con Dropdowns

El DatePicker solo selecciona fecha. Para hora, usar pares de Dropdowns:

# Horas (0-23)
- ddHoraH:
    Control: Dropdown
    Properties:
        Items: =Sequence(24, 0)
        DefaultSelectedItems: =[8]

# Separador ":"
- lblSep:
    Control: Text
    Properties:
        Text: =":"
        Weight: =FontWeight.Bold

# Minutos (intervalos de 5)
- ddHoraM:
    Control: Dropdown
    Properties:
        Items: =[0, 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55]
        DefaultSelectedItems: =[0]

Construir DateTime desde dropdowns:

DateAdd(
    DateAdd(Today(), Value(ddHoraH.Selected.Value), TimeUnit.Hours),
    Value(ddHoraM.Selected.Value),
    TimeUnit.Minutes
)

Calcular duraciÃ³n:

With(
    {
        mins: (Value(ddFinH.Selected.Value) * 60 + Value(ddFinM.Selected.Value)) -
              (Value(ddInicioH.Selected.Value) * 60 + Value(ddInicioM.Selected.Value))
    },
    If(mins > 0, Text(RoundDown(mins / 60, 0)) & "h " & Text(Mod(mins, 60)) & "min", "â ï¸ Error")
)

ð Proceso de Paste Code

Crear la pantalla manualmente en Power Apps Studio
Asegurar que el nombre coincide con el definido en el YAML
Copiar TODO el contenido del archivo YAML (incluyendo Screens:)
Seleccionar la pantalla en el Tree View
Pegar con Ctrl+V o Click derecho â Paste code
Si hay errores de design-time por colecciones en OnVisible, ejecutar (Play â¶ï¸) para que se creen

â ï¸ Tabla de errores comunes

Error	Causa	SoluciÃ³n
`PA2108: Unknown property 'Color'`	Propiedad clÃ¡sica	Usar `FontColor`
`PA2108: Unknown property 'FontWeight'` en Text	Propiedad clÃ¡sica	Usar `Weight`
`PA2108: Unknown property 'Fill'` en Button	Propiedad clÃ¡sica	Usar `BasePaletteColor`
`PA2108: Unknown property 'Default'` en TextInput	Propiedad clÃ¡sica	Usar `Value`
`PA2108: Unknown property 'DefaultDate'`	Propiedad clÃ¡sica	Usar `SelectedDate`
`PA2108: Unknown property 'OnSelect'` en GroupContainer	No soportado	Button overlay transparente
`PA1011: 'Variant' is required` en Gallery	Falta Variant	Agregar `Variant: BrowseLayout_Flexible_SocialFeed_ver5.0`
`PA2109: Unknown variant 'X'` en Gallery	Variant invÃ¡lido	Usar `BrowseLayout_Flexible_SocialFeed_ver5.0`
`YamlInvalidSyntax: PaModule`	Estructura incorrecta	Usar `Screens:` como top-level
Gallery con â en controles	ColecciÃ³n sin esquema inferible	Usar `ForAll` + registros explÃcitos
Nombre duplicado en ranking	GroupBy por columna variable	No agrupar por campos que cambian
`"Registros" error: text`	Comillas en GroupBy	Quitar comillas: `GroupBy(t, Col, Grupo)`

Control	Propiedad ClÃ¡sica	Propiedad Moderna
Text	`Color`	`FontColor`
Text	`FontWeight`	`Weight`
Button	`Fill`	`BasePaletteColor`
Button	`Color`	`FontColor`
Button	`Size`	`FontSize`
TextInput	`Default`	`Value`
TextInput	`HintText`	(no existe)
DatePicker	`DefaultDate`	`SelectedDate`
GroupContainer	`OnSelect`	(no existe)
Todos	`RadiusTopLeft` etc.	(no existe)

ð¡ Tips Power Fx

Separadores: Usar comas (,) como separadores â la config regional del entorno define si Power Apps espera , o ;
Strings multilÃnea: Usar |- en YAML seguido de la fÃ³rmula con = al inicio
SharePoint Choice columns: Al hacer Patch, usar {Value: "texto"} para columnas de tipo Choice
SharePoint list names: Verificar el nombre EXACTO de la lista (con nÃºmeros si hay duplicados, ej: MiLista1)
Colecciones tipadas: Siempre usar ForAll({campo: valor}) en vez de AddColumns para colecciones que alimentan Gallery
Variables globales: Cachear datos compartidos en Screen_Inicio.OnVisible y reutilizar en otras pantallas

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台

powerapps-yaml

Agent 安装分布

Skill 文档

Power Apps YAML â GuÃa Completa para Vibe Coding

CuÃ¡ndo usar

ð Estructura Base (pa.yaml Schema v3)

Reglas de estructura

ð¨ Propiedades de Controles Modernos (CRÃTICO)

Control `Text` (Label)

Control `Button`

Control `TextInput`

Control `DatePicker`

Control `Dropdown`

Control `GroupContainer`

ð Gallery â Reglas CrÃticas

Regla #1: Variant es OBLIGATORIO

Regla #2: Items de SharePoint directo â funciona bien

Regla #3: Items de colecciÃ³n â usar ForAll con esquema explÃcito

Regla #4: GroupBy â NO usar comillas en columnas

Regla #5: No agrupar por columnas que cambian

Regla #6: Acceder a tabla agrupada dentro de ForAll

Template completo para Gallery con colecciÃ³n:

ð PatrÃ³n de CachÃ© Local (OptimizaciÃ³n)

Problema

SoluciÃ³n: Centro de cachÃ© en Screen_Inicio

Reutilizar en otras pantallas

DespuÃ©s de guardar un registro â actualizar cachÃ© local

ð¨ Colores del Tema (App.Formulas)

â° PatrÃ³n: Selector de Hora con Dropdowns

Construir DateTime desde dropdowns:

Calcular duraciÃ³n:

ð Proceso de Paste Code

â ï¸ Tabla de errores comunes

ð§© Mapeo rÃ¡pido: ClÃ¡sico â Moderno

ð¡ Tips Power Fx

powerapps-yaml

Agent 安装分布

Skill 文档

Power Apps YAML â GuÃ­a Completa para Vibe Coding

CuÃ¡ndo usar

ð Estructura Base (pa.yaml Schema v3)

Reglas de estructura

ð¨ Propiedades de Controles Modernos (CRÃTICO)

Control Text (Label)

Control Button

Control TextInput

Control DatePicker

Control Dropdown

Control GroupContainer

ð Gallery â Reglas CrÃ­ticas

Regla #1: Variant es OBLIGATORIO

Regla #2: Items de SharePoint directo â funciona bien

Regla #3: Items de colecciÃ³n â usar ForAll con esquema explÃ­cito

Regla #4: GroupBy â NO usar comillas en columnas

Regla #5: No agrupar por columnas que cambian

Regla #6: Acceder a tabla agrupada dentro de ForAll

Template completo para Gallery con colecciÃ³n:

ð PatrÃ³n de CachÃ© Local (OptimizaciÃ³n)

Problema

SoluciÃ³n: Centro de cachÃ© en Screen_Inicio

Reutilizar en otras pantallas

DespuÃ©s de guardar un registro â actualizar cachÃ© local

ð¨ Colores del Tema (App.Formulas)

â° PatrÃ³n: Selector de Hora con Dropdowns

Construir DateTime desde dropdowns:

Calcular duraciÃ³n:

ð Proceso de Paste Code

â ï¸ Tabla de errores comunes

ð§© Mapeo rÃ¡pido: ClÃ¡sico â Moderno

ð¡ Tips Power Fx

Power Apps YAML â GuÃa Completa para Vibe Coding

ð Estructura Base (pa.yaml Schema v3)

ð¨ Propiedades de Controles Modernos (CRÃTICO)

Control `Text` (Label)

Control `Button`

Control `TextInput`

Control `DatePicker`

Control `Dropdown`

Control `GroupContainer`

ð Gallery â Reglas CrÃticas

Regla #2: Items de SharePoint directo â funciona bien

Regla #3: Items de colecciÃ³n â usar ForAll con esquema explÃcito

Regla #4: GroupBy â NO usar comillas en columnas

ð PatrÃ³n de CachÃ© Local (OptimizaciÃ³n)

DespuÃ©s de guardar un registro â actualizar cachÃ© local

ð¨ Colores del Tema (App.Formulas)

â° PatrÃ³n: Selector de Hora con Dropdowns

ð Proceso de Paste Code

â ï¸ Tabla de errores comunes

ð§© Mapeo rÃ¡pido: ClÃ¡sico â Moderno

ð¡ Tips Power Fx