Bookshelf Home | Contents | Index | PDF |
Oracle Web Services On Demand Guide > Best Practices for Designing Client Application > Best Practices for Integration Design > Entering Telephone Number Values through Web ServicesTelephone number values entered through Web service requests and the Oracle CRM On Demand UI are displayed differently both in the UI and in the response to the QueryPage operation. Table 14 shows how telephone number values are displayed in the UI or within the response to a QueryPage request. Telephone number values differ from other values in that the format of the value impacts the accuracy of the value. When querying for a telephone number value, it is necessary to return the value with formatting. Recommended Formats for Telephone NumbersWhen determining the value to be input through Web Services you must take into account how the telephone number will appear in the UI and in the Web service response. The following formats are recommended for telephone numbers entered through the UI or Web services, as they are formatted the same way in the UI and in Web service responses: The following is an example of a request that uses one of the above formats to insert a Contact with telephone number fields. <ContactFirstName>Contact</ContactFirstName> <ContactLastName>Name</ContactLastName> <WorkPhone>1 (404) 555-0199 #123</WorkPhone> <PHONE_000>1 (404) 555-0199 #123</PHONE_000> The following is the query response: <ListOfContact xmlns="urn:/crmondemand/xml/Contact/Data" lastpage="true"> <ContactFirstName>qq2</ContactFirstName> <ContactLastName>ww2</ContactLastName> <WorkPhone>1 (404) 555-0199 #123</WorkPhone> <PHONE_000>1 (404) 555-0199 #123</PHONE_000> Other Considerations for Telephone NumbersIf you use the + character and parentheses () characters together in a Web services request, the number is displayed differently in the UI and Web service response. For example, the input: is displayed as the following in the Web service response: and as the following in the UI: It is not possible to modify the telephone number in the UI to display a + prefix for a telephone number, or to remove the parentheses () from a telephone number using Web services. For example, the input: is displayed as the following in the Web service response: and as the following in the UI: There are locale considerations when entering telephone numbers. As an example, if the user locale is set to Australia (country code +61) and a Web service request contains the 10 digit telephone number: as the number displayed defaults to the North American Numbering Plan if the country code is not included. In this case, the user locale (Australia) is not considered. If you enter the same telephone number ( where the country code is set to Australia. To make the behavior consistent across Web service requests and the UI, it is recommended that in Web service requests you prefix the number with the + character and country code. For the previous example, the telephone number in the Web service request would be: Telephone numbers submitted through Web service requests must not begin with an alphabetic character and must either begin with a numeric value or a + character. For example, updating a telephone number field with the value |
Oracle Web Services On Demand Guide, Version 20.0 (Oracle CRM On Demand Release 32) | Copyright © 2016, Oracle and/or its affiliates. All rights reserved. Legal Notices. | |