Automatyzacja zadań pól na podstawie stanu, przejścia lub powodu
Warto 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 programem 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 elementu pracy są rozszerzyć w celu obsługi automatyczne przechodzi stanu elementów roboczych w innych systemach.
Posiadany 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 pobrania stanu akcji po tej pozycji roboczych. Pole wyboru w oknie dialogowym Kontrola wersji rozwiązania usterki i zamknąć zadania, które są skojarzone z zaewidencjonowania korzystania z tej metody.
ACTION jest opcjonalna elementu podrzędnego elementu ACTIONS.
Uwaga
API śledzenia elementów pracy jest częścią Visual Studio ALM zestawu SDK, w sposób opisany w następującej strony w witrynie sieci Web firmy Microsoft: Rozszerzanie Team Foundation.
Na przykład narzędzie jest wstępnie do automatycznego przejścia 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ęte, ukończone, gotowy do testu, uwzględnić w tworzenie i tak dalej. Jedną z opcji będzie wymagać, aby wszystkie autorzy typu elementu pracy do dołączenia do stanu jawnie o nazwie "Rozwiązania".
Rozwiązaniem jest zbyt ograniczające. Jest również niska wydajność z perspektywy międzynarodowe, ponieważ nie umożliwia lokalizacji Stany. Zamiast tego integratorów można zadeklarować akcji, takie jak "Ewidencjonowania" lub "Pełna", która powoduje automatyczne przejście elementów roboczych. Autor typu elementu roboczego czy mogą deklarować tej akcji 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, tak jak w przypadku pola nazwy odwołania. Na przykład Kontrola wersji programu Team Foundation Microsoft.VSTS.Actions.CheckIn jest używana do identyfikowania przejście, które jest odpowiednie dla elementów pracy, które są skojarzone z zaewidencjonowania. Aby uzyskać więcej informacji, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.
<ACTION value="NameOfAction" />
minOccurs = "0"
maxOccurs = "niepowiązanego"
Kroki wymagane w celu obsługi automatyzacji
Integrację narzędzie z śledzenia elementów roboczych, narzędzie wykonać następujące kroki:
Należy określić, jakie stanu elementu roboczego powinien być są przenoszone do po wykonaniu akcji.
Ustaw element roboczy do stanu "do".
API śledzenia elementów roboczych 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ącą stronę w witrynie sieci Web firmy Microsoft: zestaw SDK programu Team Foundation Server.
Uwaga
Akcja transakcji, która spowodowała przejście stanu określonego zdarzeń nie została zarejestrowana.Musi śledzić akcji, które spowodowało przejście, pola elementu pracy dodatkowe do śledzenia jego można określić, czy można określić 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 momencie ewidencjonowania. W tym do akcji "microsoft.vsts.actions.checkin" został zdefiniowany.
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, jeśli developer wprowadzania zmian. Autor typu elementu roboczego można zdefiniować innego Państwa o nazwie "Gotowy do tworzenia," co oznacza, że deweloper został zadeklarowany 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" stan "Jest gotowy do tworzenia" podczas operacji ewidencjonowania przez deklarującego 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
Stan przejścia akcji można użyć w celu zautomatyzowania przejścia elementów roboczych w różnych miejscach ich przepływu pracy. Należy rozważyć użycie następujące szczegóły akcji przejścia:
Przejście akcje są opcjonalne. Jeśli bieżący stan wystąpienia elementu roboczego ma wpis akcji dla określonej akcji, zwraca stan "do". Jeśli nie, wartość zwracana jest wartość Null. Integracji powinna obsługiwać bezpiecznie zwracanej wartości Null. To:
Nie są odrzucane.
Pozostaw śledzenia lub dziennika, który wskazuje integracji czy nie automatycznego przejścia, ponieważ jest wymagane akcji, który nie został znaleziony.
Dla każdego typu elementu roboczego akcji musi być unikatowa dla pary From/Akcja stanu. Oznacza to, że autorzy typu elementu roboczego nie można określić wiele "do" stanów na te same działania.
Jednak wiele akcji w tej samej 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 programistycznych dla których można używać tylko angielskiego znaków.
Nazwy akcji powinny być zgodne z tą samą konwencją nazw odwołania jako nazwy odwołanie do pola, aby uniknąć konfliktów nazw akcji między dostawców i klientów. Ta konwencja nie są wymuszane przez narzędzie. Visual Studio ALM używa Microsoft.VSTS.Actions.<your action>.
Sprawdzanie błędów automatycznego przejścia
Integratory spróbować dwa rodzaje automatycznego przejścia. Pierwsza jest automatycznie przejścia, który występuje z powodu czynności użytkownika. Druga jest przejście automatycznie występujący przez nienadzorowanej automatyzację, takich jak godzinach nocnych kompilacji.
Akcji użytkownika automatycznie przejścia dla tego rodzaju automatycznego przejścia użytkownika znajduje się reagować na pojawiające się problemy związane z reguły. Należy się upewnić, że obsługuje sytuacji, gdy autor typu elementu roboczego dodaje pole wymagane nie może rozpoznać integracji. Do obsługi tej sytuacji, wykonaj przejścia automatycznie i następnie kontrolę typu elementu roboczego dla naruszeń reguł. Jeśli znajdziesz, wyświetlenie formularza dla użytkownika można rozpoznać.
Nienadzorowanej automatyzacji automatycznie przejścia należy założyć, że żaden użytkownik nie jest obecna, aby rozwiązać te problemy. W takim przypadku integracji powinna się nie powieść protokołu. Dziennik błędów powinien stanu, że nastąpiła została automatycznie przejścia i powinien on Podaj przyczynę błędu.
Podczas definiowania obydwu typów automatycznego przejścia, należy zdefiniować przejścia tak, aby każdy element roboczy osiągnie stan prawidłowy na końcu przejścia bez interwencji użytkownika. Innymi słowy wszystkich reguł zdefiniowanych dla stanu, które są przenoszone do zostały spełnione przez dostarczanie wartości domyślnych lub skopiować wartości dla wszystkich pól. Jeśli którekolwiek z pól staje się nieprawidłowy, po przejściu zmiana stanu zakończy się niepowodzeniem.
Aby zachować pola staje się nieprawidłowy, wykonaj następujące czynności:
Definiowanie DEFAULTREASON za zmianę stanu.
Dla pola, które staje się wymagane po przejściu stanu, użyj DEFAULT lub COPY reguły elementy, aby określić wartość dla pola.
Na przykład została utworzona akcja przejścia ewidencjonowania, która przechodzi stan elementu roboczego "Działającym" do "Jest gotowy do utworzenia". Element roboczy "Jest gotowy do tworzenia" zasady wymagają, że można ustawić pola "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.