Bookshelf Home | Contents | Index | PDF |
Oracle Web Services On Demand Guide > Overview of Web Services On Demand > Field Types Supported by Oracle CRM On Demand > Mapping Primary Address Fields Using Web ServicesIn Web services requests, a PrimaryAddressLine1 field is used to dynamically map the primary address field from an external application to the primary address field in Oracle CRM On Demand. The primary address field in Oracle CRM On Demand can vary depending on the Country value for each address; thus the PrimaryAddressLine1 field will map to a different field in the address object based on the Country value. Table 6 and Table 7 show the mapping for the PrimaryAddressLine1 field depending on the selected Country value. NOTE: The actual name of the PrimaryAddressLine1 fields varies with the record type as shown in Objects Supporting the PrimaryAddressLine1 Field.
Querying for an Address Record using PrimaryAddressLine1When using the PrimaryAddressLine1 field to query for an address record, the value returned is the value contained in the mapped field for the specified country. For example, when querying for an address with <Country>Canada</Country>, the PrimaryAddressLine1 field is mapped to the Address field: <?xml version="1.0" encoding="UTF-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <SOAP-ENV:Body><ns:AccountQueryPage_Output xmlns:ns="urn:crmondemand/ws/ecbs/account/"> <ListOfAccount xmlns="urn:/crmondemand/xml/Account/Data" lastpage="true"> <AccountName>ACCOUNTTEST1</AccountName> <ListOfAddress lastpage="true"> <StreetAddress3></StreetAddress3> <IntegrationId>1QA2-R7C3O</IntegrationId> <Address>100 Main Street</Address> <StreetAddress2></StreetAddress2> <PrimaryAddressLine1>100 Main Street</PrimaryAddressLine1> whereas, when the <Country> value is Togo, the PrimaryAddressLine1 field maps to the County field: <?xml version="1.0" encoding="UTF-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <SOAP-ENV:Body><ns:AccountQueryPage_Output xmlns:ns="urn:crmondemand/ws/ecbs/account/"> <ListOfAccount xmlns="urn:/crmondemand/xml/Account/Data" lastpage="true"> <AccountName>ACCOUNTTEST2</AccountName> <ListOfAddress lastpage="true"> <StreetAddress3></StreetAddress3> <IntegrationId>1QA2-R7IMS</IntegrationId> <StreetAddress2></StreetAddress2> <PrimaryAddressLine1>10222</PrimaryAddressLine1> Inserting or Updating an Address Record using PrimaryAddressLine1When inserting or updating an address record using the PrimaryAddressLine1 field, the value provided in the PrimaryAddressLine1 field is written to the primary address field based on the Country value provided in the request. If a value is provided for both the PrimaryAddressLine1 field and the primary address field (for example, County) for the specified country, the value in the PrimaryAddressLine1 field is respected and the value in the primary address field is ignored. This is shown in Table 8.
In the case where only a PrimaryAddressLine1 value is submitted, this value is written to the mapped field in the DB as shown in Table 9.
Objects Supporting the PrimaryAddressLine1 FieldThe PrimaryAddressLine1 field is available on a number of objects accessible through the Web Services v2.0 interface as shown in Table 10 and Table 11.
|
Oracle Web Services On Demand Guide, Version 21.0 (Oracle CRM On Demand Release 33) | Copyright © 2016, Oracle and/or its affiliates. All rights reserved. Legal Notices. | |