Establecer Parámetros acción evento

Hay dos maneras básicas de establecer parámetros para una acción de evento:

  • Utilice los formularios Parámetro de acción evento asociados con cada tipo de acción.

    Para acceder a estos formularios, seleccione un Tipo de acción y, a continuación, haga clic en Editar parámetros en el formulario Acciones de evento.

  • Especifique los parámetros directamente en el campo de edición de texto en el formulario Acciones de evento.

También puede empezar con los formularios de parámetro de acción evento y, a continuación, editar manualmente la salida en el formulario Acciones de evento.

Nota:  Si está familiarizado con los parámetros, funciones y sintaxis de los parámetros de acción, puede introducir la información del parámetro manualmente en el campo de texto. Sin embargo, salvo que esté muy seguro de su capacidad de escribir estos datos desde cero o que esté pegando datos desde una fuente fiable y para asegurar que usa solo parámetros, funciones y sintaxis válidas, recomendamos que utilice los formularios de parámetro de acción evento, que han sido diseñados específicamente para este propósito.

Consejos e instrucciones para Utilizar parámetros de acción evento de forma eficaz

Mientras que los formularios de parámetro de acción evento facilitan establecer parámetros de acción evento en lugar de crearlos manualmente, aún así, debe estar familiarizado de alguna manera con los parámetros, funciones y sintaxis disponibles para cada tipo de acción. Probablemente, la mejor manera de hacer esto es abrir el formulario asociado a cada tipo de acción y acceder a la Ayuda en línea de ese formulario y sus campos. También hay una extensa documentación de referencia proporcionada en la Guía al Sistema de evento de aplicación.

Cada formulario de parámetro de acción evento incluye solo aquellos parámetros y funciones que funcionarán con el tipo de acción seleccionada. Por lo que, por ejemplo, si está creando una acción para notificar destinatarios de algo, solo estarán disponibles los parámetros que pueda necesitar para crear dicha notificación desde el formulario Notificar acción evento.

La mayoría de las opciones en un formulario de parámetro de acción evento incluyen tanto un campo como un botón. El campo puede ser de cualquiera de estos tipos:

  • Un campo de edición de texto en el que puede introducir el valor directamente para dicha opción.
  • Una lista desplegable en la que puede seleccionar el valor que desee.
  • Un cuadro combinado que le permite o seleccionar un valor de una lista desplegable o introducir un valor manualmente.

El botón asociado normalmente abre uno de estos formularios:

  • El Editor de expresiones de acción evento, que es un formulario genérico utilizado para crear valores deseados utilizando expresiones.

    Para más información, consulte Utilizar expresiones en parámetros de acción evento.

  • Otro formulario de parámetro de acción evento auxiliar diseñado específicamente para ayudar con la creación de un valor adecuado para esa opción.

    Por ejemplo, el botón Condición, en muchos formularios de parámetros de acción de evento, abre el formulario Condición de parámetro de acción de evento, que se ha diseñado específicamente para facilitar la creación y el formato de una instrucción de condición adecuada para el sistema de eventos que se va a usar.

Cuando hace clic en Aceptar en el formulario del parámetro de acción de evento, los valores especificados se devuelven al formulario principal, con un formato que usa la sintaxis correcta.

Para comprobar que la sintaxis está libre de errores, haga clic en el botón Comprobar sintaxis antes de proceder.

Ejemplo

Como parte de un evento que notifica a un administrador cuando el límite de crédito de un cliente se ha cambiado, suponga que desea avisar al Gerente de crédito para que de la aprobación si el nuevo límite de crédito es 500.000$ o menos. Si el nuevo límite de crédito es más de 500.000$, entonces el Supervisor de crédito debe aprobar el cambio. Puede utilizar un tipo de acción Ramificación para determinar quién recibe el mensaje de aviso.

Para manejar esta situación, debe crear un controlador de evento que se ejecute cada vez que se cambie el crédito de un cliente. Después de utilizar el formulario Controladores de evento para crear el controlador, haga clic en el botón Acciones evento para abrir el formulario Acciones evento. Allí, para una de las acciones, asignará un número de secuencia de acción y seleccionara Ramificación en el campo Tipo de acción.

En este punto, haga clic en Editar parámetros para abrir el formulario Ramificación de acción evento. Ese formulario tiene dos campos y un botón (además de los botones Aceptar y Cancelar). Si quiere usar el formulario auxiliar para establecer la condición, haga clic en el botón Condición.

En este ejemplo, la condición se debe establecer de manera que si el valor de la propiedad CreditLimit es menor que o igual a 500.000 el controlador de evento procede al siguiente paso de acción. Si no, si la propiedad de CreditLimit es mayor que 500.000, entonces el flujo de acción se ramifica a una paso de acción distinto.

Cuándo el formulario Condición de parámetro de acción evento se abre, decide utilizar los botones de Expresión para ayudar a configurar la condición. Hacer clic en el botón Expresión 1 abre el Editor de expresiones de acción evento, el cual utilizará para configurar la primera parte de la condición. Si quiere especificar el valor de la propiedad CreditLimit, entonces seleccione PROPERTY (o P) en la lista Seleccionar una función.

Después de seleccionar la función PROPERTY, el Editor de expresiones de acción evento añade un campo Parámetro 1. En este campo, como conoce el nombre de la propiedad cuyo valor desea devolver, simplemente tiene que especificar CreditLimit y luego hacer clic en Aceptar para volver al formulario Condición de parámetro de acción de evento.

En el campo Operador, seleccione, a continuación, el símbolo "mayor que" (>).

Por último, en el campo de Expresión 2, especifique 500000. En este caso, no necesita utilizar el Editor de expresiones de acción evento, porque conoce el valor que quiere usar, y quiere codificarlo de forma rígida al valor.

Cuando hace clic en Aceptar, el sistema vuelve al formulario Ramificación de acción evento, y rellena el campo Condición. En el campo Destino, entonces, podría realizar cualquiera de estas acciones:

  • Seleccionar el número del paso de secuencia de acción donde quiere que vaya el controlador si esta condición prueba TRUE (si ya existe el paso de secuencia de acción de destino).
  • Para un paso de secuencia de acción que todavía no existe, especifique el número del paso que planea crear más tarde para el destino.

Cuando hace clic en Aceptar, el sistema devuelve el formulario Acciones de evento, con el texto de parámetro correcto.

En este punto recomendamos que haga clic en Comprobar sintaxis para comprobar que la sintaxis de parámetro es correcta. Si hay un error, verá un mensaje de error bastante mezclado y largo. También puede utilizar este mensaje de error para determinar donde y que puede ser el error, concentrándolo en la línea en la que el error aparece y el "Contexto previo". En muchos casos, tal como este, debe tener el nombre de la propiedad entre comillas, si no el sistema devuelve un error. (De hecho, la omisión de las comillas es el error mas común de errores de sintaxis.)

Si esto pasara intente corregir el error manualmente y luego haga clic otra vez en Comprobar sintaxis Continúe haciendo esto hasta que haya eliminado todos los errores.

Precaución: Si no corrige ningún error de sintaxis antes de hacer clic otra vez en Editar parámetros, perderá todo el texto de los parámetros y tendrá que empezar de nuevo.
Temas relacionados