Configurar acciones

 

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

Puede habilitar una acción personalizada desde un flujo de trabajo o un diálogo, sin escribir código.Más información:Invocar una acción personalizada desde un flujo de trabajo o un diálogo.

También puede crear una acción para que un desarrollador pueda usarla en código o puede necesitar editar una acción que estaba definida anteriormente. Como procesos de flujo de trabajo, tenga en cuenta lo siguiente:

• ¿Qué acciones deben realizarse?

• ¿En qué condiciones deben llevarse a cabo las acciones?

A diferencia de los procesos de flujo de trabajo, no necesita establecer las opciones siguientes:

• Iniciar al: las acciones se inician si el código llama al mensaje generado para ellas.

• Ámbito: las acciones se ejecutan siempre en el contexto del usuario que llama.

• Ejecutar en segundo plano: las acciones son siempre flujos de trabajo en tiempo real.

Una acción también tiene algo que no tienen los procesos de flujo de trabajo: argumentos de entrada y salida.Más información:Definir argumentos de procesos

En este tema

Crear acciones

Editar una acción

Crear acciones

Importante

Si está creando una acción que se incluirá como parte de una solución que se va a distribuir, créela en el contexto de la solución. Vaya a Configuración > Soluciones y busque la solución no administrada de la que formará parte esta acción. A continuación, en la barra de menú, seleccione Nuevo > Proceso. De este modo, se asegurará de que el prefijo de personalización asociado con el nombre de la acción será coherente con otros componentes de la solución. Después de crear la acción, no puede cambiar el prefijo.

Como los procesos de flujo de trabajo, las acciones tienen las siguientes propiedades en el cuadro de diálogo Crear proceso.

• Nombre del proceso
  Tras escribir el nombre del proceso, se creará un nombre único para él quitando espacios o caracteres especiales del nombre del proceso.

• Categoría
  Esta propiedad establece que se trata de un proceso de acción. No se puede cambiar una vez guardado el proceso.

• Entidad
  Con los procesos de acciones, puede seleccionar una entidad para proporcionar contexto para el flujo de trabajo igual que con otros tipos de procesos, pero también tiene la opción de elegir Ninguno (global). Use esta opción si la acción no requiere el contexto de una entidad específica. No se puede cambiar una vez guardado el proceso.

• Tipo
  Puede usar esta propiedad para elegir entre crear una nueva acción desde cero o partir de una plantilla existente.

Editar una acción

Debe desactivar los procesos para poder modificarlas.

Puede editar una acción que se creó como parte de una solución no administrada o se incluyó en una solución instalada en la organización. Si la solución es una solución administrada, es posible que no pueda editarla. El editor de soluciones puede modificar las propiedades administradas para que la acción instalada con una solución administrada no se pueda editar.

Cuando se guarda una acción, se genera un nombre único basándose en el nombre del proceso. Este nombre único tiene el prefijo de personalización agregado desde el editor de soluciones. Este es el nombre del mensaje que un desarrollador usará en el código.

Importante

Una vez activada la acción y el código está escrito para usar un nombre único, el nombre único no se debe cambiar sin cambiar también el código que le hace referencia.

Al editar una acción tiene las siguientes opciones:

• Nombre del proceso
  Una vez creado el proceso y generado el nombre único a partir del nombre del proceso, puede modificar el nombre del proceso. Es posible que quiera implementar una convención de nomenclatura para que sea más fácil encontrar procesos específicos.

• Nombre único
  Cuando se guarda una acción, se genera un nombre único basándose en el nombre del proceso. Este nombre único tiene el prefijo de personalización de editor de soluciones agregado. Este es el nombre del mensaje que un desarrollador usará en el código. No cambie este nombre único si el proceso se ha activado y el código existe en espera de llamar a la acción con este nombre.

• Habilitar reversión
  Generalmente, los procesos que admiten transacciones "desharán" (o revertirán) la operación completa si alguna parte falla. Hay algunas excepciones a esto. Algunas acciones que los desarrolladores pueden hacer en el código iniciado por la acción podrían no ser compatibles con las transacciones. Por ejemplo, si el código realiza acciones en otros sistemas que estén fuera del ámbito de la transacción. Estas pueden revertirse ejecutando la acción en Microsoft Dynamics 365. Algunos mensajes de la plataforma Dynamics 365 no admiten transacciones. No obstante, todo lo que puede realizar con la interfaz de usuario de la acción admitirá transacciones. Todas las acciones que forman parte de un flujo de trabajo en tiempo real se consideran en la transacción, pero con las acciones tiene la opción de descartar esto.

  Debería consultar con el programador que usará este mensaje para determinar si debe estar en la transacción o no. Normalmente, una acción debe estar en la transacción si las acciones realizadas por el proceso de negocio no tienen sentido, a menos que todas se completen correctamente. El ejemplo clásico consiste en transferir fondos entre dos cuentas bancarias. Si se retiran fondos de una cuenta debe depositarlos en la otra. Si una acción falla, deben fallar ambas.

  Nota

  No se admite habilitar la opción de reversión si una acción personalizada se invoca directamente desde un flujo de trabajo o un diálogo. Puede habilitar la reversión si una acción se desencadena por un mensaje de servicios web de Dynamics 365.

