Skonfiguruj niestandardowe akcje procesu z przepływu pracy

Możesz włączyć niestandardową akcję procesu z przepływu pracy w czasie rzeczywistym bez pisania kodu. Więcej informacji: Wywoływanie akcji niestandardowych z przepływu pracy

Możesz również utworzyć niestandardową akcję procesu, aby deweloper mógł jej użyć w kodzie lub może być konieczne edytowanie akcji, która została wcześniej zdefiniowana. Podobnie jak w przypadku procesów przepływu pracy w czasie rzeczywistym, należy rozważyć następujące kwestie:

• Na czym polega ta akcja?

• W jakich warunkach powinna być wykonywana ta akcja?

W odróżnieniu od procesów przepływu pracy w czasie rzeczywistym nie musisz ustawiać następujących opcji:

• Rozpoczęcie: Niestandardowe akcje procesu rozpoczynają się, gdy kod wywołuje wygenerowany dla nich komunikat.

• Zakres: Niestandardowe akcje procesu są zawsze uruchamiane w kontekście wywołującego użytkownika.

• Uruchom w tle: Niestandardowe działania procesu są zawsze przepływami pracy w czasie rzeczywistym.

Niestandardowe akcje procesów mają również coś, czego procesy przepływu pracy w czasie rzeczywistym nie mają — argumenty wejściowe i wyjściowe. Więcej informacji: Definiowanie argumentów procesu

Tworzenie niestandardowej akcji procesu

Ważne

Jeśli tworzysz akcję, która ma być częścią rozwiązania, które będzie dystrybuowane, należy ją utworzyć w kontekście rozwiązania. Przejdź do Ustawienia > Rozwiązania i zlokalizuj rozwiązanie niezarządzane, którego ta akcja będzie częścią. Następnie na pasku menu wybierz Nowy > Proces. W ten sposób można się upewnić, że prefiks dostosowywania skojarzony z nazwą akcji będzie zgodny z innymi składnikami w rozwiązaniu. Po utworzeniu akcji nie można zmienić prefiksu.

Uwaga

Jeśli zamierzasz napisać dodatek plug-in w celu zaimplementowania logiki niestandardowej akcji procesu zamiast projektanta przepływu pracy należy użyć niestandardowego interfejsu API. Więcej informacji: Porównanie niestandardowej akcji procesu i niestandardowego interfejsu API

Podobnie jak procesy przepływu pracy w czasie rzeczywistym, akcje mają następujące właściwości w oknie dialogowym Utwórz proces:

• Nazwa procesu

  Po wprowadzeniu nazwy dla procesu zostanie dla niego utworzona unikatowa nazwa powstająca przez usunięcie spacji i znaków specjalnych z nazwy procesu.

• Kategoria

  Właściwość ta ustala, że jest to proces akcji. Po zapisaniu procesu nie można zmienić tych ustawień.

• Encja

  Dzięki procesom akcji można wybrać tabelę zapewniającą kontekst przepływu pracy w czasie rzeczywistym podobnie jak inne rodzaje procesów, ale istnieje również możliwość wyboru opcji Brak (globalna). Użycie tej akcji nie wymaga kontekstu określonej tabeli. Po zapisaniu procesu nie można zmienić tych ustawień.

• Typ

  Użyj tej właściwości, aby wybrać, czy chcesz zbudować nową niestandardową akcję procesu od podstaw, czy rozpocząć od istniejącego szablonu.

Edytuj akcję

Najpierw należy dezaktywować procesy, zanim będzie można je edytować.

Możesz edytować niestandardową akcję procesu, która została utworzona jako część niezarządzanego rozwiązania lub zawarta w rozwiązaniu zainstalowanym w Twojej organizacji. Jeśli rozwiązanie jest rozwiązaniem zarządzanym, możesz nie być w stanie go edytować. Wydawca rozwiązania ma możliwość edycji właściwości zarządzanych tak, aby akcji zainstalowanej z rozwiązaniem zarządzanymi nie można było edytować.

Po zapisaniu akcji jest generowana unikatowa nazwa na podstawie nazwy procesu. Ta unikatowa nazwa ma prefiks dostosowywania dodawany przez wydawcę rozwiązania. Jest to nazwa komunikatu używana przez dewelopera w kodzie.

Podczas edycji akcji dostępne są następujące opcje:

• Nazwa procesu

  Po utworzeniu procesu i wygenerowaniu unikatowej nazwy na podstawie nazwy procesu, można edytować nazwę procesu. Możesz zechcieć zastosować konwencję nazewnictwa, aby znajdowanie określonych procesów było łatwiejsze.

