Crear ou editar accións personalizadas a partir dun fluxo de traballo

Este tema aplícase a Dynamics 365 Customer Engagement (on-premises). Para a versión de Power Apps deste tema, consulte: Configura accións personalizadas desde un fluxo de traballo

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

Tamén pode crear unha acción 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, 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, non é necesario definir as seguintes opcións:

• Comezar cando: as accións comezan cando o código chama á mensaxe xerada para elas.

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

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

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

Crear unha acción

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. Vaia a Configuración>Solucións e localice a solución non xestionada da que formará parte esta acción. A continuación, na barra de menús, 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.

Do mesmo xeito que os procesos de fluxo de traballo, 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
Cos procesos de accións, pode seleccionar unha entidade para proporcionar contexto ao fluxo de traballo do mesmo xeito que outros tipos de procesos, pero tamén tes a opción de escoller Ningún (global). Utilice isto se a súa acción non require o contexto dunha entidade 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 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 creada como parte dunha solución non xestionada ou incluído 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, 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 a recuperación
Polo xeral, os procesos que admiten transaccións “desfarán“ (ou restaurarán) a operación completa se falla calquera parte deles. Hai algunhas excepcións a isto. É posible que algunhas das accións que deben levar a cabo os programadores no código iniciadas pola acción non admitan as transaccións. Por exemplo, se 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 personalizada se invoca directamente desde un fluxo de traballo. Pode activar a reversión se se desencadea unha acción por unha mensaxe de servizos web de Dynamics 365 Customer Engagement (on-premises).

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: Define argumentos do proceso

Engadir etapas, 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: Engade 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 un novo rexistro de caso, pode ter o valor do título do caso que se pasará como 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	Un true ou false valor.
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.
Entidade	Un rexistro para a entidade especificada. Cando se selecciona Entidade, a lista despregable está activada e permítelle seleccionar o tipo de entidade.
EntityCollection	Colección de rexistros de entidade.
EntityReference	Obxecto que contén o nome, o id e o tipo de rexistro de entidade que a identifica exclusivamente. Cando se selecciona EntityReference, a lista despregable está activada e permítelle seleccionar o tipo de entidade.
Flotante	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 dos argumentos EntityCollection non se poden establecer 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: Crea as túas propias accións

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 tanto para fluxos de traballo como para accións en tempo real, consulte Fases e pasos do fluxo de traballo.

Ademais dos pasos que se poden usar para fluxos de traballo en tempo real, as accións tamén teñen a Asignar valor paso. 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 do rexistro no que se está executando, rexistros relacionados con ese rexistro cunha relación de varios a un, rexistros creados nun paso anterior ou valores que forman parte do propio proceso.

Consulte tamén

Accións
Invoca accións personalizadas desde un fluxo de traballo
Monitorización de fluxos de traballo e accións en tempo real
Procesos de fluxo de traballo
Visión xeral dos fluxos de procesos de negocio
Supervisar e xestionar os procesos de fluxo de traballo
Crea as túas propias accións