Mukautettujen toimintojen luominen tai muokkaaminen työnkulusta

Tässä ohjeaiheessa käsitellään Dynamics 365 Customer Engagement (on-premises) -sovellusta. Ohjeaiheen Power Apps -versio on täällä: Mukautettujen toimintojen määrittäminen työnkulusta

Voit ottaa mukautetun toiminnon käyttöön työnkulusta ilman koodin kirjoittamista. Lisätietoja: Mukautettujen toimintojen käynnistäminen työnkulusta.

Voit luoda toiminnon niin, että kehittäjä voi käyttää sitä koodissa tai niin, että voit muokata aiemmin määritettyä toimintoa. Kuten työnkulkuprosesseissakin, harkitse seuraavaa:

• Mitä toiminnon tulisi tehdä?

• Millaisten ehtojen vallitessa toiminto tulee suorittaa?

Toisin kuin työnkulkuprosesseissa, sinun ei tarvitse määrittää seuraavia asetuksia:

• Aloita, kun: toiminnot alkavat, kun koodi kutsuu niitä varten luotua viestiä.

• Vaikutusalue: toiminnot suoritetaan aina kutsuvan käyttäjän kontekstissa.

• Tausta-ajo: toiminnot ovat aina reaaliaikaista työnkulkuja.

Toimenpiteillä on myös jotain, jota ei ole työnkulun prosesseissa – syöttö- ja tulosargumentit. Lisätietoja: Prosessin argumenttien määrittäminen

Luo toiminto

Tärkeä

Jos luot toiminnon sisällytettäväksi ratkaisuun, joka jaetaan, luo se ratkaisun yhteydessä. Valitse Asetukset>Ratkaisut ja etsi ei-hallittu ratkaisu, jonka osaksi tämä toiminto tulee. Valikkorivillä valitse uusi>prosessi. Tämä varmistaa, että mukautuksen etuliite liittyen toiminnon nimen on yhdenmukainen muiden komponenttien kanssa. Kun luot toiminnon, et voi muuttaa etuliitettä.

Kuten työnkulkuprosessitkin, toiminnoilla on seuraavat ominaisuudet Luo prosessi -valintaikkunassa.

Prosessin nimi
Kun prosessille on annettu nimi, yksilöivä nimi muodostetaan poistamalla nimestä kaikki välilyönnit ja erikoismerkit.

Luokka
Tämä ominaisuus kertoo, että kyseessä on toimintoprosessi. Tätä ei voi muuttaa prosessin tallentamisen jälkeen.

Entiteetti
Toimintojen prosessien avulla voit valita entiteetin luodaksesi asiayhteyden työnkululle samoin kuin muun tyyppisiä prosesseja, mutta sinulla on myös mahdollisuus valita ei mitään (yleinen). Käytä tätä, jos toiminta ei edellytä tietyn entiteetin asiayhteydettä. Tätä ei voi muuttaa prosessin tallentamisen jälkeen.

Tyyppi
Tämän ominaisuuden avulla voit valita rakennatko uuden toimenpiteen luomisen vai olemassa olevasta mallista aloittamisen.

Muokkaa toimintoa

Prosessit tulee poistaa käytöstä ennen kuin niitä voi muokata.

Voit muokata toimintoa, joka on luotu osana hallitsematonta ratkaisua tai sisällytetty ratkaisuun, joka on asennettu organisaatioosi. Jos ratkaisu on hallittu ratkaisu, et ehkä voi muokata sitä. Ratkaisun julkaisijalla on mahdollisuus muokata hallittuja ominaisuuksia siten, että hallittuun ratkaisuun asennettua toimintoa ei voi muokata.

Kun toiminto on tallennettu yksilöllinen nimi luodaan perustuen prosessin nimeen. Tässä yksilöllisessä nimessä on lisätty ratkaisun julkaisijasta mukautuksen etuliite. Tämä on viesti, jota kehittäjä käyttää niiden koodissa.

Kun muokkaat toimintoa, sinulla on seuraavat vaihtoehdot:

