![Call-Branch](https://demo5-academy.pega.com/sites/default/files/styles/1024/public/media/images/2020-10/Call-Branch.png?itok=QQGrZB8l)
Estructura de la actividad
Las actividades están compuestas por una o más secuencias de pasos. Cada paso de la actividad debe especificar un método que describa la acción que realiza el sistema.
Una página de pasos es una página en la memoria donde se procesa el método. De manera predeterminada, la actividad se ejecuta en el contexto en el que se invocó. Por ejemplo, una actividad que se llama desde una figura de utilidad durante el procesamiento del caso se ejecuta teniendo en cuenta la página asignada al tipo de caso (pyWorkPage).
En la siguiente imagen, haga clic en los íconos + para obtener más información sobre la configuración de una actividad.
Actividades de acción
Las actividades ejecutan pasos en un orden numerado. Loop (Bucle), When (Cuándo) y Jump (Saltar) indican una acción o condición cuando desea repetir pasos o alterar la secuencia en la que se ejecutan los pasos.
En la siguiente imagen, haga clic en los íconos + para obtener más información sobre las acciones y condiciones de las actividades.
Métodos para invocar otras actividades
Las actividades pueden invocar otras actividades, lo que le permite a un desarrollador crear actividades modulares y poder reutilizar las actividades estándar. Pega Platform™ ofrece dos métodos para ejecutar otra actividad: (Llamada) y (Rama).
Llamada
Pega ejecuta la actividad especificada y luego regresa el control a la actividad que invocó a la otra cuando termina el proceso de la actividad invocada. Considere dos actividades, A y B: si A llama a B, luego el control regresa a A cuando B finaliza.
Rama
Pega Platform ejecuta la actividad especificada, pero el control regresa a la regla que invocó la primera actividad. La actividad original finaliza una vez que la actividad bifurcada se completa. Considere dos actividades, C y D: si C se bifurca a D, cuando D (la actividad bifurcada) se completa, el control regresa a la regla que invocó la actividad C.
Nota: Para obtener más información sobre la creación de actividades, consulte Creación de actividades.
Parámetros
Los parámetros definen variables que ingresan datos a una actividad o recuperan datos de esta.
Los parámetros facilitan la reutilización de actividades permitiéndole pasar argumentos cuando se invoque la actividad, en lugar de al principio durante el desarrollo.
- Los parámetros de las actividades se definen en la pestaña Parameters (Parámetros) del formulario de actividades.
- Use el parámetro de notación param. para hacer referencia al valor de un parámetro.
- Los nombres y valores de parámetros se mantienen en una página especial del portapapeles, conocida como página de parámetros, que no es visible con la herramienta del portapapeles.
Seguridad
Para proteger mejor su aplicación, configure controles de acceso específicos para la actividad para limitar la manera en que puede ejecutarse una actividad y para quién puede ejecutarse. Use la configuración en la pestaña Security (Seguridad) de una regla de actividad para especificar el tipo de actividad y poder restringir qué usuarios (u otros solicitantes) pueden ejecutarla.
Restricción del acceso
Use las configuraciones de seguridad en la sección Restrict access (Restringir acceso) para restringir si los usuarios ejecutan la actividad y cómo lo hacen en el momento de la ejecución.
Seleccione el checkbox Allow invocation from browser (Permitir invocación desde el navegador) para permitirles a los usuarios comenzar esta actividad directamente a través del procesamiento de la entrada del usuario, como un botón Submit (Enviar) o un elemento pyActivity= en una URL. Desmarque esta opción si quiere que esta actividad comience únicamente a partir de otra, a través de los métodos de llamada, rama u otros.
Caution: Para la mayoría de las actividades, deje este checkbox sin marcar para promover la seguridad de su aplicación. Permitir que las actividades se inicien desde una URL u otras entradas de usuarios (ya sea que el solicitante se haya autenticado o sea un invitado) puede permitirles a los usuarios saltearse los pasos necesarios de verificación, seguridad o configuración.
Seleccione el checkbox Require authentication to run (Obligatorio) para permitir que únicamente los solicitantes autenticados inicien esta actividad. Desmarque este checkbox para permitirles a los usuarios invitados ejecutar esta actividad si reúnen otros criterios de acceso y seguridad.
Nota: Require authentication to run está seleccionado de manera predeterminada para nuevas actividades. En la mayoría de los casos, no necesita cambiar esta selección.
Identifique uno o más privilegios para restringir a los usuarios y otros solicitantes que pueden ejecutar esta actividad. En el momento de la ejecución, si el usuario no forma parte de un grupo de acceso que proporciona acceso a uno de los privilegios identificados, la ejecución de la actividad falla.
Nota: Para obtener más información sobre la configuración de la sección Restrict access (Restringir el acceso) de la pestaña Security (Seguridad) en una actividad, consulte Configuración de la seguridad de una actividad.
Tipo de actividad
Seleccione un tipo de actividad para determinar si puede hacerse referencia a esta actividad en otras reglas y de qué manera. Por ejemplo, seleccionar el tipo de actividad Route (Ruta) restringe el uso de la actividad a asignaciones de enrutamiento en el flujo de trabajo del caso. La lista Activity type (Tipo de actividad) ofrece las siguientes opciones.
Tipo de actividad | Descripción |
---|---|
Actividad | Seleccione cuando no esté disponible un valor más específico. No se puede hacer referencia directamente a las actividades con este valor en las reglas de flujo. |
Ensamblador | Desactualizado, no utilizar. |
Asignar | Seleccione si se hace referencia a la actividad desde la figura de asignación en una regla de flujo. Las actividades de asignación se usan para crear la asignación y son diferentes de otros tipos de actividades que pueden invocarse desde una actividad, por ejemplo, las actividades Notify (Notificar) y Route (Ruta). |
Asincrónica | Seleccione si la actividad se ejecuta en un hilo en segundo plano de manera asincrónica. La actividad puede invocar solo estos métodos de pasos: Load-DataPage (Cargar página de datos), Connect-Wait (Conectar y esperar) y Call-Async-Activity (Invocar actividad asincrónica) (instrucción de paso para permitirle al usuario cargar una actividad asincrónica). |
Cargar página de datos | Selecciona si la actividad agrega valores a las páginas de datos. Haga referencia a esta actividad en la pestaña Definition (Definición) de una regla Data Page (Página de datos). |
Localizar | Desactualizado. Solo disponible para las actividades existentes que utilizan páginas localizables. |
Notificar | Seleccionar si la actividad se usa para notificar a los usuarios una asignación pendiente. |
Onchange | Seleccionar si la actividad la ejecuta automáticamente una regla Declare OnChange (Declarar disparador). |
Ruta | Seleccionar si la actividad se usa para enrutar una asignación en una regla de flujo. |
Conexión de reglas | Seleccionar si la actividad invoca una regla de conector para servir como interfaz con un sistema externo. |
Disparador | Seleccionar si la actividad la ejecuta automáticamente una regla Declare Trigger (Declarar disparador). |
Utilidad | Seleccionar si la actividad la invoca una figura de utilidad en una regla de flujo. |
Validar | Desactualizado, no utilizar. |
Nota: Para obtener más información sobre la configuración del tipo de actividad para una actividad invocada desde una regla de flujo, consulte la pestaña Security (Seguridad) en el formulario de actividades.
Prácticas recomendadas de las actividades
General
- Siempre que sea posible, use tipos de reglas alternativas, como un data transform para configurar un valor de propiedad.
- Evite usar valores codificados reutilizables en las propiedades, por ejemplo, los URL o las clases. En su lugar, use páginas de datos, tablas de decisión o valores de mapas.
- Mantenga las actividades breves. Limite sus actividades a menos de 25 pasos y enfoque cada actividad en completar una tarea.
- Use actividades reutilizables.
- Use el campo Description (Descripción) para describir lo que hace cada paso de la actividad.
- Configure un Activity type (Tipo de actividad) adecuado en la pestaña Security (Seguridad) para eliminar las advertencias. Por ejemplo, Utility (default) (Utilidad [predeterminado]), Validate (Validar) y Load Data Page (Cargar página de datos).
Pasos
- Reduzca o elimine el uso de ciclos duplicados para mejorar el rendimiento de la aplicación.
- Quite las líneas con comentarios antes de fusionar sus reglas, a menos que estas líneas sirvan para clarificar detalles de la actividad.
- Evite usar métodos de actividades desactualizados.
- Limite el uso de Java de programación manual. Evite usar pasos de Java en las actividades cuando estén disponibles tipos de reglas estándar o personalizadas, funciones de biblioteca o métodos de actividades.
Caution: El método Java permite agregar código Java personalizado a una actividad. Use este método con mucho cuidado. El uso de código Java personalizado en las actividades constituye una violación grave de las prácticas recomendadas de desarrollo de aplicaciones de Pega porque introduce problemas de mantenimiento. Use la landing page Access Control Check (Verificación del control de acceso) para identificar las invocaciones de actividades que requieren mitigación. Para obtener más información sobre la landing page Access Control Check (Verificación del control de acceso), consulte Uso de las verificaciones de control de acceso.
Parámetros
- Use parámetros para definir bien los datos de entrada y salida, para que los System Architects entiendan cómo se usa la actividad y aumenten la capacidad de mantenimiento de la aplicación. Si la actividad necesita un valor específico para procesar, pase un parámetro escalar en lugar de una referencia de página completa.
Compruebe sus conocimientos con la siguiente actividad:
This Topic is available in the following Module:
- Actividades v4
If you are having problems with your training, please review the Pega Academy Support FAQs.
¿Quiere ayudarnos a mejorar este contenido?