Punkt końcowy kontrolki przepływu pracy

Punkt końcowy sterowania przepływem pracy umożliwia deweloperom wywoływanie operacji sterowania w celu zdalnego sterowania wystąpieniami przepływu pracy hostowanymi przy użyciu polecenia WorkflowServiceHost. Ta funkcja może służyć do programowego wykonywania operacji sterowania, takich jak wstrzymanie, wznowienie i zakończenie.

Ostrzeżenie

Jeśli używasz punktu końcowego zarządzania przepływem pracy w ramach transakcji, a kontrolowany przepływ pracy zawiera czynność Persist, wystąpienie przepływu pracy będzie blokowane do momentu upłynięcia limitu czasu transakcji.

Zarządzanie instancją workflow

Program .NET Framework 4.6.1 definiuje nowy kontrakt o nazwie IWorkflowInstanceManagement. Ten kontrakt definiuje serię operacji sterujących, które pozwalają na zdalne sterowanie wystąpieniami przepływu pracy pod nadzorem WorkflowServiceHost. WorkflowControlEndpoint to standardowy punkt końcowy, który zapewnia implementację kontraktu IWorkflowInstanceManagement . WorkflowControlClient jest klasą używaną do wysyłania operacji kontrolnych do klasy WorkflowControlEndpoint.

Wystąpienia przepływu pracy mogą być w jednym z następujących stanów:

Aktywna
Stan wystąpienia przepływu pracy przed osiągnięciem stanu ukończonego i gdy nie jest w stanie zawieszonym. W tym stanie, instancja przepływu pracy działa i przetwarza wiadomości aplikacji.

Zawieszony
Gdy instancja przepływu pracy znajduje się w tym stanie, nie jest uruchamiana, nawet jeśli istnieją działania, które nie zostały rozpoczęte lub zostały uruchomione częściowo.

Zakończone
Stan końcowy instancji przepływu pracy. Wystąpienie przepływu pracy nie może zostać uruchomione po osiągnięciu stanu ukończonego.

IWorkflowInstanceManagement

Interfejs IWorkflowInstanceManagement definiuje zestaw operacji sterowania z synchronicznymi i asynchronicznymi wersjami. Wersje transakcyjne wymagają zastosowania powiązania obsługującego transakcje. W poniższej tabeli wymieniono obsługiwane operacje sterowania.

Operacja sterowania	Opis
Anuluj	Wymusza zatrzymanie wykonywania instancji przepływu pracy.
Anuluj	Przekształca instancję przepływu pracy ze stanu aktywnego lub zawieszonego na stan ukończony.
Biegnij	Umożliwia wykonanie wystąpienia przepływu pracy.
Wstrzymaj	Przenosi wystąpienie procesu ze stanu aktywnego do stanu zawieszenia.
Zakończyć	Przekształca instancję przepływu pracy ze stanu aktywnego lub zawieszonego na stan ukończony.
Anulowano zawieszenie	Przenosi wystąpienie przepływu pracy ze stanu wstrzymania do stanu aktywnego.
AnulujTransakcję	Wykonuje operację Anuluj w ramach transakcji (przepływanej z klienta lub utworzonej lokalnie). Jeśli system utrzymuje trwały stan wystąpienia przepływu pracy, wystąpienie przepływu pracy musi być utrwalane podczas wykonywania tej operacji.
TransactedRun	Wykonuje operację Uruchom w ramach transakcji (przepływanej z klienta lub utworzonej lokalnie). Jeśli system utrzymuje trwały stan wystąpienia przepływu pracy, wystąpienie przepływu pracy musi być utrwalane podczas wykonywania tej operacji.
Zawieszenie Transakcji	Wykonuje operację wstrzymywania w ramach transakcji (przesyłanej przez klienta lub utworzonej lokalnie). Jeśli system utrzymuje trwały stan wystąpienia przepływu pracy, wystąpienie przepływu pracy musi być utrwalane podczas wykonywania tej operacji.
Zakończenie Transakcyjne	Wykonuje operację zakończenia w ramach transakcji (pochodzącą od klienta lub utworzoną lokalnie). Jeśli system utrzymuje trwały stan wystąpienia przepływu pracy, wystąpienie przepływu pracy musi być utrwalane podczas wykonywania tej operacji.
TransakcjaOdblokowanie	Wykonuje operację Unsuspend w ramach transakcji (przepływanej z klienta lub utworzonej lokalnie). Jeśli system utrzymuje trwały stan wystąpienia przepływu pracy, wystąpienie przepływu pracy musi być utrwalane podczas wykonywania tej operacji.

Kontrakt IWorkflowInstanceManagement nie zapewnia środków do utworzenia nowego wystąpienia przepływu pracy, tylko do zarządzania istniejącymi wystąpieniami przepływu pracy. Aby uzyskać więcej informacji na temat zdalnego tworzenia nowego wystąpienia przepływu pracy, zobacz Rozszerzalność hosta usługi przepływu pracy.

Punkt Końcowy Sterowania Przepływem Pracy

WorkflowControlEndpointto standardowy punkt końcowy z ustalonym kontraktem. IWorkflowInstanceManagement Po dodaniu punktu końcowego do wystąpienia WorkflowServiceHost, można go użyć do wysyłania operacji poleceń do dowolnego wystąpienia przepływu pracy hostowanego przez wystąpienie hosta. Aby uzyskać więcej informacji na temat standardowych punktów końcowych, odwiedź Standardowe Punkty Końcowe.

KlientKontroliPrzepływuPracy

WorkflowControlClient to klasa, która umożliwia wysyłanie komunikatów sterujących do WorkflowControlEndpoint na WorkflowServiceHost. Zawiera ona metodę dla każdej operacji obsługiwanej przez IWorkflowInstanceManagement kontrakt z wyjątkiem operacji transakcyjnych. WorkflowControlClient używa transakcji otoczenia, aby określić, czy operacja transakcyjna powinna być wykorzystana.