Tworzenie lub edytowanie akcji niestandardowych za pomocą przepływu pracy
Ten temat dotyczy platformy Dynamics 365 Customer Engagement (on-premises). Aby zapoznać się z wersją tego tematu dotyczącą usługi Power Apps, zobacz: Konfigurowanie akcji niestandardowych za pomocą przepływu pracy
Możesz włączyć akcję niestandardową z przepływu pracy bez pisania kodu. Więcej informacji: Wywoływanie akcji niestandardowych z przepływu pracy.
Możesz również utworzyć akcję, dzięki czemu programista będzie mógł jej użyć w kodzie. Możliwe również, że będziesz musiał edytować akcję, która została wcześniej zdefiniowana. Podobnie jak w przypadku procesów przepływu pracy, 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 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.
Akcje mają również coś, czego nie mają procesy przepływu pracy — argumenty wejściowe i wyjściowe. Więcej informacji: Definiowanie argumentów procesu
Tworzenie akcji
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.
Podobnie jak procesy przepływu pracy, 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ć encję 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 encji. Po zapisaniu procesu nie można zmienić tych ustawień.
Typ
Użyj tej właściwości, aby wybrać, czy nowa akcja będzie tworzona od podstaw czy za pomocą istniejącego szablonu.
Edytuj akcję
Najpierw należy dezaktywować procesy, zanim będzie można je edytować.
Możesz edytować akcję, która została utworzona jako część rozwiązania niezarządzanego lub zawarta w rozwiązaniu zainstalowanym w 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 umieszczane przez deweloperów w kodzie inicjowanym przez akcję 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 akcja niestandardowa 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 Dynamics 365 Customer Engagement (on-premises).
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 rekord 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ść. |
| Encja | Rekord dla określonej encji. Po wybraniu opcji Encja będzie dostępna lista rozwijana umożliwiająca wybranie typu encji. |
| EntityCollection | Zbiór rekordów encji. |
| EntityReference | Obiekt, który zawiera nazwę, identyfikator i typ rekordu encji, który ją jednoznacznie identyfikuje. Po wybraniu EntityReference lista rozwijana zostanie włączona, co umożliwi wybranie typu encji. |
| Liczba zmiennoprzecinkowa | 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: Create your own actions (Tworzenie własnych akcji)
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, 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 rekordu, dla których działa akcja, rekordów powiązanych z tym rekordem relacją wiele do jednego, rekordów utworzonych w poprzednim kroku lub wartości, które są częścią samego procesu.
Zobacz także
Akcje
Wywołaj akcje niestandardowe z przepływu pracy
Monitorowanie przepływów pracy i akcji w czasie rzeczywistym
Procesy przepływu pracy
Omówienie procesów biznesowych
Monitorowanie i zarządzanie przepływami procesu pracy
Tworzenie własnych akcji