Pripojenie k Azure DevOps zo služby Power Apps

Článok
08/05/2024

Konektor Power Apps pre Azure DevOps umožňuje pracovať s inštanciou Azure DevOps. Môžete si prezerať Azure DevOps dotazy, vyberať pracovné položky na základe rôznych typov pracovných položiek a zobrazovať či upravovať podrobnosti všetko z aplikácie plátna, ku ktorej sa pripájate Azure DevOps.

Tip

Úplný zoznam všetkých akcií nájdete v časti Akcie konektora Azure DevOps.

Cieľom tohto článku je usmerniť vás pri vytváraní aplikácie na plátne, ktorá sa dokáže spojiť s Azure DevOps a zhromaždiť zoznam dotazov a interagovať s pracovnými položkami v projekte.

Požiadavky

Sú potrebné nasledujúce požiadavky:

Licencia Power Apps. Ak nemáte licenciu, použite 30-dňovú skúšobnú verziu, alebo sa prihláste do plánu vývojára pre nevýrobné použitie.
Ak je pre vás Power Apps novinkou, oboznámte sa so základmi Power Apps prostredníctvom generovania aplikácie a následným prispôsobením ovládacích prvkov, galérie, formulárov a kariet danej aplikácie.
A aplikácia na prázdne plátno na pripojenie Azure DevOps.
Ak chcete vytvoriť aplikáciu uvedenú v tomto článku, budete potrebovať Azure DevOps inštanciu, ktorá zahŕňa organizáciu, projekt a zdieľaný dotaz s niekoľkými vzorovými pracovnými položkami dostupnými na úpravu.
Azure DevOps Inštancia musí byť povolená pre prístup aplikácií tretej strany cez OAuth. Ďalšie informácie nájdete v časti Správa zásad prístupu pre Azure DevOps.

Krok 1 – Pridať Azure DevOps zdroj údajov

Na pripojenie k Azure DevOps, upravte prázdnu aplikáciu plátna a pridajte k zdroju údajov Azure DevOps.

Pripojte sa k Azure DevOps.

Ak ešte nemáte pripojenie Azure DevOps, stlačte možnosť Pripojiť a postupujte podľa pokynov na zadanie svojich podrobností a potom povoľte aplikácii pripojiť sa.

Krok 2 – Zoznam zdieľaných dopytov

V tejto časti použijeme akciu ListQueriesInFolder pre konektor Azure DevOps na zoznam dostupných dopytov.

Na ľavej table stlačte možnosť Vložiť > Rozloženie > Prázdna zvislá galéria.
Vo vlastnosti Položky galérie zadajte nasledovný vzorec, čím sa nahradia ukážkové hodnoty parametra.
```
AzureDevOps.ListQueriesInFolder("Project","Organization","Folder").value
```

Zoznam dopytov v priečinku pomocou vzorca pridaného do vlastnosti Items vertikálnej galérie.

Ak príklad používa premenné "Projekt", "Organizácia" a "Priečinok" a skutočné hodnoty sú v textových poliach pod riadkom vzorcov (zvýraznené). Hodnoty projektu a organizácie nájdete z adresy URL, ktorá sa používa na pripojenie k Azure Dev Ops. Priečinok bude zvyčajne „Zdieľané dopyty“ alebo „Moje dopyty“.

Nájdite názov projektu a organizácie pre svoju inštanciu Azure Dev Ops.

Ak sa vo vzorci vyššie zobrazí nasledujúca chyba, povoľte vo svojej organizácii prístup aplikácie tretej strany pomocou protokolu OAuth a skúste to znova. Azure DevOps
"AzureDevOps.ListQueriesInFolder zlyhal:{"status":401,"message":"TF400813:Používateľ 'GUID' nemá oprávnenie na prístup k tomuto zdroju."}

Stlačte možnosť Rozloženie pre galériu pre Názov a titulky.
Vyberte polia vhodné pre Azure Dev Ops ako Názov a FolderOptions pre názov a titulky.

Polia galérie pre zoznam dopytov.

Krok 3 - Zoznam pracovných položiek

