Työjonotoiminnot

Power Automaten työjonoja voidaan käyttää prosessiin liittyvien töiden tallentamiseen sekä mahdollistamaan monimutkaisten prosessien ja automaatioiden erottaminen, jolloin niissä voidaan käyttää asynkronista tiedonsiirtoa.

Työjonoilla voi olla merkittävä vaikutus automatisointien tehokkuuden, skaalattavuuden ja vikasietoisuuden parantamisessa ja työn priorisoinnissa. Työjonojen avulla voit suorittaa tärkeimmät työkohteet ensin riippumatta siitä, ovatko niiden suorittajina digitaaliset työntekijät, ihmistyöntekijät vai integroinnit.

Huomautus

• Työjonoon liittyvien toimintojen ensimmäisen joukon tuotantotason tuki edellyttää Power Automate -työpöytäsovelluksen versiota 2.37 tai uudempaa.
• Power Automaten työpöytäsovelluksen työjonotoiminnot on premium-ominaisuus, joka edellyttää Power Automate -tilauksen.
• Tällä hetkellä vain Käsittele työjonokohteet ja Päivitä työjonokohde -toiminnot voidaan luokitella ja sallia tai rajoittaa tietojen menetyksen estämiskäytäntöjen (DLP) avulla. Muut toiminnot seuraavat pian. Huomaa, että pilvityönkulkupohjaista työjonojen käyttöä ei voi rajoittaa DLP-käytännöillä.

Käsittele työjonokohteet

Käsittele työjonokohteet -toiminto ilmaisee jonon orkestroijalle, että kone on valmiina käsittelemään vähintään yhden työjonokohteen. Uutta kohdetta pyytävällä käyttäjäkontekstilla on oltava riittävät oikeudet työjonoon ja työjonokohteiden taulukkoon, jotta se voi käsitellä työjonoja.

Jonon hallinta määrittää edellisessä toiminnossa viitatun työjonon avulla seuraavat käytettävissä olevat kohteet kyseisessä työjonossa, jotka ovat Jonoon asetettu -tilassa. Kun työpöytätyönkulku etenee näiden toimintojen läpi tämän toiminnon hahmontamassa Käsittele työjonokohteita -silmukassa, voit kutsua arvoa käyttämällä toiminnolle määrittämääsi muuttujaa yhdessä ominaisuuden .Value kanssa. Tässä tapauksessa kutsut työjonokohteen arvoa käyttämällä muuttujaa %WorkQueueItem.Value%

Tärkeää

FetchXML-lausekkeen antaminen Suodata rivejä -kentässä ohittaa työjonojen orkestroijan jonotettujen kohteiden FIFO-oletuslogiikan. Tämä mahdollistaa mukautetun jonosta poistamisjärjestyksen määrittäminen sekä kohteiden vanhentumispäivien ja muiden sellaisten automaattisesti käytettävien asetusten ohittamisen, kun mitään suodatinlauseketta ei anneta.

Processworkqueueitemaction

Toiminto Käsittele työjonokohteen toiminto vaatii seuraavat argumentit.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
Työjono	Ei	Viesti		Sen työjonon työjonotunnus, joka sisältää käsiteltävät kohteet.
Suodata rivit	Kyllä	Viesti		FetchXML-kyselylauseketta käytetään kohteiden noutamiseen työjonosta.
Ohita työjonon automaattisen uudelleenyrityksen määritys	Kyllä	Totuusarvo	Epätosi	Käyttöönotettuna näkyvissä on kenttä, jossa voidaan määrittää IT Exceptions -uudelleenyritysten enimmäismäärä tai ohittaa se.
Uudelleenyritysten enimmäismäärä	No	Tekstiarvo, Numeerinen arvo	Jos ei korvata, se käyttää työjonotietueessa määritettyä uudelleenyritysten enimmäismäärän oletusarvoa.	IT Exceptions -uudelleenyritysten suurin sallittu määrä. Tämä parametri mahdollista uudelleenyritysmäärän arvon pienentämisen tai suurentamista sekä uudelleenyritysmekanismin poistamisen käytöstä, kun määräksi määritetään 0.

Tuotetut muuttujat

Argumentti	Type	Description
WorkQueueItem	Ei	Käsiteltävään työjonokohteeseen tallennetut tiedot

Poikkeukset

