Formulare › Der Formulardesigner › Funktionen der Formularelemente › Formularelemente › Datenquellen › ca_pam_getDatasetData(dataSetExpression,callBack)

ca_pam_getDatasetData(dataSetExpression,callBack)

Ruft den Wert einer Variable aus einem CA Process Automation-Datensatz ab.

Hinweis: In CA Process Automation-Versionen vor 04.1.00 hatte diese Methode die Bezeichnung "ca_pam_getDataFromDatasetQuery".

Eingabeparameter

datasetExpression (string)

Eine Zeichenfolge, ein Ausdruck oder ein Funktionsaufruf, die bzw. der zu einem absoluten Pfad zu einem Datensatz führt. Dieser Parameter enthält das Schlüsselwort "Datensätze", den Bibliothekspfad zu einem Datensatzobjekt und den Variablennamen des ValueMap-Array.

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

callBack (object)

Definiert eine Referenz auf das Funktionsobjekt, das aufgerufen werden soll, nachdem die Daten einschließlich der Methoden "onSuccess" und "onFailure" aufgerufen wurden.

Rückgabewert

Wenn die Funktion die Daten abruft, wird entweder die Funktion "onSuccess(result)" oder "onFailure(caught) callBack" ausgeführt. Die Funktion selbst gibt keinen Wert zurück.

Beispiel

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

Der Beispielcode enthält folgende Informationen:

• Das Textfeld "TxtFieldWithDatasetPath" speichert den Datensatzausdruck.
• Die Funktion "getTextFieldValue" ruft den Wert des Datensatzausdrucks ab.
• Die Funktion "getDataUsingDatasetExpression" ruft die Werte aus dem Datensatz ab, und ruft die Funktion "callBack" ab, um zu bestimmen, was danach geschieht.
• Um mit diesem Beispiel fortzufahren, können Sie die folgenden Funktionen in der Deklaration "callBack.onSuccess" verwenden, um jeweils die Daten auf eine Tabelle oder ein Suchfeld anzuwenden:

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