Teraz použijeme akciu GetQueryResultsV2 pre konektor Azure DevOps na zobrazenie všetkých pracovných položiek pre vybratý dotaz. Toto spája galériu s zdroj údajov.

Vložte ďalšiu prázdnu vertikálnu galériu a umiestnite ju na pravú stranu existujúcej galérie.
Vo vlastnosti Položky galérie zadajte nasledovný vzorec, čím sa nahradia ukážkové hodnoty parametra. Podľa potreby nahraďte názov projektu a organizácie.
```
AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value
```

Získajte výsledky dopytu z existujúcej galérie na základe vybratého dopytu.

Tento vzorec používa akciu GetQueryResultsV2 s názvom projektu, ID dotazu a názvom organizácie. ID dopytu v tomto príklade (Gallery2.Selected.Id) odkazuje na dotaz vybraný zo zoznamu dotazov dostupných prostredníctvom galérie pridanej skôr. Podľa potreby nahraďte názov galérie.

Pridanie nezadaných návratových hodnôt do vašej galérie

Vrátený výsledok GetQueryResultsV2 je dynamický. A hodnoty sú preto tiež nezadané.

Zobraziť polia pracovnej položky s názvom, typom pracovnej položky.

K niektorým hodnotám však máte prístup. Azure Dev Ops vráti základnú množinu hodnôt pre všetky zadané položky. Vyberte údaje karta v galérii a vložte dva textové štítky. Nastavte vlastnosť textu štítkov takto:

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

Krok 4 - Zobrazte pracovné položky

Aplikácia zobrazuje zoznam všetkých dotazov a zoznam pracovných položiek pre vybratý dotaz. Teraz môžeme pridať editačný formulár, ktorý použijeme na jednoduché zobrazenie údajov.

Usporiadajte dve galérie na obrazovke tak, aby ste vytvorili priestor pre formulár úprav, ktorý pridáme presunutím oboch galérií doľava na obrazovke.
Pridajte na obrazovku možnosť Upraviť formulár a presuňte ho na pravú stranu galérií.

Pridať formulár na úpravu.

Vlastnosť DataSource v editačnom formulári nastavte na AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value. Podľa potreby nahraďte názov projektu a organizácie.
Nastavte vlastnosť Položka formulára úpravy na Gallery2.Selected.

Tento vzorec nastavuje vlastnosť Položka pre formulár úprav na pracovnú položku, ktorá je vybratá v zozname pracovných položiek.
Stlačte možnosť Upraviť polia na table vlastnosti na pravej strane obrazovky.
Vyberte ... (elipsa) > Pridať vlastné karta.
Usporiadajte kartu údajov vo formulári úprav v hornej časti.
Ponechajte zvolenú vlastnú kartu a vložte ovládací prvok Zadávanie textu. Po výbere sa ovládací prvok pridá do vlastnej karty.
Zväčšite veľkosť ovládacieho prvku zadávania textu.

Ovládací prvok zadávania textu vo vlastnom karta.

Vlastnosť Predvolené ovládacieho prvku zadávania textu nastavte na Text(ThisItem.Value.'System.Title'). Funkcia Text „typuje“ návrat ako Text.

Toto je ovládanie zadávania textu odkazujúce na názov pracovnej položky.

Tento vzorec nastavuje predvolený text v ovládacom prvku zadávania textu na pole Názov vybranej pracovnej položky Azure DevOps.

Tip

Ak váš Azure DevOps projekt používa pole Popis s HTML alebo formátovaným textom, môžete použiť aj editor formátovaného textu ovládanie vstupu namiesto vstupu textu alebo ovládacích prvkov štítkov. Pomocou ovládacieho prvku Rich text editor v tomto prípade tiež pomáha vyriešiť akékoľvek problémy, ako napríklad zobrazenie popisu s kódom HTML namiesto obyčajného alebo formátovaného textu.

Opakujte predchádzajúce kroky a pridajte ďalšie vlastné karta s ovládacím prvkom na zadávanie textu vo vnútri s Predvolené vlastnosťou nastavenou na Text(ThisItem.Value.'System.State').

Tento vzorec nastaví predvolený text v ovládacom prvku zadávania textu na pole Stav z vybratej Azure DevOps pracovnej položky.
Usporiadajte karty údajov vo formulári úprav, aby ste vytvorili priestor, kam pridáme ikonu uloženia.

