Automatyzacja zadań pól na podstawie stanu, przejścia lub powodu
Chcesz automatycznie przejście elementów pracy z jednego stanu do innego Państwa na podstawie zdarzenia, który występuje w innym miejscu w Visual Studio Application Lifecycle Management (ALM) lub zdarzenia, poza Visual Studio ALM.Na przykład można zautomatyzować przejście usterkę z jednego stanu do drugiego w oparciu o występujące w wywołaniu narzędzie do śledzenia.Model typu elementu roboczego i API śledzenia elementów pracy są rozszerzyć w celu obsługi automatycznego przeniesienia elementów roboczych w innych systemach.
Jeśli masz kod, który zmienia stan elementu roboczego można generalize kodu kojarząc akcję zmiana stanu odpowiednie przy użyciu ACTION elementu.Można przekazać wartość działania w celu [WorkItem.GetNextState] metodę w celu uzyskania stanu akcji po tej pozycji roboczych.Pole wyboru w oknie dialogowym Kontrola wersji używa tej metody do rozwiązania usterki i Zamknij zadania, które są skojarzone z zaewidencjonowania.
ACTIONjest elementem opcjonalne podrzędnych ACTIONS.
[!UWAGA]
API śledzenia elementów pracy jest częścią Visual Studio ALM SDK, zgodnie z następującą stronę w witrynie sieci Web firmy Microsoft: rozszerzanie Team Foundation.
Na przykład narzędzie jest wstępnie do automatycznie przejście elementu roboczego na "Rozwiązane" po użytkownika zaewidencjonuje zmianę.Jednak jako dostawca integracji, nie wiadomo, jakie stanu Autor typu elementu roboczego został zadeklarowany jako "Rozwiązany".Autor może oznaczać rozwiązany, zamknięty, ukończone, gotowy do testu, uwzględnić w tworzenie i tak dalej.Jedną z opcji będzie wymagać wszystkich autorów typu elementu roboczego do dołączenia do stanu jawnie o nazwie "Rozwiązania".
Że rozwiązanie jest zbyt ograniczające.Jest również niska z perspektywy międzynarodowe, ponieważ nie umożliwia lokalizacji Stany.Zamiast tego integratorów można zadeklarować akcji, takich jak "Ewidencjonowania" lub "Pełna", która powoduje automatyczne przejście dla elementów pracy.Autor typu elementu roboczego będzie następnie deklarujemy ta akcja na odpowiednie przejścia.
W tym temacie:
Składnia elementu akcji
Kroki wymagane w celu obsługi automatyzacji
Kojarzenie przejście stanu z akcji
Szczegóły akcji przejścia
Sprawdzanie błędów automatycznego przejścia
Składnia elementu akcji
Następująca składnia jest używana do ACTION elementu.Wartość atrybutu określa nazwę akcji i jest wymagany.Należy stosować się do tej samej konwencji nazewnictwa dla akcji dla pola nazwy odwołania.Na przykład Kontrola wersji programu Team Foundation jest używana Microsoft.VSTS.Actions.CheckIn przejście, które jest odpowiednie dla elementów pracy, które są skojarzone z zaewidencjonowania.Aby uzyskać więcej informacji, zobacz Konwencje nazewnictwa obiektów śledzenia elementów pracy.
<ACTION value="NameOfAction" />
minOccurs = "0"
maxOccurs = "niepowiązanego"
Kroki wymagane w celu obsługi automatyzacji
Integrację narzędzie z śledzenia elementów pracy, to narzędzie musi wykonać następujące kroki:
Należy określić, jakie stan elementu roboczego powinien być są przenoszone do po wykonaniu akcji.
Element pracy ustawiany stan "do".
API śledzenia elementów pracy udostępnia metody wykonywania tych kroków.API śledzenia elementów pracy jest częścią Visual Studio ALM SDK.Aby uzyskać więcej informacji, zobacz następujące strony w witrynie firmy Microsoft: zestaw SDK programu Team Foundation Server.
[!UWAGA]
Akcja transakcji, która spowodowała przejście stanu określonego wystąpienia nie jest rejestrowana.Należy śledzić akcji, który spowodował przejścia, możesz określić dodatkowe pracy pole element do śledzenia jego lub można zdefiniować wartość przyczyny.
Powrót do początku
Skojarz przejście stanu z akcji
Akcje przejście stanu umożliwia zautomatyzowanie przejścia elementów roboczych w różnych miejscach ich przepływu pracy.Na przykład Team Foundation Server system kontroli wersji musi obsługiwać automatyczne przejścia elementów roboczych w czasie ewidencjonowania.W tym zdefiniowano akcję "microsoft.vsts.actions.checkin".
Autor typu elementu roboczego można definiować typu elementu roboczego "Nieprawidłowość", który jest w stanie o nazwie "Praca" i używać tego elementu roboczego podczas wprowadzania zmian dewelopera.Autor typu elementu roboczego można zdefiniować innego Państwa o nazwie "Gotowy do tworzenia," co oznacza, że deweloper ma zgłoszone kodu, który został zmodyfikowany przez nieprawidłowość będzie gotowa w godzinach nocnych kompilacji.
Autor może automatycznie przejście elementu pracy ze stanu "Praca", "Gotowy do tworzenia" stan podczas operacji ewidencjonowania przez deklarowania następujące:
<TRANSITION from="Working" to="Ready To Build">
<ACTIONS>
<ACTION value="microsoft.vsts.actions.checkin"/>
</ACTIONS>
</TRANSITION>
Powrót do początku
Szczegóły akcji przejścia
Akcje przejście stanu umożliwia zautomatyzowanie przejścia elementów roboczych w różnych miejscach ich przepływu pracy.Należy rozważyć następujące szczegóły obciążenia o akcjach przejścia:
Przejście akcje są opcjonalne.Jeśli bieżący stan wystąpienia element pracy ma wpis akcji dla określonej akcji, zwraca stan "do".Jeśli nie, wartość zwracana jest wartość Null.Integracji powinna obsługiwać bezpiecznie zwracane wartości Null.Czyli:
Nie są odrzucane.
Pozostaw śledzenia lub dziennika, który wskazuje integracji czy nie przejścia automatycznie, ponieważ jest wymagane akcję, która nie zostanie znaleziony.
Dla każdego typu elementu roboczego akcje musi być unikatowa pary From stan/akcji.Oznacza to, że autorzy typu elementu roboczego nie można określić wiele "do" stanów dla tej samej akcji.
Jednak wiele operacji na tym samym przejścia są obsługiwane zezwalająca na wielu integracji automatycznego przejścia, jak pokazano w następującym przykładzie:
<TRANSITION from="Working" to="Ready To Build"> <ACTIONS> <ACTION value="Microsoft.VSTS.Actions.Checkin"/> <ACTION value="ADatum.Actions.Complete"/> </ACTIONS> </TRANSITION>Nazwy akcji są nazwy programistyczną dla których można używać tylko angielskiego znaków.
Nazwy akcji powinny być zgodne z tą samą konwencją nazw odwołanie jako nazwy odwołania pola, aby uniknąć konfliktów nazw akcji między dostawcy i klienci.Ta konwencja nie są wymuszane przez narzędzie.Visual Studio ALMużywa Microsoft.VSTS.Actions.<your action>.
Sprawdzanie błędów automatycznego przejścia
Integratory spróbować dwa rodzaje automatycznego przejścia.Pierwsza jest przejście automatycznego występujący z powodu czynności użytkownika.Drugi jest przejście automatycznego realizowanych za nienadzorowanej automatyzację, takich jak godzinach nocnych kompilacji.
Akcja użytkownika automatycznie przejścia do tego rodzaju automatycznego przejścia użytkownika znajduje się reagować na pojawiające się problemy związane z reguły.Należy upewnić się, pomocy technicznej sytuacja, która występuje, gdy autor typu elementu roboczego dodaje pole wymagane nie może rozpoznać integracji.Do obsługi tej sytuacji, wykonać automatycznego przejścia, a następnie sprawdzić typu elementu pracy dla naruszeń reguł.Jeśli znajdziesz, wyświetlenie formularza dla użytkownika do rozpoznania.
Automatyzacji nienadzorowanej automatycznego przejścia należy założyć, że żaden użytkownik nie jest wyświetlany, aby rozwiązać te problemy.W takim przypadku integracji, jeżeli nie poprawnego działania.Dziennik błędów powinien stanu, że została podjęta próba automatycznego przejścia i przekazuje on przyczynę awarii.
Określając obydwu typów automatycznego przejścia, należy zdefiniować przejścia tak, aby każdy element pracy osiągnie stan prawidłowy na końcu przejścia bez interwencji użytkownika.Innymi słowy wszystkich reguł zdefiniowanych dla stanu, w której są przenoszone do zostały spełnione podając wartości domyślnych lub kopiowane wartości dla wszystkich pól.Jeśli którekolwiek z pól staje się nieprawidłowy, po przejściu zmiana stanu nie powiedzie się.
Aby pola staje się nieprawidłowy, wykonaj następujące czynności:
Definiowanie DEFAULTREASON za zmianę stanu.
Dla pól, które staje się wymagane po przejściu stanu, użyj DEFAULT lub COPY zasady elementów, aby określić wartość dla pola.
Na przykład utworzono akcji przejścia ewidencjonowania, która przechodzi stan elementu roboczego "Działającym" do "Gotowy do tworzenia".Element roboczy "Gotowy do tworzenia" zasady wymagają ustawić pole "Rozwiązany przez".Następnie należy zdefiniować DEFAULT lub COPY elementu reguły dla "ResolvedBy" w TRANSITION sekcji.Ponadto należy zdefiniować DEFAULTREASON aby upewnić się, że bez interwencji użytkownika można ustawić wymaganego pola.