Prisijungimas prie Azure DevOps iš Power Apps

Power Apps jungtis Azure DevOps leidžia dirbti su Azure DevOps egzemplioriumi. Galite peržiūrėti Azure DevOps užklausas, pasirinkti darbo elementus pagal skirtingus darbo elementų tipus ir peržiūrėti arba redaguoti išsamią informaciją drobės programoje, prie kurios jungiatės Azure DevOps.

Šio straipsnio tikslas yra padėti jums sukurti drobės programą, su kuria būtų galima susisiekti ir Azure DevOps surinkti užklausų sąrašą bei sąveikauti su projekto darbo elementais.

Būtinosios sąlygos

Būtina nustatyti šiuos reikalavimus:

• Turėti „Power Apps“ licenciją. Jei licencijos neturite, naudokite 30 dienų bandomąją versiją arba prisiregistruokite prie kūrėjo plano, skirto naudoti ne gamybai.
• Jei Power Apps nepažįstate, susipažinkite su Power Apps pagrindais generuodami programą ir tada tinkinkite tos programos valdiklius, galeriją, formas ir korteles.
• Tuščia drobės programa , prie kurios galima prisijungti Azure DevOps.
• Norėdami sukurti šiame straipsnyje pateiktą programą, jums reikės Azure DevOps egzemplioriaus, kuriame yra organizacija, projektas ir bendrinama užklausa su keliais darbo elementų pavyzdžiais, kuriuos galima redaguoti.
• Egzempliorius Azure DevOps turi būti įjungtas trečiosios šalies programų prieigai per "OAuth". Daugiau informacijos ieškokite Prieigos strategijų valdymas Azure DevOps.

1 veiksmas - pridėti Azure DevOps duomenų šaltinis

Norėdami prisijungti prie Azure DevOps redaguokite tuščią drobės programą ir įtraukite Azure DevOps duomenų šaltinį.

Jei dar neturite Azure DevOps ryšio, pasirinkite Prisijungti ir pateikite savo informaciją vadovaudamiesi raginimais, o tada leiskite programai prisijungti.

2 veiksmas – bendrinamų užklausų sąrašas

Šiame skyriuje naudosime Azure DevOps jungties veiksmą ListQueriesInFolder, kad nurodytume galimas užklausas.

1. Kairiojoje srityje pasirinkite Įterpti > Maketas > Tuščia vertikali galerija.

2. Įveskite toliau nurodytą galerijos ypatybės Elementai formulę atitinkamai pakeisdami pavyzdines parametrų reikšmes.

   AzureDevOps.ListQueriesInFolder("Project","Organization","Folder").value
   

Jei pavyzdyje naudojami kintamieji "Projektas", "Organizacija" ir "Aplankas", o faktinės reikšmės yra teksto laukeliuose po formulės juosta (paryškinta). Savo projekto ir organizacijos reikšmes galite rasti iš URL, naudojamo prisijungti prie "Azure Dev Ops". Aplankas paprastai bus "Bendrinamos užklausos" arba "Mano užklausos".

Jei gaunate šią klaidą aukščiau pateiktoje formulėje, įgalinkite trečiosios šalies programų prieigą naudodami "OAuth " savo Azure DevOps organizacijoje ir bandykite dar kartą.
"AzureDevOps.ListQueriesInFolder failed:{"status":401,"message":"TF400813:Vartotojas "GUID" neturi teisės pasiekti šio ištekliaus."}

1. Pasirinkite galerijos Maketo reikšmę Pavadinimas ir paantraštė.

2. Pasirinkite laukus, tinkamus "Azure Dev Ops", kaip pavadinimo ir subtitrų pavadinimą ir "FolderOptions ".

3 veiksmas – išvardykite darbo elementus

Dabar jungčiai naudojame veiksmą GetQueryResultsV2 , kad Azure DevOps pateiktume visus pasirinktos užklausos darbo elementus. Tai sieja galeriją su duomenų šaltinis.