• Activar como
  Como todos los procesos, puede activar el proceso como una plantilla y usarlo como punto de partida avanzado para los procesos que sigan un modelo similar.

• Definir argumentos de procesos
  En esta área, especificará los datos que la acción prevé iniciar y los datos que se omitirán de la acción.Más información:Definir argumentos de procesos

• Agregar fases, condiciones y acciones
  Como otros procesos, especifique las acciones que se van a realizar y cuándo.Más información:Agregar fases y pasos

Definir argumentos de procesos

Cuando un desarrollador usa un mensaje, puede empezar con algunos datos que se pueden transferir al mensaje y usar. Por ejemplo, para crear un nuevo registro de caso, puede tener el valor de título de caso que se transferirá como un argumento. Este sería un argumento de entrada.

Cuando finalice el mensaje, el programador puede necesitar pasar algunos datos que han cambiado o se han generado con el mensaje a otra operación en su código. Estos deben definirse como argumento de salida.

Los argumentos de entrada y de salida deben tener un nombre, un tipo y determinada información sobre si el argumento siempre es obligatorio. También puede proporcionar una descripción.

El nombre del mensaje y la información de todos los argumentos de proceso representan la "firma" del mensaje. Después de activar una acción y de empezarla a usar en código, la firma no debe cambiar. Cambiar este firma produciría fallos del código que usa el mensaje. La única excepción a esto sería cambiar uno de los parámetros para que no sea siempre obligatorio.

Cambiar el orden de los argumentos clasificándolos o moviéndolos arriba o abajo no causaría ninguna diferencia porque los argumentos se identifican por el nombre, no por el orden. Cambiar la descripción no interrumpirá el código que utiliza el mensaje.

Tipos de argumento de proceso de acción

La siguiente tabla describe los tipos de argumento de proceso de acción.

Tipo	Descripción
Boolean	Un valor true o false.
DateTime	Un valor que almacena la información de fecha y hora.
Decimal	Un valor numérico con precisión decimal. Se usa cuando la precisión es extremadamente importante.
Entity	Un registro de Dynamics 365 para la entidad especificada. Al seleccionar Entity, la lista desplegable se activa y permite seleccionar el tipo de entidad.
EntityCollection	Una recopilación de registros de la entidad.
EntityReference	Un objeto que contiene el nombre, el identificador y el tipo de registro de una entidad que lo identifica de forma única. Al seleccionar EntityReference, la lista desplegable se activa y permite seleccionar el tipo de entidad.
Float	Un valor numérico con precisión decimal. Se utiliza cuando los datos vienen de una medida que no es absolutamente exacta.
Integer	Un número entero.
Money	Un valor que almacena los datos sobre una cantidad de dinero.
Picklist	Un valor que representa una opción de un atributo OptionSet.
String	Un valor de texto.

Nota

Los valores de argumento EntityCollection no se pueden definir en la interfaz de usuario para las condiciones o acciones. Estos se proporcionan para que los usen los programadores en código personalizado.Más información:Cree acciones propias

Agregar fases y pasos

Las acciones son un tipo de proceso muy similar a los flujos de trabajo en tiempo real. Todos los pasos que se pueden usar en flujos de trabajo en tiempo real se pueden usar en acciones. Para obtener más información acerca de los pasos que se pueden usar en los flujos de trabajo en tiempo real y las acciones, consulte Fases y pasos del flujo de trabajo.

Además de los pasos que se pueden usar para los flujos de trabajo en tiempo real, acciones también tienen el paso Asignar valor, que es similar al que se usa para definir variables o argumentos de entrada en diálogos. En las acciones, solo se pueden usar para definir argumentos de salida. Puede usar el asistente de formulario para establecer argumentos de salida en valores específicos o, más probablemente, en valores del registro en el que se ejecuta la acción, registros relacionados con dicho registro con relaciones de varios a uno, registros creados en un paso anterior o valores que forman parte del propio proceso.

Ver también

Acciones
Invocar una acción personalizada desde un flujo de trabajo o un diálogo
Controlar los flujos de trabajo y acciones en tiempo real
Crear y editar procesos
Procesos del flujo de trabajo
Diálogos
Flujos de proceso de negocio
Supervisar y administrar procesos
Crear acciones propias

© 2016 Microsoft Corporation. Todos los derechos reservados. Copyright