Funções JavaScript predefinidas

O CA Service Catalog fornece várias opções para executar tarefas automatizadas em campos de formulários, incluindo objetos de dados de relatório, expressões JavaScript e funções JavaScript. Este tópico relaciona as funções JavaScript predefinidas e fornece uma visão geral de como é possível usá-las para automatizar as tarefas nos campos.

Use as seguintes diretrizes para especificar valores para os operandos usados em várias das funções JavaScript predefinidas. Para a maioria das funções, os dois primeiros operandos da lista a seguir são obrigatórios e os outros são opcionais; verifique a sintaxe da função individual para ver que operandos se aplicam a ela.

ca_fdDoFieldLookup(fieldId, reportId),

Executa o objeto de dados de relatório, associa-o ao campo de consulta e copia os dados retornados pelo objeto de dados para os campos correspondentes no formulário.

Para fieldId, especifique o valor do atributo _id do campo de consulta.

Para reportId, especifique o valor do objeto de dados criado anteriormente.

Para obter mais detalhes, consulte Como preencher campos com base na entrada do usuário para um objeto de dados de relatório.

ca_reportQuery(reportId, variables, onSuccess, onFailure)

Executa um objeto de dados de relatório (objeto de dados) que consulta a origem de dados (como o MDB) para os dados desejados e retorna o resultado.

Para obter detalhes sobre como preencher campos em um formulário com os resultados de uma consulta, consulte Como preencher previamente campos com base em um objeto de dados de relatório e funções do JavaScript.

ca_fdValidateCC(credit card number, credit card type)

Valida o formato de número de cartão de crédito digitado pelo usuário em um formulário que você criou, como explicado em Como validar a entrada do usuário.

ca_fdShowField(formId, _id)

Localiza o campo com a _id indicada com _id=formId e o torna visível se já não estiver visível.

ca_fdHideField(formId, _id)

Localiza o campo com a _id indicada e o torna invisível se estiver visível no momento.

ca_fdDisableField(formId, _id)

Localiza o campo com a _id indicada e o desativa.

ca_fdEnableField(formId, _id)

Localiza o campo com a _id indicada e o ativa.

ca_fdSelectOption(formId, _id, name, value)

Seleciona a opção com o nome e o valor especificados no campo de seleção com o atributo _id correspondente.

ca_fdSelectOptionByIndex(formId, _id, index)

Seleciona a opção do índice correspondente no campo de seleção com o atributo _id correspondente.

ca_fdUnselectOption(formId, _id, name, value)

Desmarca a opção com o nome e o valor especificados no campo de seleção com o atributo _id correspondente.

ca_fdUnselectOptionByIndex(formId, _id, index)

Desmarca a opção do índice correspondente no campo de seleção com o atributo _id correspondente.

ca_fdGetSelectedOptions(formId, _id)

Retorna a matriz de números inteiros que indica os índices de opções selecionadas.

ca_fdGetSelectedOptionValues (formId, _id)

Retorna uma matriz de sequências de caracteres que indicam os valores das opções selecionadas. Selecione o primeiro valor da opção da seguinte maneira:

ca_fdGetSelectedOptionValues(formId, _id)[0]

Selecione o segundo valor da opção, alterando de 0 para 1; selecione o terceiro valor da opção alterando de 1 para 2 e assim por diante.

Essa função é especialmente útil para usar a entrada do usuário para preencher previamente uma caixa de seleção.

ca_fdSelectRadio(formId, name, _id)

Seleciona o botão de opção com _id correspondente no grupo de botões de opção com atributo de nome correspondente.

ca_fdIsSelectRadio (formId, name, _id)

Retorna se o botão de opção indicado está selecionado.

ca_fdSelectCheckBox(formId,_id)

Seleciona a caixa de seleção com atributo _id correspondente.

ca_fdUnselectCheckBox(formId, _id)

Desmarca a caixa de seleção com atributo _id correspondente.

ca_fdIsSelectedCheckBox(formId,_id)

Retorna se a caixa de seleção está selecionada.

ca_fdSetDateFieldValue(formId, _id, date) e funções relacionadas

Define o valor do campo de data especificado com o atributo _id correspondente. Essa função pode adotar valores inteiros Null, String ou Long para o parâmetro denominado date.

Para limpar o valor do campo, use a sequência de caracteres vazia e nula.

Especifique sequências de caracteres não vazias no formato especificado para o campo Data e hora (um elemento do formulário) da seguinte maneira:

Em ambos os casos, separe várias sequências de caracteres com um espaço.

As funções JavaScript relacionadas para definir a data são mostradas a seguir. O texto anterior para a função ca_fdSetDateFieldValue(formId, _id, date) também se aplica a essas funções.

Além disso, para todas as funções JavaScript ca_fdSetDateField*, você pode definir a data no número de milésimos de segundo desde a "hora de referência" ou uma hora base padrão de meia-noite (00:00:00) GMT, em 1 de janeiro de 1970. Para obter detalhes sobre como definir a data dessa maneira, consulte a referência de programação Java padrão, por exemplo, o site da Oracle, oracle.com.

ca_fdGetDateFieldValue(formId, _id, date) e funções relacionadas

Obtém o valor do campo de data especificado como uma sequência de caracteres formatada de acordo com a formatação especificada para o campo de data.

As informações sobre o campo Data e hora da função anterior (ca_fdSetDateFieldValue(formId, _id, date)) também se aplicam a esta função.

As funções JavaScript relacionadas para definir a data são as seguintes. O texto anterior para a função ca_fdGetDateFieldValue(formId, _id, date) também se aplica a essas funções.

Além disso, para todas as funções JavaScript ca_fdGetDateField*, você pode obter a data no número de milésimos de segundo desde a "hora de referência" ou uma hora base padrão de meia-noite (00:00:00) GMT, em 1 de janeiro de 1970. Para obter detalhes sobre como obter a data dessa maneira, consulte a referência de programação Java padrão, por exemplo, o site da Oracle, oracle.com.

ca_fdSetTextFieldValue(formId, _id, text)

Define o texto do campo de texto com atributo _id correspondente, que pode ser campo de texto e área de texto.

ca_fdGetTextFieldValue(formId, _id)

Obtém o texto do campo de texto com atributo _id correspondente, que pode ser campo de texto e área de texto.

ca_fdFetchSelectData(formId,_id)

Faz com que a caixa de seleção com o parâmetro _id especificado busque o objeto de dados do relatório novamente. Essa função é especialmente útil quando o objeto de dados do relatório usa a entrada do usuário. Como uma prática recomendada, execute essa função quando tal entrada for alterada, para certificar-se de que a caixa de seleção exibe os dados corretos.

Essa função é especialmente útil para usar a entrada do usuário para preencher previamente uma caixa de seleção.

As funções a seguir são somente para formulários de sistema: