Povežite se sa uslugom Azure DevOps iz usluge Power Apps

Članak
10/05/2023

Power Apps konektor za Azure DevOps omogućava da radite sa Azure DevOps instancom. Upite možete Azure DevOps da pregledate, izaberete radne stavke na osnovu različitih tipova radnih stavki i prikažete ili uredite detalje iz aplikacije podloge za crtanje sa kojom se povezujete Azure DevOps.

Napojnica

Kompletnu listu svih radnji potražite u članku Radnje Azure DevOps konektora.

Cilj ovog članka je da vas vodi u izradi aplikacije na platnu sa kojom možete da se povežete Azure DevOps kako biste prikupili listu upita i komunicirali sa stavkama rada u projektu.

Preduslovi

Neophodni su sledeći zahtevi:

Power Apps licenca. Ako nemate licencu, koristite 30-dnevnu probnu verziju ili se prijavite za razvojni plan za neproizvodno korišćenje.
Ako ste tek počeli da koristite Power Apps, upoznajte se sa Power Apps osnovama tako što ćete generisati aplikaciju, a zatim prilagodite kontrole, galeriju, obrasce i kartice te aplikacije.
Prazna aplikacija podloge za crtanje koju treba koristiti za povezivanje Azure DevOps.
Da biste kreirali aplikaciju istaknutu u ovom članku, biće vam Azure DevOps potrebna instanca koja uključuje organizaciju, projekat i deljeni upit sa nekoliko probnih radnih stavki dostupnih za uređivanje.
Instanca Azure DevOps mora biti omogućena za pristup aplikacijama nezavisnih proizvođača putem OAutha. Više informacija potražite u članku Upravljanje smernicama za pristup Azure DevOps.

Korak 1 - Dodaj Azure DevOps izvor podataka

Da biste se povezali uslugom Azure DevOps, uredite praznu aplikaciju sa podlogom i Azure DevOps izvor podataka.

Povežite se sa Azure DevOps.

Ako već nemate Azure DevOps vezu, izaberite opciju Poveži se i pratite odzive da biste naveli svoje detalje, a zatim dozvolite aplikaciji da se poveže.

2. korak - Lista deljenih upita

U ovom odeljku ćemo koristiti radnju ListQueriesInFolder da bi Azure DevOps konektor navodio dostupne upite.

U levom oknu izaberite Umetanje > Raspored > Prazna vertikalna galerija.
Unesite sledeću formulu za svojstvo Items galerije sa sledećom formulom umesto naziva tabele, tako što ćete zameniti vrednosti probnih parametara prema potrebi.
```
AzureDevOps.ListQueriesInFolder("Project","Organization","Folder").value
```

Navedite upite u fascikli koristeći formulu dodatu u svojstvo stavke vertikalne galerije.

Ako se u primeru koriste promenljive "Projekat", "Organizacija" i "Fascikla", a stvarne vrednosti se naći u okvirima za tekst ispod polja za formulu (istaknuto). Vrednosti projekta i organizacije možete pronaći iz URL adrese koja se koristi za povezivanje sa Azure Dev Ops. Fascikla će obično biti "Deljeni upiti" ili "Moji upiti".

Pronađite ime projekta i organizacije za instancu Azure Dev Ops.

Ako dobijete sledeću grešku u gorenavedenoj formuli, omogućite pristup aplikacijama nezavisnih proizvođača koristeći OAuth u vašoj Azure DevOps organizaciji i pokušajte ponovo.
"AzureDevOps.ListQueriesInFolder failed:{"status":401,"message":"TF400813:The user 'GUID' isn't authorized to access this resource."}

Izaberite da Raspored galerije bude Naslov i podnaslov.
Odaberite polja prikladna za Azure Dev Ops kao ime i fascikleOpcije za naslov i titlove.

Galerija polja za upite za listing.

3. korak - Lista radnih stavki

Sada koristimo radnju GetQueryResultsV2 da bi Azure DevOps linija spajanja nabrajala sve radne stavke za izabrani upit. Ovo vezuje galeriju za izvor podataka.

