Utilización del generador de servicios › Elementos de opciones de servicio › Cómo completar previamente los campos de texto de los formularios de CA Workflow › Definición de atributos para campos de texto rellenados previamente

Definición de atributos para campos de texto rellenados previamente

En CA Workflow, se pueden crear campos de texto en formularios según sea necesario. Para rellenar previamente los campos de texto, deberá seguir los pasos de esta sección. Estos pasos incluyen el agregar varios atributos nuevos necesarios para el campo principal, esto es, el campo utilizado para capturar los datos utilizados para rellenar previamente otros campos de texto. Este tema continúa el ejemplo del ID de empleado iniciado en Cómo rellenar previamente los campos de texto de formularios.

Para definir atributos para campos de texto rellenados previamente

1. Asegúrese de haber seleccionado el formulario que desee utilizar y de que los campos que desee rellenar previamente ya están creados. Si necesita crear alguno de estos campos, hágalo ahora, tal y como se explica en la sección Cómo modificar un formulario para que incluya nuevos campos de texto.
2. Asegúrese de que el id de cada campo de texto rellenado previamente coincida exactamente (incluyendo mayúsculas y minúsculas) con el campo de la base de datos correspondiente en la consulta del objeto de datos del informe, tal y como se explica en Cómo rellenar previamente los campos de texto de formularios.

   Para continuar con el ejemplo del ID de empleado iniciado en esa sección, asegúrese de crear los siguientes campos de texto, y de que los atributos de id del formulario coincidan exactamente con los nombres de campo correspondientes de la base de datos: Nombre, Apellidos, Número de teléfono, Dirección de correo electrónico y Dirección postal.

   Si es necesario, siga los pasos descritos en Cómo modificar un formulario para que incluya nuevos campos de texto para crear estos campos y especificar sus atributos.

3. Abra el formulario que desea editar. Para obtener más información, si es necesario, consulte Cómo modificar un formulario para que incluya nuevos campos de texto.
4. En el formulario, seleccione el campo de entrada principal.

   Para continuar con el ejemplo del ID de empleado, abra el formulario Employee Termination y seleccione el campo de ID de empleado.

   Los atributos existentes para dicho campo aparecen en la tabla de atributos del campo en la parte inferior de la pantalla: en las columnas de nombre y valor se muestran los nombres y valores de cada atributo para el campo seleccionado. Los nombres de los atributos predeterminados correspondientes al campo de ID de empleado son id, etiqueta, obligatorio y valor. La pantalla tendrá una apariencia parecida a ésta:

   

5. Para crear un atributo nuevo para el campo seleccionado (ID de empleado), haga clic en el icono del signo (+) de color verde situado al lado de la columna Nombre de la tabla del atributo del campo.
6. En la fila correspondiente al nuevo atributo, haga clic en la lista desplegable de la columna Nombre y seleccione el nombre de cualquier opción, por ejemplo, sugerencia.

   Dicho nombre aparece como la nueva entrada en la columna Nombre.

7. Haga doble clic en el nombre para seleccionarlo.

   Los bloques correspondientes al nombre y al valor aparecen resaltados.

8. Mientras mantiene el cursor en el bloque Nombre, escriba encima del nombre existente e introduzca el nombre nuevo: icon.

   Haga doble clic dentro de la columna correspondiente al valor e introduzca el nombre de la ruta a la imagen personalizada (como, por ejemplo, una lupa) que desea utilizar como icono de búsqueda en el formulario.

   El valor predeterminado es custom/images/icon.gif, sin ninguna especificación adicional acerca de la unidad o el directorio.

   Para utilizar otro archivo de imagen (nombredearchivo.gif), cópielo en la carpeta custom/images y especifique custom/images/nombredearchivo.gif en la columna correspondiente al valor.

   Nota: Cuando los usuarios hacen clic en este icono en el formulario, se lleva a cabo una acción. Esta acción se especifica mediante el atributo icon_action, que se describe en un paso posterior.

