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

  • Мақала

Қолданылады: Canvas apps Desktop flows Model-driven apps Power Platform CLI

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

Сипаттама

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

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

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

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

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

First, Index және Last функциялары бір жазбаны қайтарады. FirstN және LastN функциялары тіпті жалғыз жазбаны көрсетсеңіз де, кестені қайтарады.

Өкіл

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

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

Синтаксис

First( Table )
Last( Table )

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

FirstN( Table [, NumberOfRecords ] )
LastN( Table [, NumberOfRecords ] )

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

Index( Table, RecordIndex )

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

Мысалдар

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

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 ) IceCream бірінші жазбасын қайтарады. { Түрі: "Шоколад", Мөлшер: 100 }
Last( IceCream ) IceCream соңғы жазбасын қайтарады. { Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 ) IceCream үшінші жазбасын қайтарады. { Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 ) IceCream алғашқы екі жазбасын қамтитын кестені қайтарады. Шоколад пен Ванильге арналған жазбалары бар кесте
LastN( IceCream, 2 ) IceCream соңғы екі жазбасын қамтитын кестені қайтарады. Жалбыз шоколад және пісте жазбалары бар кесте
Index( IceCream, 4 ).Quantity Кестенің төртінші жазбасын қайтарады және саны бағанын шығарады. 60
Index( IceCream, 10 ) Сұралған жазба кестенің шегінен тыс болғандықтан қатені қайтарады. Қате