Umetnite drugu praznu vertikalnu galeriju i postavite je desno od postojeće galerije.
Unesite sledeću formulu za svojstvo Items galerije sa sledećom formulom umesto naziva tabele, tako što ćete zameniti vrednosti probnih parametara prema potrebi. Zamenite imena projekata i organizacije na odgovarajući način.
```
AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value
```

Nabavite rezultate upita iz postojeće galerije na osnovu izabranog upita..

Ova formula koristi radnju GetQueryResultsV2 sa imenom projekta, ID-om upita i imenom organizacije. ID upita u ovom primeru (Gallery2.Selected.Id) odnosi se na upit izabran sa liste upita dostupnih u galeriji koja je ranije dodata. Zamenite ime galerije na odgovarajući način.

Dodavanje netipiranih povratnih vrednosti u galeriju

Vraćeni rezultat getQueryResultsV2 je dinamičan. A vrednosti su stoga i neukusne.

Prikažite polja radne stavke naslova, vrstu radne stavke.

Međutim, nekim vrednostima možete da pristupite. Azure Dev Ops daje osnovni skup vrednosti za sve stavke koje su otkucane. Izaberite karticu sa podacima u galeriji i umetnite dve tekstualne oznake. Postavite svojstvo teksta nalepnica na sledeći način:

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

4. korak - Prikazivanje radnih stavki

Aplikacija prikazuje listu svih upita i listu radnih stavki za izabrani upit. Sada možemo da dodamo obrazac za uređivanje koji ćemo koristiti za jednostavno prikazivanje podataka.

Rasporedite dve galerije na ekranu da biste napravili mesta za obrazac za uređivanje koji dodajemo premeštanjem obe galerije sa leve strane ekrana.
Dodajte Obrazac za uređivanje na ekran i premestite ga desno od galerija.

Dodajte obrazac za uređivanje.

Postavite svojstvo DataSource obrasca za uređivanje na AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value. Zamenite imena projekata i organizacije na odgovarajući način.
Podesite svojstvo Item obrasca za uređivanje na Gallery2.Selected.

Ova formula postavlja svojstvo Item za obrazac za uređivanje na radnu stavku koja je izabrana na listi radnih stavki.
Izaberite Uredi polja iz okna sa svojstvima na desnoj strani ekrana.
Izaberi ... (elipsa) > Dode prilagođene kartice.
Prerasporedite karticu sa podacima unutar obrasca za uređivanje na vrhu.
Neka prilagođena kartica ostane izabrana, umetnite kontrolu Unos teksta. Kada se izabere, kontrola se dodaje unutar prilagođene kartice.
Povećajte veličinu kontrole unosa teksta.

Kontrola unosa teksta unutar prilagođene kartice.

Postavite podrazumevano svojstvo kontrole unosa teksta na Text(ThisItem.Value.'System.Title'). Funkcija Text 'types' the return as Text.

Ovo je kontrola unosa teksta koja se odnosi na naslov radne stavke.

Ova formula postavlja podrazumevani tekst unutar kontrole unosa teksta na polje Naslov iz izabrane Azure DevOps radne stavke.

Napojnica

Ako projekat koristi Azure DevOps polje "Opis " sa HTML-om ili obogaćenim tekstom, možete da koristite i kontrolu unosa uređivača obogaćenog teksta umesto kontrola unosa teksta ili oznake. Korišćenje kontrole uređivača obogaćenog teksta u ovom slučaju takođe pomaže u rešavanju svih problema kao što je opis koji se prikazuje sa HTML kodom umesto čistog ili obogaćenog teksta.

Ponovite prethodne korake da biste dodali još jednu prilagođenu karticu, sa kontrolom unosa teksta koja je unutra postavljena na podrazumevano svojstvo Text(ThisItem.Value.'System.State').

Ova formula postavlja podrazumevani tekst unutar kontrole unosa teksta na polje " Država" od izabrane radne Azure DevOps stavke.
Prerasporedite kartice sa podacima unutar obrasca za uređivanje da biste kreirali prostor na koji ćemo dodati ikonu za čuvanje.

Dodavanje netipiranih i dinamičkih povratnih vrednosti obrascima

