24.3 Adición de gestores personalizados

Los gestores personalizados se utilizan en DRA para que los atributos de propiedades interactúen entre sí a fin de realizar una tarea de flujo de trabajo y para las personalizaciones de carga y envío en un formulario de creación, propiedad o flujo de trabajo.

Gestores personalizados de propiedades

Entre los ejemplos de gestores personalizados de propiedades, se incluyen:

  • Consulta del valor de otros campos.

  • Actualización de los valores de los campos.

  • Activación o desactivación del estado de solo lectura de un campo.

  • Visualización u ocultación de los campos en función de las variables configuradas.

Gestores de carga de formularios

Por lo general, los gestores de carga de formularios realizan controles de inicialización. Solo se ejecutan una vez cuando el formulario se carga inicialmente. En el caso de las páginas de propiedades, estas se ejecutan antes de que se consulte al servidor en busca de las propiedades del objeto seleccionado.

Gestores de envío de formularios

Los gestores de envío de formularios permiten a los usuarios realizar algún tipo de validación y, posiblemente, cancelar el envío de formularios si se produce un problema.

Para obtener ejemplos más detallados del uso de los gestores personalizados y las personalizaciones en la consola Web, consulte las secciones Web Console Customization (Personalización de la consola Web) y Workflow Customization (Personalización de flujos de trabajo) en la referencia de personalización de productos de la página de documentación de DRA.

Habilitación de JavaScript personalizado

Por motivos de seguridad, el código JavaScript personalizado está inhabilitado por defecto. Al habilitar JavaScript personalizado, los administradores pueden escribir fragmentos de código de JavaScript que la consola Web ejecutará tal cual. Solo debe habilitar esta excepción si comprende y acepta los riesgos.

Para permitir que las personalizaciones incluyan código JavaScript personalizado:

  1. Desplácese a C:\ProgramData\NetIQ\DRARESTProxy.

  2. Abra el archivo restProxy.config.

  3. Añada allowCustomJavaScript="true" al elemento <consoleConfiguration>.

24.3.1 Pasos básicos para la creación de un gestor personalizado:

Los pasos siguientes comienzan desde una página de gestor personalizado preseleccionada. Para llegar hasta ese punto, puede acceder a los gestores personalizados de propiedades de objeto mediante el icono de propiedades de un campo de propiedades. Puede acceder a los gestores de carga de formularios y envío de formularios a través del botón Propiedades del formulario del formulario de flujo de trabajo seleccionado, una página Crear objeto o una página Editar propiedades.

  1. Seleccione la pestaña de gestor correspondiente en función de la propiedad o la página que esté personalizando:

    • Gestores personalizados

    • Gestores de carga de formularios

    • Gestores de envío de formularios

  2. Habilite la página del gestor y lleve a cabo una de las siguientes acciones:

    • Gestor personalizado de campo de propiedad:

      1. Seleccione un tiempo de ejecución. Por lo general, debe utilizar la segunda o la tercera opción de Tiempo de ejecución.

      2. Haga clic en + Añadir y seleccione un gestor personalizado en el menú Añadir gestor personalizado.

    • Gestor de formularios: haga clic en + Añadir y seleccione un gestor personalizado en el menú Añadir gestor personalizado.

    NOTA:Por lo general, es posible que solo necesite un gestor personalizado, pero se puede utilizar más de uno. Se ejecutan varios gestores de forma secuencial en el orden en que aparecen en la lista. Si desea cambiar el orden de los gestores u omitir un gestor innecesario, puede añadir macros de controles de flujo en el guión.

  3. Deberá configurar cada gestor personalizado que añada a la página. Las opciones de configuración varían según el tipo de gestor.

    Puede crear sus propios tipos de gestor.

    • Gestores de consultas LDAP o REST:

      1. Si desea que la consulta se base en valores estáticos, defina Información de conexión y Parámetros de consulta.

        Si desea que la consulta sea dinámica, introduzca los valores de espacio reservado en los campos obligatorios. Esto es necesario para que se ejecute el gestor. El guión anulará los valores de espacio reservado.

        NOTA:También puede configurar Encabezados y Cookies para la consulta REST.

      2. En Acción anterior a consulta, utilice el editor de guiones para escribir código JavaScript personalizado que se ejecutará antes de que se envíe la consulta. Este guión tiene acceso a toda la información de conexión y a los parámetros de consulta y puede modificar cualquiera de ellos para personalizar la consulta. Por ejemplo, la definición de parámetros de la consulta en función de los valores que ha especificado el usuario en el formulario.

      3. En Acción posterior a consulta, incluya un guión para procesar los resultados de la consulta. Algunas de las tareas habituales son la comprobación de errores, la actualización de valores de formulario en función de los resultados obtenidos y la validación de exclusividad de objetos según el número de objetos devueltos por la consulta.

    • Guión: inserte código JavaScript personalizado para generar el guión.

    • Consulta de DRA: especifique la carga de JSON en la pestaña Parámetros de consulta. El formato de carga debe coincidir con el valor o los pares de valores de VarSet que se enviarán al servidor DRA. De manera similar a las consultas REST y LDAP, puede especificar una acción anterior a la consulta que se puede utilizar para modificar la carga antes de enviarla al servidor y una acción posterior a la consulta para procesar los resultados.

    • Gestores de cuadro de mensajes: después de definir las propiedades del propio cuadro de mensaje, también puede escribir los segmentos de JavaScript para Acción anterior a mostrar y Acción posterior al cierre.

      Estas acciones son opcionales. La acción anterior a mostrar se utiliza para personalizar cualquiera de las propiedades del cuadro de mensaje antes de que se muestre al usuario y la acción posterior al cierre se utiliza para procesar la selección del botón del usuario y realizar cualquier lógica adicional basada en ella.

  4. Haga clic en Aceptar para guardar el gestor.

Para obtener ejemplos más detallados del uso de los gestores personalizados y las personalizaciones en la consola Web, consulte las secciones Web Console Customization (Personalización de la consola Web) y Workflow Customization (Personalización de flujos de trabajo) en la referencia de personalización de productos de la página de documentación de DRA.