9. Haga clic en Aceptar para guardar los cambios y cerrar el formulario.
10. Abra el formulario de nuevo para continuar con la definición de atributos.
11. Vuelva a seleccionar el campo de ID de empleado y especifique los siguientes nuevos atributos, utilizando los pasos anteriores como modelo:

    Name=icon_action

    icon_action es el nombre de atributo fijo.

    Value=función suministrada previamente o personalizada

    Especifica la función JavaScript que se ejecutará cuando el usuario final que está completando el formulario hace clic en el icono especificado por el atributo anterior (icono). La función JavaScript es la función ca_PopupVariableWindow(customMain) o una función personalizada, tal y como se indica a continuación:

    Value=ca_PopupVariableWindow(customMain)

    La función ca_PopupVariableWindow(customMain) solicita al usuario introducir un valor para el campo de entrada principal. Mediante este valor, la función ejecuta la consulta para rellenar previamente los campos de texto.

    En el ejemplo del ID de empleado, la función solicita al usuario la introducción del ID de usuario y, a continuación, utiliza dicho ID para ejecutar la consulta para cumplimentar previamente los campos de texto con datos de personal relacionados como los nombres y apellidos, las direcciones de correo electrónico, etc.

    Value=customCallback(función personalizada)

    Permite especificar el nombre de la función JavaScript personalizada que se va a ejecutar.

    Es necesario utilizar la función customCallback para recuperar la función personalizada. La función customCallback se incluye en el archivo custom_form_example.js.

    Especifique funciones personalizadas en el archivo custom_form_lib.js file o custom_form_example.js, tal y como se explica en la sección Funciones JavaScript para la reutilización, personalización y resolución de problemas.

    Name=icon _tooltip

    icon_tooltip es el nombre de atributo fijo.

    Value=información sobre herramientas

    Especifica una cadena de texto que proporciona la información sobre herramientas del icono. Cuando los usuarios colocan en ratón sobre el icono, este texto se muestra sobre el icono para explicar su función.

    Name=prefill

    prefill es el nombre de atributo fijo.

    Value=objeto de datos de informest

    Especifica el id del objeto de datos de informes que recupera los datos utilizados para rellenar previamente los campos de texto del formulario.

    Ejemplo: $report_data.78870b102af20c13425451163b2d2370-7ff41195054288150$

    Nota: Los atributos de campo denominados icono, icon_attribute e icon_tooltip son específicos de la implementación de CA Service Catalog de CA Workflow y, por lo tanto, es posible que no sean compatibles con implementaciones de otros productos de CA Workflow.

12. Haga clic en Aceptar para cerrar el formulario y guardar los cambios.
13. Guarde la definición del proceso mediante la que ha accedido al formulario (USM_Forms_Container).
14. Personalice y pruebe el formulario en Funciones JavaScript para la reutilización, personalización y resolución de problemas.

    Si es necesario, refine el formulario, expórtelo de nuevo y pruébelo hasta que funcione correctamente.

15. Finalice el formulario para que pueda probarlo en solicitudes reales. Para obtener más información, consulte Finalización del formulario.

Finalización del formulario

Para finalizar el formulario, previsualícelo, ajústelo según sea necesario y, a continuación, expórtelo.

Para finalizar el formulario

1. Haga clic en Vista previa para consultar cómo se mostrará su formulario a usuarios. Realice los ajustes necesarios.
2. Haga clic en Exportar.

   Aparecerá el cuadro de diálogo Examinar.

3. Desplácese a la carpeta %USM_HOME%/view/forms y guarde el formulario con un nuevo nombre de archivo, por ejemplo, Personnel Data for Emp Term.xml.

   Importante: asegúrese de utilizar un nombre de archivo diferente para evitar que un formulario predeterminado incluido en un parche o una actualización posterior sobrescriba los cambios por accidente. También es útil conservar intacto el formulario original si se necesita verificar el contenido predeterminado del formulario más adelante por cualquier motivo.

4. Haga clic en Aceptar en el Creador de formularios.
5. Compruebe el Creador de formularios y verifique que el formulario aparece y funciona del modo deseado.

   Nota: Para obtener ayuda acerca de la resolución de problemas de la cumplimentación previa y de las funciones JavaScript, consulte Funciones JavaScript para la reutilización, personalización y resolución de problemas.

6. Si es necesario, refine el formulario, expórtelo de nuevo y compruebe que cumple con sus requisitos.

   Nota: Recuerde que el ejemplo de ejecución de ID de empleado, no está ideado como un producto final para “conectar” al sistema tal cual, sino como un ejemplo ilustrativo destino a demostrar cómo modificar los formularios predeterminados para que se adapten a los recursos y necesidades concretos de la organización,

   Ahora está preparado para incluir este formulario en un servicio o un grupo de opciones de servicio con el fin de probarlo en una solicitud real de Catalog.