Akcje kolejek pracy
Kolejki pracy w Power Automate służą do przechowywania danych dotyczących procesów oraz do obsługi złożonych procesów i automatyzacji, co umożliwia asynchroniczną komunikację.
Kolejki pracy mogą odgrywać kluczową rolę w poprawianiu wydajności, skalowalności i odporności automatyzacji oraz w ustalaniu priorytetów pracy. Kolejki pracy umożliwiają przetwarzanie w pierwszej kolejności elementów o wysokim priorytecie, niezależnie od tego, czy są one przetwarzane przez pracowników cyfrowych, pracowników czy przez integrację.
Uwaga
- Obsługa pierwszego zestawu akcji związanych z kolejką pracy na poziomie produkcyjnym wymaga wersji klasycznej Power Automate w wersji 2.37 lub nowszej.
- Akcje kolejki pracy w Power Automate na komputerze to funkcja premium, która wymaga subskrypcji Power Automate.
- Obecnie tylko akcje Przetwórz elementy kolejki pracy oraz akcje Aktualizuj elementy kolejki pracy można określić zgodnie z zasadami zapobiegania utracie danych (DLP), a inne akcje będą dostępne wkrótce. Należy zauważyć, że zasady DLP nie mogą ograniczać użycia kolejek pracy opartych na przepływie w chmurze.
Przetwórz elementy kolejki pracy
Akcja Przetwórz elementy kolejki pracy oznacza dla orkiestratora kolejki, że komputer jest gotowy do przetwarzania jednego lub większej liczby elementów kolejki pracy. Kontekst użytkownika żądający nowego elementu musi mieć wystarczające uprawnienia do tabeli elementów kolejki służbowej i kolejki pracy w celu przetwarzania kolejek pracy.
Ta kolejka pracy przywoływana w poprzedniej akcji jest używana przez orkiestratora kolejki do określenia następnych dostępnych elementów w tej kolejce pracy w stanie W kolejce. Gdy przepływ pulpitu przechodzi przez akcje w obrębie pętli elementów kolejki pracy procesu, które są renderowane przez tę akcję, można wywołać wartość, przejmiąc akcję ze zmienną wyznaczyną do działania razem z właściwością .Value. W takim przypadku można wywołać wartość elementu kolejki pracy przy użyciu zmiennej %WorkQueueItem.Value%
Ważne
Podając wyrażenie FetchXML w polu „Filtruj wiersze”, pomijasz logikę FIFO domyślnego koordynatora kolejki pracy dla elementów w kolejce. Umożliwia to ustawienie niestandardowej kolejności usuwania z kolejki i ignorowanie dat wygaśnięcia elementów oraz innych ustawień, które są automatycznie stosowane, gdy nie podano wyrażenia filtru.
Processworkqueueitemaction
Akcja Przetwórz element w kolejce pracy wymaga następujących argumentów.
Parametry wejściowe
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | Podpis |
|---|---|---|---|---|
| Kolejka pracy | Nie. | Tekst | Identyfikator kolejki pracy kolejki pracy zawierający elementy do przetwarzania. | |
| Filtruj wiersze | Tak | Tekst | Wyrażenie FetchXML zapytania używane do pobierania elementów z kolejki pracy. | |
| Zastępowanie konfiguracji automatycznego ponawiania na poziomie kolejki pracy | Tak | Wartość logiczna | Fałsz | Po włączeniu zostanie wyświetlone pole umożliwiające ustawienie lub zastąpienie maksymalnej liczby ponownych prób IT Exceptions. |
| Maks. liczba ponowień | Nie. | Wartość tekstowa, Wartość liczbowa | Jeśli nie zostanie zastąpiony, używa domyślnej maksymalnej liczby ponownych prób zdefiniowanej w rekordzie kolejki pracy. | Maksymalna dozwolona liczba ponownych prób dla IT Exceptions. Ten parametr umożliwia dostosowanie liczby ponownych prób do wyższej lub niższej wartości, a nawet wyłączenie mechanizmu ponawiania prób przez ustawienie liczby na 0. |
Utworzone zmienne
| Argument | Type | Podpis |
|---|---|---|
| WorkQueueItem | Nie. | Informacje przechowywane w przetwarzanych elementach kolejki pracy |
Wyjątki
| Wyjątek | opis |
|---|---|
| Nie znaleziono kolejki pracy | Wartość wprowadzona do parametru kolejki pracy jest nieprawidłowa. |
| Kolejka pracy wstrzymana lub zatrzymana | Kolejka pracy jest wstrzymana lub zatrzymana, co nie jest prawidłowym stanem podczas przetwarzania elementów. |
| Nieprawidłowe FetchXML | Dostarczono nieprawidłowe wyrażenie FetchXML. |
| Nie można przetworzyć kolejki pracy | Złe żądanie – błąd w składni zapytania. |
Co to są zapytania FetchXML?
Microsoft Dataverse FetchXML to język używany do pobierania danych z bazy danych Dataverse. Został zaprojektowany tak, aby był łatwy w tworzeniu, obsłudze i zrozumieniu. Na przykład możesz poprosić orkiestratora o przetworzenie elementów w innej kolejności niż pierwsze weszło, pierwsze wyszło (FIFO) i w określonym przedziale czasu wygaśnięcia.
Aby ograniczyć obsługę zapytań FetchXML do przetwarzania elementów kolejki roboczej, obsługiwany jest ograniczony zestaw terminów FetchXML i wyrażeń. Te terminy obejmują filtry, warunki i wyrażenia porządkowania, wszystkie ograniczone do tabeli elementów kolejki pracy (workqueueitem). Zwracane są tylko elementy, które są w stanie Queued.
Przykład zapytania FetchXML
Poniżej przedstawiono przykładowe wyrażenie zapytania dotyczące sposobu filtrowania name i porządkowania wyników według rekordów wygasających jako pierwsze (FEFO).
<filter type="and">
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
<condition attribute="name" operator="eq" value="MyNonUniqueNameString" />
</filter>
<order attribute="expirydate" descending="false" />
Wykonywanie zapytań o szczegóły pomocy technicznej i dane referencyjne
- Lista operatorów zapytań dostępnych do użycia, w tym operatorów, takich jak on-or-before, between i last-month.
- Lista atrybutów dostępnych w tabeli pozycji kolejki pracy.
Aktualizuj element kolejki pracy
Akcja Aktualizuj element kolejki pracy umożliwia użytkownikom zmianę stanu i przetwarzania wyników wybranego elementu kolejki pracy.
Updateworkqueueitemaction
Akcja Aktualizuj element kolejki pracy wymaga następujących argumentów.
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | opis |
|---|---|---|---|---|
| Element kolejki pracy | Nie. | Tekst | Zmienna elementu kolejki pracy, która została wcześniej zwrócona przez kolejkę | |
| Status | Nie. | Przetworzone, wyjątek ogólny | Przetworzone | Aktualizowanie elementu kolejki pracy przetwarzanego przy użyciu stanu z listy opcji. |
| Uwagi dotyczące przetwarzania | Tak | Tekst | Uwagi lub wartość przetwarzania niestandardowego, które mają zostać dołączone do przetwarzanego elementu kolejki. | |
| Wyczyść uwagi dotyczące przetwarzania | Tak | Wartość logiczna | Fałsz | Włączenie tego ustawienia spowoduje ukrycie i wyczyszczenie pola Uwagi dotyczące przetwarzania na tym ekranie oraz usunięcie z bazy danych uwag dotyczących przetwarzania, które zostały uprzednio przechwycone dla tego elementu. |
Wyjątki
| Argument | Podpis |
|---|---|
| Nie znaleziono elementu kolejki pracy | Przetwarzany element kolejki pracy został już usunięty lub nie należy już do kolejki, z której został wywoływany. |
| Element kolejki pracy został wstrzymany | Przetwarzany element kolejki pracy zawiera stan on hold w orkiestratorze kolejki i nie może być już aktualizowany. |
| Nie można zaktualizować elementu kolejki pracy | Aktualizowany element kolejki pracy napotkał nieoczekiwany błąd. Więcej informacji można znaleźć w komunikacie o błędzie. |
Dodaj element kolejki pracy
Akcja Dodaj element kolejki pracy umożliwia użytkownikom dodawanie elementów kolejki pracy do kolejki pracy, która została skonfigurowana w portalu przepływu.
Enqueueworkqueueitemaction
Akcja Dodaj element w kolejce pracy wymaga następujących argumentów.
Parametry wejściowe
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | Podpis |
|---|---|---|---|---|
| Kolejka pracy | Nie. | Wartość tekstowa | Element kolejki pracy, której będzie dodany element | |
| Priorytet | Nie. | Wysoki, Normalny, Niski | Normalna | Priorytet, do którego ma być ustawione element kolejki pracy |
| Imię i nazwisko/nazwa | Nie. | Wartość tekstowa, Wartość liczbowa | Nazwa niestandardowa lub identyfikator nowego elementu kolejki pracy | |
| Dane wejściowe | Nie. | Wartość tekstowa, Wartość liczbowa | Dane należące do kolumny wartości, która ma być przetwarzana | |
| Wygasa | Tak | Datetime | Wartość data/godzina ustawiona w celu wygaśnięcia elementu kolejki. W przeciwnym razie ustawiana jest wartość domyślna, jeśli zostanie ustawiona dla kolejki | |
| Uwagi dotyczące przetwarzania | Tak | Wartość tekstowa, Wartość liczbowa | Niestandardowe notatki przetwarzania, które należy dodać do nowego elementu kolejki | |
| Ma unikatowy identyfikator lub odwołanie | Tak | Wartość tekstowa, Wartość liczbowa | Po włączeniu tej kolejki należy podać wartość unikatową. Jeśli wartość jest pusta, unikatowa wartość w formacie system-<GUID> jest automatycznie podawana w systemie |
Utworzone zmienne
| Argument | Type | Podpis |
|---|---|---|
| WorkQueueItem | Nie. | Informacje przechowywane dla dodawania elementów kolejki pracy |
Wyjątki
| Argument | opis |
|---|---|
| Nie znaleziono kolejki pracy | Wartość wprowadzona do parametru kolejki pracy jest nieprawidłowa |
| Nie można dodać elementu do kolejki pracy | Nie można dodać elementu kolejki pracy do kolejki pracy. Żądanie zły — błąd w składni zapytania |
Dodaj wiele elementów kolejki pracy
Akcja Dodaj wiele elementów kolejki pracy umożliwia użytkownikom dodawanie jednego lub większej liczby elementów kolejki pracy do kolejki pracy na podstawie danych dostarczonych jako tabela danych pozycji kolejki pracy.
Ta akcja wymaga niestandardowej tabeli danych, która zawiera co najmniej jeden element kolejki pracy. Tabela danych musi składać się z ośmiu kolumn i być zgodna z następującym schematem:
| Nazwa kolumny | Podpis | Wymagania | Dozwolone wartości |
|---|---|---|---|
| Nazwa/nazwisko | Nazwa elementu. | Nie. | Dowolny ciąg alfanumeryczny |
| Dane wejściowe | Wprowadź szczegóły lub dane elementu. | Tak | Dowolny ciąg alfanumeryczny |
| Wygasa za | Określa czas trwania do wygaśnięcia elementu. | Nie. | Wartość daty i godziny |
| Uwagi dotyczące przetwarzania | Przetwarzanie notatek związanych z elementem. | Nie. | Dowolny ciąg alfanumeryczny |
| Priorytet | Poziom priorytetu elementu. | Tak | Wartość liczbowa 100 (wysoka), 200 (normalna), 300 (niska) |
| Unikatowe odwołanie | Unikatowy identyfikator lub wartość referencyjna elementu. | Nie. | Dowolny unikatowy ciąg alfanumeryczny lub odwołanie |
| Status | Stan elementu podczas pozyskiwania. | Tak | Wartość liczbowa równa zero (W kolejce), jeden (Wstrzymane). |
| Opóźnij do | Określa datę i godzinę, od której elementy kolejki pracy powinny być ignorowane podczas przetwarzania. | Nie. | Wartość daty i godziny |
Fragment kodu działania Robin służący do tworzenia tabeli danych
Poniższy przykład to fragment kodu Robin (używany w tradycyjnych przepływach), który można skopiować i wkleić bezpośrednio do okna projektanta pulpitu w Power Automate. Ten fragment kodu dodaje do przepływu akcję Utwórz nową tabelę danych z oczekiwanym zestawem pól.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable
Fragment kodu PowerFx służący do tworzenia tabeli danych
Poniższy przykład to fragment kodu PowerFx, który można skopiować i wkleić bezpośrednio do okna projektanta pulpitu w Power Automate. Ten fragment kodu dodaje do przepływu akcję Utwórz nową tabelę danych z oczekiwanym zestawem pól.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx''] } DataTable=> DataTable
Batchenqueueworkqueueitemsaction
Akcja Dodaj wiele elementów kolejki pracy wymaga następujących argumentów.
Parametry wejściowe
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | Podpis |
|---|---|---|---|---|
| Kolejka pracy | Nie. | Wartość tekstowa | Element kolejki pracy, której będzie dodany element | |
| Dane elementu kolejki pracy | Tak | Tabela danych | Niestandardowa tabela danych zawierająca elementy kolejki pracy, które mają zostać dodane do kolejki pracy |
Utworzone zmienne
| Argument | Type | Wartość domyślna | Podpis |
|---|---|---|---|
| FailedWorkQueueItems | Nie. | Włączony | Jeśli wystąpią błędy, ten obiekt przechowuje indeks elementu, którego nie udało się wstawić, wraz z kodem błędu. Zwracany indeks jest pozycją (indeksem) elementu w podanej tabeli danych kolejki pracy dla akcji Dodaj wiele elementów kolejki pracy. |
| HasFailedItems | Nie. | Włączony | Wskaźnik określający, czy akcje napotkały błędy pozyskiwania z powodu problemów z danymi elementu kolejki pracy. |
| SuccessfulWorkQueueItems | Disabled | Nie. | Obiekt niestandardowy przechowujący indeks i elementy kolejki pracy, które zostały pomyślnie dodane do kolejki pracy. |
Wyjątki
| Argument | Podpis |
|---|---|
| Nie znaleziono kolejki pracy | Wartość wprowadzona do parametru kolejki pracy jest nieprawidłowa |
| Kolejka pracy wstrzymana lub zatrzymana | Nie można dodać elementu kolejki pracy do kolejki pracy, ponieważ kolejka pracy jest wstrzymana lub zatrzymana. |
| Nie udało się zbiorczo umieścić w kolejce listy elementów kolejki pracy | Nie można dodać elementów kolejki pracy do kolejki pracy z powodu błędu żądania lub komunikacji. |
Umieść ponownie element w kolejce z opóźnieniem
Akcja Umieść ponownie element w kolejce z opóźnieniem pozwala użytkownikom na odczytanie elementu kolejki przetwarzanego w przepływie pulpitu z powrotem do kolejki źródłowej. Dodatkowo element z kolejki może być w niej utrzymywany i zwalniany w określonym czasie.
Requeueworkqueueitemaction
Akcja Ponownie umieść element w kolejce z opóźnieniem wymaga następujących argumentów.
Parametry wejściowe
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | Podpis |
|---|---|---|---|---|
| Element kolejki pracy | Nie. | Element kolejki pracy | Element kolejki pracy, której będzie dodany element | |
| Opóźnij do | Nie. | Wartość daty i godziny | Normalna | Wartość data/godzina stosowana w celu opóźniania elementu kolejki do określonego czasu |
| Wygasa | Tak | Wartość daty i godziny | Niestandardowy czas wygaśnięcia akcja dla elementu, który jest ponownie kolejkowany | |
| Uwagi dotyczące przetwarzania | Tak | Wartość tekstowa, Wartość liczbowa | Niestandardowe notatki przetwarzania, które należy dodać do nowego elementu kolejki | |
| Wyczyść uwagi dotyczące przetwarzania | Tak | Wartość logiczna | Fałsz | Włączenie tego ustawienia spowoduje ukrycie i wyczyszczenie pola Uwagi dotyczące przetwarzania na tym ekranie oraz usunięcie z bazy danych uwag dotyczących przetwarzania, które zostały uprzednio przechwycone dla tego elementu |
Wyjątki
| Argument | Podpis |
|---|---|
| Nie znaleziono kolejki pracy | Wartość wprowadzona do parametru kolejki pracy jest nieprawidłowa |
| Nie znaleziono elementu kolejki pracy | Wartość elementu kolejki jest nieprawidłowa |
| Nie można ponownie umieścić w kolejce elementu kolejki pracy | Nie można dodać elementu kolejki pracy do kolejki pracy. Żądanie zły — błąd w składni zapytania |
Aktualizuj uwagi dotyczące przetwarzania elementu kolejki pracy
Akcja Aktualizuj uwagi dotyczące przetwarzania elementu kolejki pracy umożliwia użytkownikom aktualizowanie lub czyszczenie uwag dotyczących przetwarzania wybranych elementów kolejki pracy bez konieczności zmiany ich stanu ani żadnej innej właściwości.
updateprocessingnotesaction
Akcja Aktualizuj uwagi dotyczące przetwarzania elementu kolejki pracy wymaga następujących argumentów.
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | Podpis |
|---|---|---|---|---|
| Element kolejki pracy | Nie. | Tekst | Zmienna elementu kolejki pracy, które były wcześniej zwracane przez orkiestratora kolejki | |
| Uwagi dotyczące przetwarzania | Tak | Tekst | Wynik lub wartość przetwarzania niestandardowego, które mają zostać dołączone do przetwarzanego elementu kolejki | |
| Wyczyść uwagi dotyczące przetwarzania | Tak | Wartość logiczna | Fałsz | Włączenie tego ustawienia spowoduje ukrycie i wyczyszczenie pola Uwagi dotyczące przetwarzania na tym ekranie oraz usunięcie z bazy danych uwag dotyczących przetwarzania, które były uprzednio przechwytywane dla tego elementu |
Wyjątki
| Argument | Podpis |
|---|---|
| Nie znaleziono kolejki pracy | Element kolejki pracy skojarzony z elementem został usunięty lub nie jest już dostępny |
| Nie znaleziono elementu kolejki pracy | Element kolejki pracy jest nieprawidłowy |
| Nie można dołączyć wyników przetwarzania | Aktualizowany element kolejki pracy napotkał nieoczekiwany błąd. Więcej informacji można znaleźć w komunikacie o błędzie. |
Pobierz elementy kolejki pracy wg filtra
Akcja Pobierz elementy kolejki pracy według filtru umożliwia użytkownikom pobranie jednego lub większej liczby elementów kolejki pracy na podstawie wyrażenia filtru FetchXML.
Getworkqueueitemsaction
Akcja Pobierz elementy kolejki pracy wg filtru wymaga następujących argumentów.
Parametry wejściowe
| Argument | Opcjonalnie | Akceptuje | Wartość domyślna | Podpis |
|---|---|---|---|---|
| Kolejka pracy | Nie. | Tekst | Kolejka pracy do pobierania elementów z | |
| Filtruj wiersze | Nie. | Tekst | Wyrażenie zapytania FetchXML używane do pobierania elementów z kolejki pracy | |
| Wiersze do zwrócenia | Nie. | telefonu | 5000 | Maksymalna liczba elementów kolejki pracy zwracanych przez orkiestratora |
Utworzone zmienne
| Argument | Type | Wartość domyślna | Podpis |
|---|---|---|---|
| WorkQueueItem | Nie. | Włączony | Lista elementów kolejki pracy pasujących do wyrażenia filtru. |
Wyjątki
| Argument | Podpis |
|---|---|
| Kolejka pracy | Kolejka pracy do pobierania elementów. |
| Filtruj wiersze | Wyrażenie FetchXML zapytania używane do pobierania elementów z kolejki pracy. |
| Wiersze do zwrócenia | Maksymalna liczba elementów kolejki pracy zwracanych przez orkiestratora (domyślnie 5000). |
Co to są zapytania FetchXML?
Microsoft Dataverse FetchXML to język używany do pobierania danych z bazy danych Dataverse. Został zaprojektowany tak, aby był łatwy w tworzeniu, obsłudze i zrozumieniu. Na przykład możesz poprosić usługę Dataverse o podanie listy wszystkich elementów kolejki pracy, które są w stanie IT Exception.
Aby ograniczyć obsługę zapytań FetchXml do pobierania elementów kolejki pracy, obsługujemy tylko ograniczony zestaw terminów i wyrażeń FetchXml. Te terminy i wyrażenia obejmują atrybuty, filtry, warunki i wyrażenia porządkowania, wszystkie ograniczone do tabeli elementów kolejki pracy (workqueueitem). Należy jawnie określić, które właściwości mają być zwracane z tabeli elementów kolejki pracy oraz żądaną kolejność sortowania.
Przykład zapytania FetchXML
Poniższy przykład jest wyrażeniem zapytania określającym sposób pobierania kilku właściwości, odfiltrowywania błędnych elementów oznaczonych jako IT Exceptions i porządkowania wyników według rekordów wygasających jako pierwsze (FEFO).
<attribute name="statecode" />
<attribute name="uniqueidbyqueue" />
<attribute name="createdon" />
<attribute name="completedon" />
<attribute name="workqueueitemid" />
<attribute name="executioncontext" />
<attribute name="name" />
<attribute name="expirydate" />
<attribute name="processingresult" />
<attribute name="priority" />
<attribute name="statuscode" />
<attribute name="modifiedon" />
<attribute name="processingstarttime" />
<attribute name="retrycount" />
<attribute name="requeuecount" />
<attribute name="input" />
<attribute name="delayuntil" />
<filter type="and">
<condition attribute="statecode" operator="eq" value="4" />
<condition attribute="statuscode" operator="eq" value="5" />
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
</filter>
<order attribute="expirydate" descending="false" />
Wykonywanie zapytań o szczegóły pomocy technicznej i dane referencyjne
- Lista operatorów zapytań dostępnych do użycia, w tym operatorów, takich jak on-or-before, between i last-month.
- Lista atrybutów dostępnych w tabeli pozycji kolejki pracy.
Stan (statecode)
| Status | Kod | Podpis |
|---|---|---|
| W kolejce | 0 | Element znajduje się w kolejce |
| Trwa przetwarzanie | 1 | Trwa przetwarzanie |
| Przetworzone | 2 | Przetworzone elementy |
| Wstrzymano | 3 | Element jest wstrzymany |
| Error | 100 | Element napotkał błąd |
Przyczyna stanu (statuscode)
| Przyczyna stanu | Kod | Podpis |
|---|---|---|
| W kolejce | 0 | Element znajduje się w kolejce |
| Trwa przetwarzanie | 1 | Trwa przetwarzanie |
| Przetworzone | 2 | Przetworzone elementy |
| OnHold (wstrzymane) | 3 | Element jest wstrzymany |
| Wyjątek ogólny | 100 | Napotkano wyjątek ogólny |
| Wyjątek IT | 5 | Napotkano wyjątek IT |
| Wyjątek biznesowy | 6 | Napotkano wyjątek biznesowy |
| Utracony komunikat | 7 | Element jest wstrzymany |
| ProcessingTimeout | 8 | Upłynął limit czasu przetwarzania elementu |