Prosessin nimi
Kun prosessi on luotu ja yksilöllinen nimi on luotu prosessin nimestä, voit muokata prosessin nimeä. Haluat ehkä käyttää nimeämiskäytäntöä, jotta on helpompi löytää tiettyjä prosesseja.

Yksilöivä nimi
Kun toiminto on tallennettu yksilöllinen nimi luodaan perustuen prosessin nimeen. Tähän yksilölliseen nimeen on lisätty ratkaisun julkaisijasta mukautuksen etuliite. Tämä on viesti, jota kehittäjä käyttää niiden koodissa. Älä muuta tätä yksilöllistä nimeä, jos prosessi on aktivoitu ja koodi on paikallaan odottamassa kutsua toimintoa, joka käyttää tätä nimeä.

Tärkeä

Kun toiminto on aktivoitu ja koodi on kirjoitettu käyttämään yksilöllistä nimeä, yksilöllistä nimeä ei saa muuttaa muuttamatta koodia, joka viittaa siihen.

Ota käyttöön palautus
Yleensä prosessit, jotka tukevat tapahtumia "kumoavat" (tai peruuttavat) koko toiminnan, jos mikä tahansa osa epäonnistuu. On joitakin poikkeuksia. Jotkin toimintojenkehittäjät voivat tehdä koodissa, jonka toiminta on käynnistänyt, ei ehkä tue tapahtumia. Esimerkiksi jos koodi suorittaa toimia muissa järjestelmissä, jotka ovat tapahtuman vaikutusalueen ulkopuolella. Niitä ei voi peruuttaa sovelluksessa suoritettavalla toiminnolla. Osa ympäristön viesteistä ei tue tapahtumia. Mutta kaikki, mitä voit tehdä vain toiminnon käyttöliittymällä, tukee tapahtumia. Kaikki toiminnot, jotka kuuluvat reaaliaikaiseen työnkulkuun otetaan huomioon tapahtumassa, mutta toimintojen kanssa on vaihtoehto kieltäytyä tästä.

Konsultoi kehittäjää, joka käyttää tätä viestiä määrittääkseen, onko sen oltava tapahtumassa vai ei. Yleisesti ottaen toimenpiteen tulisi olla tapahtumassa, jos Liiketoimintaprosessin suorittamissa toiminnoissa ei ole järkeä, paitsi jos ne on suoritettu. Klassinen esimerkki on varojen siirtäminen kahden pankkitilin välillä. Jos talletat varoja toiselta tililtä, sinun täytyy ottaa ne toiselta. Jos jompikumpi epäonnistuu, molemmat epäonnistuvat.

Muistiinpano

Palauttamista ei voi ottaa käyttöön, jos mukautettu toiminto käynnistetään suoraan työnkulusta. Palauttamisen voi ottaa käyttöön, jos toiminto on Dynamics 365 Customer Engagement (on-premises):n verkkopalveluviestin käynnistämä.

Aktivoi muodossa
Kuten kaikki prosessit, voit aktivoida prosessin mallina ja käyttää sitä kehittyneenä lähtökohtana prosesseissa, jotka vastaavat samanlaista mallia.

Määritä prosessin argumentit
Tällä alueella voit määrittää mitkä tahansa tiedot, joita toiminto odottaa aloitettavaksi ja mitä tietoja jätetään toiminnosta pois. Lisätietoja: Prosessin argumenttien määrittäminen

Lisää vaiheet, ehdot ja toiminnot
Kuten muut prosessit, määrität suoritettavat toiminnot ja suoritusajan. Lisätietoja: Vaiheiden, ehtojen ja toimintojen lisääminen

Määritä prosessin argumentit

Kun kehittäjä käyttää viestiä, ne voivat alkaa tiedoilla, jotka ne voivat siirtää viestiin. Voit luoda uuden palvelupyyntötietueen, kun sinulla on palvelupyynnön otsikko-arvo, joka välitetään syöteargumenttina.

Kun viesti on valmis, kehittäjän täytyy ehkä välittää tietoja, joita on muutettu tai jotka toinen viesti on luonut toiseen toimintoon niiden koodissa. Nämä tiedot ovat tulosargumentti.

