Funciones de JavaScript predefinidas

CA Service Catalog ofrece varias opciones para ejecutar tareas automatizadas en los campos de los formularios, como objetos de datos de informe, expresiones de JavaScript y funciones de JavaScript. Este tema enumera las funciones de JavaScript predefinidas y proporciona una descripción general de cómo se pueden utilizar opcionalmente para automatizar tareas en campos.

Siga las siguientes directrices para especificar valores para los operandos utilizados en varias de las funciones de JavaScript predefinidas. En la mayor parte de las funciones, los primeros dos operandos de la siguiente lista son obligatorios y los restantes son opcionales; revise la sintaxis para buscar una función específica que permita determinar qué operandos son aplicables a esa función.

• En lo que se refiere a formId, especifique el valor del atributo _id del formulario en el cual desea ejecutar la función.
• Por lo que respecta a _id, especifique el valor del atributo _id del elemento incluido en el formulario en el que desea ejecutar la función.
• En cuanto a name, value e index, especifique el valor de estos atributos en el elemento en el que la función se está ejecutando.
• Si hay operandos adicionales en funciones específicas, se mencionarán según proceda. Por ejemplo, el atributo index sólo se puede aplicar a determinados elementos, como un grupo de selección

ca_fdDoFieldLookup(fieldId, reportId),

Ejecuta el objeto de datos de informe, lo asocia al campo de búsqueda y copia los datos devueltos por el objeto de datos en los campos coincidentes del formulario.

Para fieldId, especifique el valor del atributo _id del campo de búsqueda.

En reportId, especifique el valor del objeto de datos que creó anteriormente.

Para obtener más información, consulte la sección Cómo completar los campos según los datos introducidos por el usuario en un objeto de datos de informe.

ca_reportQuery(reportId, variables, onSuccess, onFailure)

Ejecuta un objeto de datos de informe (objeto de datos) que consulta la fuente de datos (por ejemplo, MDB) de los datos que desea utilizar y devuelve los resultados.

