Tworzenie niestandardowej akcji procesu
Użyj niestandardowych akcji procesu, jeśli chcesz zautomatyzować serię poleceń w systemie. Niestandardowe akcje procesów poszerzają słownictwo dostępne dla programistów w celu wyrażania procesów biznesowych. Niestandardowa akcja procesu wykorzystuje podstawowe komendy udostępniane przez system, takie jak Utwórz, Aktualizuj, Usuń i Przypisz, aby utworzyć bardziej wyraziste czasowniki, takie jak Zatwierdź, Eskaluj, Przekaż lub Harmonogram. Jeśli definicja procesu biznesowego ulegnie zmianie, osoba niebędąca programistą może edytować niestandardową akcję procesu, aby nie trzeba było zmieniać kodu.
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
Tworzenie niestandardowej akcji procesu
Ważne
Jeśli tworzysz niestandardową akcję procesu, która ma być częścią rozwiązania, które będzie dystrybuowane, utwórz ją 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.
Podobnie jak procesy przepływu pracy, niestandardowe akcje procesu 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ń.
Tabela
Dzięki procesom akcji można wybrać tabelę zapewniającą kontekst przepływu pracy 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.
W odróżnieniu od procesów przepływu pracy nie musisz ustawiać następujących opcji:
Rozpoczęcie: akcje są uruchamiane, gdy kod wywołuje wygenerowany dla nich komunikat.
Zakres: akcje są zawsze uruchamiane w kontekście użytkownika wywołującego.
Uruchom w tle: akcje są zawsze przepływami pracy w czasie rzeczywistym.
Niestandardowe akcje procesów mają również coś, czego procesy przepływu pracy nie mają — argumenty wejściowe i wyjściowe.
Uwaga
Możesz włączyć niestandardową akcję procesu z przepływu pracy bez pisania kodu. Więcej informacji: Wywołaj niestandardowe akcje procesu z przepływu pracy
Edytowanie niestandardowej akcji procesu
Musisz dezaktywować niestandardowe akcje procesu, 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
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. 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ą pewne wyjątki od tej reguły. Niektóre akcje, które programiści mogą wykonać w kodzie zainicjowanym przez akcję procesu niestandardowego, mogą nie obsługiwać transakcji. Na przykład, dzieje się tak, jeśli kod wykonuje akcje w innych systemach, które wykraczają poza zakres 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. Wycofywanie można włączyć, jeśli akcja jest wyzwalana przez wiadomość usługi sieci Web Power Apps.
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 i kroków
Podobnie jak w przypadku innych procesów, należy określić akcje do wykonania oraz czas ich wykonywania. Więcej informacji: Dodawanie etapów i kroków
Definiowanie argumentów procesu
Gdy programiści używają 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 niestandardowej akcji procesu i używaniu jej w kodzie podpis nie może ulec zmianie. 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 tabeli lista rozwijana zostanie włączona, co umożliwi 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 entityReference 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
Niestandardowe akcje procesu to typ procesu bardzo podobny 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, zobacz 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
Wywołaj niestandardowe akcje procesu z przepływu pracy
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).