• Unikatowa nazwa

  Podczas zapisywania niestandardowej akcji procesu generowana jest unikatowa nazwa na podstawie nazwy procesu. Ta unikatowa nazwa ma prefiks dostosowywania dodawany przez wydawcę rozwiązania. Jest to nazwa komunikatu używana przez dewelopera w kodzie. Nie należy zmieniać unikatowej nazwy, jeśli proces został uaktywniony i istnieje kod, który prawdopodobnie wywołuje akcję przy użyciu tej nazwy.

  Ważne

  Po aktywowaniu akcji i zapisaniu kodu w celu użycia unikatowej nazwy, nazwa ta nie może być zmieniona bez jednoczesnej zmiany kodu, który odwołuje się do niej.

• Włącz wycofywanie

  Ogólnie rzecz biorąc procesy, które obsługują transakcje będą cofać całą operację, jeśli jakaś ich część nie powiedzie się. Istnieją wyjątki od tej reguły. Akcje wykonywane w kodzie przez dewelopera zainicjowane przez akcję procesu niestandardowego mogą nie obsługiwać transakcji. Przykładem może być sytuacja, w której kod wykonuje działania w innych systemach, które są poza zakresem transakcji. Nie można tego wycofać przez akcję uruchomioną w aplikacji. Niektóre komunikaty w platformie nie obsługują transakcji. Ale wszystko, co można zrobić za pomocą samego interfejsu użytkownika akcji obsługuje transakcje. Wszystkie akcje, które są częścią przepływu pracy w czasie rzeczywistym są uważane za element transakcji, ale w przypadku akcji istnieje możliwość rezygnacji z tego.

  Należy skonsultować się z programistą, który użyje tego komunikatu w celu określenia, czy musi to być elementem transakcji. Na ogół akcja powinna być elementem transakcji, jeśli akcje wykonywane przez proces biznesowy nie mają sensu, chyba, że wszystkie z nich zakończyły się pomyślnie. Klasycznym przykładem jest transfer funduszy między dwoma kontami bankowymi. W przypadku wycofania środków z jednego konta należy je wpłacić na inne. Jeśli jedna z tych operacji się nie powiedzie, obie muszą zakończyć się niepowodzeniem.

  Uwaga

  • Nie można włączyć wycofywania, jeśli niestandardowa akcja procesu jest wywoływana bezpośrednio z przepływu pracy. Można włączyć wycofywanie, jeśli niestandardowa akcja procesu jest wyzwalana przez komunikat usług sieci Web Power Apps.
  • Jeśli zdefiniowana akcja nie zmienia danych, ale tylko pobiera, istnieją sytuacje, w których można poprawić wydajność, wyłączając włączanie wycofywania.

• Aktywuj jako

  Podobnie jak wszystkie procesy można aktywować proces jako szablon i używać go jako zaawansowany punkt wyjścia dla procesów, które mają podobną strukturę.

• Definiowanie argumentów procesu

  W tym obszarze określisz wszelkie dane, których rozpoczęcia spodziewa się akcja, oraz dane, jakie zostaną przekazane w wyniku akcji. Więcej informacji: Definiowanie argumentów procesu

• Dodawanie etapów, warunków i akcji

  Podobnie jak w przypadku innych procesów, należy określić akcje do wykonania oraz czas ich wykonywania. Więcej informacji: Dodawanie etapów, warunków i akcji

Definiowanie argumentów procesu

Gdy programista używa komunikatu, mogą się one rozpoczynać od pewnych danych przekazywanych do komunikatu. Na przykład, aby utworzyć nowy wiersz sprawy, może istnieć wartość tytułu sprawy, która jest przekazywana jako argument wejściowy.

Gdy komunikat jest gotowy, deweloper może musieć przekazać niektóre dane, które zostały zmienione lub wygenerowane przez komunikat do innej operacji w kodzie. Te dane są argumentem wyjściowym.

Zarówno argumenty wejściowe i wyjściowe muszą mieć określoną nazwę, typ oraz niektóre informacje o tym, czy argument jest zawsze wymagany. Można także podać opis.

Nazwa komunikatu i informacje o wszystkich argumentach procesu reprezentują podpis komunikatu. Po aktywowaniu akcji oraz użyciu jej w kodzie, podpis nie może się zmienić. Jeśli ten podpis ulega zmianie, kod, który używa komunikatu, nie powiedzie się. Jedynym wyjątkiem może być zmiana jednego z parametrów w taki sposób, aby nie zawsze był wymagany.

