Escribir scripts para flujos de procesos de negocio

 

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

Con Microsoft Dynamics CRM 2015 y actualización de Microsoft Dynamics CRM Online 2015 hay un objeto del lado del cliente que puede usar para interactuar con flujos de proceso de negocio en sus scripts. El espacio de nombres de Xrm.Page.data se amplía para incluir métodos en Xrm.Page.data.process. El espacio de nombres de Xrm.Page.ui se amplía para incluir métodos en Xrm.Page.ui.process.

En este tema

Estructura de flujos de proceso de negocio

Acciones que se pueden automatizar

Eventos para flujos de proceso de negocio

Estructura de flujos de proceso de negocio

Los flujos de proceso de negocio estén formadas por una serie de fases, cada una con varios pasos. Sólo una fase es la fase activa. Cuando los pasos requeridos en cada fase se completan, el proceso puede pasar a la siguiente fase y se convierte en la fase activa. La fase siguiente se puede definir según las condiciones del flujo de proceso de negocio tal como se muestra en el siguiente diagrama.

Las fases se pueden asociar con entidades relacionadas específicas, por lo que un flujo de proceso de negocio pueden abarcar varias entidades. El proceso de negocio se mantiene igual y lleva al usuario a una conclusión deseada.Más información:TechNet: Flujos de proceso de negocio

Acciones que se pueden automatizar

Normalmente, el progreso a lo largo del proceso de negocio depende de los datos introducidos por el usuario. Como programador, puede realizar las mismas acciones mediante programación en scripts de formularios.

• Cambie el proceso cuando hay más de un proceso disponible para la entidad.
  Use Xrm.Page.data.process. getEnabledProcesses para recuperar la información acerca de los procesos habilitados que el usuario puede elegir para la entidad. Después use Xrm.Page.data.process. setActiveProcess para convertir uno de los procesos habilitados en activo.

• Pase a la siguiente fase cuando se completen todos los pasos obligatorios para convertirlo en la fase activa actual.
  Usar Xrm.Page.data.process. moveNext.

• Vaya a la fase anterior y conviértala en la fase activa actual.
  Usar Xrm.Page.data.process. movePrevious.

• Seleccione una fase para ver el estado de los pasos de la fase.
  Use Xrm.Page.data.process. getActivePath para recuperar información acerca de las fases que se han completado, la fase activa actual, y las fases válidas disponibles desde la fase activa actual. Examine los pasos incluidos en esa fase y compare los valores de atributo correspondientes del formulario para determinar si se han completado.

• Complete un paso
  Los pasos se completan cuando se escriben los datos correspondiente del formulario. Puede determinar el atributo mediante el método getAttribute del paso. Esto devolverá el nombre lógico del atributo. Después use Xrm.Page.getAttribute para recuperar el atributo de la recopilación de Xrm.Page.data.entity.attributes y luego use el método setValue del atributo para establecer el valor.

• Detecte si un paso es necesario
  Use el método de isRequired del paso para determinar si un paso es necesario para el flujo de proceso de negocio.

• Expanda o contraiga el control del flujo de proceso de negocio
  Usar Xrm.Page.ui.process.setDisplayState.

También hay algunas tareas que puede realizar como programador que un usuario no puede realizar.

• Ocultar el control del proceso
  Use Xrm.Page.ui.process. 1468bab0-f6b3-4320-a60c-a88c9d4fcf1f#BKMK_setVisible para controlar si desea mostrar el control del flujo de proceso de negocio.

• Vaya a una fase válida completada.
  Use Xrm.Page.data.process.setActiveStage para establecer una de las fases válidas completadas en la entidad actual.

• Consulte la definición de proceso incluidas las fases no visibles actualmente
  Use Xrm.Page.data.process.getActiveProcess para consultar la definición del flujo de proceso de negocio, incluidas las fases que podrían no ser visibles debido a la lógica de bifurcación del proceso.

Eventos para flujos de proceso de negocio

Puede interactuar con cualquier evento proporcionado por el formulario con flujos de proceso de negocio, pero dos nuevos eventos permiten ejecutar código basándose en eventos solo para el control de flujo de proceso de negocio. Puede ejecutar código cuando la fase activa de un flujo de proceso de negocio cambie (Evento OnStageChange) o cuando se seleccione una fase (Evento OnStageSelected).

Cualquiera de estos nuevos eventos proporciona una interfaz de usuario para registrar los controladores de eventos. Debe usar los métodos que se proporcionan para agregar o quitar controladores para estos eventos en el evento OnLoad del formulario.Más información:Eventos de control del flujo de proceso de negocio

Ver también

Use el modelo de objeto Xrm.Page
Xrm.Page.data.process (referencia del lado del cliente)
Ejemplo: Xrm.Page.data.process.getEnabledProcesses
Ejemplo: Xrm.Page.data.process.getActivePath
Eventos de control del flujo de proceso de negocio
TechNet: Flujos de proceso de negocio

© 2017 Microsoft. Todos los derechos reservados. Copyright