Udostępnij za pośrednictwem


Konfigurowanie akcji

 

Data opublikowania: listopad 2016

Dotyczy: Dynamics CRM 2015

Możesz włączyć akcję niestandardową z przepływu pracy lub dialogu, bez pisania kodu.Więcej informacji:Wywołaj akcję niestandardową z przepływu pracy lub dialogu.

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:

  • Jakie rezultaty powinny przynieść akcje?

  • Na jakich warunkach powinny być wykonywane akcje?

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.

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

W tym temacie

Tworzenie akcji

Edytuj akcję

Tworzenie akcji

Ważne

Jeśli tworzysz akcję, która będzie dołączona jako część rozwiązania, które będzie dystrybuowane, należy ją utworzyć w kontekście rozwiązania. Przejdź do opcji Ustawienia > Rozwiązania i zlokalizuj rozwiązanie niezarządzane, którego ta akcja będzie częścią. Następnie na pasku menu wybierz opcję 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
    Ta właściwość umożliwia wybranie, 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.

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.

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.

  • 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 programie Microsoft Dynamics 365. Niektóre komunikaty w platformie Dynamics 365 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

    Opcja Włącz wycofywanie nie jest obsługiwana, jeśli akcja niestandardowa jest wywoływana bezpośrednio z przepływu pracy lub dialogu. Wycofywanie można włączyć, jeśli akcja jest wyzwalana przez wiadomość usługi sieci Web Dynamics 365.

  • 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 i kroków

Definiowanie argumentów procesu

Gdy programista używa komunikatu, mogą się one rozpoczynać od pewnych danych przekazywanych do komunikatu i wykorzystywanych. Na przykład, aby utworzyć nowy rekord sprawy, możesz mieć wartość tytułu sprawy, która zostanie przekazana jako argument. Byłby to 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. To musi być zdefiniowane jako argument wyjściowy.

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ć. Zmiana tego podpisu spowoduje, że wszelki 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 przez ich sortowanie lub przeniesienie w górę lub w dół nie ma znaczenia, ponieważ argumenty są identyfikowane przez nazwę, a nie kolejność. Zmiana opisu nie spowoduje uszkodzenie kodu za pomocą wiadomości.

Typy argumentów procesu akcji

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

Typ

Opis

Boolean

Wartość true lub false.

DateTime

Wartość, która przechowuje informacje dotyczące daty i godziny.

Decimal

Wartość liczby z dokładnością po przecinku. Używana, gdy bardzo ważna jest dokładność.

Entity

Rekord Dynamics 365 dla określonej encji. Po wybraniu opcji Entity 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 opcji EntityReference będzie dostępna lista rozwijana umożliwiająca wybranie typu encji.

Float

Wartość liczby z dokładnością po przecinku. Używane, gdy dane pochodzą z pomiaru, który nie jest absolutnie dokładny.

Integer

Liczba całkowita.

Money

Wartość, która przechowuje dane dotyczące kwoty pieniędzy.

Picklist

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: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ływu pracy i ich poszczególne kroki.

Oprócz czynności, które mogą być używane dla przepływów pracy w czasie rzeczywistym, także akcje mają krok Przypisywanie wartości, który jest podobny do używanego do ustawiania zmiennych lub argumentów wejściowych w oknach dialogowych. 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 też

Czynności
Wywołaj akcję niestandardową z przepływu pracy lub dialogu
Monitorowanie przepływów pracy i akcji w czasie rzeczywistym
Tworzenie i edytowanie procesów
Procesy przepływu pracy
Dialogi
Przepływy procesów biznesowych
Monitorowanie procesów i zarządzanie nimi
Tworzenie własnych akcji

© 2016 Microsoft Corporation. Wszelkie prawa zastrzeżone. Prawa autorskie