Crear o editar accions personalitzades d'un flux de treball

Aquest tema s'aplica al Dynamics 365 Customer Engagement (on-premises). Per a la versió del Power Apps d'aquest tema, vegeu: Configurar accions personalitzades des d'un flux de treball

Podeu habilitar una acció personalitzada d'un flux de treball sense escriure codi. Més informació: Invocar accions personalitzades des d'un flux de treball.

També podeu crear una acció perquè un desenvolupador pugui fer-la servir al codi o pot ser que hàgiu d'editar una acció prèviament definida. Com amb els processos de flux de treball, teniu en compte el següent:

• Què ha de fer l'acció?

• Sota quines condicions s'ha de realitzar l'acció?

A diferència dels processos de flux de treball, no cal definir les següents opcions:

• Comença quan: les accions s'inicien quan el codi crida el missatge generat per a elles.

• Àmbit: les accions sempre s'executen en el context de l'usuari que truca.

• Executar-se en segon pla: les accions sempre són fluxos de treball en temps real.

Les accions també tenen una cosa que no tenen els processos de flux de treball: arguments d'entrada i sortida. Més informació: Definir arguments de procés

Crear una acció

Important

Si esteu creant una acció que s'inclourà com a part d'una solució que es distribuirà, creeu-la en el context de la solució. Aneu a Solucions>de configuració i localitzeu la solució no administrada de la qual formarà part aquesta acció. A continuació, a la barra de menús, seleccioneu Procés> nou. Això garanteix que el prefix de personalització associat amb el nom de l'acció sigui coherent amb altres components de la solució. Després de crear l'acció, no es pot canviar el prefix.

Igual que els processos de flux de treball, les accions tenen les propietats següents al quadre de diàleg Crea un procés .

Nom del procés
Després d'introduir un nom per al procés, es crearà un nom únic; per fer-ho, se suprimiran els espais o caràcters especials del nom del procés.

Categoria
Aquesta propietat estableix que aquest és un procés d'acció. No podeu canviar aquesta configuració després de desar el procés.

Entitat
Amb els processos d'accions, podeu seleccionar una entitat per proporcionar context per al flux de treball igual que altres tipus de processos, però també teniu l'opció de triar Cap (global). Utilitzeu aquesta opció si l'acció no necessita el context d'una entitat concreta. No podeu canviar aquesta configuració després de desar el procés.

Tipus
Utilitzeu aquesta propietat per decidir si crear una nova acció des de zero o començar des d'una plantilla existent.

Editar una acció

Cal desactivar processos abans de poder editar-los.

Podeu editar una acció que es va crear com a part d'una solució no administrada o que es va incloure en una solució instal·lada a l'organització. Si la solució és una solució administrada, no podeu editar-la. L'editor de solucions té l'opció d'editar les propietats administrades per tal que no es pugui editar l'acció instal·lada amb una solució administrada.

Quan es guarda una acció, es genera un nom exclusiu basat en el nom del procés. Aquest nom exclusiu té el prefix de personalització afegit des de l'editor de solucions. Aquest és el nom del missatge que utilitzarà un desenvolupador en el seu codi.

Quan s'edita una acció teniu les opcions següents:

Nom del procés
Després que es creï el procés i es generi el nom exclusiu a partir del nom del procés, podeu editar el nom del procés. És possible que vulgueu aplicar una convenció de nomenclatura perquè sigui més fàcil localitzar determinats processos.

Nom únic
Quan es guarda una acció, es genera un nom exclusiu basat en el nom del procés. Aquest nom exclusiu té el prefix de personalització afegit des de l'editor de solucions. Aquest és el nom del missatge que utilitzarà un desenvolupador en el seu codi. No canvieu aquest nom exclusiu si s'ha activat el procés i el codi és al seu lloc esperant cridar l'acció utilitzant aquest nom.

Important

Un cop activada l'acció i escrit el codi per utilitzar un nom exclusiu, no s'ha de canviar el nom exclusiu sense canviar també el codi que hi fa referència.

Habilita la reversió
Generalment, els processos que donen suport a transaccions "desfaran" (o revertiran) tota l'operació si falla qualsevol part. Hi ha algunes excepcions. Algunes accions que els desenvolupadors podrien fer al codi iniciades per l'acció podrien no ser compatibles amb les transaccions. Per exemple, si el codi realitza accions en altres sistemes que van més enllà de l'àmbit de la transacció. Aquests no els pot revertir l'acció que s'executa en una aplicació. Alguns dels missatges de la plataforma no són compatibles amb les transaccions. Però tot el que podeu fer només amb la interfície d'usuarisi de l'acció serà compatible amb les transaccions. Totes les accions que formen part d'un flux de treball en temps real es consideren en transacció, però amb les accions teniu l'opció de desactivar això.

