Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Le code di lavoro in Power Automate possono essere utilizzate per archiviare dati pertinenti per il processo e fornire un modo per disaccoppiare processi complessi e automazioni, consentendo loro di comunicare in modo asincrono.
Le code di lavoro possono svolgere un ruolo cruciale nel migliorare l'efficienza, la scalabilità e la resilienza delle automazioni e aiutare a stabilire le priorità del lavoro. Le code di lavoro ti consentono di completare dapprima gli elementi con la priorità più alta, indipendentemente dal fatto che vengano elaborati da lavoratori digitali, lavoratori umani o tramite integrazioni.
Nota
- Il supporto a livello di produzione per la prima serie di azioni relative alla coda di lavoro richiede la versione desktop di Power Automate 2.37 o successiva.
- Le azioni della coda di lavoro in Power Automate per desktop sono una funzionalità premium che richiede un abbonamento a Power Automate.
- Attualmente solo le azioni Elaborare elementi della coda di lavoro e Aggiorna elemento della coda di lavoro possono essere classificate e consentite o limitate tramite i criteri della prevenzione della perdita dei dati (DLP), a cui seguiranno presto altre azioni. Tieni presente che l'uso delle code di lavoro basate sui flussi cloud non può essere limitato dai criteri DLP.
Elabora elementi della coda di lavoro
L'azione Elabora elementi della coda di lavoro indica all'agente di orchestrazione della coda che la macchina è pronta per elaborare uno o più elementi della coda di lavoro. Il contesto utente che richiede un nuovo elemento deve disporre di privilegi sufficienti per la coda di lavoro e la tabella degli elementi della coda di lavoro per poter elaborare le code di lavoro.
La coda di lavoro a cui si fa riferimento nell'azione precedente viene utilizzata dall'orchestratore della coda per determinare i successivi elementi disponibili in quella coda di lavoro che si trova in stato In coda. Man mano che il flusso desktop esegue le azioni del ciclo Elabora elementi della coda di lavoro di cui questa azione esegue il rendering, puoi richiamare il valore utilizzando la variabile che hai designato per l'azione insieme alla proprietà .Value. In questo caso, puoi chiamare il valore dell'elemento della coda di lavoro utilizzando la variabile %WorkQueueItem.Value%
Importante
Specificando un'espressione FetchXML nel campo "Filtra righe", si ignora la logica FIFO dell'orchestratore della coda di lavoro predefinita per gli elementi in coda. Ciò consente di impostare un ordine di rimozione dalla coda personalizzato e di ignorare le date di scadenza degli articoli e altre impostazioni che vengono applicate automaticamente quando non viene fornita alcuna espressione di filtro.
Processworkqueueitemaction
L'azione Elabora elementi della coda di lavoro richiede i seguenti argomenti.
Parametri di input
| Argomento | Facoltativo | Accetta | Valore predefinito | Descrzione |
|---|---|---|---|---|
| Coda di lavoro | No | Testo | L'ID coda di lavoro della coda di lavoro che contiene gli elementi da elaborare. | |
| Filtra righe | Sì | Testo | L'espressione di query FetchXML utilizzata per recuperare gli elementi dalla coda di lavoro. | |
| Sovrascrivi la configurazione dei nuovi tentativi automatici della coda di lavoro | Sì | Boolean | Falso | Se abilitata, viene visualizzato un campo che consente di impostare o sovrascrivere il numero massimo di tentativi per IT Exceptions. |
| Numero massimo di tentativi | No | Valore di testo, Valore numerico | Se non viene sovrascritto, utilizza il numero massimo di tentativi predefinito definito nel record della coda di lavoro. | Il numero massimo di tentativi consentiti per IT Exceptions. Questo parametro consente di regolare il conteggio dei tentativi su un valore più alto o più basso, o addirittura di disattivare il meccanismo di tentativi impostando il conteggio su 0. |
Variabili prodotte
| Argomento | Tipo | Descrzione |
|---|---|---|
| WorkQueueItem | Elemento di una coda di lavoro | Le informazioni memorizzate nell'elemento della coda di lavoro in fase di elaborazione |
Eccezioni
| Eccezione | Descrzione |
|---|---|
| Coda di lavoro non trovata | Il valore immesso nel parametro della coda di lavoro non è valido. |
| Coda di lavoro sospesa o interrotta | La coda di lavoro è in pausa o interrotta, il che non è uno stato valido durante l'elaborazione degli elementi. |
| FetchXML non valido | Un'espressione FetchXML non valida è stata fornita. |
| Impossibile elaborare la coda di lavoro | Richiesta errata: errore nella sintassi della query. |
Cosa sono le query FetchXML?
Microsoft Dataverse FetchXML è un linguaggio utilizzato per recuperare dati da un database Dataverse. È progettato per essere facile da creare, utilizzare e comprendere. Ad esempio, potresti voler chiedere all'orchestratore di elaborare gli elementi in un ordine diverso dal metodo FIFO (first-in-first-out) e entro un intervallo di tempo di scadenza specifico.
Per limitare il supporto delle query FetchXML all'elaborazione degli elementi della coda di lavoro, è supportato un set limitato di termini ed espressioni FetchXML. Questi termini includono filtri, condizioni ed espressioni di ordinamento, tutti limitati alla tabella degli elementi della coda di lavoro (workqueueitem). Vengono restituiti solo gli elementi che si trovano in uno stato Queued.
Query FetchXML di esempio
Di seguito è riportato un esempio di espressione di query su come filtrare name e ordinare i risultati in base ai record che scadono per primi (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" />
Le query supportano i dettagli e i dati di riferimento
- Elenco degli operatori di query disponibili per l'uso, inclusi operatori quali il o prima del, tra e mese scorso.
- Elenco degli attributi disponibili nella tabella Elemento coda di lavoro.
Aggiorna elemento della coda di lavoro
L'azione Aggiorna elemento della coda di lavoro consente agli utenti di modificare lo stato e i risultati dell'elaborazione dell'elemento della coda di lavoro selezionato.
Updateworkqueueitemaction
L'azione Aggiorna elemento della coda di lavoro richiede i seguenti argomenti.
| Argomento | Facoltativo | Accetta | Valore predefinito | Descrzione |
|---|---|---|---|---|
| Elemento della coda di lavoro | No | Testo | Variabile dell'elemento della coda di lavoro precedentemente restituita dall'orchestratore della coda | |
| Stato | No | Elaborato, Eccezione generica | Elaborato | Aggiorna l'elemento della coda di lavoro in fase di elaborazione utilizzando uno stato dell'elenco di opzioni. |
| Note di elaborazione | Sì | Testo | Note o valore di elaborazione personalizzati da aggiungere all'elemento della coda in fase di elaborazione. | |
| Cancella le note di elaborazione | Sì | Boolean | Falso | Se abilitata, cancella il campo delle note di elaborazione da questa schermata e rimuove tutte le note di elaborazione dal database acquisite in precedenza per l'elemento. |
Eccezioni
| Argomento | Descrzione |
|---|---|
| Elemento della coda di lavoro non trovato | L'elemento della coda di lavoro in fase di elaborazione è stato eliminato o non appartiene più alla coda da cui è stato chiamato. |
| Elemento della coda di lavoro in sospeso | L'elemento della coda di lavoro in fase di elaborazione contiene uno stato di on hold nell'agente di orchestrazione della coda e non può più essere aggiornato. |
| Impossibile aggiornare l'elemento della coda di lavoro | Si è verificato un errore imprevisto durante l'aggiornamento dell'elemento della coda di lavoro. Controlla il messaggio di errore per altri dettagli. |
Aggiungi un elemento della coda di lavoro
L'azione Aggiungi elemento della coda di lavoro consente agli utenti di popolare gli elementi della coda di lavoro in una coda di lavoro che è stata impostata nel portale dei flussi.
Enqueueworkqueueitemaction
L'azione Aggiungi elemento della coda di lavoro richiede i seguenti argomenti.
Parametri di input
| Argomento | Facoltativo | Accetta | Valore predefinito | Descrzione |
|---|---|---|---|---|
| Coda di lavoro | No | Valore del testo | L'elemento della coda di lavoro in cui aggiungere l'elemento | |
| Priorità | No | Alta, Normale, Bassa | Normale | La priorità su cui impostare l'elemento della coda di lavoro |
| Nome | No | Valore di testo, Valore numerico | Nome o ID personalizzato per il nuovo elemento della coda di lavoro | |
| Input | No | Valore di testo, Valore numerico | I dati, che appartengono alla colonna dei valori da elaborare | |
| Expires | Sì | Data e ora | Il valore di data e ora impostato per determinare la scadenza dell'elemento della coda; altrimenti viene adottato il valore predefinito, se impostato per la coda | |
| Note di elaborazione | Sì | Valore di testo, Valore numerico | Note di elaborazione personalizzate da aggiungere al nuovo elemento della coda | |
| Ha un riferimento o ID univoco | Sì | Valore di testo, Valore numerico | Se abilitato, è necessario fornire un valore univoco all'interno di questa coda. Se lasciato vuoto, il sistema fornisce automaticamente un valore univoco nel formato system-<GUID> |
Variabili prodotte
| Argomento | Tipo | Descrzione |
|---|---|---|
| WorkQueueItem | Elemento di una coda di lavoro | Informazioni memorizzate per l'elemento della coda di lavoro da aggiungere |
Eccezioni
| Argomento | Descrzione |
|---|---|
| Coda di lavoro non trovata | Il valore immesso nel parametro della coda di lavoro non è valido |
| Impossibile aggiungere l'elemento alla coda di lavoro | Impossibile aggiungere l'elemento della coda di lavoro alla coda di lavoro. Richiesta errata: errore nella sintassi della query |
Aggiungi più elementi alla coda di lavoro
L'azione Aggiungi più elementi alla coda di lavoro consente agli utenti di aggiungere uno o più elementi alla coda di lavoro in base ai dati forniti come tabella dati degli elementi della coda di lavoro.
Questa azione richiede una tabella dati personalizzata che contenga uno o più elementi della coda di lavoro. La tabella dati deve avere otto colonne e conformarsi allo schema seguente:
| Nome della colonna | Descrzione | Obbligatorio | Valori consentiti |
|---|---|---|---|
| Name | Nome dell'elemento. | No | Qualsiasi stringa alfanumerica |
| Input | Inserisci i dettagli o i dati dell'elemento. | Sì | Qualsiasi stringa alfanumerica |
| Scade tra | Specifica la durata fino alla scadenza dell'elemento. | No | Valore di data e ora |
| Note di elaborazione | Note di elaborazione relative all'elemento. | No | Qualsiasi stringa alfanumerica |
| Priorità | Il livello di priorità dell'elemento. | Sì | Valore numerico di 100 (Alto), 200 (Normale), 300 (Basso) |
| Riferimento univoco | Un identificatore univoco o un valore di riferimento per l'elemento. | No | Qualsiasi stringa alfanumerica o riferimento univoco |
| Status | Stato dell'elemento durante l'acquisizione. | Sì | Valore numerico di zero (in coda) o uno (in attesa). |
| Ritarda fino a | Specifica una data e un'ora fino a quando gli elementi della coda di lavoro devono essere ignorati per l'elaborazione. | No | Valore di data e ora |
Frammento di codice Robin per la creazione della tabella dati
L'esempio seguente è un frammento di codice robin (utilizzato nei flussi tradizionali) che è possibile copiare e incollare direttamente nella finestra di progettazione del desktop Power Automate. Questo frammento aggiunge un'azione Crea nuova tabella dati con il set di campi previsto al tuo flusso.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable
Frammento di codice PowerFx per la creazione della tabella dati
L'esempio seguente è un frammento di codice PowerFx che è possibile copiare e incollare direttamente nella finestra di progettazione del desktop Power Automate. Questo frammento aggiunge un'azione Crea nuova tabella dati con il set di campi previsto al tuo flusso.
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
L'azione Aggiungi più elementi alla coda di lavoro richiede i seguenti argomenti.
Parametri di input
| Argomento | Facoltativo | Accetta | Valore predefinito | Descrzione |
|---|---|---|---|---|
| Coda di lavoro | No | Valore del testo | L'elemento della coda di lavoro in cui aggiungere l'elemento | |
| Dati dell'elemento della coda di lavoro | Sì | Tabella dati | La tabella dati personalizzata contenente gli elementi della coda di lavoro da aggiungere alla coda di lavoro |
Variabili prodotte
| Argomento | Tipo | Valore predefinito | Descrzione |
|---|---|---|---|
| FailedWorkQueueItems | No | Attivata | In caso di errori, questo oggetto contiene l'indice dell'elemento che non è stato possibile inserire insieme a un codice di errore. L'indice restituito è la posizione (indice) dell'elemento nella tabella dati della coda di lavoro fornita dall'azione Aggiungi più elementi alla coda di lavoro . |
| HasFailedItems | No | Attivata | Indicatore che segnala se le azioni hanno riscontrato errori di acquisizione a causa di problemi nei dati degli elementi della coda di lavoro. |
| SuccessfulWorkQueueItems | Disabilitato | No | Un oggetto personalizzato che include un indice e una coda di lavoro aggiunti correttamente alla coda di lavoro. |
Eccezioni
| Argomento | Descrzione |
|---|---|
| Coda di lavoro non trovata | Il valore immesso nel parametro della coda di lavoro non è valido |
| Coda di lavoro sospesa o interrotta | Non è stato possibile aggiungere l'elemento alla coda di lavoro perché la coda di lavoro è in pausa o interrotta. |
| Impossibile accodare in blocco un elenco di elementi della coda di lavoro | Non è stato possibile aggiungere gli elementi alla coda di lavoro a causa di una richiesta o di un errore di comunicazione. |
Accoda nuovamente l'elemento con ritardo
L'azione Reinserisci elemento in coda con ritardo consente agli utenti di reinserire un elemento della coda in elaborazione nel flusso desktop di nuovo nella coda di origine. Inoltre, l'elemento in coda può essere trattenuto e rilasciato fino a un tempo definito.
Requeueworkqueueitemaction
L'azione Riaccodare l'elemento con ritardo richiede i seguenti argomenti.
Parametri di input
| Argomento | Facoltativo | Accetta | Valore predefinito | Descrzione |
|---|---|---|---|---|
| Elemento della coda di lavoro | No | Elemento di una coda di lavoro | L'elemento della coda di lavoro in cui aggiungere l'elemento | |
| Ritarda fino a | No | Valore data e ora | Il valore di data e ora applicato per posticipare l'elemento della coda fino a | |
| Expires | Sì | Valore data e ora | Orario di scadenza personalizzato per l'articolo riaccodato | |
| Note di elaborazione | Sì | Valore di testo, Valore numerico | Note di elaborazione personalizzate da aggiungere al nuovo elemento della coda | |
| Cancella le note di elaborazione | Sì | Boolean | Falso | Se abilitata, cancella il campo delle note di elaborazione da questa schermata e rimuove tutte le note di elaborazione dal database acquisite in precedenza per l'elemento |
Eccezioni
| Argomento | Descrzione |
|---|---|
| Coda di lavoro non trovata | Il valore immesso nel parametro della coda di lavoro non è valido |
| Elemento della coda di lavoro non trovato | Il valore dell'elemento della coda non è valido |
| Impossibile accodare nuovamente l'elemento nella coda di lavoro | Impossibile aggiungere l'elemento della coda di lavoro alla coda di lavoro. Richiesta errata: errore nella sintassi della query |
Aggiorna le note di elaborazione dell'elemento della coda di lavoro
L'azione Aggiorna note di elaborazione dell'elemento della coda di lavoro consente agli utenti di aggiornare o cancellare le note di elaborazione dell'elemento coda di lavoro selezionato senza modificarne lo stato o qualsiasi altra proprietà.
updateprocessingnotesaction
L'azione Aggiorna note per l'elaborazione degli elementi della coda di lavoro richiede i seguenti argomenti.
| Argomento | Facoltativo | Accetta | Valore predefinito | Descrzione |
|---|---|---|---|---|
| Elemento della coda di lavoro | No | Testo | Variabile dell'elemento della coda di lavoro precedentemente restituito dall'orchestratore della coda | |
| Note di elaborazione | Sì | Testo | Risultato o valore di elaborazione personalizzati da aggiungere all'elemento della coda in fase di elaborazione | |
| Cancella le note di elaborazione | Sì | Boolean | Falso | Se abilitata, cancella il campo delle note di elaborazione da questa schermata e rimuove tutte le note di elaborazione dal database acquisite in precedenza per l'elemento |
Eccezioni
| Argomento | Descrzione |
|---|---|
| Coda di lavoro non trovata | La coda di lavoro associata all'elemento è stata eliminata o non è più accessibile |
| Elemento della coda di lavoro non trovato | Elemento della coda di lavoro non valido |
| Impossibile accodare i risultati dell'elaborazione | Si è verificato un errore imprevisto durante l'aggiornamento dell'elemento della coda di lavoro. Controlla il messaggio di errore per altri dettagli. |
Recupera elementi della coda di lavoro tramite filtro
L'azione Ottieni elementi della coda di lavoro tramite filtro consente agli utenti di recuperare uno o più elementi della coda di lavoro in base a un'espressione di filtro FetchXML.
Getworkqueueitemsaction
L'azione Ottieni elementi della coda di lavoro tramite filtro richiede i seguenti argomenti.
Parametri di input
| Argomento | Facoltativo | Accetta | Valore predefinito | Descrzione |
|---|---|---|---|---|
| Coda di lavoro | No | Testo | Coda di lavoro da cui recuperare gli elementi | |
| Filtra righe | No | Testo | Espressione di query FetchXML utilizzata per recuperare gli elementi dalla coda di lavoro | |
| Righe da restituire | No | Numero | 5000 | Numero massimo di elementi della coda di lavoro restituiti dall'orchestratore |
Variabili prodotte
| Argomento | Tipo | Valore predefinito | Descrzione |
|---|---|---|---|
| WorkQueueItems | No | Attivata | Elenco degli elementi della coda di lavoro che corrispondono all'espressione del filtro. |
Cosa sono le query FetchXML?
Microsoft Dataverse FetchXML è un linguaggio utilizzato per recuperare dati da un database Dataverse. È progettato per essere facile da creare, utilizzare e comprendere. Ad esempio, potresti chiedere a Dataverse di fornirti un elenco di tutti gli elementi della coda di lavoro che si trovano nello stato IT Exception.
Per limitare il supporto delle query FetchXml al recupero degli elementi della coda di lavoro, supportiamo solo un set limitato di termini ed espressioni FetchXml. Questi termini ed espressioni includono attributi, filtri, condizioni ed espressioni di ordinamento, tutti limitati alla tabella degli elementi della coda di lavoro (workqueueitem). È necessario specificare esplicitamente quali proprietà restituire dalla tabella degli elementi della coda di lavoro e l'ordinamento desiderato.
Query FetchXML di esempio
L'esempio seguente è un'espressione di query su come recuperare diverse proprietà, filtrare gli elementi con errori contrassegnati come IT Exceptions e ordinare i risultati in base alle registrazioni che scadono per prime (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" />
Le query supportano i dettagli e i dati di riferimento
- Elenco degli operatori di query disponibili per l'uso, inclusi operatori quali il o prima del, tra e mese scorso.
- Elenco degli attributi disponibili nella tabella Elemento coda di lavoro.
Stato (statecode)
| Status | Codice | Descrzione |
|---|---|---|
| In attesa | 0 | L'articolo è in coda |
| In elaborazione | 1 | L'elemento è in fase di elaborazione |
| Elaborato | 2 | Elemento processato |
| In attesa | 3 | L'articolo è in sospeso |
| Errore | 4 | Elemento ha riscontrato un errore |
Motivo dello stato (statuscode)
| Motivo dello stato | Codice | Descrzione |
|---|---|---|
| In coda | 0 | L'articolo è in coda |
| In elaborazione | 1 | L'elemento è in fase di elaborazione |
| Elaborato | 2 | Elemento processato |
| Pausa | 3 | L'elemento è sospeso o in attesa |
| Eccezione generica | 4 | L'elemento ha riscontrato un'eccezione generica |
| ITException | 5 | L'elemento ha riscontrato un'eccezione IT |
| BusinessException | 6 | L'elemento ha riscontrato un'eccezione aziendale |
| DeadLetter | 7 | L'elemento è in sospeso |
| ProcessingTimeout | 8 | Timeout elaborazione elemento |