Funcións de recollida, borrado e borrado de recollida

Crea e borra coleccións e engade rexistros a calquera orixe de datos.

Collect

Aplícase a: Aplicacións de lenzo Tarxetas Dataverse complementos de código baixo Power Platform CLI Fluxos de escritorio

A función Recoller engade rexistros a unha orixe de datos. Os elementos a engadir poden ser:

• Un único valor: o valor sitúase no campo Value dun novo rexistro. O resto de propiedades quedan blank.
• Un rexistro: cada propiedade chamada colócase na propiedade correspondente dun novo rexistro. O resto de propiedades quedan en branco.
• Unha táboa: engádese cada rexistro da táboa como rexistro separado da orixe de datos como se describe anteriormente. A táboa non se engade como táboa aniñada a un rexistro. Para iso, axuste a táboa nun rexistro primeiro.

Cando se usa cunha colección, crearanse columnas adicionais segundo sexa necesario. As columnas doutras orixes de datos son fixadas pola orixe de datos e non se poden engadir novas columnas.

Se a orixe de datos aínda non existe, créase unha colección.

Ás veces utilízanse coleccións para almacenar variables globais ou facer unha copia temporal dunha orixe de datos. As aplicacións de lenzo baséase en fórmulas que se recalculan automaticamente a medida que o usuario interactúa cunha aplicación. As coleccións non gozan desta vantaxe e o seu uso pode facer que a aplicación sexa máis difícil de crear e entender. Antes de usar unha colección deste xeito, revise traballar con variables.

Tamén pode usar a función Patch para crear rexistros nunha orixe de datos.

Recoller devolve a orixe de datos modificada como táboa. Recoller só se pode usar nunha fórmula de comportamento.

Desmarcar

Aplícase a: aplicacións Canvas

A función Borrar elimina todos os rexistros dunha colección. As columnas da colección permanecerán.

Teña en conta que Borrar opera só en coleccións e non noutras orixes de datos. Pode usar RemoveIf( DataSource, true ) para esta fin. Teña coidado porque isto eliminará todos os rexistros do almacenamento da orixe de datos e pode afectar a outros usuarios.

Pode usar a función Remove para eliminar selectivamente os rexistros.

Borrar non ten valor de devolución. Só se pode usar nunha fórmula de comportamento.

ClearCollect

Aplícase a: Aplicacións de lenzo Aplicacións baseadas en modelos

A función ClearCollect elimina todos os rexistros dunha colección. E logo engade un conxunto diferente de rexistros á mesma colección. Cunha única función, ClearCollect ofrece a combinación de Borrar e logo Recoller.

ClearCollect devolve a colección modificada como táboa. ClearCollect só se pode usar nunha fórmula de comportamento.

Delegación

Estas funcións, cando se usan cunha orixe de datos, non se poden delegar. Só se recuperará a primeira parte da orixe de datos e logo a función aplicada. Pode que o resultado non represente o historial completo. É posible que se mostre un aviso na fase de creación para lembrarlle desta limitación e suxerirlle que mude a alternativas delegables sempre que sexa posible. Para obter máis información, consulte a visión xeral da delegación.

Sintaxe

Recoller( DataSource, Item, ... )

• DataSource – Obrigatorio. A orixe de datos á que quere engadir datos. Se aínda non existe, créase unha nova colección.
• Item(s) - Obrigatorio. Un ou máis rexistros ou táboas para engadir á orixe de datos.

Borrar( Collection )

• Collection – Obrigatorio. A colección que quere borrar.

ClearCollect( Collection, Item, ... )

• Collection – Obrigatorio. A colección que desexa eliminar e á que logo engadir datos.
• Item(s) - Obrigatorio. Un ou máis rexistros ou táboas para engadir á orixe de datos.

Exemplos

Borrar e engadir rexistros a unha orixe de datos

Nestes exemplos, borrará e engadirá a unha colección chamada Xeado. O orixe de datos comeza con estes contidos:

Fórmula	Descripción	Resultado
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	Elimina todos os datos da colección Xeado e despois engade un rexistro que inclúe unha cantidade de xeado de amorodos.	A colección IceCream tamén se modificou.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	Engade dous rexistros á colección Xeado que inclúe unha cantidade de xeado de pistacho e laranxa.	A colección IceCream tamén se modificou.
Clear( IceCream )	Elimina todos os rexistros da colección Xeado.	A colección IceCream tamén se modificou.

Para obter exemplos paso a paso de como crear unha colección, consulte Crear e actualizar unha colección.

Rexistros e táboas

Estes exemplos examinan o modo no que se manexan os argumentos de rexistros e táboas en Recoller e ClearCollect.

Fórmula	Descripción	Resultado
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Borre todos os datos e, a continuación, engade dous rexistros á colección Xeado que inclúe unha cantidade de xeado de chocolate e vainilla. Os rexistros que se van engadir fornécense como argumentos individuais á función.	A colección IceCream tamén se modificou.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) )	O mesmo que no exemplo anterior, agás que os rexistros se combinan nunha táboa e se pasan por un único argumento. O contido da táboa extráese rexistro por rexistro antes de ser engadido á colección Xeado.	A colección IceCream tamén se modificou.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	O mesmo que o exemplo anterior, agás que a táboa está envolta nun rexistro. Non se extraen os rexistros da táboa e en cambio engádese toda a táboa como unha cela do rexistro.	A colección IceCream tamén se modificou.