Pridanie nezadaných a dynamických návratových hodnôt do formulárov

Doteraz sme používali formulár na úpravu, ktorý zjednodušuje príbeh o prístupe k údajom tým, že poskytuje spoločnú vlastnosť DataSource a Item, s ktorou môžu pracovať všetky údaje Karty vo formulári. Ak použijete editačný formulár, na prístup k nezadaným hodnotám sa uistite, že ste nastavili obe vlastnosti zdroj údajov a položky takto: (Nahradením hodnôt pre Organizáciu a Projekt.)

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

Keď odovzdáte vlastnosť textu "WorkItemType", napríklad "Feature", umožní vám to prepínať z položiek, ako sú funkcie a pracovné položky. Keďže množina polí pre tieto položky sa navzájom líši, typ návratu z tohto volania je dynamický.

Ku konkrétnym hodnotám môžete pristupovať pomocou bežnej metódy Text(ThisItem.Value.'System.Id'). Prípadne k nim môžete pristupovať prostredníctvom všeobecnejšieho dynamického odpoveď pomocou Text(ThisItem.fields.System_Id). Tieto názvy dynamických hodnôt nie sú zvyčajne zdokumentované. Ak chcete nájsť správne názvy týchto polí, vrátane neštandardných polí, otvorte nástroj monitorovania a preskúmajte údaje odpoveď pre volanie GetWorkItemDetails. Ďalšie pokyny nájdete na obrázku nižšie.

Ak nepoužívate formulár na úpravu, ale namiesto toho používate kontajner, môžete tieto hodnoty získať pomocou vzorca, ako je ten nižšie, ktorý získava informácie z vlastného tímového poľa.

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

Ovládací prvok zadávania textu, ktorý odkazuje na názov pracovnej položky.

Aktualizujú sa hodnoty v Azure DevOps

Ak chcete aktualizovať hodnotu v Azure Dev ops, použite UpdateWorkItem v OnSelect tlačidla.

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

Vzorec pridá nový vzorový text, ale môžete použiť aj výraz PowerFx.

Uistite sa, že vzorec používa malé písmená pre nevlastné alebo vstavané názvy polí. Napríklad pri odkaze na pole „Popis“ použite description: "This is a new description" namiesto Description:"This is a new description". Nesprávne veľké a malé písmená môžu viesť k chybe „400 Požadovaný parameter chýba pre požadovanú operáciu: 'UpdateWorkItem'“. Pre vlastné/dynamické hodnoty môžete použiť normálne veľké a malé písmená v poli zobrazenia. Napríklad názov poľa pre vlastné pole je len zobrazovaný názov „Vlastné pole 1“. Táto konvencia pomenovania návratových hodnôt je špecifická pre Azure DevOps a môže sa líšiť od iných služieb.

Ďalšie kroky

Prehrajte aplikáciu. Zvoľte si dotaz zo zoznamu dotazov. Potom vyberte pracovnú položku, ktorej názov alebo popis chcete aktualizovať. Vykonajte zmenu a následne stlačte tlačidlo uloženia. Zmeny sa ukladajú do pracovnej položky Azure DevOps. Prepnite na iný dotaz a prepnite späť, aby ste videli zmeny zobrazené v aplikácii.

Podobne si aplikáciu prispôsobte ďalej alebo vytvorte aplikáciu s ďalšími kartami s údajmi vo formulároch. Môžete tiež použiť zobrazovací formulár namiesto editačného formulára na zobrazenie údajov na rôznych dátových kartách. Pri používaní zobrazovacieho formulára sa uistite, že používate ovládací prvok Textový štítok na zobrazenie textu. Pri použití formátovaného textu alebo formátu HTML (ako napr. pole Popis v Azure DevOps), použite ovládací prvok HTML text. Ďalšie informácie o prispôsobení tejto aplikácie nájdete v časti ovládacie prvky, galéria, formuláre a karty.

Pozrite si tiež

Práca s dynamickou schémou zdrojov údajov v Power Apps (experimentálna)

Poznámka

Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)

Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).

Zdieľať cez