1. Įterpkite kitą tuščią vertikalią galeriją ir įdėkite ją esamos galerijos dešinėje pusėje.

2. Įveskite toliau nurodytą galerijos ypatybės Elementai formulę atitinkamai pakeisdami pavyzdines parametrų reikšmes. Jei reikia, pakeiskite savo projektų ir organizacijų pavadinimus.

   AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value
   

Šioje formulėje naudojamas veiksmas GetQueryResultsV2 su projekto pavadinimu, užklausos ID ir organizacijos pavadinimu. Užklausos ID šiame pavyzdyje (Gallery2.Selected.Id) nurodo užklausą, pasirinktą iš užklausų sąrašo, prieinamo anksčiau pridėtoje galerijoje. Atitinkamai pakeiskite galerijos pavadinimą.

Neįvestų grąžinamų reikšmių įtraukimas į galeriją

Grąžintas GetQueryResultsV2 rezultatas yra dinamiškas. Todėl reikšmės taip pat neįrašytos.

Tačiau galite pasiekti kai kurias reikšmes. "Azure Dev Ops" pateikia visų įvestų elementų pagrindinių reikšmių rinkinį. Galerijoje pasirinkite duomenų kortelė ir įterpkite dvi teksto etiketes. Etikečių teksto ypatybę nustatykite taip:

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

4 veiksmas – darbo elementų rodymas

Taikomojoje programoje rodomas visų užklausų sąrašas ir pasirinktos užklausos darbo elementų sąrašas. Dabar galime pridėti redagavimo formą, kurią naudosime tiesiog duomenims rodyti.

1. Sutvarkykite dvi galerijas ekrane, kad atsirastų vietos redagavimo formai, kurią pridedame perkeldami abi galerijas į kairę nuo ekrano.

2. Įtraukite į ekraną redagavimo formą ir perkelkite ją į dešiniąją galerijų pusę.

1. Nustatykite redagavimo formos ypatybę DataSource AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value. Jei reikia, pakeiskite savo projektų ir organizacijų pavadinimus.

2. Nustatykite redagavimo formos ypatybę Elementas kaip Gallery2.Selected.

   Ši formulė darbo elementų sąraše pasirinktam darbo elementui nustato redagavimo formos ypatybę Elementas.

3. Dešiniojoje ekrano pusėje esančioje ypatybių srityje pasirinkite Redaguoti laukus.

4. Pasirinkite ... (daugtaškis) > Įtraukite pasirinktinį kortelė.

   

5. Pertvarkykite duomenų kortelę redagavimo formos viršuje.

   

6. Laikydami pažymėtą pasirinktinę kortelę įterpkite valdiklį Teksto įvestis. Pasirinkus šį valdiklį jis įtraukiamas į pasirinktinę kortelę.

7. Padidinkite teksto įvesties valdiklio dydį.

5. Nustatykite teksto įvesties valdiklio ypatybę Numatytoji Text(ThisItem.Value.'System.Title'). Funkcija Tekstas grąžinimą "įveda" kaip tekstą.

Ši formulė nustato numatytąjį tekstą teksto įvesties valdiklyje lauke Pavadinimas iš pasirinkto Azure DevOps darbo elemento.

6. Pakartokite ankstesnius veiksmus, kad įtrauktumėte kitą pasirinktinį kortelė, kurio viduje yra teksto įvesties valdiklis, kurio ypatybė Numatytoji nustatyta kaip Numatytoji Text(ThisItem.Value.'System.State').

   Ši formulė nustato numatytąjį tekstą teksto įvesties valdiklyje į lauką Būsena iš pasirinkto Azure DevOps darbo elemento.

7. Pertvarkykite duomenų korteles redagavimo formoje ir sukurkite vietos, kur įtrauksime įrašymo piktogramą.

Neįvestų ir dinaminių grąžinamų reikšmių įtraukimas į formas

