Configurar accións de proceso personalizadas desde un fluxo de traballo

Pode activar unha acción de proceso personalizada desde un fluxo de traballo en tempo real sen escribir código. Máis información: Activar accións personalizadas desde un fluxo de traballo

Tamén pode crear unha acción de proceso personalizada para que un programador poida utilizala en código ou pode que teña que editar unha acción definida previamente. Ao igual que cos procesos de fluxo de traballo en tempo real, considere o seguinte:

• Que debe facer a acción?

• En que condicións se debe efectuar a acción?

A diferenza dos procesos de fluxo de traballo en tempo real, non é necesario definir as seguintes opcións:

• Iniciar cando: as accións de proceso personalizadas inícianse cando o código chama á mensaxe xerada para eles.

• Ámbito: as accións de proceso personalizadas sempre se executan no contexto do usuario que chama.

• Executar en segundo plano: as accións de proceso personalizadas son sempre fluxos de traballo en tempo real.

As accións de proceso personalizadas tamén teñen algo que os procesos de fluxo de traballo en tempo real non teñen: argumentos de entrada e saída. Máis información: Definir os argumentos do proceso

Crear unha acción de proceso personalizada

Importante

Se está a crear unha acción que se incluirá como parte dunha solución que se distribuirá, créea no contexto da solución. Ir a Configuración > Solucións e localice a solución non xestionada da que formará parte esta acción. A seguir, na barra de menú, seleccione Novo > Proceso. Isto garantirá que o prefixo de personalización asociado co nome da acción sexa coherente con outros compoñentes da solución. Unha vez creada a acción, non se pode modificar o prefixo.

Nota

Se pretende escribir un complemento para implementar a súa lóxica para unha acción de proceso personalizada en vez de usar o deseñador de fluxo de traballo, debería usar a API personalizada. Máis información: Comparar a acción de proceso personalizada e a API personalizada

Ao igual que cos procesos de fluxo de traballo en tempo real, as accións teñen as seguintes propiedades na caixa de diálogo Crear proceso:

• Nome do proceso

  Despois de introducir un nome para o proceso, crearase un nome único para el ao eliminar os espazos ou caracteres especiais do nome do proceso.

• Categoría

  Esta propiedade establece que este é un proceso de acción. Non se pode modificar isto unha vez gardado o proceso.

• Entidade

  Con procesos de acción, pode seleccionar unha táboa para fornecer contexto para o fluxo de traballo en tempo real como outros tipos de procesos, mais tamén ten a opción de escoller Ningún (global). Utilice isto se a súa acción non require o contexto dunha táboa específica. Non se pode modificar isto unha vez gardado o proceso.

• Tipo

  Use esta propiedade para escoller se desexa crear unha nova acción de proceso personalizada desde cero ou para comezar a partir dun modelo xa existente.

Editar unha acción

Debe desactivar procesos para poder editalos.

Pode editar unha acción de proceso personalizada creada como parte dunha solución non xestionada ou incluída nunha solución instalada na súa organización. Se a solución é unha solución xestionada, é posible que non poida editala. O publicador de solucións ten a opción de editar as propiedades xestionadas para que a acción instalada cunha solución xestionada non se poida editar.

Ao gardar unha acción, xérase un nome único baseado no nome do proceso. A este nome único se lle engade o prefixo de personalización desde o publicador de solucións. Este é o nome da mensaxe que os programadores utilizarán no seu código.

Ao editar unha acción, dispón das seguintes opcións:

• Nome do proceso

  Unha vez creado o proceso e xerado o nome único a partir do nome do proceso, pode editar o nome do proceso. É posible que desexe aplicar unha convención de nomenclatura para facilitar a localización de procesos específicos.

• Nome único

  Ao gardar unha acción de proceso personalizada, xérase un nome único baseado no nome do proceso. A este nome único se lle engade o prefixo de personalización desde o publicador de solucións. Este é o nome da mensaxe que os programadores utilizarán no seu código. Non modifique este nome único se o proceso se activou e o código está listo esperando para chamar á acción utilizando este nome.

  Importante

  Unha vez activada a acción e escrito o código para utilizar un nome único, o nome único non se debe modificar sen modificar tamén o código que fai referencia a el.

• Activar reversión

  Polo xeral, os procesos que admiten transaccións “desfarán“ (ou restaurarán) a operación completa se falla calquera parte deles. Hai excepcións a isto. É posible que as accións executadas no código por un programador iniciadas pola acción de proceso personalizada non admitan as transaccións. Un exemplo sería cando o código executa accións noutros sistemas que van máis alá do ámbito da transacción. Non se poden restaurar mediante a acción que se está executando nunha aplicación. Algunhas mensaxes da plataforma non admiten transaccións. Pero todo o que pode facer coa interface de usuario da acción admite transaccións. Todas as accións que son parte dun fluxo de traballo en tempo real considéranse nunha transacción, pero coas accións ten a opción de anular isto.

  Debería consultar co programador que utilizará esta mensaxe para determinar se debe estar nunha transacción ou non. Polo xeral, unha acción debería estar nunha transacción se as accións efectuadas polo proceso de negocio non teñen sentido a menos que todas se completen correctamente. Exemplo clásico de transferencia de fundos entre dúas contas bancarias. Se retira fondos dunha conta, deberá depositalos na outra. En caso de que unha falle, deberán fallar as dúas.

  Nota

  • Non pode activar a reversión se unha acción de proceso personalizada se invoca directamente desde un fluxo de traballo. Pode activar a reversión se unha acción de proceso personalizada é desencadeada por unha mensaxe de servizos web de Power Apps.
  • Se a acción definida non cambia os datos, senón que só recupera datos, hai certas situacións nas que se pode mellorar o rendemento desactivando Activar retroceso.

