getStringValues (DOMElement - JavaScript)

Gets the string values of the data elements that match an XPath.

Defined in

DOMElement

Syntax

getStringValues(xpath:string) : string[]

getStringValues(xpath:string, selectionNS:NamespaceContext) : string[]

Parameters Description
xpath The XPath of elements associated with the document.
selectionNS A namespace context.
Return value Description
string[] The data values of the elements.

Usage

This method is equivalent to getStringValues in DOMDocument.

In a schema, these data elements should be defined as string. In the data properties, the display type of a bound field should be String.

If the XPath includes namespace prefixes, either:

Examples

(1) This example is for the onclick event of a button. It gets elements from the document specified by an index. The requestScope variables are bound to edit boxes on the page so the user specifies i before clicking the button, and gets back y or msg.
var dc = database.getAllDocuments();
if(dc.getDocumentCount() > 0) {
	if(requestScope.i != null &&
	requestScope.i >= 0 && 
	requestScope.i < dc.getDocumentCount()) {
		var ar = dc.getDocumentArray(requestScope.i + 1);
		var doc = ar[i];
		var elem = doc.getDocumentElement();
		requestScope.y = elem.getStringValues("/schema0/element0").join(", ");
	} else {
		requestScope.msg = "No such document";
	}
} else {
	requestScope.msg = "No documents in database";
}
(2) This example is for the onclick event of a button. It gets elements from the document specified by an index using namespaces. The requestScope variables are bound to edit boxes on the page so the user specifies i before clicking the button, and gets back y or msg.
var dc = database.getAllDocuments();
if(dc.getDocumentCount() > 0) {
	if(requestScope.i != null &&
	requestScope.i >= 0 && 
	requestScope.i < dc.getDocumentCount()) {
		var ns = new NamespaceContextImpl();
		ns.addNamespace("p", "http://mynamespace.com");
		var ar = dc.getDocumentArray(requestScope.i + 1);
		var doc = ar[i];
		var elem = doc.getDocumentElement();
		requestScope.y = elem.getStringValues("/p:schema0/p:element0", ns).join(", ");
		
	} else {
		requestScope.msg = "No such document";
	}
} else {
	requestScope.msg = "No documents in database";
}