The EWRead operation returns the encoded data of the specified record. The URL must include the ID of the record being queried.
In place of the usual ID parameter, you can use $searchSQL to identify the record to update, provided that the search returns exactly one record and no more. For example, if you have a unique ext_id field in , you can update a single record that has ext_id='a0B2c345' using &$searchSQL=ext_id='a0B2c345'
in the URL.
Assume an instance of is available on localhost, port 8080 and is called "Demo". The updated record can be seen in the Update example.
The following request is issued:
https://localhost:8080/ewws/EWRead?$KB=Demo&$table=Contacts.Employees&$login=admin&$password=qwerty&$lang=en&id=358 |
The following result will be returned:
EWREST_full_name='John Doe'; EWREST_first_name='John'; EWREST__1576_company_name0='IBM'; EWREST_f_group_0='Service Manager'; EWREST_id='358'; EWREST__106_sw_description='Service Management Team'; EWREST__login='jdoe'; EWREST_date_updated='Dec 27 2017 04:40:24'; EWREST_type='employees'; EWREST_date_created='Dec 27 2017 04:34:38'; EWREST_rep_email='example23@example.com'; EWREST_default_approval_title='Document Approval'; EWREST_last_name='Doe'; |
Here is an example for a JavaScript-based client that invokes the REST interface via AJAX:
function xmlhttpGet (strURL) { var xmlHttpReq=false; var self=this; // Mozilla/Safari if (window.XMLHttpRequest) { try { netscape.security.PrivilegeManager. enablePrivilege("UniversalBrowserRead"); } catch (e) { alert("Permission UniversalBrowserRead denied."); } self.xmlHttpReq=new XMLHttpRequest(); }// IE else if (window.ActiveXObject) { self.xmlHttpReq=new ActiveXObject("Microsoft.xmlHTTP"); } self.xmlHttpReq.open('GET', strURL, true); self.xmlHttpReq.onreadystatechange=requestComplete; self.xmlHttpReq.send(null); } function requestComplete() { if (xmlHttpReq.readyState==4||xmlHttpReq.readyState=="complete") { eval (self.xmlHttpReq.responseText); alert ("Opportunity"+EWREST_opportunity_name_0); } } function main() { xmlhttpGet('https://localhost:8080/ewws/EWRead?$KB=Demo&$table=Contacts.Employees&$login=admin&$password=qwerty&$lang=en&id=358'); } |
Related articles |