Bookshelf Home | Contents | Index | PDF |
Oracle Web Services On Demand Guide > Web Services On Demand API Calls > Service API Calls > GetMappingReturns the display names and XML tags of the fields of a record type or one of its child components. Objects SupportedGetMapping is supported for all objects accessible through Web Services V1.0 and Web Services 2.0 and all of their child components. UsageYou use the GetMapping method to return the mapping between the display names of all the fields in a particular record type and the XML tags for each field. If the record type is supported for Web Services v1.0, then the mapping between the display name of the fields and the XML tag name for Web Services v1.0 is returned. This is the case even if the record type is supported for Web Services v2.0 as well. If the record type is only supported for Web Services v2.0, then the mapping between the display name and the XML tag name for Web Services v2.0 is returned. GetMapping returns only the mapping for fields that are exposed for both the UI and Web services. If a field is not exposed in the UI, then it is not returned by GetMapping for the record type. In some cases, the names of objects used in the ObjectName argument differ from the name of the object used in the UI of Oracle CRM On Demand, as shown in Mapping of Display Names to Service API Object Names. The GetMapping method works with all Custom Objects. However, you must use a different naming convention for Custom Objects 1-3, compared to Custom Object 4 and higher, where there are no spaces in the object name. SOAP requests must use the following naming convention for object names:
For some fields, the DisplayName returned has the value ArgumentsTable 51 describes the arguments taken by the GetMapping method.
Return Value of the CallA list of the display names for fields and their associated XML mappings:
Sample SOAP Request - GetMappingThe following SOAP request retrieves the display names and XML element names of the fields of the book record type as specified in the <ObjectName> argument: <?xml version="1.0" encoding="utf-8" standalone="no"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <wsse:Username>%%%USERNAME%%%</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">%%%PASSWORD%%%</wsse:Password> <MappingWS_GetMapping_Input xmlns="urn:crmondemand/ws/mapping/"> Sample SOAP ResponseThe following response contains the mappings for a number of fields for the book object: <?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"> <ns:MappingWS_GetMapping_Output xmlns:ns="urn:crmondemand/ws/mapping/"> <ns:ObjectName>Book</ns:ObjectName> <ListOfField xmlns="urn:/crmondemand/xml/mappingservice"> <DisplayName>Can Contain Data</DisplayName> <ElementName>CanContainDataFlag</ElementName> <ElementName>BookId</ElementName> <DisplayName>Parent Book</DisplayName> <ElementName>ParentBookName</ElementName> <DisplayName>Created</DisplayName> <ElementName>CreatedBy</ElementName> <DataType>Text (Long)</DataType> <DisplayName>Book Type</DisplayName> <ElementName>BookType</ElementName> <DisplayName>Modified: Date</DisplayName> <ElementName>ModifiedDate</ElementName> <DataType>Date/Time</DataType> <DisplayName>Created: Date</DisplayName> <ElementName>CreatedDate</ElementName> <DataType>Date/Time</DataType> <DisplayName>Description</DisplayName> <ElementName>Description</ElementName> <DataType>Text (Long)</DataType> <DisplayName>Book Name</DisplayName> <ElementName>BookName</ElementName> <DataType>Text (Short)</DataType> |
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. | |