Zmiana kolejności argumentów odbywa się przez ich sortowanie lub przeniesienie w górę lub w dół, ponieważ argumenty są identyfikowane po nazwie, a nie po kolejności. Zmiana opisu nie spowoduje uszkodzenia kodu korzystającego z wiadomości.

Typy argumentów procesu akcji

W poniższej tabeli opisano typy argumentów procesu akcji.

Typ	Opis
Logiczny	Wartość true lub false.
Data/godzina	Wartość, która przechowuje informacje dotyczące daty i godziny.
Liczba dziesiętna	Wartość liczby z dokładnością po przecinku. Używana, gdy bardzo ważna jest dokładność.
Tabela	Wiersz dla określonej tabeli. Po wybraniu opcji Tabela będzie dostępna lista rozwijana umożliwiająca wybranie typu tabeli.
entityCollection	Kolekcja wierszy tabeli.
entityReference	Obiekt, który zawiera nazwę, identyfikator i typ wiersza tabeli, który go jednoznacznie identyfikuje. Po wybraniu elementu tableReference lista rozwijana zostanie włączona, co umożliwi wybranie typu tabeli.
Float	Wartość liczby z dokładnością po przecinku. Używane, gdy dane pochodzą z pomiaru, który nie jest absolutnie dokładny.
Liczba całkowita	Liczba całkowita.
Pieniądze	Wartość, która przechowuje dane dotyczące kwoty pieniędzy.
Lista wyboru	Wartość, która reprezentuje opcję atrybutu OptionSet.
String	Wartość tekstowa.

Uwaga

Wartości argumentu entityCollection nie można ustawić w interfejsie użytkownika dla warunków lub akcji. Są one dostarczane do użycia przez deweloperów w kodzie niestandardowym. Więcej informacji: Twórz własne wiadomości

Dodawanie etapów i kroków

Akcje są rodzajem procesu bardzo podobnego do przepływów pracy w czasie rzeczywistym. Wszystkie kroki, które mogą być używane w przepływach pracy w czasie rzeczywistym można wykorzystać w akcjach. Aby uzyskać informacje o krokach, które mogą być używane zarówno w przepływach pracy w czasie rzeczywistym, jak i akcjach, przejdź do Etapy przepływów pracy i ich poszczególne kroki.

Oprócz kroków, które mogą być używane dla przepływów pracy w czasie rzeczywistym, akcje mają również krop Przypisz wartość. W przypadku akcji można to wykorzystać tylko do ustawienia argumentów wyjściowych. Możesz użyć asystenta formularzy, aby ustawić argumenty wyjściowe dla określonych wartości lub, co jest bardziej prawdopodobne, dla wartości z wiersza, dla których działa akcja, wierszy powiązanych z tym wierszy relacją wiele do jednego, wierszy utworzonych w poprzednim kroku lub wartości, które są częścią samego procesu.

Właściwości zarządzane

Niestandardowe akcje procesu mają dwie odpowiednie właściwości zarządzane

Można dostosowywać

Właściwość zarządzana można dostosowywać, jeśli użytkownik nie instaluje rozwiązanie zarządzane zawierającej niestandardową akcję procesu, może ją edytować lub usunąć. Jeśli chcesz, aby akcja procesu niestandardowego była edytowana lub usuwana, jeśli jest uwzględniona w rozwiązanie zarządzane, ta właściwość powinna mieć wartość true (prawda).

Czy krok przetwarzania niestandardowego jest dozwolony dla innych wydawców

Krok Jest przetwarzaniem niestandardowym dozwolony dla właściwości zarządzanej innych wydawców umożliwia określenie, czy deweloperzy dodatek plug-in innych firm mogą rejestrować kroki dodatku plug-in w komunikacie utworzonym przez niestandardową akcję procesu. Jeśli to prawda, dodatki plug-in zarejestrowane przez wszystkie osoby w tym komunikacie zostaną uruchomione i mogą zmodyfikować zachowanie niestandardowej akcji procesu. Gdy fałsz, zostaną uruchomione tylko kroki dodatki plug-in zarejestrowane w ramach rozwiązania z tego wydawca rozwiązania.

Następne kroki

Używanie akcji
Wywoływanie akcji niestandardowych z przepływu pracy
Monitorowanie przepływów pracy i akcji w czasie rzeczywistym

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).