Power Apps бағдарламасынан Azure DevOps қосылымына қосылу

Мақала
01/25/2024

Azure DevOps арналған Power Apps коннекторы Azure DevOps данасымен жұмыс істеуге мүмкіндік береді. Сұрауларды көруге Azure DevOps , әр түрлі жұмыс элементі түрлеріне негізделген жұмыс элементтерін таңдауға және оған қосылатын кенеп бағдарламасының ішінен барлық мәліметтерді көруге немесе өңдеуге болады Azure DevOps.

Шайпұл

Әрекеттердің толық тізімін Azure DevOps коннектор әрекеттері бөлімінен қараңыз.

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

Алғышарттар

Мынадай талаптарды орындау қажет:

Power Apps лицензиясы. Лицензияңыз болмаса, 30 күндік сынақ нұсқасын пайдаланыңыз немесе өндірістік емес пайдалануға үшін әзірлеуші жоспарына тіркеліңіз.
Power Apps жүйесін жаңадан пайдаланып жатсаңыз, Power Apps негіздерімен бағдарлама жасау арқылы және содан кейін бағдарламаның басқару элементтерін, галереяны, пішіндерді және карталарды теңшеу арқылы танысыңыз.
Қосылу үшін пайдаланылатын бос кенеп бағдарламасы Azure DevOps.
Осы мақалада танымал бағдарламаны жасау үшін ұйымды, жобаны және өңдеуге қол жетімді бірнеше үлгі жұмыс элементтері бар ортақ сұрауды қамтитын нұсқа қажет Azure DevOps болады.
Azure DevOps Нұсқа OAuth арқылы үшінші тарап қолданбасының қатынасу мүмкіндігі үшін іске қосылуы тиіс. Қосымша ақпарат алу үшін Кіру саясатын басқару бөлімін қараңыз Azure DevOps.

1-қадам - деректер көзі қосу Azure DevOps

Azure DevOps жүйесіне қосылу үшін бос кенеп бағдарламасын өңдеңіз және Azure DevOps деректер көзін қосыңыз.

Қосылыңыз Azure DevOps.

Егер сізде Azure DevOps қосылымы болмаса, Қосылу түймешігін таңдаңыз және мәліметтерді беру үшін нұсқауларды орындаңыз, содан кейін бағдарламаға қосылуға рұқсат беріңіз.

2-қадам - Ортақ сұраулар тізімі

Бұл бөлімде біз ListQueriesInFolder әрекетін Azure DevOps коннекторы үшін қолжетімді сұрауларды тізімдеу үшін пайдаланамыз.

Сол жақ тақтадан Енгізу > Орналасу > Бос тік галерея тармағын таңдаңыз.
Мысал параметр мәндерін қажетінше ауыстыру арқылы галереяның Элементтер сипаты үшін келесі формуланы енгізіңіз.
```
AzureDevOps.ListQueriesInFolder("Project","Organization","Folder").value
```

Тігінен жиынтықтың Элементтер сипатына қосылған формуланы пайдаланып қалтадағы сұрауларды тізімдеу.

Егер мысалда «Жоба», «Ұйымдастыру» және «Қалта» айнымалылары пайдаланылса және нақты мәндер формула жолағының астындағы мәтін жолақтарында (бөлектелген) болады. Жоба және Ұйым мәндерін Azure Dev Ops қызметіне қосылу үшін пайдаланылатын URL мекенжайынан таба аласыз. Қалта әдетте «Ортақ сұраулар» немесе «Менің сұрауларым» болады.

Azure Dev Ops нұсқасының жоба және ұйым атауын тауып алыңыз.

