Nawiązywanie połączenia z usługą Azure DevOps z poziomu usługi Power Apps

Łącznik usługi Power Apps dla usługi Azure DevOps umożliwia pracę z wystąpieniem usługi Azure DevOps. Wyświetlanie zapytań usługi Azure DevOps, wybieranie elementów roboczych według typu i wyświetlanie lub edytowanie szczegółów — wszystkie z poziomu aplikacji kanwy połączonej z usługą Azure DevOps.

Ten artykuł przeprowadzi Cię przez proces tworzenia aplikacji kanwy łączącej się z usługą Azure DevOps w celu uzyskania listy zapytań i interakcji z elementami roboczymi w projekcie.

Wymagania wstępne

Potrzebne są następujące elementy:

• Licencja Power Apps. Jeśli go nie masz, użyj 30-dniowej wersji próbnej lub zarejestruj się w celu skorzystania z planu dewelopera w celu użycia nieprodukcyjnego.
• Jeśli dopiero zaczynasz korzystać z usługi Power Apps, poznaj podstawy , generując aplikację, a następnie dostosuj kontrolki, galerię, formularze i karty aplikacji.
• Pusta aplikacja kanwy do nawiązania połączenia z usługą Azure DevOps.
• Aby utworzyć aplikację w tym artykule, potrzebujesz wystąpienia usługi Azure DevOps z organizacją, projektem i udostępnionym zapytaniem, które ma kilka przykładowych elementów roboczych dostępnych do edycji.
• Wystąpienie usługi Azure DevOps musi zezwalać na dostęp do aplikacji innej firmy za pośrednictwem protokołu OAuth. Aby uzyskać więcej informacji, zobacz Zarządzanie zasadami dostępu dla usługi Azure DevOps.

Krok 1. Dodawanie źródła danych usługi Azure DevOps

Aby nawiązać połączenie z usługą Azure DevOps, edytujpustą aplikację kanwy i dodaj źródło danych usługi Azure DevOps .

Jeśli nie masz połączenia usługi Azure DevOps, wybierz pozycję Połącz, postępuj zgodnie z monitami, aby wprowadzić szczegóły, i zezwól aplikacji na połączenie.

Krok 2. Wyświetlanie listy udostępnionych zapytań

W tej sekcji użyjesz akcji ListQueriesInFolder dla łącznika usługi Azure DevOps, aby wyświetlić listę dostępnych zapytań.

1. W okienku po lewej stronie wybierz pozycję Wstaw>układ>Pusta galeria pionowa.

2. Wprowadź następującą formułę dla właściwości Items galerii. Zastąp przykładowe wartości parametrów własnymi wartościami.

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

W przykładzie użyto zmiennych "Project", "Organization" i "Folder". Rzeczywiste wartości znajdują się w polach tekstowych poniżej paska formuły (wyróżnione). Wartości projektu i organizacji znajdują się w adresie URL używanym do nawiązywania połączenia z usługą Azure DevOps. Folder to zazwyczaj "Udostępnione zapytania" lub "Moje zapytania".

Jeśli w powyższej formule wystąpi następujący błąd, włącz dostęp do aplikacji innych firm przy użyciu protokołu OAuth w organizacji usługi Azure DevOps i spróbuj ponownie.

"AzureDevOps.ListQueriesInFolder nie powiodło się:{"status":401,"message":"TF400813:Użytkownik 'GUID' nie ma autoryzacji dostępu do tego zasobu."}"

1. Ustaw pozycję Układ galerii na Tytuł i podtytuł.

2. Wybierz pola odpowiednie dla usługi Azure DevOps jako Name (Nazwa ) i FolderOptions (FolderOpcje ) dla tytułu i podtytułów.

Krok 3. Wyświetlanie listy elementów roboczych

Użyj akcji GetQueryResultsV2 dla łącznika usługi Azure DevOps, aby wyświetlić listę wszystkich elementów roboczych dla wybranego zapytania. Ta akcja wiąże galerię ze źródłem danych.

1. Wstaw inną pustą galerię pionową i umieść ją obok istniejącej galerii.

2. Wprowadź następującą formułę dla właściwości Items galerii. Zastąp przykładowe wartości parametrów nazwami projektu i organizacji.

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

Ta formuła używa akcji GetQueryResultsV2 z nazwą projektu, identyfikatorem zapytania i nazwą organizacji. Identyfikator zapytania w tym przykładzie (Gallery2.Selected.Id) odnosi się do zapytania wybranego z listy zapytań dostępnych za pośrednictwem galerii dodanej wcześniej. W razie potrzeby zastąp nazwę galerii.

Dodawanie dynamicznych wartości zwracanych do galerii

Wynik getQueryResultsV2 jest dynamiczny, więc wartości są również dynamiczne.

Możesz jednak uzyskać dostęp do niektórych wartości. Usługa Azure DevOps zwraca podstawowy zestaw wartości dla wszystkich wpisanych elementów. Wybierz kartę danych w galerii i wstaw dwie etykiety tekstowe. Ustaw właściwość text etykiet w następujący sposób:

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

Krok 4. Wyświetlanie elementów roboczych

Aplikacja zawiera listę wszystkich zapytań i listę elementów roboczych dla wybranego zapytania. Teraz dodaj formularz edycji, aby wyświetlić dane.