Do sada smo koristili obrazac "Uređivanje" koji pojednostavljuje priču o pristupu podacima obezbeđivanjem zajedničkog svojstva DataSource i Item sa kojim sve kartice sa podacima u obrascu mogu da funkcionišu. Ako koristite obrazac "Uređivanje", da biste pristupili netipiranim vrednostima uverite se da ste postavili i svojstva izvor podataka i stavku na sledeći način: (Zamena u vrednostima za organizaciju i projekat.)

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

Kada prosledite tekstualno svojstvo "WorkItemType", na primer, "Funkcija", omogućava vam da se prebacite sa stavki kao što su "Funkcije" i "Radne stavke". Pošto se skup polja za ove stavke međusobno razlikuje, tip povraćaja od ovog poziva je dinamičan.

Određenim vrednostima možete pristupiti koristeći zajednički metod Text(ThisItem.Value.' System.Id'). Druga mogućnost je da im pristupite putem opšteg dinamičkog odgovora koristeći opciju "Tekst ThisItem.fields.System_Id). Ova imena dinamičkih vrednosti obično nisu dokumentovana. Da biste pronašli ispravna imena za ova polja, uključujući ne-standardna polja, otvorite alatku za monitor i ispitajte odgovor na podatke za poziv GetWorkItemDetails. Pogledajte sliku ispod da biste dali smernice.

Ako ne koristite obrazac za uređivanje, ali umesto toga koristite kontejner, ove vrednosti možete da preuzmete pomoću formule kao što je ona ispod koja preuzima informacije iz prilagođenog polja tima.

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

Kontrola unosa teksta koja se odnosi na naslov radne stavke.

Ažuriranje vrednosti u Azure DevOps

Da biste ažurirali vrednost u Azure Dev ops koristite UpdateWorkItem u prozoru OnSelect dugmeta.

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

Formula dodaje novi probni tekst, ali možete da koristite i PowerFx izraz.

Uverite se da formula koristi niža velika i velika i velika mesta za imena polja koja nisu prilagođena ili su ugrađena. Na primer, kada se pozivate na polje "Opis", koristite umesto description: "This is a new description" Description:"This is a new description". Neispravno kućište može dovesti do greške "400 Zahtevani parametar nedostaje za zahtevanu operaciju: "UpdateWorkItem". Za prilagođene / dinamičke vrednosti možete da koristite normalno kućište polja za prikaz. Na primer, ime polja za prilagođeno polje je samo "ime za prikaz "Prilagođeno polje 1". Ova konvencija o imenovanju povratnih vrednosti je specifična i može Azure DevOps se razlikovati od drugih usluga.

Sledeći koraci

Pokretanje aplikacije. Izaberite upit iz liste upita. A zatim odaberite radnu stavku za koju želite da ažurirate naslov ili opis. Unesite promenu, a zatim izaberite dugme „Sačuvaj“. Promene čuvaju u radnoj stavki Azure DevOps. Prebacite se na drugi upit i vratite se nazad da biste videli prikaz promena unutar aplikacije.

Slično tome, dodatno prilagodite aplikaciju ili kreirajte aplikaciju sa dodatnim karticama sa podacima u obrascima. Obrazac za prikaz možete da koristite i umesto da uređujete obrazac da biste samo prikazali podatke unutar različitih kartica sa podacima. Kada koristite obrazac za prikaz, uverite se da koristite kontrolu tekstualne oznake za prikazivanje teksta. Kada koristite obogaćeni tekst ili HTML format (kao što je polje Opis u usluzi Azure DevOps), koristite kontrolu HTML tekst. Više informacija o prilagođavanju aplikacije potražite u člancima o kontrolama, galeriji, obrascima i karticama.

Pogledajte i ovo

Rad sa izvorima podataka po dinamičkoj šemi u usluzi Power Apps (eksperimentalno)

Napomena

Možete li nam reći o svojim željenim postavkama jezika u dokumentaciji? Ispunite kratku anketu. (imajte na umu da je ova anketa na engleskom jeziku)

Anketa će trajati oko sedam minuta. Ne prikupljaju se lični podaci (izjava o privatnosti).

Deli putem