Sekä syöte- että tulosargumenteilla on oltava nimi, tyyppi, ja joitakin tietoja siitä, onko argumentti on aina pakollinen. Voit myös antaa kuvauksen.

Viestin nimi ja tiedot prosessin argumenteista edustavat viestin "allekirjoitusta". Kun toiminto on aktivoitu ja sitä käytetään koodissa, allekirjoitus ei saa muuttaa. Tämän allekirjoituksen muuttaminen aiheuttaa minkä tahansa koodia käyttävän viestin epäonnistumisen. Ainoa poikkeus voi muuttaa jonkin parametreistä niin, että sitä ei aina tarvita.

Argumenttien järjestystä voi muuttaa lajittelemalla tai siirtämällä niitä ylös- tai alaspäin, koska argumentit on merkitty nimen, ei järjestyksen mukaan. Lisäksi, kuvauksen muuttaminen ei riko koodia, joka käyttää viestiä.

Toimintaprosessin argumenttityypit

Seuraavassa taulukossa kuvataan toimintaprosessin argumenttityyppejä.

Tyyppi	Kuvaus
Boolean	A true tai false -arvo.
DateTime	Arvo, joka tallentaa päivämäärä-ja aikatiedot.
Desimaali	Numeroarvo, jossa desimaalitarkkuus. Käytetään, kun tarkkuus on erittäin tärkeää.
Entiteetti	Määritetyn entiteetin tietue. Kun valitset Entity, avattava valikko on käytössä ja voit valita entiteetin tyypin.
EntityCollection	Entiteetin tietuekokoelma.
EntityReference	Objekti, joka sisältää entiteettitietueen nimen, tunnuksen ja tyypin, joka määrittää sen yksiselitteisesti. Kun valitset EntityReference, avattava valikko on käytössä ja voit valita entiteetin tyypin.
Liukuluku	Numeroarvo, jossa desimaalitarkkuus. Käytetään, kun tiedot tulevat mittauksesta, joka ei ole täysin tarkka.
Integer	Kokonaisluku.
Raha	Arvo, joka tallentaa tietoja rahamäärästä.
Valintaluettelo	Arvo, joka vastaa vaihtoehtoa OptionSet-määritteelle.
String	Tekstiarvo.

Muistiinpano

EntityCollection -argumenttiarvoja ei voi määrittää käyttöliittymässä, joka on ehdoille tai toimille. Ne toimitetaan käyttöön mukautetun koodin kehittäjien toimesta. Lisätietoja: Omien toimintojen luominen

Lisää vaiheet ja osavaiheet

Toiminnot ovat prosessi, joka on hyvin samankaltainen kuin reaaliaikaiset työnkulut. Kaikki vaiheet, joita voidaan käyttää reaaliaikaisissa työnkuluissa voidaan käyttää toimintoina. Lisätietoja vaiheista, joita voidaan käyttää sekä reaaliaikaisissa työnkuluissa että toiminnoissa, katso Työnkulun vaiheet ja osavaiheet.

Tosiaikaisissa työnkuluissa käytettävien vaiheiden lisäksi, toiminnoilla on myös Määritä arvo -vaihe. Niitä voidaan käyttää toiminnoissa vain tuotoksen argumenttien määritykseen. Lomakeavustajan avulla voit määrittää tuotoksen argumentit tiettyihin arvoihin tai todennäköisempää, arvoihin tietueesta, jossa toimenpide suoritetaan, tähän tietueeseen liittyvistä tietueista monta yhteen-suhteen kanssa, aiemmassa vaiheessa luodusta tietueesta tai arvoihin, jotka ovat osa itse prosessia.

Katso myös

Toiminnot
Mukautetun toiminnon käynnistäminen työnkulusta
Reaaliaikainen seuranta työnkuluille ja toiminnoille
Työnkulkuprosessit
Liiketoimintaprosessien yleiskatsaus
Työnkulkuprosessien valvonta ja hallinta
Luo omat toiminnot