• Activar como

  Ao igual que con todos os procesos, pode activar o proceso como modelo e utilizalo como punto de inicio avanzado dos procesos que siguen un padrón similar.

• Definir os argumentos do proceso

  Nesta área, especificará os datos que a acción espera iniciar e os datos que se pasarán fóra da acción. Máis información: Definir os argumentos do proceso

• Engadir fases, condicións e accións

  Ao igual que con outros procesos, especifique as accións que debe realizar e cando realizalas. Máis información: Engadir etapas, condicións e accións

Definir os argumentos do proceso

Cando un programador utiliza unha mensaxe, pode comezar con algúns datos que poden pasar á mensaxe. Por exemplo, para crear unha nova fila de caso, pode ter o valor do título do caso que se pasará como o argumento de entrada.

Cando finalice a mensaxe, é posible que o programador teña que pasar algúns datos modificados ou xerados pola mensaxe a outra operación no seu código. Estes datos son o argumento de salida.

Os argumentos de entrada e saída deben ter un nome, un tipo e algunha información acerca de se o argumento é sempre necesario. Tamén pode fornecer unha descrición.

O nome da mensaxe e a información acerca de todos os argumentos do proceso representan a sinatura da mensaxe. Unha vez desactivada unha acción e utilizada no código, non se debe modificar a sinatura. Se esta sinatura cambia, provocará que falle o código que utiliza a mensaxe. A única excepción a isto pode ser modificar un dos parámetros para que non sexa sempre necesario.

Pode modificar a orde dos argumentos ordenándoos ou movéndoos arriba ou abaixo porque os argumentos identifícanse polo nome, non a orde. Modificar a descrición tampouco danará o código que utiliza a mensaxe.

Tipos de argumento de proceso da acción

Na seguinte táboa descríbense os tipos de argumento de procesos de acción.

Tipo	Descripción
Booleano	Valor true ou false.
Data e hora	Valor que almacena a información de data e hora.
Decimal	Valor numérico con precisión decimal. Utilizado cando a precisión é extremadamente importante.
Táboa	Unha fila para a táboa especificada. Cando se selecciona Táboa, a lista despregable está activada e permítelle seleccionar o tipo de táboa.
entityCollection	Unha recompilación de filas de táboas.
entityReference	Obxecto que contén o nome, o ID e o tipo dunha fila de táboas que a identifica exclusivamente. Cando se selecciona tableReference, a lista despregable está activada e permítelle seleccionar o tipo de táboa.
Float	Valor numérico con precisión decimal. Utilizado cando se reciben datos dunha medición que non é totalmente precisa.
Enteiro	Número enteiro.
Diñeiro	Valor que almacena os datos dunha cantidade de diñeiro.
Lista despregable	Un valor que representa unha opción para un atributo OptionSet.
String	Valor de texto.

Nota

Os valores do argumento entityCollection non se poden definir na interface de usuario para condicións ou accións. Estes fornécense para que os utilicen os programadores no código personalizado. Máis información: Crear as súas propias mensaxes

Engadir fases e pasos

As accións son un tipo de proceso moi similar aos fluxos de traballo en tempo real. Todos os pasos que se poden utilizar nos fluxos de traballo en tempo real poden utilizarse nas accións. Para obter información sobre os pasos que se poden utilizar para os fluxos de traballo en tempo real e accións, vaia a Fases e pasos do fluxo de traballo.

Ademais dos pasos que se poden usar para os fluxos de traballo en tempo real, as accións tamén teñen o paso Atribuír valor. Nas accións, só se poden usar para definir argumentos de saída. Pode utilizar o asistente de formularios para definir os argumentos de saída en valores específicos ou, opción máis probable, en valores da fila na que se está executando, filas relacionadas con esa fila cunha relación de varios a un, filas creadas nun paso anterior ou valores que forman parte do propio proceso.

Propiedades xestionadas

As accións de proceso personalizadas teñen dúas propiedades xestionadas relevantes

É personalizable

A propiedade xestionada É personalizable controla se alguén que instala un solución administrada que conteña a acción de proceso personalizada pode editala ou eliminala. Se desexa que a acción de proceso personalizada se edite ou elimine cando se inclúa nunha solución administrada, debería establecer esta propiedade como verdadeira.

É paso de procesamento personalizado permitido para outros editores

A propiedade xestionada É paso de procesamento personalizado permitido para outros editores controla se os programadores de complementos de terceiros poden rexistrar os pasos do complemento na mensaxe creada pola acción de proceso personalizada. Cando isto sexa certo, os complementos rexistrados por calquera persoa nesta mensaxe executaranse e poderán modificar o comportamento da acción de proceso personalizada. Cando sexa falso, só se executarán os pasos dos complementos rexistrados dentro dunha solución do mesmo publicador de solucións.

Pasos seguintes

Usar accións
Invocar accións personalizadas desde un fluxo de traballo
Monitorar fluxos de traballo en tempo real e accións

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).