• En reportId, especifique el objeto de datos que desea consultar.
• En las variables, especifique la asignación de JavaScript con los valores y nombres de variables, por ejemplo, {var1":"foo","var2":"bar","var3":_.user.id}. Estas variables coinciden con las que se consultaron en el objeto de datos de informe.
• En onSuccess, especifique la función de JavaScript que se ejecutará si la consulta se devuelve satisfactoriamente. La función onSuccess debe admitir un operando. Este operando se configura con una matriz de asignaciones, cada una de las cuales representa una fila, devuelta por la consulta.
• En onFailure, especifique la función de JavaScript que se ejecutará si la llamada falla.

Para obtener más información acerca de cómo completar campos en un formulario con los resultados de una consulta, consulte la sección Cómo completar previamente campos basados en un objeto de datos de informe y funciones de JavaScript.

ca_fdValidateCC (número y tipo de tarjeta de crédito)

Valida el formato de un número de tarjeta de crédito introducido por el usuario en un formulario, como se describe en la sección Cómo validar los datos introducidos por el usuario.

ca_fdShowField(formId, _id)

Busca el campo con el valor _id especificado en el formulario con _id=formId y lo hace visible (si todavía no lo es).

ca_fdHideField(formId, _id)

Busca el campo con el valor _id especificado y lo hace invisible (si es visible en ese momento).

ca_fdDisableField(formId, _id)

Busca el campo con el valor _id especificado y lo desactiva.

ca_fdEnableField(formId, _id)

Busca el campo con el valor _id especificado y lo activa.

ca_fdSelectOption(formId, _id, name, value)

Selecciona la opción con el nombre y valor especificado en el campo de selección con el atributo _id correspondiente.

ca_fdSelectOptionByIndex(formId, _id, index)

Selecciona la opción en el índice correspondiente en el campo de selección con el atributo _id correspondiente.

ca_fdUnselectOption(formId, _id, name, value)

Anula la selección de la opción con el nombre y valor especificado en el campo de selección con el atributo _id correspondiente.

ca_fdUnselectOptionByIndex(formId, _id, index)

Anula la selección de la opción en el índice correspondiente en el campo de selección con el atributo _id correspondiente.

ca_fdGetSelectedOptions(formId, _id)

Devuelve una matriz de valores enteros que indican los índices de las opciones seleccionadas.

ca_fdGetSelectedOptionValues (formId, _id)

Devuelve una matriz de cadenas que indican los valores de las opciones seleccionadas. Seleccione el primer valor de la opción como se explica a continuación:

ca_fdGetSelectedOptionValues(formId, _id)[0]

Seleccione el segundo valor de la opción cambiando el 0 a 1; seleccione el tercer valor de la opción cambiando el 1 a 2 y así sucesivamente.

Esta función es especialmente útil para usar la entrada del usuario para completar previamente un cuadro de selección.

ca_fdSelectRadio(formId, name, _id)

Selecciona los botones de opción con el valor _id correspondiente en el grupo de botones de opción con el atributo de nombre correspondiente.

ca_fdIsSelectRadio (formId, name, _id)

Indica si el botón de opción especificado se selecciona.

ca_fdSelectCheckBox(formId,_id)

Activa la casilla de verificación con el atributo _id correspondiente.

ca_fdUnselectCheckBox(formId, _id)

Desactiva la casilla de verificación con el atributo _id correspondiente.

ca_fdIsSelectedCheckBox(formId,_id)

Indica si la casilla de verificación seleccionada se activa.

ca_fdSetDateFieldValue(formId, _id, date) y funciones relacionadas

Establece el valor del campo de fecha especificado con el atributo _id correspondiente. Esta función puede tomar valores enteros Nulos, Cadena o Largos para el parámetro denominado fecha.

Para borrar el valor del campo, utilice los valores cadena vacía y nulo.

Especifique las cadenas que no estén vacías en el formato especificado para el campo Fecha y hora (un elemento del formulario), de la siguiente manera:

• Si la parte de la hora del campo Fecha y hora está oculta, especifique las cadenas sólo en el formato de fecha, ya sea con el atributo de formato del campo Fecha y hora o el formato Fecha de la unidad de negocio.
• Si la parte de la hora del campo Fecha y hora está visible, especifique las cadenas en el formato fecha y hora especificado por ese campo.

En ambos casos, separe las cadenas múltiples con un espacio.

Las funciones de JavaScript relacionadas para establecer la fecha son como se muestra a continuación. El texto anterior para la función ca_fdSetDateFieldValue(formId, _id, date) también se aplica a estas funciones.

• ca_fdSetDateFieldMinValue(formId, _id, date): establece el valor mínimo de la fecha.
• ca_fdSetDateFieldMaxValue(formId, _id, date): establece el valor máximo de la fecha.

Además, para todas las funciones de JavaScript de ca_fdSetDateField*, se puede establecer la fecha en milisegundos a partir del tiempo o la hora base estándar de medianoche (00:00:00) GMT, 1.º de de enero de 1970. Para obtener más detalles sobre cómo establecer la fecha de esta manera, consulte la referencia estándar de programación en Java, por ejemplo, el sitio Web de Oracle, oracle.com.

ca_fdGetDateFieldValue(formId, _id, date) y funciones relacionadas

Obtiene el valor del campo de fecha indicado como una cadena de caracteres formateada conforme al formato especificado para el campo de fecha.

También se aplica a esta función la información acerca del campo Fecha y hora para la función anterior (ca_fdSetDateFieldValue(formId, _id, date)).

Las funciones de JavaScript relacionadas para establecer la fecha son como se muestra a continuación. El texto anterior para la función ca_fdGetDateFieldValue(formId, _id, date) también se aplica a estas funciones.

• ca_fdGetDateFieldValueInMillis(formId, _id, date): tiene el valor de la fecha en milisegundos.
• ca_fdGetDateFieldMinValue(formId, _id, date): establece el valor mínimo de la fecha.
• ca_fdGetDateFieldValueInMillis(formId, _id, date): establece el valor mínimo de la fecha en milisegundos.
• ca_fdGetDateFieldMaxValue(formId, _id, date): establece el valor máximo de la fecha.
• ca_fdGetDateFieldValueInMillis(formId, _id, date): establece el valor máximo de la fecha en milisegundos.

Además, para todas las funciones de JavaScript de ca_fdGetDateField*, se puede establecer la fecha en milisegundos desde el tiempo o la hora base estándar de medianoche (00:00:00) GMT, 1.º de de enero de 1970. Para obtener más detalles sobre cómo establecer la fecha de esta manera, consulte la referencia estándar de programación en Java, por ejemplo, el sitio Web de Oracle, oracle.com.

ca_fdSetTextFieldValue(formId, _id, text)

Define el texto del campo de texto con el atributo _id correspondiente, que puede ser campo de texto y área de texto.

ca_fdGetTextFieldValue(formId, _id)

Obtiene el texto del campo de texto con el atributo _id correspondiente, que puede ser campo de texto y área de texto.

ca_fdFetchSelectData(formId,_id)

Hace que el cuadro de selección con el _id especificado vuelva a recopilar el objeto de datos de informe. Esta función es especialmente útil cuando el objeto de datos de informe tiene en cuenta la entrada del usuario. Es recomendable que se invoque esta función cuando cambie dicha entrada para asegurarse de que el cuadro de selección muestre los datos correctos.

Además, esta función es especialmente útil para usar la entrada del usuario para completar previamente un cuadro de selección.

Las funciones siguientes son para formularios del sistema solamente:

• custom_onPriorityChange(newPriority)
• custom_onDateRequiredChange(newDateRequired)
• custom_onRequestedForChange(type, id, name, shippingAddress)