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 incluye 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.

_.serviceoption.status()

Devuelve el estado del elemento de línea al cual pertenece el formulario actual. Utilice esta función para especificar atributos de formulario que dependen dinámicamente del estado del elemento de línea. Por ejemplo, para ocultar ciertos campos de formulario cuando se completa su estado de línea, establezca el atributo oculto como "_.serviceoption.status() == 200".

Nota: Esta función también se puede utilizar para ocultar o desactivar un elemento de opción de servicio. Para ello, utilice esta función en el cuadro de texto oculto o desactivado.

Esta función también resulta especialmente útil en los estados En espera y Reanudar. Se pueden dar motivos en mensajes de texto para ambos.

Nota: Esta función no admite parámetros.

ca_fdDoFieldLookup(fieldId, reportId),

Ejecuta el objeto de datos de informe, lo asocia al campo de búsqueda y copia los datos devueltos en los campos coincidentes del formulario. Puede utilizar estas acciones para completar los campos de acuerdo con los datos introducidos por el usuario en un objeto de datos de informe.

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.

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 se especifican y devuelve los resultados.

• En reportId, especifique el objeto de datos que desea consultar.
• Para variables, especifique la asignación de JavaScript con los nombres y los valores de variables. Estos son algunos ejemplos: {“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 deberá ejecutar si la llamada no devuelve resultados.

Se pueden rellenar campos previamente en función de 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 creado por usted.

ca_fdShowField(formId, _id)

Se aplica a un único campo.

Encuentra el formulario (formId) y el campo (_id) especificados. También muestra ese campo si no fuera visible.

ca_fdShowFields(formId, _ids)

Se aplica a varios campos.

Encuentra el formulario (formId) y el campo (_ids) especificados. También muestra los campos si no fueran visibles.

El segundo parámetro es una matriz que contiene los _ids de varios campos del formulario tal y como se muestra en el ejemplo de ca_fdHideFields(formId, _ids).

ca_fdHideField(formId, _id)

Se aplica a un único campo.

Encuentra el formulario (formId) y el campo (_id) especificados. También oculta ese campo si fuera visible.

ca_fdHideFields(formId, _ids)

Se aplica a varios campos.

Encuentra el formulario (formId) y los campos (_id) especificados. También oculta los campos si fueran visibles.

El segundo parámetro es una matriz que contiene los _ids de varios campos del formulario. Por ejemplo, supongamos que desea ocultar los campos de nombre y apellidos de un formulario. Asimismo, el _id del formulario es name_form y los valores de _id de los campos son first_name y last_name. En este caso, debe utilizarse el código siguiente:

ca_fdHideFields("name_form", ["first_name","last_name"]

ca_fdDisableField(formId, _id)

Se aplica a un único campo.

Encuentra el formulario (formId) y el campo (_id) especificados. También desactiva el campo si no lo está ya.

ca_fdDisableFields(formId, _ids)

Se aplica a varios campos.

Encuentra el formulario (formId) y los campos (_id) especificados. También desactiva los campos si no lo están ya.

El segundo parámetro es una matriz que contiene los _ids de varios campos del formulario tal y como se muestra en el ejemplo de ca_fdHideFields(formId, _ids).

ca_fdEnableField(formId, _id)

Se aplica a un único campo.

Encuentra el formulario (formId) y el campo (_id) especificados. También activa el campo si no lo está ya.

ca_fdEnableFields(formId, _ids)

Se aplica a varios campos.

Encuentra el formulario (formId) y los campos (_id) especificados. También activa los campos si no lo están ya.

El segundo parámetro es una matriz que contiene los _ids de varios campos del formulario tal y como se muestra en el ejemplo de ca_fdHideFields(formId, _ids).

ca_fdSelectOption(formId, _id, name, value) y ca_fdSelectOptionByIndex(formId, _id, index)

Se puede utilizar cualquiera de estas funciones para seleccionar mediante un programa un valor en un cuadro de selección. Estas funciones tienen el mismo efecto y difieren solamente por su nombre:

• ca_fdSelectOption selecciona la opción con el atributo _id, el nombre y el valor especificados en el campo de selección.
• ca_fdSelectOptionByIndex selecciona la opción con el valor de índice y el atributo _id especificados en el campo de selección.

Observe los siguientes ejemplos:

Ejemplo 1

Este ejemplo selecciona la primera opción del cuadro de selección. Este ejemplo utiliza los valores siguientes:

• Atributo _id del formulario: form_id
• Atributo _id del cuadro de selección: memory_select

  ca_fdSelectOption(‘form_id’, ‘memory_select’, 1) :
  

Ejemplo 2

Este ejemplo selecciona la primera opción del cuadro de selección del formulario actual. Este ejemplo utiliza los valores siguientes:

• Atributo _id del formulario: ca_fd.formId
• Atributo _id del cuadro de selección: memory_select

  ca_fdSelectOption(ca_fd.formId, ‘memory_select’, 1) :
  

Si no se encuentra el cuadro de selección especificado, la llamada se ignora y no se registra ningún error.

Ejemplo 3

Los ejemplos anteriores se pueden volver a escribir con valores explícitos para las opciones de la siguiente manera:

ca_fdSelectOption(‘form_id’, ‘memory_select’, ‘option1’, ‘option1_value’), ca_fdSelectOption(ca_fd.formId, ‘memory_select’, ‘option1’, ‘option1_value’):

option1

Especifica el nombre de una opción tal y como aparece en el árbol del Diseñador de formularios. El valor de esta opción es option1_value.

ca_fdUnselectOption(formId, _id, name, value)

Anula la selección de la opción con el nombre y el valor especificados 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_fdUnselectAllOptions(formId, _id)

Anula la selección de todas opciones en el campo de selección con el atributo _id correspondiente.

ca_fdGetSelectedOptions(formId, _id)

Devuelve una matriz de números 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 resulta especialmente útil para usar la entrada del usuario para rellenar 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 de número entero nulo, cadena o longitud para el parámetro denominado fecha.

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

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

• Si la parte de la hora del campo Fecha/Hora está visible, especifique las cadenas únicamente en el formato de fecha. Utilice el atributo de formato del campo Fecha/Hora o el formato de 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 ca_fdSetDateField*, se puede establecer la fecha en milisegundos a partir de la hora base estándar de medianoche (00:00:00) GMT, 1 de enero de 1970. Para obtener más información sobre cómo establecer la fecha de esta manera, consulte la referencia estándar de programación en Java; por ejemplo, en 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 ca_fdGetDateField*, se puede establecer la fecha en milisegundos a partir de la hora base estándar de medianoche (00:00:00) GMT, 1 de enero de 1970. Para obtener más información sobre cómo establecer la fecha de esta manera, consulte la referencia estándar de programación en Java; por ejemplo, en 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.

Esta función también resulta especialmente útil para usar la entrada del usuario para rellenar 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)