Poikkeus	Kuvaus
Työjonoa ei löydy	Työjonoparametriin syötetty arvo on virheellinen.
Työjono keskeytettiin tai pysäytettiin	Työjono joko keskeytetään tai pysäytetään, mikä ei ole kelvollinen tila kohteita käsiteltäessä.
Virheellinen FetchXML	Annettu FetchXML-lauseke oli virheellinen.
Työjonon käsittely epäonnistui	Virheellinen pyyntö – virhe kyselyn syntaksissa.

Mitä FetchXML-kyselyt ovat?

Microsoft Dataversen FetchXML on kieli, jolla noudetaan tietoja Dataverse-tietokannasta. Sitä on helppo luoda, käyttää ja ymmärtää. Esimerkiksi orkestroijaa voidaan pyytää käsittelemään kohteet jossain muussa kuin FIFO (ensimmäisenä sisään, ensimmäisenä ulos) -järjestyksessä ja tietyn vanhentumisajan kuluessa.

FetchXML-kyselytukea työnjonokohteiden käsittelyssä rajoitetaan tukemalla rajoitettua FetchXML-ehto ja -lausekejoukkoa. Näitä ehtoja ovat suodattimet, ehdot ja järjestyslausekkeet, jotka kaikki on rajoitettu työjonon kohdetaulukkoon (workqueueitem). Vain kohteet, joiden tila on Queued, palautetaan.

FetchXML-esimerkkikysely

Seuraava on esimerkki kyselylausekkeesta, jossa suodatusperusteena on käytössä name ja tulokset järjestetään ensimmäisenä vanhentuvien tietueiden (FEFO) perusteella.

<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" />

Kyselyn tukitiedot ja viitetiedot

• Käytössä olevien kyselyoperaattorien luettelo, mukaan lukien operaattorit, kuten viimeistään, välillä ja edellinen kuukausi.
• Työjonokohde-taulukossa käytettävissä olevien määritteiden luettelo-

Päivitä työjonokohde

Päivitä työjonokohde -toiminnon avulla käyttäjät voivat muuttaa valitun työjonokohteen tilaa ja käsittelytuloksia.

Updateworkqueueitemaction

Toiminto Päivitä työjonokohteen toiminto vaatii seuraavat argumentit.

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Kuvaus
Työjonokohde	Ei	Viesti		Työjonokohteen muuttuja, jonka jonon orkestroija on aiemmin palauttanut
Tila	Ei	Käsitelty, yleinen poikkeus	Käsitelty	Päivitä käsiteltävä työjonokohde valitsemalla tila vaihtoehtoluettelosta.
Käsittelyhuomautukset	Kyllä	Viesti		Käsiteltävään jonon kohteeseen liitettävät mukautetut käsittelyn muistiinpanot tai arvo.
Tyhjennä käsittelymuistiinpanot	Kyllä	Totuusarvo	Epätosi	Kun tämä on käytössä, se piilottaa ja tyhjentää käsittelymuistiinpanojen kentän tältä näytöltä ja poistaa tietokannasta kaikki käsittelymuistiinpanot, jotka on aiemmin tallennettu tälle kohteelle.

Poikkeukset

Argumentti	Description
Työjonokohdetta ei löydy	Käsiteltävä työjonokohde on joko poistettu tai se ei enää kuulu siihen jonoon, josta se on kutsuttu.
Työjonokohde pidossa	Käsiteltävän työjonokohteen tila jonon orkestroijassa on on hold, eikä sitä enää voi päivittää.
Työjonokohteen päivittäminen epäonnistui	Päivitettävä työjonokohde kohtasi odottamattoman virheen. Lisätietoja on virhesanomassa.

Lisää työjonokohde

Lisää työjonokohde -toiminto sallii käyttäjien lisätä työjonokohteita työjonoon, joka on määritetty työnkulkuportaalissa.

Enqueueworkqueueitemaction

