Collect, Clear және ClearCollect функциялары

  • Мақала

Жинақтарды жасайды және тазалайды әрі кез келген деректер көзінежазбаларды қосады.

Collect

Қолданылады: Canvas қолданбалары Карталар Dataverse төмен кодты қосылатын модульдер Power Platform CLI Жұмыс үстелі ағындары

Collect функциясы деректер көзіне жазбаларды қосады. Қосатын элементтер мыналар болуы мүмкін:

  • Бір мән: мән жаңа жазбаның Value өрісіне орналастырылады. Барлық басқа сипаттар blank (бос) қалдырылады.
  • Жазба: әрбір аталған сипат жаңа жазбаның сәйкес сипатына орналастырылады. Барлық басқа сипаттар blank (бос) қалдырылады.
  • Кесте: кестенің әр жазбасы жоғарыда сипатталғандай деректер көзінің жеке жазбасы ретінде қосылады. Кесте жазбаға кірістірілген кесте ретінде қосылмайды. Мұны істеу үшін алдымен кестені жазбамен орап алыңыз.

Жинақпен бірге пайдаланғанда, қажет кезде қосымша бағандар жасалады. Басқа деректер кездері үшін бағандарды деректер көзі бекітеді және жаңа бағандарды қосу мүмкін емес.

Егер деректер көзі бұрыннан болмаса, жинақ жасалады.

Жинақтар кейде глобалдық айнымалыларды сақтау немесе деректер көзінің уақытша көшірмесін жасау үшін пайдаланылады. Кенеп бағдарламалары пайдаланушы бағдарламамен өзара әрекеттескен кезде автоматты түрде қайта есептелетін формулаларға негізделеді. Жинақтарда бұл артықшылық жоқ және оларды пайдалану бағдарламаңызды жасау және түсінуді қиындатуы мүмкін. Жинақты осылай пайдаланбас бұрын айнымалылармен жұмыс істеу бөлімін қарап шығыңыз.

Сондай-ақ деректер көзінде жазбаларды жасау үшін Patch функциясын пайдалануға болады.

Collect өзгертілген деректер көзін кесте түрінде қайтарады. Collect функциясын тек мінез-құлық формуласында пайдалануға болады.

Өшіру

Мыналарға қолданылады: Canvas қолданбалары

Clear функциясы жинақтың барлық жазбаларын жояды. Жинақтың бағандары қалады.

Clear функциясы тек жинақтарда жұмыс істейтінін және басқа деректер көздерінде жұмыс істемейтінін ескеріңіз. Бұл мақсатта RemoveIf( DataSource, true ) функциясын пайдалана аласыз. Сақ болыңыз, өйткені бұл деректер көзі қоймасындағы барлық жазбаларды жояды және басқа пайдаланушыларға әсер етуі мүмкін.

Жазбаларды таңдау бойынша жою үшін Remove функциясын пайдалана аласыз.

Clear функциясының қайтарылатын мәні жоқ. Оны тек мінез-құлық формуласында пайдалануға болады.

ClearCollect

Қолданылады: Canvas қолданбалары Үлгіге негізделген қолданбалар

ClearCollect функциясы жинақтан барлық жазбаларды жояды. Бір жинаққа жазбалардың әртүрлі жинағын қосады. ClearCollect функциясы бір функцияда Clear функциясын, содан кейін Collect функциясын ұсынады.

ClearCollect өзгертілген жинақты кесте түрінде қайтарады. ClearCollect функциясын тек мінез-құлық формуласында пайдалануға болады.

Өкіл

Деректер көзімен бірге пайдаланылғанда, бұл функция тағайындалмайды. Деректер көзінің бірінші бөлімі ғана алынып, функция қолданылады. Нәтиже толық тарихты білдірмейді. Ескерту авторлық уақытта осы шектеу туралы еске салу және мүмкіндігінше жіберілетін баламалы нұсқаларды ауыстыруды ұсыну үшін пайда болуы мүмкін. Қосымша ақпарат алу үшін, Өкілдік шолуы бөлімін қараңыз.

Синтаксис

Collect( DataSource, Item, ... )

  • DataSource – Міндетті. Деректер қосқыңыз келетін деректер көзі. Егер бұрыннан болмаса, жаңа жинақ жасалады.
  • Item(s) - Міндетті. Деректер көзіне қосатын бір немесе бірнеше жазбалар немесе кестелер.

Clear( Collection )

  • Collection – Міндетті. Тазалағыңыз келетін жинақ.

ClearCollect( Collection, Item, ... )

  • Collection – Міндетті. Тазалап, содан кейін деректерді қосқыңыз келетін жинақ.
  • Item(s) - Міндетті. Деректер көзіне қосатын бір немесе бірнеше жазбалар немесе кестелер.

Мысалдар

Деректер көзінен жазбаларды тазалау және қосу

Осы мысалдарда сіз IceCream атты жинақты өшіресіз және оған қосасыз. Деректер көзі мына мазмұнмен басталады:

Үлгі деректер көзі.

Формула Сипаттамасы Нәтиже
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) IceCream жинағынан барлық деректерді тазалайды, содан кейін құлпынай балмұздағының мөлшерін қамтитын жазбаны қосады. Бір жазбасы бар кесте.

IceCream жинағы да өзгертілді.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) IceCream жинағына фисташка және апельсин балмұздағының мөлшерін қамтитын екі жазбаны қосады. Екі жазбасы бар кесте.

IceCream жинағы да өзгертілді.
Clear( IceCream ) IceCream жинағынан барлық жазбаларды жояды. Бос үстел.

IceCream жинағы да өзгертілді.

Жинақты жасау жолының қадамдық мысалдарын Жинақты жасау және жаңарту бөлімінен қараңыз.

Жазбалар және кестелер

Бұл мысалдарда Collect және ClearCollect функцияларының жазба және кесте аргументтері қалай өңделетіні қарастырылады.

Формула Сипаттама Нәтиже
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) Барлық деректерді тазалайды, содан кейін IceCream жинағы шоколад және ваниль балмұздағының мөлшерін қамтитын екі жазбаны қосады. Қосылатын жазбалар функцияның жеке аргументтері ретінде беріледі. Коллекцияға шоколад және ванильді жазбалар қосылды.

IceCream жинағы да өзгертілді.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) ) Алдыңғы мысалға ұқсас, тек жазбалар кестеде біріктіріліп, бір аргумент арқылы өткізіледі. Кестенің мазмұны IceCream жинағына қосылмастан бұрын әр жазбадан кезекпен шығарып алынады. Шоколад және ваниль жазбалары коллекцияға қосылды және өзгертілді.

IceCream жинағы да өзгертілді.
ClearCollect( IceCream,
{ MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )		 Алдыңғы мысалмен бірдей, тек кесте жазбамен орап алынады. Кестенің жазбалары шығарып алынбайды және оның орнына бүкіл кесте жазбаның ұяшығы түрінде қосылады. Коллекцияға қосылған шоколад және ваниль жазбалары жазбаға оралған кестемен өзгертілген.

IceCream жинағы да өзгертілді.