Егер жоғарыда көрсетілген формулада келесі қатені алсаңыз, ұйымыңыздағы OAuth арқылы үшінші тарап бағдарламасына қатынасу мүмкіндігін қосыңыз және қайталап көріңіз Azure DevOps .
AzureDevOps.ListQueriesInFolder:"күй":{401", хабар": "TF400813:User 'GUID' бұл ресурсқа кіруге рұқсаты жоқ.}

Галерея үшін Орналасу және Тақырып және субтитр параметрін таңдаңыз.
Тақырып және субтитрлар үшін Azure Dev Ops үшін атау және қалталар ретінде сәйкес өрістерді таңдаңыз.

Сұрауларды тізімдеуге арналған жиынтық өрістері.

3-қадам - Жұмыс элементтерінің тізімі

Енді таңдалған сұрау үшін барлық жұмыс элементтерін тізімдеу үшін қосқыш үшін GetQueryResultsV2 әрекетін пайдаланамыз Azure DevOps . Бұл галереяны деректер көзі байланыстырады.

Басқа бос тік галереяны енгізіп, оны бар галереяның оң жағына орналастырыңыз.
Мысал параметр мәндерін қажетінше ауыстыру арқылы галереяның Элементтер сипаты үшін келесі формуланы енгізіңіз. Жоба және Ұйым атауларын сәйкесінше алмастырыңыз.
```
AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value
```

Таңдалған сұрау негізінде бұрыннан бар жиынтықтан сұрау нәтижелерін алыңыз...

Бұл формула GetQueryResultsV2 әрекетін жоба атымен, сұрау идентификаторымен және ұйым атымен пайдаланады. Осы мысалдағы сұрау идентификаторы (Gallery2.Selected.Id) бұрын қосылған галерея арқылы қолжетімді сұраулар тізімінен таңдалған сұрауды білдіреді. Галерея атауын сәйкесінше ауыстырыңыз.

Жиынтыққа терілмеген қайтару мәндерін қосу

GetQueryResultsV2-нің қайтарылған нәтижесі серпінді. Сондықтан да мәндері де сызылмаған.

Тақырыптың, жұмыс элементінің түрінің жұмыс элементі өрістерін көрсету.

Дегенмен кейбір мәндерге қатынасуға болады. Azure Dev Ops терілген барлық элементтер үшін негізгі мәндер жиынтығын қайтарады. Жиынтықтағы деректер картасын таңдап, екі мәтін белгісін кірістіріңіз. Жапсырмалардың мәтіндік сипатын былай орнатыңыз:

    ThisItem.Value.'System.WorkItemType'
    ThisItem.Value.'System.Title'

4-қадам - Жұмыс элементтерін көрсету

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

Екі галереяны да экранның сол жағына жылжыту арқылы қосатын өңдеу пішініне арналған бөлме жасау үшін экрандағы екі галереяны орнатыңыз.
Экранға Өңдеу пішіні түймешігін қосыңыз және оны галереялардың оң жағына жылжытыңыз.

Өңдеу пішінін қосыңыз.

Өңдеу пішінінің DataSource сипатын орнатыңыз AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value. Жоба және Ұйым атауларын сәйкесінше алмастырыңыз.
Өңдеу пішінінің Элемент сипатын Gallery2.Selected параметріне орнатыңыз.

Бұл формула өңдеу пішініне арналған Элемент сипатын жұмыс элементтерінің тізімінде таңдалған жұмыс элементіне орнатады.
Экранның оң жағындағы сипат тақтасынан Өрістерді өңдеу түймешігін таңдаңыз.
Таңдау ... (эллипсис) > Қосымша картаны көрсету.
Деректер картасын жоғарғы жағындағы өңдеу пішінінде қайта реттеңіз.
Реттелетін картаны таңдап, Мәтін енгізу басқару элементін енгізіңіз. Таңдағаннан кейін басқару элементі реттелетін карта ішіне қосылады.
Мәтінді енгізуді басқару элементінің өлшемін үлкейтіңіз.

Реттелетін карта ішіндегі мәтінді енгізуді басқару элементі.

Мәтінді енгізу басқару элементінің әдепкі сипатын орнатыңыз Text(ThisItem.Value.'System.Title'). Мәтін функциясы 'түрлері' қайтарымы мәтін ретінде.

Бұл жұмыс элементінің тақырыбына сілтеме жасай отырып, мәтінді енгізуді басқару.

Бұл формула мәтін енгізуді басқару элементіндегі әдепкі мәтінді таңдалған Azure DevOps жұмыс элементіндегі Тақырып өрісіне орнатады.

Шайпұл

Егер жобаңызда Azure DevOps HTML немесе пішімделген мәтіні бар Сипаттама өрісі пайдаланылса, мәтін енгізу немесе белгі басқару элементтерінің орнына Rt мәтін өңдегішінің кіріс басқару элементін пайдалануға болады. Сондай-ақ бұл жағдайда Пішімделген мәтін өңдегіші басқару элементін пайдалану қарапайым немесе пішімделген мәтіннің орнына HTML кодымен көрсетілетін сипаттама сияқты кез келген мәселелерді шешуге көмектеседі.

Әдепкі сипат орнатылған мәтінді енгізу басқару элементі бар басқа реттелетін картаны қосу үшін алдыңғы қадамдарды қайталаңыз Text(ThisItem.Value.'System.State').

Бұл формула таңдалған жұмыс элементінен Мемлекет өрісіне мәтін енгізу басқару элементінің ішіндегі әдепкі мәтінді Azure DevOps орнатады.
Сақтау белгішесін қосатын орынды жасау үшін өңдеу пішінінің ішіндегі деректер карталарын қайта реттеңіз.

Пішіндеріңізге терілмеген және динамикалық қайтарым мәндерін қосу

Осы уақытқа дейін барлық деректер карталары жұмыс істей алатын жалпы DataSource және Item сипатын ұсыну арқылы деректерге қол жеткізу тарихын жеңілдететін Өңдеу пішінін қолданып жүрміз. Егер Өңдеу пішінін пайдалансаңыз, терілмеген мәндерге қатынасу үшін деректер көзі және элемент сипаттарын келесідей орнатқаныңызға көз жеткізіңіз: (Ұйым және Жоба үшін мәндеріңізді алмастыру.)

   AzureDevOps.GetWorkItemDetails(Gallery2.Selected.Value.'System.Id',Organization, Project, Gallery2.Selected.Value.'System.WorkItemType')

«WorkItemType» мәтіндік сипатын, мысалы, «Мүмкіндікті» өткізгенде, ол мүмкіндіктер және жұмыс элементтері сияқты элементтерден ауысуға мүмкіндік береді. Бұл элементтерге арналған өрістер жиыны бір-бірінен ерекшеленетіндіктен, осы қоңыраудан қайтару түрі серпінді болады.

Мәтін (ThiceItem.Value) жалпы әдісін пайдаланып нақты мәндерге қатынасуға болады. System.Id'). Балама ретінде оларға Text(ThisItem.fields.System_Id) арқылы неғұрлым жалпы динамикалық жауап арқылы кіруге болады. Бұл динамикалық мән атаулары әдетте құжатталмаған. Стандартты емес өрістерді қоса алғанда, осы өрістердің дұрыс атауларын табу үшін монитор құралын ашыңыз және GetWorkItemDetails қоңырауына арналған деректер жауабын тексеріңіз. Қосымша нұсқау алу үшін төмендегі суретке сілтеме жасаңыз.

Егер өңдеу пішінін пайдаланбасаңыз, бірақ оның орнына контейнерді пайдалансаңыз, онда төмендегі формуланы пайдалану арқылы осы мәндерді шығарып алуға болады, ол реттелетін топ өрісінен ақпаратты шығарып алады.

Text(AzureDevOps.GetWorkItemDetails(Gallery2.Selected.Value.'System.Id',Organization, Project, Gallery2.Selected.Value.'System.WorkItemType').fields.One_custom_CustomField1)

Жұмыс элементінің тақырыбына сілтеме жасайтын мәтінді енгізуді басқару элементі.

Мәндерді жаңарту Azure DevOps

Azure Dev опцияларындағы мәнді жаңарту үшін Түймешіктің OnSelect бағдарламасында UpdateWorkItem функциясын пайдаланыңыз.

AzureDevOps.UpdateWorkItem(
    Gallery2.Selected.Value.'System.Id', 
    Organization, 
    {   description: "This is a new description", 
        dynamicFields: ParseJSON(JSON({'Custom Field 1': "This is new custom text" })) 
    }
);

Формула жаңа үлгі мәтінін қосады, бірақ PowerFx өрнегін де пайдалануға болады.

Формуланың реттелмейтін немесе кіріктірілген өріс атаулары үшін төменгі корпусты пайдалануын қамтамасыз ету. Мысалы, "Сипаттама" өрісіне сілтеме жасағанда оның орнына қолданыңыз description: "This is a new description" Description:"This is a new description". Дұрыс емес қаптама «400 Сұралған операция үшін қажет параметр жоқ: 'UpdateWorkItem' қатесі болуы мүмкін. Реттелетін/динамикалық мәндер үшін дисплей өрісінің қалыпты гильзасын пайдалануға болады. Мысалы, реттелетін өрістің өріс атауы тек 'Custom Field 1' дегенді көрсетеді. Қайтару мәндерiнiң осы атауы конвенциясы басқа қызметтерге Azure DevOps тән және олардан ерекшеленуi мүмкiн.

Келесі қадамдар

Бағдарламаны ойнатыңыз. Сұраулар тізімінен сұрауды таңдаңыз. Содан кейін тақырыбын немесе сипаттамасын жаңартқыңыз келетін жұмыс элементін таңдаңыз. Өзгеріс енгізіп, сақтау түймешігін таңдаңыз. Өзгерістер Azure DevOps жұмыс элементіне сақталады. Басқа сұрауға ауысып, бағдарлама ішінде көрсетілетін өзгерістерді көру үшін кері ауысыңыз.

Сол сияқты, бағдарламаны одан әрі теңшеңіз немесе пішіндерде қосымша деректер карталары бар бағдарлама жасаңыз. Сондай-ақ әртүрлі деректер карталарының ішіндегі деректерді көрсету үшін пішінді өңдеудің орнына көрсету пішінін пайдалануға болады. Көрсету пішінін пайдаланған кезде, мәтінді көрсету үшін Мәтін белгісі басқару элементін пайдаланғаныңызға көз жеткізіңіз. Пішімделген мәтін немесе HTML пішімін пайдаланған кезде (мысалы, Azure DevOps жүйесіндегі Сипаттама өрісі), HTML мәтіні басқару элеметін пайдаланыңыз. Бұл бағдарламаны теңшеу туралы қосымша ақпарат алу үшін басқару элементтері, галерея, пішіндер және карталар бөлімін қараңыз.

Сонымен қатар қараңыз

Power Apps жүйесіндегі динамикалық схема деректер көздерімен жұмыс істеу (эксперименттік)

Ескерім

Сіз құжат тіліңіздің артықшылықтары туралы айта аласыз ба? Қысқа сауалнамаға қатысыңыз. (бұл сауалнама ағылшын тілінде екеніне назар аударыңыз)

Сауалнама шамамен жеті минут уақытыңызды алады. Жеке деректер жиналмайды (құпиялылық туралы мәлімдеме).

Бөлісу құралы: