DataSourceInfo функциясы
Қолданылады:
Canvas қолданбалары Үлгіге негізделген қолданбалар
Деректер көзі туралы ақпаратты қамтамасыз етеді.
Шолу
Деректер көздері пайдаланушы тәжірибесін оңтайландыру үшін көп ақпаратты қамтамасыз ете алады.
Баған деңгейіндегі ақпаратты Patch функциясын пайдалану алдында пайдаланушының енгізгенін тексеру үшін пайдалануға және пайдаланушыға дереу кері байланысты қамтамасыз етуге болады. Validate функциясы дәл осы ақпаратты пайдаланады.
Мысалы, деректер көзі деңгейіндегі ақпаратты жазбаларды өңдеуге және жасауға рұқсаттары жоқ пайдаланушылар үшін Өңдеу және Жаңа түймешіктерін өшіру немесе жасыру үшін пайдалануға болады.
Деректер көздерінің қанша ақпарат беретіні өзгеріп отырады, соның ішінде мүлде ақпарат бермеуі мүмкін. Жинақтар ақпаратты қамтамасыз етпейді. Ақпарат бөлігі қамтамасыз етілмеген болса, әдепкі пайдаланылады немесе бос мән қайтарылады.
Ескертпе
Қазіргі уақытта DataSourceInfo функциясына Microsoft тізіміндерінде қолдау көрсетілмейді.
Сипаттама
Баған ақпараты
Деректер көзінің нақты бағаны туралы ақпарат алу үшін DataSourceInfo функциясын пайдалануға болады:
| Ақпарат аргументі | Нәтиже түрі | Сипаттама |
|---|---|---|
| DataSourceInfo.DisplayName | Жол | Баған атауын көрсетіңіз. Егер көрсетілетін атау анықталмаған болса, баған атауын қайтарады. |
| DataSourceInfo.MaxLength | Нөмірі | Баған сыйдыра алатын таңбалардың ең көп саны. Тек жолдарды қамтитын бағандарға қатысты. Ең көп мән орнатылмаған болса, бос мәнді қайтарады. |
| DataSourceInfo.MaxValue | Нөмірі | Баған сыйдыра алатын ең үлкен сандық мән. Тек сандарды қамтитын бағандарға қатысты. Ең көп мән орнатылмаған болса, бос мәнді қайтарады. |
| DataSourceInfo.MinValue | Нөмірі | Баған сыйдыра алатын ең аз сандық мән. Тек сандарды қамтитын бағандарға қатысты. Ең аз мән орнатылмаған болса, бос мәнді қайтарады. |
| DataSourceInfo.Required | Логика | Бұл баған үшін мән қажет пе? Деректер көзі арқылы орнатылмаған болса, false мәнін қайтарады. |
Үшінші аргумент — жол түріндегі баған атауы. Мысалы, Адамдар ішіндегі Телефон бағаны тырнақшаларды қамтитын "Телефон" түрінде өткізілетін еді.
Деректер көзі туралы ақпарат
Сондай-ақ бүкіл деректер көзі туралы ақпарат алу үшін DataSourceInfo функциясын пайдалануға болады:
| Ақпарат аргументі | Нәтиже түрі | Сипаттама |
|---|---|---|
| DataSourceInfo.AllowedValues | Логика | Осы деректер көзі үшін пайдаланушыларға қандай рұқсаттарды беруге болады? Деректер көзі арқылы орнатылмаған болса, бос мәнді қайтарады. |
| DataSourceInfo.CreatePermission | Логика | Ағымдағы пайдаланушыда осы деректер көзінде жазбалар жасау рұқсаты бар ма? Деректер көзі арқылы орнатылмаған болса, true мәнін қайтарады. |
| DataSourceInfo.DeletePermission | Логика | Ағымдағы пайдаланушыда осы деректер көзінде жазбаларды жою рұқсаты бар ма? Деректер көзі арқылы орнатылмаған болса, true мәнін қайтарады. |
| DataSourceInfo.EditPermission | Логика | Ағымдағы пайдаланушыда осы деректер көзінде жазбаларды өңдеу рұқсаты бар ма? Деректер көзі арқылы орнатылмаған болса, true мәнін қайтарады. |
| DataSourceInfo.ReadPermission | Логика | Ағымдағы пайдаланушыда осы деректер көзінде жазбаларды оқу рұқсаты бар ма? Деректер көзі арқылы орнатылмаған болса, true мәнін қайтарады. |
Ескертпе
DataSourceInfo нысаны ағымдағы пайдаланушыда сұралған рұқсаттың бар-жоғын анықтай алмаса шын мәнін қайтарады. Рұқсаттарды сервер нақты жұмыс жүргізілген кезде қайтадан тексеріп, егер оған рұқсат етілмеген болса, қате көрсетіледі. Бұл уақытта DataSourceInfo мүмкіндігі көмегімен рұқсаттарды басқару тек Microsoft Dataverse қызметін пайдалану кезінде мүмкін болады.
Синтаксис
DataSourceInfo( DataSource, Ақпарат [, Баған атауы ])
- DataSource – Міндетті. Пайдаланатын деректер көзі.
- Information – Міндетті. Шығарып алғыңыз келетін ақпарат түрі.
- ColumnName – Міндетті емес. Баған деңгейіндегі ақпаратты шығарып алатын баған атауы. Деректер көзі деңгейіндегі ақпарат үшін ColumnName аргументін пайдалану мүмкін емес.
Ескертпе
Power Apps 3.24042 нұсқасына дейін баған атаулары қос тырнақшаларды пайдаланып мәтін жолы арқылы көрсетілді және деректер көзі қосылған болса, олар да логикалық атаулар болуы керек еді. Мысалы, "cr43e_name" қос тырнақшасы бар логикалық атау Аты тырнақшасыз көрсетілу атауының орнына қолданылды. . Бос орындар бар баған атаулары бар SharePoint және Excel деректер көздері үшін әрбір бос орын "_x0020_" арқылы көрсетілді, мысалы "Баған атауы" а "Баған_x0020_Атауы". Осы нұсқадан кейін барлық қолданбалар осы мақалада сипатталған жаңа синтаксиске автоматты түрде жаңартылды.
Мысалдар
Бұл бөлімдегі мысалдарда IceCream деп аталатын осы деректер көзі пайдаланылады:
Сондай-ақ деректер көзі мына ақпаратты қамтамасыз етті:
- Мөлшер үшін көрсетілетін атау — "Quantity on Hand".
- Түрі өрісінің максималды ұзындығы — 30 таңба.
- Түрі бағаны мәнді қамтуы керек. Мөлшері бағаны міндетті емес.
- Ең аз Мөлшер — 0.
- Ең үлкен Мөлшер — 100.
- Ағымдағы пайдаланушы IceCream деректер көзінің жазбаларын оқи және өңдей алады, бірақ жазбаларды жасай немесе жоя алмайды.
| Формула | Сипаттама | Нәтиже |
|---|---|---|
| DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Саны ) | IceCream деректер көзінің Мөлшер бағанының көрсетілетін атауын қайтарады. | "Қолдағы саны" |
| DataSourceInfo( IceCream, DataSourceInfo.MaxLength, дәм) | IceCream деректер көзінің Түрі бағаны үшін жолдың ең үлкен ұзындығын қайтарады. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, дәм) | IceCream деректер көзінің Түрі бағаны міндетті ме? | true |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Саны ) | IceCream деректер көзінің Мөлшер бағаны міндетті ме? | false |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, саны) | IceCream деректер көзінің Мөлшер бағанының ең үлкен сандық мәнін қайтарады. | 100-көше |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, саны) | IceCream деректер көзінің Мөлшер бағанының ең аз сандық мәнін қайтарады. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Ағымдағы пайдаланушы IceCream деректер көзіндегі жазбаларды оқи алады ма? | true |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Ағымдағы пайдаланушы IceCream деректер көзіндегі жазбаларды өңдей алады ма? | true |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Ағымдағы пайдаланушы IceCream деректер көзінде жазбаларды жасай алады ма? | false |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Ағымдағы пайдаланушы IceCream деректер көзіндегі жазбаларды жоя алады ма? | false |