1. Przenieś obie galerie po lewej stronie ekranu, aby utworzyć miejsce na formularz edycji.

2. Dodaj formularz Edytuj do ekranu i przenieś go do prawej strony galerii.

1. Ustaw właściwość DataSource formularza edycji na AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value. Zastąp ciąg "Project" i "Organization" nazwą projektu i organizacji.

2. Ustaw właściwość Item formularza edycji na Gallery2.Selected.

Ta formuła ustawia właściwość Item formularza edycji na wybrany element roboczy.

1. Wybierz pozycję ... (wielokropek) >Dodaj kartę niestandardową.

1. Przenieś kartę danych na górę formularza edycji.

1. Zwiększ rozmiar kontrolki wprowadzania tekstu.

1. Ustaw właściwość Default kontrolki wprowadzania tekstu na Text(ThisItem.Value.'System.Title')wartość . Funkcja Text zwraca wartość jako tekst.

Ta formuła ustawia domyślny tekst wewnątrz kontrolki wprowadzania tekstu na pole Tytuł z wybranego elementu roboczego usługi Azure DevOps.

1. Powtórz poprzednie kroki, aby dodać kolejną kartę niestandardową z kontrolką wprowadzania tekstu wewnątrz z właściwością Default ustawioną na Text(ThisItem.Value.'System.State')wartość .

Ta formuła ustawia domyślny tekst wewnątrz kontrolki wprowadzania tekstu na pole State z wybranego elementu roboczego usługi Azure DevOps.

1. Zmień kolejność kart danych wewnątrz formularza edycji, aby utworzyć miejsce na ikonę zapisywania.

Dodawanie dynamicznych wartości zwracanych do formularzy

Do tej pory używasz formularza Edycja, który upraszcza dostęp do danych, udostępniając wspólną właściwość DataSource i Item dla wszystkich kart danych w formularzu. Aby uzyskać dostęp do wartości dynamicznych, ustaw zarówno źródło danych, jak i właściwości elementu w następujący sposób (zastąp wartości Organization i Project wartościami):

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

Po przekazaniu właściwości tekstowej "WorkItemType", takiej jak "Funkcja", można przełączać się między elementami, takimi jak Funkcje i elementy robocze. Ponieważ zestaw pól dla tych elementów różni się, typ zwracany z tego wywołania jest dynamiczny.

Uzyskaj dostęp do określonych wartości przy użyciu typowej metody Text(ThisItem.Value.'System). Id'). Alternatywnie uzyskaj dostęp do nich za pośrednictwem bardziej ogólnej odpowiedzi dynamicznej przy użyciu funkcji Text(ThisItem.fields.System_Id). Te nazwy wartości dynamicznych nie są zwykle udokumentowane. Aby znaleźć poprawne nazwy tych pól, w tym pola inne niż standardowe, otwórz narzędzie monitora i sprawdź odpowiedź na dane wywołania GetWorkItemDetails. Zapoznaj się z poniższym obrazem, aby uzyskać wskazówki.

Jeśli nie używasz formularza Edycja, ale używasz kontenera, pobierz te wartości z formułą podobną do poniższej, która pobiera informacje z niestandardowego pola zespołu.

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

Aktualizowanie wartości w usłudze Azure DevOps

Aby zaktualizować wartość w usłudze Azure DevOps, użyj UpdateWorkItem funkcji we OnSelect właściwości przycisku.

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

Formuła dodaje nowy przykładowy tekst, ale można również użyć wyrażenia Power Fx.

Upewnij się, że formuła używa małych liter dla wbudowanych nazw pól. Na przykład w przypadku odwoływania się do pola Opis użyj polecenia description: "This is a new description" zamiast Description: "This is a new description". Nieprawidłowa wielkość liter może spowodować błąd "Brak wymaganego parametru 400 dla żądanej operacji: "UpdateWorkItem". W przypadku wartości niestandardowych lub dynamicznych użyj nazwy wyświetlanej, jak pokazano w interfejsie użytkownika, takiej jak "Pole niestandardowe 1". Ta konwencja nazewnictwa jest specyficzna dla usługi Azure DevOps i może różnić się od innych usług.

Dalsze kroki

Uruchom aplikację. Wybierz zapytanie z listy zapytań. Następnie wybierz element roboczy, którego chcesz zaktualizować tytuł lub opis. Wprowadź zmianę, a następnie wybierz przycisk Zapisz. Aplikacja zapisuje zmiany w elemencie roboczym usługi Azure DevOps. Przejdź do innego zapytania, a następnie przełącz się z powrotem, aby zobaczyć zmiany w aplikacji.

Możesz również dostosować aplikację dalej lub utworzyć aplikację z większą pulą danych na formularzach. Użyj formularza wyświetlania zamiast formularza edycji, aby wyświetlić dane na różnych kartach danych. W przypadku korzystania z formularza wyświetlania użyj kontrolki Etykieta tekstu , aby wyświetlić tekst. W przypadku używania tekstu sformatowanego lub formatu HTML (na przykład pola Opis w usłudze Azure DevOps) użyj kontrolki tekstu HTML . Aby uzyskać więcej informacji na temat dostosowywania aplikacji, zobacz kontrolki, galerię, formularze i karty.

Zobacz także

Praca ze źródłami danych schematu dynamicznego w usłudze Power Apps (eksperymentalna)