Toiminto Lisää työjonokohde vaatii seuraavat argumentit.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
Työjono	Ei	Tekstin arvo		Työjonokohde, jonne kohde lisätään
Prioriteetti	Ei	Korkea, normaali, matala	Tavallinen	Työjonon kohteelle määritettävä prioriteetti
Nimi	Ei	Tekstiarvo, Numeerinen arvo		Uuden työjonon kohteen mukautettu nimi tai tunnus
Syöte	No	Tekstiarvo, Numeerinen arvo		Tiedot, jotka kuuluvat käsiteltävään arvosarakkeeseen
Vanhentuu	Kyllä	Datetime		Päivämäärä-/aika-arvojoukko, joka on määritetty jonokohteen vanhentumiselle. Jos jonolle on määritetty sellainen, tässä käytetään oletusarvoa
Käsittelyhuomautukset	Kyllä	Tekstiarvo, Numeerinen arvo		Uuteen jonokohteeseen lisättävät mukautetut käsittelymuistiinpanot
Sisältää yksilöivän tunnuksen tai viitteen	Kyllä	Tekstiarvo, Numeerinen arvo		Kun tämä asetus on otettu käyttöön, tulisi antaa tässä jonossa yksilöllinen arvo. Jos kenttä jätetään tyhjäksi, järjestelmä antaa automaattisesti yksilöllisen arvon muodossa system-<GUID>

Tuotetut muuttujat

Argumentti	Type	Description
WorkQueueItem	Ei	Lisättävää työjonokohdetta varten tallennetut tiedot

Poikkeukset

Argumentti	Kuvaus
Työjonoa ei löydy	Työjonoparametriin syötetty arvo on virheellinen
Kohteen lisääminen työjonoon epäonnistui	Työjonokohdetta ei voitu lisätä työjonoon. Virheellinen pyyntö – virhe kyselyn syntaksissa

Lisää useita työjonokohteita

Lisää useita työjonokohteita -toiminto antaa käyttäjille mahdollisuuden lisätä työjonoon yhden tai usean työkohteen työjonokohteen tietotaulukkona annettujen tietojen perusteella.

Tätä toimintoa varten tarvitaan mukautettu tietotaulukko, jossa on vähintään yksi työjonokohde. Tietotaulukossa on oltava kahdeksan saraketta ja sen rakenteen on oltava seuraavankaltainen:

Sarakkeen nimi	Description	Pakolliset	Sallitut arvot
Name	kohteen nimeä.	No	Mikä tahansa aakkosnumeerinen merkkijono
Syöte	Syötetiedot tai kohteen tiedot.	Kyllä	Mikä tahansa aakkosnumeerinen merkkijono
Vanhentuu	Määrittää keston kohteen vanhentumiseen.	No	Päivämäärä- ja aika-arvo
Käsittelyhuomautukset	Kohteeseen liittyvät käsittelyhuomautukset.	No	Mikä tahansa aakkosnumeerinen merkkijono
Prioriteetti	Kohteen prioriteettitaso.	Kyllä	Numeroarvo, joka on joko 100 (korkea), 200 (normaali) tai 300 (matala)
Yksilöivä viite	Nimikkeen yksilöivä tunnus tai viitearvo.	No	Mikä tahansa yksilöivä aakkosnumeerinen merkkijono tai viite
Status	Kohteen tila käsittelyhetkellä.	Kyllä	Numeerinen arvo joko nolla (Jonossa) tai yksi (Pidossa).
Lykkää ajankohtaan:	Määrittää päivämäärän ja ajan hetkeen, jolloin työjonokohteiden käsittely ohitetaan.	No	Päivämäärä- ja aika-arvo

Robin-koodikatkelma tietotaulukon luontia varten

Seuraavassa esimerkissä on (perinteisissä työnkuluissa käytetty) robin-koodikatkelma, joka voidaan kopioida ja liittää suoraan Power Automate -työpöytäsovelluksen suunnitteluohjelmaikkunaan. Tämä koodikatkelma lisää Lisää uusi tietotaulukko -toiminnon ja odotustenmukaisen kenttäjoukon työnkulkuun.

Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable

PowerFx-koodikatkelma tietotaulukon luontia varten

Seuraavassa esimerkissä on PowerFx-koodikatkelma, joka voidaan kopioida ja liittää suoraan Power Automate -työpöytäsovelluksen suunnitteluohjelmaikkunaan. Tämä koodikatkelma lisää Lisää uusi tietotaulukko -toiminnon ja odotustenmukaisen kenttäjoukon työnkulkuun.

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

Lisää useita työjonokohteita -toiminto edellyttää seuraavia argumentteja.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
Työjono	No	Tekstin arvo		Työjonokohde, jonne kohde lisätään
Työjonokohteen tiedot	Kyllä	Tietotaulukko		Työjonoon lisättävät työjonokohteet sisältävä tietotaulukko

