Bookshelf Home | Contents | Index | PDF |
Oracle CRM On Demand JavaScript API Developer's Guide > JavaScript API Reference > Methods for the Field Object > Getting and Setting Screen ValuesYou can use the getValue() and setValue() methods to get and set values for fields on the current screen. The methods are supported for New and Edit pages, and also for Detail pages (including related information sections) and lists (including related item lists). For information about the getValue() and setValue() methods, see Table 5. Using the setValue() method on Detail pages or List pages is similar to inline editing in the Oracle CRM On Demand UI. When you use the setValue() method for Detail pages and List pages, the value is not set and updated in the database immediately. You must use a commitValues() method to commit the setting of values on Detail or List pages. For information about the commitValues() method, see Table 6 and Table 7. For information about finding the field names that you must use when working with these methods, see Finding Field Names. Limitations When Using the setValue() MethodThe setValue() method is not supported for the following types of field:
If you call setValue() for the above field types, null is returned. Single-association fields and fields such as Sales Stage (on Opportunity) only support setting by row ID on Detail pages. Concatenated fields are not supported, but you can set the values for constituent fields of concatenated fields for both Detail and Edit pages, regardless of whether the fields are on the page layout. For a check box field, only the values Support for Address Fields When Using the setValue() MethodFor addresses on both Edit and Detail pages, you can change the Country field using the setValue() method and at the same time set other fields in the address layout relevant to the new country setting. The field names for address fields have the format: ParentAddressName.ChildAddressName For example, for an Account billing address Country field: Parent Bill To Address.Bill To Country As a code example, you might change the country from Canada to USA, then set the state as follows: oraclecrmod.getField("Parent Bill To Address.Bill To Country").setValue("USA"); oraclecrmod.getField("Parent Bill To Address.Bill To State").setValue("NY"); oraclecrmod.getForm().commitValues(Handler); |
Oracle CRM On Demand JavaScript API Developer's Guide, Release 34 | Copyright © 2017, Oracle and/or its affiliates. All rights reserved. Legal Notices. | |