getRecordListForTableWithQuery
Retrieve a list of records for a specific item type and use a JSON query to limit the results. A SOAP error envelope is returned if the operation fails.
Parameters
Parameter | Type | Description |
---|---|---|
cookie | long | Session cookie returned by projectLogon. |
tablename | string | Table name to retrieve information from. Valid values: Defect, Test Case, Test Run, Requirement, and Requirement Document. Use getTableList to retrieve a list of available tables. |
filtername | string | Filter name to apply to the results. Set as an empty string to use no filter. Use getFilterListForTable to retrieve a list of filters for the table. Interactive filters are not supported. |
query | string | JSON query string with restrictions to filter the results. See Creating and validating JSON queries for the getRecordListForTableWithQuery operation. |
columnlist | CTableColumn[] | List of columns in the table to retrieve information from. Limits the returned data to specific columns and you can apply a filter. Use the "Record ID" column name (case sensitive) to retrieve the record ID for a list of items. |
Return value
Value | Type |
---|---|
recordlist | CRecordListSoap |
Example
string[] columnNames = {"Number", "Status", "Summary"};
CTableColumn[] columns = new CTableColumn[columnNames.Length];
for (int x = 0; x < columns.Length; x++)
{
columns[x] = new CTableColumn();
columns[x].name = columnNames[x];
}
string query = "{'Type': ['Crash - Data Loss', 'Crash - No Data Loss']}";
CRecordListSoap recList = ttsdk. getRecordListForTableWithQuery(cookie, "Defect", "", query, columns);