First, FirstN, Index, Last, және LastN функциялары

Келесілерге қолданылады: Кенеп бағдарламалары Copilot Studio Жұмыс үстелі ағындары Модельге негізделген бағдарламалар Power Platform CLI Dataverse функциялары Power Pages

Кестеден бірінші, соңғы немесе нақты жазбаны немесе бірінші немесе соңғы жазбалар жинағын қайтарады.

Сипаттама

Функция Firstкестенің алғашқы жазбасын қайтарады.

FirstN Функция кестенің бірінші жазбалар жиынтығын қайтарады, ал екінші аргумент қайтарылатын жазбалар санын көрсетеді.

Функция Last кестенің соңғы жазбасын қайтарады.

LastN Функция кестенің соңғы жазбалар жиынын қайтарады; екінші аргумент қайтарылатын жазбалар санын көрсетеді.

Index Функция кестедегі реттелген орнына негізделген кесте жазбасын қайтарады. Жазбаны нөмірлеу 1-ден басталады, сондықтан First( table ) бірдей жазбаны қайтарады Index( table, 1 ). Index Егер сұралған жазба индексі 1-ден кіші, кестедегі жазбалар санынан үлкен болса немесе кесте бос болса, қатені береді.

First, Indexжәне Last бір ғана жазбаны қайтарыңыз. FirstN Тек LastN бір ғана жазбаны көрсетсеңіз де, кестені қайтарыңыз.

Өкіл

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

Мысалы, 1 миллион жазбасы бар үлкен кестені қамтитын деректер көзімен пайдаланылғанда, Last өкілеттілік емес шектеуге бағынады және бүкіл деректер көзінің соңғы жазбасын қайтармайды. Сол сияқты, 1 миллион жазбаның ортасында жазбаны сұрау үшін пайдалану Index қатеге әкеледі, өйткені индекс өкілетті емес шектеуге негізделген диапазоннан тыс болады.

Синтаксис

First( Кесте )
Last( Кесте )

• Кесте - Міндетті. Әрекет орындайтын кесте.

FirstN( Кесте [, Жазбалар саны ] )
LastN( Кесте [, Жазбалар саны ] )

• Кесте - Міндетті. Әрекет орындайтын кесте.
• NumberOfRecords - Қосымша. Қайтаратын жазбалар саны. Егер бұл аргументті көрсетпесеңіз, функция бір жазбаны қайтарады.

Index( Кесте, RecordIndex )

• Кесте - Міндетті. Әрекет орындайтын кесте.
• RecordIndex - Міндетті. Қайтарылатын жазбаның индексі. Жазбаны нөмірлеу 1-ден басталады.

Мысалдар

Келесі мысалдар үшін біз осы кестедегі деректерді қамтитын IceCreamдеректер көзін пайдаланамыз:

Бұл кестені осы формуласы бар жинаққа орналастыруға болады (Түйме басқару элементі үшін OnStart формуласын енгізіп, түймені басыңыз):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )

Формула	Сипаттама	Нәтиже
First( Балмұздақ )	IceCream бірінші жазбасын қайтарады.	{ Түрі: "Шоколад", Мөлшер: 100 }
Last( Балмұздақ )	IceCream соңғы жазбасын қайтарады.	{ Хош иістендіргіш: "Фисташка", Саны: 200 }
Index( Балмұздақ, 3 )	IceCream үшінші жазбасын қайтарады.	{ Хош иісі: "Құлпынай", Саны: 300 }
FirstN( Балмұздақ, 2 )	IceCream алғашқы екі жазбасын қамтитын кестені қайтарады.
LastN( Балмұздақ, 2 )	IceCream соңғы екі жазбасын қамтитын кестені қайтарады.
Index( Балмұздақ, 4 ). Саны	Кестенің төртінші жазбасын қайтарады және Саны бағанын шығарады.	60
Index( Балмұздақ, 10 )	Сұралған жазба кестенің шегінен тыс болғандықтан қатені қайтарады.	Қате