Tuotetut muuttujat

Argumentti	Type	Oletusarvo	Description
FailedWorkQueueItems	No	Käytössä	Jos virheitä esiintyy, tämä objekti sisältää epäonnistuneen kohteen indeksin, joka lisätään yhdessä virhekoodin kanssa. Palautettu indeksi on kohteen sijainti (indeksi) annetussa Lisää useita työjonokohteita -toiminnon työjonon tietotaulukossa.
HasFailedItems	No	Käytössä	Ilmaisee, oliko toiminnoissa käsittelyvirheitä työjonokohteen tieto-ongelmien vuoksi.
SuccessfulWorkQueueItems	Disabled	No	Mukautettu objekti, joka sisältää indeksin ja työjonokohteet, joiden lisääminen työjonoon onnistui.

Poikkeukset

Argumentti	Description
Työjonoa ei löydy	Työjonoparametriin syötetty arvo on virheellinen
Työjono keskeytettiin tai pysäytettiin	Työjonokohdetta ei voitu lisätä työjonoon, koska työjono on joko keskeytetty tai pysäytetty.
Työjonokohteiden luettelon erän asettaminen jonoon epäonnistui	Työjonokohteita ei voitu lisätä työjonoon pyynnön tai viestintävirheen vuoksi.

Lisää kohde uudelleen jonoon viiveellä

Aseta kohde uudelleen jonoon viiveellä -toiminnon avulla käyttäjät voivat lisätä työpöytätyönkulussa käsiteltävän jonokohteen uudelleen takaisin sen alkuperäiseen jonoon. Lisäksi jonokohteen voi pitää ja vapauttaa määritettyyn aikaan asti.

Requeueworkqueueitemaction

Toiminto Aseta tuote uudelleen jonoon viiveellä vaatii seuraavat argumentit.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
Työjonokohde	Ei	Työjonokohde		Työjonokohde, jonne kohde lisätään
Lykkää ajankohtaan:	Ei	Päivämäärän/ajan arvo	Tavallinen	Jonokohteen viivästyttämiseen käytetty päivämäärä- ja aika-arvo
Vanhentuu	Kyllä	Päivämäärän/ajan arvo		Uudelleen jonoon asetetun kohteen mukautettu vanhenemisaika
Käsittelyhuomautukset	Kyllä	Tekstiarvo, Numeerinen arvo		Uuteen jonokohteeseen lisättävät mukautetut käsittelymuistiinpanot
Tyhjennä käsittelymuistiinpanot	Kyllä	Totuusarvo	Epätosi	Kun tämä on käytössä, se piilottaa ja tyhjentää käsittelymuistiinpanojen kentän tältä näytöltä ja poistaa tietokannasta kaikki käsittelymuistiinpanot, jotka on aiemmin tallennettu tälle kohteelle

Poikkeukset

Argumentti	Description
Työjonoa ei löydy	Työjonoparametriin syötetty arvo on virheellinen
Työjonokohdetta ei löydy	Jonokohteen arvo on virheellinen
Työjonokohteen asettaminen uudelleen jonoon epäonnistui	Työjonokohdetta ei voitu lisätä työjonoon. Virheellinen pyyntö – virhe kyselyn syntaksissa

Päivitä työjonokohteen käsittelyhuomautukset

Päivitä työjonokohteen käsittelymuistiinpanot -toiminnon avulla käyttäjät voivat päivittää tai tyhjentää valitun työjonokohteen käsittelymuistiinpanot muuttamatta sen tilaa tai muuta ominaisuutta.

updateprocessingnotesaction

Päivitä työjonokohteen käsittelyhuomautukset -toiminto edellyttää seuraavia argumentteja.

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
Työjonokohde	No	Viesti		Jonon hallinnan aiemmin palauttama työjonokohteen muuttuja
Käsittelyhuomautukset	Kyllä	Viesti		Käsiteltävään jonon kohteeseen liitettävä mukautettu käsittelyn tulos tai arvo
Tyhjennä käsittelymuistiinpanot	Kyllä	Totuusarvo	Epätosi	Kun tämä on käytössä, se piilottaa ja tyhjentää käsittelymuistiinpanojen kentän tältä näytöltä ja poistaa tietokannasta kaikki käsittelymuistiinpanot, jotka on aiemmin tallennettu tälle kohteelle

Poikkeukset