Iki šiol naudojome redagavimo formą, kuri supaprastina duomenų prieigos istoriją, pateikdama bendrą "DataSource" ir "Item" ypatybę, su kuria gali dirbti visi formoje Kortelės duomenys. Jei naudojate redagavimo formą, norėdami pasiekti neįvestas reikšmes, įsitikinkite, kad nustatėte ir duomenų šaltinis, ir elemento ypatybes, kaip nurodyta toliau: (Organizacijos ir projekto reikšmių pakeitimas.)

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

Kai perduodate teksto ypatybę "WorkItemType", pavyzdžiui, "Funkcija", ji leidžia perjungti elementus, pvz., Funkcijas ir Darbo elementus. Kadangi šių prekių laukų rinkinys skiriasi vienas nuo kito, šio skambučio grąžinimo tipas yra dinaminis.

Konkrečias reikšmes galite pasiekti naudodami bendrą metodą Text(ThisItem.Value.' System.Id"). Arba galite juos pasiekti per bendresnius dinaminius atsakymas naudodami tekstą (ThisItem.fields.System_Id). Šie dinaminių reikšmių pavadinimai paprastai nėra dokumentuojami. Norėdami rasti teisingus šių laukų pavadinimus, įskaitant nestandartinius laukus, atidarykite monitoriaus įrankį ir išnagrinėkite "GetWorkItemDetails" skambučio duomenų atsakymas. Daugiau nurodymų rasite toliau pateiktame paveikslėlyje.

Jei naudojate ne redagavimo formą, o konteinerį, galite nuskaityti šias reikšmes naudodami toliau pateiktą formulę, kuri nuskaito informaciją iš pasirinktinio komandos lauko.

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

Reikšmių naujinimas Azure DevOps

Norėdami atnaujinti reikšmę "Azure Dev ops", naudokite UpdateWorkItem, esantį mygtuko OnSelect dalyje.

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" })) 
    }
);

Formulė įtraukia naują teksto pavyzdį, bet taip pat galite naudoti "PowerFx" išraišką.

Įsitikinkite, kad formulėje nepasirinktiniams arba įtaisytiesiems laukų pavadinimams naudojamos mažosios raidės. Pavyzdžiui, kai nurodote lauką "Aprašymas", naudokite description: "This is a new description" vietoj Description:"This is a new description". Dėl neteisingo korpuso gali atsirasti klaida "400 Trūksta reikiamo parametro prašomai operacijai: "UpdateWorkItem". Pasirinktinėms / dinaminėms vertėms galite naudoti įprastą ekrano lauko korpusą. Pavyzdžiui, pasirinktinio lauko lauko pavadinimas yra tik rodomas pavadinimas "1 pasirinktinis laukas". Ši grąžinamų reikšmių pavadinimų suteikimo konvencija yra būdinga Azure DevOps kitoms paslaugoms ir gali skirtis nuo jų.

Paskesni veiksmai

Paleiskite programą. Pasirinkite užklausą iš užklausų sąrašo. Tada pasirinkite darbo elementą, kurio pavadinimą arba aprašą norite atnaujinti. Atlikite keitimą, tada paspauskite mygtuką „Įrašyti“. Keitimai įrašomi į Azure DevOps darbo elementą. Perjunkite kitą užklausą ir perjunkite atgal, kad pakeitimai būtų rodomi programoje.

Atitinkamai toliau tinkinkite programą arba sukurkite programą su papildomomis formų duomenų kortelėmis. Taip pat galite naudoti rodymo formą vietoje redagavimo formos, kad tiesiog būtų rodomi duomenys skirtingose duomenų kortelėse. Naudodami rodymo formą įsitikinkite, kad tekstui rodyti naudojate teksto žymos valdiklį. Naudodami raiškiojo teksto ar HTML formatą (pvz., Azure DevOps lauką Aprašas), naudokite HTML teksto valdiklį. Daugiau informacijos apie tos programos tinkinimą žr. skyriuose apie valdiklius, galeriją, formas ir korteles.

Taip pat žr.

Darbas su dinaminės schemos duomenų šaltiniais naudojant Power Apps (eksperimentinė)