Configurar accions de procés personalitzades des d'un flux de treball
Podeu habilitar una acció de procés personalitzada des d'un flux de treball en temps real sense escriure codi. Per a més informació: Invocar accions personalitzades des d’un flux de treball
També podeu crear una acció de procés personalitzada 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 en temps real, tingueu 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 en temps real, no cal definir les següents opcions:
Comença el: les accions de procés personalitzada s'inicien quan el codi crida el missatge generat per a elles.
Àmbit: les accions de procés personalitzada sempre s'executen en el context de l'usuari que truca.
Executa en segon terme: les accions de procés personalitzada són sempre fluxos de treball en temps real.
Les accions de procés personalitzada també tenen una cosa que no tenen els processos de flux de treball en temps real: arguments d'entrada i sortida. Per a més informació: Definir arguments de procés
Crear una acció de procés personalitzada
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 que formarà aquesta acció. A continuació, a la barra de menús, seleccioneu Crea > Procés. 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.
Nota
Si teniu intenció d'escriure un complement per implementar la lògica per a una acció de procés personalitzada en comptes d'utilitzar el dissenyador de fluxos de treball, haureu d'utilitzar l'API personalitzada. Més informació: Comparar l'acció de procés personalitzada i l'API personalitzada
Com els processos de flux de treball en temps real, les accions tenen les següents propietats 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 taula per proporcionar context al flux de treball en temps real 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 taula concreta. No podeu canviar aquesta configuració després de desar el procés.
Tipus
Utilitzeu aquesta propietat per decidir si crear una nova acció de procés personalitzada 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ó de procés personalitzada 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 exclusiu
Quan es guarda una acció de procés personalitzada, 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 executades en codi per un desenvolupador i iniciades per l'acció de procés personalitzada podrien no ser compatibles amb les transaccions. Un exemple seria 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'usuari 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ó de procés personalitzada s'invoca directament des de dins d'un flux de treball. Podeu habilitar la reversió si un missatge de serveis web del Power Apps activa una acció de procés personalitzada.
- Si l'acció definida no canvia dades, sinó que només en recupera, hi ha determinades situacions en les quals es pot millorar el rendiment inhabilitant Habilita la reversió.
Activa-ho 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.
Defineix 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ó. Per a més informació: Definir arguments de procés
Afegir fases, condicions i accions
Com altres processos, especifiqueu quines accions dur a terme i quan fer-ho. Per a 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 una fila de cas nova, 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 | Un valor true o false. |
| 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. |
| Taula | Una fila de la taula especificada. Quan seleccioneu Taula, la llista desplegable s'habilita i permet seleccionar el tipus de taula. |
| entityCollection | Una col·lecció de files de taula. |
| entityReference | Un objecte que conté el nom, identificació i tipus d'una fila de taula que l'identifica de manera exclusiva. Quan seleccioneu tableReference, la llista desplegable s'habilita i permet seleccionar el tipus de taula. |
| Float | 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 de l'argument 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ó: Crear els vostres propis missatges
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 per a fluxos de treball en temps real i accions, aneu a Passos i fases del flux de treball.
A més dels passos que es poden utilitzar per a fluxos de treball en temps real, les accions també tenen el pas Assigna un 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 la fila contra els quals s'està executant l'acció, files relacionades amb aquesta fila amb una relació de diverses a una, files creades en un pas anterior o valors que formen part del procés mateix.
Propietats administrades
Les accions de procés personalitzades tenen dues propietats administrades rellevants
És personalitzable
La propietat administrada Is Customizable controla si un usuari que instal·la una solució administrada que conté l'acció de procés personalitzada la pot editar o suprimir. Si voleu que l'acció de procés personalitzada s'editi o se suprimeixi quan s'inclogui en una solució administrada, heu d'establir aquesta propietat en cert.
Està permès el pas de processament personalitzat per a altres editors
La propietat administrada És un pas de processament personalitzat per a altres editors controla si els desenvolupadors de complements de tercers poden registrar els passos del complement al missatge creat per l'acció de procés personalitzada. Quan això és cert, els complements registrats per qualsevol persona en aquest missatge s'executaran i poden modificar el comportament de l'acció de procés personalitzada. Quan sigui fals, només s'executaran els passos de complements registrats en una solució des del mateix editor de solucions.
Passos següents
Utilitzar accions
Invocar accions personalitzades des d'un flux de treball
Control dels fluxos de treball i accions en temps real