Crear una acció de procés personalitzada

S'utilitzen accions de procés personalitzades quan es vol automatitzar una sèrie d'ordres en el sistema. Les accions de procés personalitzades amplien el vocabulari disponible per a desenvolupadors per expressar els processos de negoci. Les accions de procés personalitzades utilitzen verbs bàsics proporcionats pel sistema, com Crea, Actualitza, Suprimeix i Assigna, per crear verbs més expressius, com ara Aprova, Escala, Encamina o Planifica. Si canvia la definició d'un procés de negoci, algú que no és un desenvolupador pot editar l'acció de procés personalitzada, així no cal canviar el codi.

Crear una acció de procés personalitzada

Com els processos de flux de treball, les accions de procés personalitzades 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.

• Taula

  Amb els processos d'accions, podeu seleccionar una taula per proporcionar context 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 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.

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

• Comença el: 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.

• Executa en segon terme: les accions 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: arguments d'entrada i sortida.

Editar una acció de procés personalitzada

Cal desactivar les accions de procés personalitzades abans de poder editar-les.

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 ú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ó de procés personalitzada 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ó de procés 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 Power Apps.

• 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.

• Definir 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 i passos

  Com altres processos, especifiqueu quines accions dur a terme i quan fer-ho. Per a més informació: Afegir fases i passos

Definir arguments del procés

Quan els desenvolupador utilitzen missatges, poden començar amb algunes dades que poden 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ó de procés personalitzada 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ó.

Afegir fases i passos

Les accions de procés personalitzades 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, vegeu 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 usuarisi 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

Invocar accions de procés personalitzades des d'un flux de treball