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 zdarzenie , który występuje w innych miejscach w Visual Studio Application Lifecycle Management (ALM) lub zdarzenie występującego poza Visual Studio ALM.Na przykład można zautomatyzować przejścia usterka z jednego Państwa do drugiego w oparciu o to, co dzieje się w narzędziu śledzenie wywołania.Model typ elementu pracy i API śledzenia elementu pracy zostaje rozszerzony o obsługuje automatyczne przenoszenie elementów pracy w innych systemach.
Jeśli kod, który zmienia stan element roboczymożna generalize tego kodu, kojarząc z przejściem właściwe Państwo swoje działania przy użyciu ACTION element.Można przekazać wartość działania w celu [WorkItem.GetNextState] metoda get post-action stan tego element roboczy. kontrola wersji wyboru w okno dialogowe używa tej metoda rozpoznać błędów i zamknąć zadania, które są skojarzone z wyboru w.
ACTIONelement opcjonalny element podrzędny jest ACTIONS.
[!UWAGA]
API śledzenia elementu pracy jest częścią Visual Studio ALM SDK, zgodnie z opisem następujące strony w witrynie firmy Microsoft w sieci Web: Rozszerzanie Team Foundation.
Na przykład narzędzie jest wstępnie do automatycznie przejście element roboczy , aby "Rozwiązany" po użytkownik sprawdza, czy zmiana.Jednakże jak integracja dostawca, nie wiadomo jakie Państwo Autor typ elementu pracy został zadeklarowany jako "Rozpoznane".Autor może oznaczać rozwiązany, zamknięty, zakończone, gotowy do badania, obejmują w budowanie i tak dalej.Jedną z opcji będzie wymagać, aby wszystkie prace autorzy typ elementu obejmują Państwo wyraźnie o nazwie "Rozwiązany".
rozwiązanie jest zbyt restrykcyjne.Jest również słaba z międzynarodowego punktu widzenia, ponieważ nie powoduje włączenia lokalizacja Państwa.Zamiast tego integratorów można zadeklarować działanie, takie jak "Check-in" lub "Zakończ", która powoduje automatyczne przejście, elementów roboczych.Autor typ elementu prac będzie następnie zadeklarować tej akcji odpowiednie przejście.
W tym temacie
Składnia dla elementu działania
Kroki wymagane do obsługi Automatyzacja
Kojarzenie przejście stanu z akcji
Szczegóły działania przejścia
Sprawdzanie błędów automatycznego przejścia
Składnia dla elementu działania
Następująca składnia jest używana dla ACTION element.Wartość atrybut Określa nazwę akcji i jest wymagany.Należy wykonać tej samej konwencji nazewnictwa dla działań jako nazwy pole w odniesienia.Na przykład Kontrola wersji programu Team Foundation używa Microsoft.VSTS.Actions.CheckIn do identyfikowania przejścia, która jest odpowiednia dla elementów pracy, które są skojarzone z wyboru w.Aby uzyskać więcej informacji, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.
<ACTION value="NameOfAction" />
minOccurs = "0"
maxOccurs = "niepowiązany"
Kroki wymagane do obsługi Automatyzacja
Zintegrowanie narzędzie ze śledzeniem zapasu pracy, narzędzie, należy wykonać następujące kroki:
Należy określić, co Państwo, że przenoszone element roboczy do podczas wykonywania akcji.
Można ustawić element roboczy do stanu "do".
API śledzenia elementu pracy zapewnia metody wykonywania tych kroków.API śledzenia elementu pracy jest częścią Visual Studio ALM SDK.Aby uzyskać więcej informacji, zobacz następujące strony w witrynie firmy Microsoft w sieci Web: Team Foundation Server SDK.
[!UWAGA]
Akcja transakcji, która spowodowała przejścia określonym stanie występować nie jest rejestrowana.Należy śledzić działania, który spowodował przejście, można określić dodatkowy element roboczy pole do śledzenia lub można zdefiniować wartość przyczyny.
Powrót do początku
Kojarzenie przejście stanu z akcji
Państwo przejścia akcji można użyć do zautomatyzowania przejścia elementów pracy w różnych punktach ich przepływ pracy.Na przykład Team Foundation Serversystemu kontrola wersji musi obsługiwać automatyczne przejścia elementów roboczych w chwili wyboru w. W tym działania "microsoft.vsts.actions.checkin" został zdefiniowany.
Autor typ elementu prac można zdefiniować pracy "Uszkodzenia" typ elementu , który ma stan o nazwie "Praca" i użyj tego element roboczy , gdy deweloper wprowadzania zmian.Autor typ elementu prac można zdefiniować innego Państwa, o nazwie "Gotowy do tworzenia," co oznacza, że deweloper został zadeklarowany kod, który został dotknięty działaniem wadę będzie gotowa w godzinach nocnych kompilacja.
Autor może automatycznie przejście element roboczy ze stanu "Praca" stan "Gotowe do tworzenia" podczas operacji wyboru oświadczając 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 działania przejścia
Używanie akcji przejścia Państwo do zautomatyzowania przejścia elementów pracy w różnych punktach ich przepływ pracy.Warto rozważyć następujące szczegóły obciążenia o akcjach przejścia:
Akcje przejścia są opcjonalne.Jeśli bieżący stan wystąpienia element roboczy ma działanie wpis dla określonej akcji, zwraca stan "do".Jeśli nie, wartość zwracana jest wartość Null.Integracji powinny dojście zwracane wartości Null elegancko.To:
Nie są odrzucane.
Pozostaw śledzenia lub dziennik, który wskazuje integracji did auto przejście, ponieważ wymagane jej działania, który nie został znaleziony.
Dla każdego gniazda typ elementuakcje muszą być unikatowe dla par From Państwa/działania.Oznacza to, że autorzy typ elementu pracy nie można określić wiele "do" Państw dla tego samego działania.
Aby umożliwić wielu integracji auto przejście, jak pokazano w poniższym przykładzie są jednak obsługiwane wielu akcji na tym samym przejścia:
<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 programowy, dla których można używać jedynie znaki alfabetu angielskiego.
Nazwy akcji należy postępuj zgodnie z tą samą konwencją przestrzeń nazw odniesienia jako nazwy pole odwołanie, aby uniknąć konfliktów nazw działań między dostawcami i klientami.Niniejsza Konwencja nie są wymuszane przez narzędzie.Visual Studio ALMuses Microsoft.VSTS.Actions.<your action>.
Powrót do początku
Sprawdzanie błędów automatycznego przejścia
Integratory można wypróbować dwa rodzaje automatycznego przejścia.Pierwszy z nich to auto przejście, które występuje z powodu działań użytkownik .Druga jest przejście auto występujący przez automatyzacji instalacji nienadzorowanej, takich jak nocne kompilacja.
Akcja użytkownika auto przejścia dla tego rodzaju auto przejście użytkownik ma reagować na pojawiające się problemy związane z reguły.Należy upewnić się, że obsługują jest sytuacja, który występuje, gdy autor pracy, typ elementu dodaje wymagane pole nie rozpoznaje integracji.Do obsługi tej sytuacji, wykonywać automatyczny przejścia, a następnie inspekcji pracy typ elementu do naruszenia reguł.Jeśli znajdziesz, wyświetlanie formularz dla użytkownik , aby rozpoznać.
Auto przejścia automatyzacji instalacji nienadzorowanej należy zakładać, że żaden użytkownik jest obecny, aby rozpoznać te problemy.W przypadku integracji niezastosowania się bezpiecznie.Dziennik błędów powinny określać, że został próbował auto przejście, i powinna ona dać przyczyna niepowodzenia.
Podczas definiowania albo typu auto przejście, należy zdefiniować przejścia tak, aby każdy element roboczy osiągnie prawidłowy stanu na koniec przejścia bez interwencji użytkownik .Innymi słowy wszystkie reguły, które są zdefiniowane dla Państwa, są przenoszone do są spełnione przez dostarczenie domyślne lub skopiowane wartości dla wszystkich pól.Jeśli dowolne pole staje się nieprawidłowy po przejściu przejście stanu nie powiedzie się.
Aby zachować pola z staje się nieprawidłowy, wykonaj następujące czynności:
Definiowanie DEFAULTREASON na przejście stanu.
Dla pól, które mogłyby stać się wymagane po przejście stanu, użyj DEFAULT lub COPY reguły elementów, aby określić wartość dla pole.
Na przykład utworzono działania przejścia Check-In, które przejścia stan element roboczy z "Praca" do "Gotowy do utworzenia".element roboczydla zasady "Gotowy do tworzenia" wymagają, że "Rozwiązany przez" pole można ustawić.Następnie należy zdefiniować DEFAULT lub COPY elementu reguły dla "ResolvedBy" w TRANSITION sekcji.Ponadto, przy definiowaniu DEFAULTREASON , aby upewnić się, że wymagane pole można ustawić bez interwencji użytkownik .
Powrót do początku
Zobacz też
Koncepcje
Gdzie i kiedy mają zastosowanie reguły pole