Home » API » scrapeableFile

extractOneValue

scrapeableFile.extractOneValue( String text, String name ) (professional and enterprise editions only)
scrapeableFile.extractOneValue( String text, String name, String token ) (professional and enterprise edition version 4.0.20a and above only)
Description
This method is similar to extractData except that it assumes only a single string will be returned. When the first method is invoked the first column in the first row of the resulting DataSet object will be returned and when the second method is invoked the column named token in the first row of the resulting DataSet object will be returned. The text parameter should be a string containing the HTML you'd like to extract information from. The name parameter should be the name of an extractor pattern associated with the current scrapeable file. The token parameter should be the name of the token in the extractor pattern from name.
Example
// Applies the extractor pattern "PRODUCT_NAME" to the data found in
// the variable productDescriptionText. The extracted string is
// stored in the productName variable.
// Returns the value found in the first token found in the extractor pattern
// or null if no token is found.
productName = scrapeableFile.extractOneValue( productDescriptionText, "PRODUCT_NAME" );
Example
// Applies the extractor pattern "PRODUCT_NAME" to the data found in
// the variable productDescriptionText. The extracted string is
// stored in the productName variable.
// Returns the value found in the token "NAME" found in the extractor pattern
// or null if no token is found.
productName = scrapeableFile.extractOneValue( productDescriptionText, "PRODUCT_NAME", "NAME" );