Argumentti	Description
Työjonoa ei löydy	Kohteeseen liitetty työjono on poistettu tai se ei ole enää käytettävissä
Työjonokohdetta ei löydy	Työjonokohde on virheellinen
Käsittelytulosten lisääminen epäonnistui	Päivitettävä työjonokohde kohtasi odottamattoman virheen. Lisätietoja on virhesanomassa.

Hae työjonokohteet suodattimen mukaan

Hae työjonokohteet suodattimen mukaan -toiminto antaa käyttäjille mahdollisuuden noutaa vähintään yhden työjonokohteen FetchXML-suodatinlausekkeen perusteella.

Getworkqueueitemsaction

Hae työjonokohteet suodattimen mukaan -toiminto edellyttää seuraavia argumentteja.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
Työjono	No	Viesti		Työjono, josta kohteet noudetaan
Suodata rivit	No	Viesti		FetchXML-kyselylauseketta käytetään kohteiden noutamiseen työjonosta
Palautettavat rivit	No	Number	5000	Orkestroijan palauttamien työjonokohteiden enimmäismäärä

Tuotetut muuttujat

Argumentti	Type	Oletusarvo	Description
WorkQueueItems	No	Käytössä	Luettelo suodatinlauseketta vastaavista työjonokohteista.

Poikkeukset

Argumentti	Description
Työjono	Työjono, josta kohteet noudetaan.
Suodata rivit	FetchXML-kyselylauseketta käytetään kohteiden noutamiseen työjonosta.
Palautettavat rivit	Orkestroijan palauttamien työjonokohteiden enimmäismäärä (oletus on 5 000).

Mitä FetchXML-kyselyt ovat?

Microsoft Dataversen FetchXML on kieli, jolla noudetaan tietoja Dataverse-tietokannasta. Sitä on helppo luoda, käyttää ja ymmärtää. Dataversea voidaan esimerkiksi pyytää antamaan luettelo työjonokohteista, joiden tila on IT Exception.

Työjonokohteiden noutamista koskevaa FetchXml-kyselytukea rajoitetaan tukemalla vain rajoitettua FetchXml-ehto- ja -lausekejoukkoa. Näitä ehtoja ja lausekkeita ovat määritteet, suodattimet, ehdot ja järjestyslausekkeet, jotka kaikki on rajoitettu työjonon kohdetaulukkoon (workqueueitem). Työjonokohdetaulukosta noudettavat ominaisuudet ja toivottu lajittelujärjestys on nimenomaisesti määritettävä.

FetchXML-esimerkkikysely

Seuraava esimerkki on kyselylauseke, jolla noudetaan useita ominaisuuksia, suodatetaan pois virheelliset nimikkeet, joilla on merkintä IT Exceptions, ja järjestetään tulokset ensimmäisenä vanhentuvien tietueiden (FEFO) mukaan.

<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" />

Kyselyn tukitiedot ja viitetiedot

• Käytössä olevien kyselyoperaattorien luettelo, mukaan lukien operaattorit, kuten viimeistään, välillä ja edellinen kuukausi.
• Työjonokohde-taulukossa käytettävissä olevien määritteiden luettelo-

Tila (statecode)

Status	Koodi	Description
Jonossa	0	Kohde on jonossa
Käsittely	1	Kohdetta käsitellään
Käsitelty	2	Kohde käsiteltiin
Pidossa	3	Kohde on pidossa
Error	4	Kohteessa on virhe

Tilan syy (statuscode)

Tilan syy	Koodi	Description
Jonossa	0	Kohde on jonossa
Käsittely	1	Kohdetta käsitellään
Käsitelty	2	Kohde käsiteltiin
OnHold (keskeytetty)	3	Kohde on pidossa (keskeytetty)
Yleinen poikkeus	4	Kohde havaitsi yleisen poikkeuksen
IT-poikkeus	5	Kohde havaitsi IT-poikkeuksen
Liiketoimintapoikkeus	6	Kohde havaitsi liiketoimintapoikkeuksen
Perille toimittamaton sanoma	7	Kohde on pidossa
ProcessingTimeout	8	Kohteen käsittelyn aikakatkaisua

Liittyvät tiedot

• Työjonon yleiskatsaus
• Työjonojen hallinta
• Työjonon tietojen joukkotuonti
• Työjonojen käynnistäminen
• Työjonojen käsitteleminen