Heu de consultar amb el desenvolupador qui farà servir aquest missatge per determinar si ha de ser en transacció o no. Generalment, una acció ha de ser en transacció si les accions realitzades per processos de negoci no tenen sentit llevat que totes s'hagin completat amb èxit. L'exemple clàssic és transferir fons entre dos comptes bancaris. Si retireu fons d'un compte, heu de dipositar-los a l'altre. Si una de les dues accions falla, les dues han de fallar.

Nota

No podeu habilitar la reversió si una acció personalitzada s'invoca directament des de dins d'un flux de treball. Podeu habilitar la reversió si es desencadena una acció mitjançant un missatge dels serveis web del Dynamics 365 Customer Engagement (on-premises).

Activa com a
Com tots els processos, podeu activar el procés com a plantilla i utilitzar-lo com un punt de partida avançat per a processos que segueixen un patró similar.

Definiu els arguments del procés
En aquesta àrea, especificareu totes les dades que l'acció espera que comencin i quines dades es passaran fora de l'acció. Més informació: Definir arguments de procés

Afegir etapes, condicions i accions
Com altres processos, especifiqueu quines accions dur a terme i quan fer-ho. Més informació: Afegir fases, condicions i accions

Definir arguments del procés

Quan un desenvolupador utilitza un missatge, pot començar amb algunes dades que pot passar al missatge. Per exemple, per crear un registre de cas nou, podeu tenir el valor de títol de cas que es passarà com a argument d'entrada.

Quan el missatge s'acaba, el desenvolupador pot necessitar passar algunes dades que el missatge ha canviat o generat en una altra operació en el seu codi. Aquestes dades són l'argument de sortida.

Tant els arguments d'entrada com de sortida han de tenir un nom, un tipus i informació sobre si l'argument és sempre imprescindible. També podeu proporcionar una descripció.

El nom del missatge i la informació sobre tots els arguments del procés representen la "signatura" per al missatge. Després que una acció s'activi i s'utilitzi en el codi, la signatura no ha de canviar. Si es canvia aquesta signatura, es produirà un error en tots els codis que utilitzi el missatge. L'única excepció pot ser canviar un dels paràmetres de manera que no sempre sigui necessària.

Podeu canviar l'ordre dels arguments classificant-los o desplaçant-los amunt o avall, ja que els arguments s'identifiquen pel nom, no per l'ordre. A més, canviar la descripció no afectarà el codi que utilitza el missatge.

Tipus d'argument de procés d'acció

La taula següent descriu els tipus d'argument de procés d'acció.

Type	Descripció
Boolean	A true o false valor.
DateTime	Un valor que emmagatzema informació de data i hora.
Decimal	Un valor numèric amb precisió decimal. S'utilitza quan la precisió és molt important.
Entitat	Un registre de l'entitat especificada. Quan seleccioneu Entitat, la llista desplegable s'habilita i permet seleccionar el tipus d'entitat.
EntityCollection	Un recull de registres d'entitat.
EntityReference	Un objecte que conté el nom, identificació i tipus d'un registre d'entitat que l'identifica de manera exclusiva. Quan seleccioneu EntityReference, la llista desplegable s'habilita i permet seleccionar el tipus d'entitat.
Flotant	Un valor numèric amb precisió decimal. S'utilitza quan les dades provenen d'una mesura que no és absolutament precisa.
Integer	Un nombre enter.
Diners	Un valor que emmagatzema dades sobre una quantitat de diners.
Llista de selecció	Un valor que representa una opció per a un atribut OptionSet.
String	Un valor de text.

Nota

Els valors dels arguments EntityCollection no es poden definir a la interfície d'usuari per a condicions o accions. Es proporcionen per al seu ús per part de desenvolupadors de codi personalitzat. Més informació: Crea les teves pròpies accions

Afegir fases i passos

Les accions són un tipus de procés molt similar als fluxos de treball en temps real. Tots els passos que es poden utilitzar en fluxos de treball en temps real es poden utilitzar en accions. Per obtenir informació sobre els passos que es poden utilitzar tant per als fluxos de treball com per a les accions en temps real, vegeu Fases i passos del flux de treball.

A més dels passos que es poden utilitzar per als fluxos de treball en temps real, les accions també tenen el pas Assigna valor . A les accions, es poden utilitzar només per establir arguments de sortida. Podeu utilitzar l'auxiliar de formulari per definir arguments de sortida en valors específics o, més probablement, en valors de registre contra els quals s'està executant l'acció, registres relacionats amb aquest registre amb una relació de diversos a un, registres creats en un pas anterior o valors que formen part del procés mateix.

Vegeu també

Accions
Invocar accions personalitzades des d'un flux de treball
Monitorització de fluxos de treball i accions en temps real
Processos de flux de treball
Visió general dels fluxos del procés de negoci
Supervisar i gestionar els processos de flux de treball
Crea les teves pròpies accions