Bookshelf Home | Contents | Index | PDF |
Oracle Web Services On Demand Guide > Web Services On Demand API Calls > Service API Calls > UpdatePicklistUpdates picklist values in Oracle CRM On Demand. Objects SupportedUpdatePicklist is supported for the same objects as supported by the GetPicklistValues method, see GetPicklistValues. UsageYou use the UpdatePicklist method to update lists of values, typically in a language-dependent manner. The ListOfPicklistValues argument contains a sequence of PicklistValues elements, each of which has the following child elements:
If the CreateNew argument is set to Y, new picklist values are created with the specified values. If the CreateNew argument is set to Y, new picklist values are created with the specified values from DisplayValue and Order, which are required values. If the CreateNew argument is set to N, existing picklist values are updated with the specified values from DisplayValue or Code, as long as these values are valid. You cannot use the UpdatePicklist method to create custom picklists or multi-select picklists. You must create new picklist fields through the Oracle CRM On Demand application UI. You cannot update read-only picklist fields. ArgumentsTable 64 describes the arguments taken by the UpdatePicklist method. Return Value of the CallReturns a status string indicating the success or otherwise of the call. Sample SOAP Requests and ResponsesThis topic contains sample SOAP requests that invoke UpdatePicklist. Sample SOAP Request 1 - UpdatePicklist: Create a New Picklist ValueThe following SOAP request creates a new picklist value for the CallFrequency picklist of the account record type. NOTE: When you create new picklist values, the <Code> element is not taken into consideration, and the LIC will be equal to the <DisplayValue> value. <?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> <PicklistWS_UpdatePicklist_Input xmlns="urn:crmondemand/ws/picklist/"> <RecordType>Account</RecordType> <FieldName>CallFrequency</FieldName> <DisplayValue>BiYearly_v</DisplayValue> <NeedTranslate>N</NeedTranslate> </PicklistWS_UpdatePicklist_Input> Sample SOAP Request 2 - UpdatePicklist: Update an Existing Picklist ValueThe following SOAP request updates an existing picklist value for the CallFrequency picklist of the account record type. The picklist value is updated in the user's default language: <?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> <PicklistWS_UpdatePicklist_Input xmlns="urn:crmondemand/ws/picklist/"> <RecordType>Account</RecordType> <FieldName>CallFrequency</FieldName> <DisplayValue>BiYearly</DisplayValue> </PicklistWS_UpdatePicklist_Input> Sample SOAP Request 3 - UpdatePicklist with LanguageCodeThe following SOAP request updates an existing picklist value for the CallFrequency picklist of the account record type. The picklist value is updated in French according to the <LanguageCode> value specified in the request: <?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> <PicklistWS_UpdatePicklist_Input xmlns="urn:crmondemand/ws/picklist/"> <RecordType>Account</RecordType> <FieldName>CallFrequency</FieldName> <LanguageCode>FRA</LanguageCode> <DisplayValue>BiYearly_FRA</DisplayValue> <NeedTranslate>N</NeedTranslate> </PicklistWS_UpdatePicklist_Input> Sample SOAP RequestsThe response is the same for each of the three sample SOAP requests: <?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:PicklistWS_UpdatePicklist_Output xmlns:ns="urn:crmondemand/ws/picklist/"> |
Oracle Web Services On Demand Guide, Version 26.0 (Oracle CRM On Demand Release 38) | Copyright © 2019, Oracle and/or its affiliates. All rights reserved. Legal Notices. | |