Formulários › Criador de formulários › Funções de elemento do formulário › Elementos do formulário › Origem dos dados › ca_pam_getDatasetData(dataSetExpression,callBack)

ca_pam_getDatasetData(dataSetExpression,callBack)

Recupera o valor de uma variável a partir de um conjunto de dados do CA Process Automation.

Observação: nas releases do CA Process Automation antes de 04.1.00, este método era chamado ca_pam_getDataFromDatasetQuery.

Parâmetros de entrada

datasetExpression (string)

Define uma sequência de caracteres, expressão ou chamada de função que resulta em um caminho absoluto para um conjunto de dados. Este parâmetro inclui a palavra-chave Conjuntos de dados, o caminho da biblioteca para um objeto do conjunto de dados e o nome da variável de matriz ValueMap.

Datasets["/BR412-DATA-FOLDER-20111214/Folder_FORMS_20120328/dataset_forms_demo/My_Dataset55"].MyVal

callBack (object)

Define uma referência para o objeto de função a ser chamada após a recuperação dos dados, incluindo seus métodos onSuccess e onFailure.

Valor de retorno

Quando a função recupera os dados, a função onSuccess(result) ou onFailure(caught) callBack é executada. A própria função não retorna qualquer valor.

Exemplo

ca_pam_getDatasetData(ca_pam_getTextFieldValue('Form.TxtFieldWithDatasetPath'),callBack)

O código de exemplo contém as seguintes informações:

• O campo de texto TxtFieldWithDatasetPath armazena a expressão do conjunto de dados.
• A função getTextFieldValue obtém o valor da expressão de conjunto de dados.
• A função getDataUsingDatasetExpression obtém os valores do conjunto de dados e chama a função callBack para determinar o que acontecerá em seguida.
• Para continuar com este exemplo, é possível usar as seguintes funções na declaração callBack.onSuccess para aplicar os dados em uma tabela ou em um campo de pesquisa, respectivamente:

  ca_pam_setTableData('Form.employeeList',result);
  ca_pam_showDataInTable(result,'Form.Results','Dataset results');