Database.com Metadata API Developer's Guide - Salesforce.com
Database.com Metadata API Developer's Guide - Salesforce.com
Database.com Metadata API Developer's Guide - Salesforce.com
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
Understanding <strong>Metadata</strong> <strong>API</strong>Development PlatformsDevelopment Platforms<strong>Metadata</strong> <strong>API</strong> supports both file-based and CRUD-based development.File-Based DevelopmentThe declarative or file-based asynchronous <strong>Metadata</strong> <strong>API</strong> deploy() and retrieve() calls deploy or retrieve a .zip filethat holds <strong>com</strong>ponents in a set of folders, and a manifest file named package.xml. For more information, see Deployingand Retrieving <strong>Metadata</strong> on page 14. The easiest way to access the file-based functionality is to use the Force.<strong>com</strong> IDE orForce.<strong>com</strong> Migration Tool.CRUD-Based DevelopmentThe CRUD-based <strong>Metadata</strong> <strong>API</strong> calls act upon the metadata <strong>com</strong>ponents in a manner similar to the way synchronous <strong>API</strong>calls in the enterprise WSDL act upon objects. For more information about the enterprise WSDL, see the SOAP <strong>API</strong> <strong>Developer's</strong><strong>Guide</strong>.Use the asynchronous create(), update(), and delete() calls with the utility call checkStatus(). For more information,see CRUD-Based <strong>Metadata</strong> Development.Alternatively, you can use the synchronous equivalents of these calls that are listed in CRUD-based <strong>Metadata</strong> <strong>API</strong> calls, suchas create<strong>Metadata</strong>().Standards Compliance<strong>Metadata</strong> <strong>API</strong> is implemented to <strong>com</strong>ply with the following specifications:Standard NameSimple Object Access Protocol (SOAP)1.1Web Service Description Language(WSDL) 1.1WS-I Basic Profile 1.1Websitehttp://www.w3.org/TR/2000/NOTE-SOAP-20000508/http://www.w3.org/TR/2001/NOTE-wsdl-20010315http://www.ws-i.org/Profiles/BasicProfile-1.1-2004-08-24.html<strong>Metadata</strong> <strong>API</strong> Support Policy<strong>Salesforce</strong>.<strong>com</strong> supports previous versions of <strong>Metadata</strong> <strong>API</strong>. However, your new client applications should use the most recentversion of the Force.<strong>com</strong> <strong>Metadata</strong> <strong>API</strong> WSDL file to fully exploit the benefits of richer features and greater efficiency.Backward Compatibility<strong>Salesforce</strong>.<strong>com</strong> strives to make backward <strong>com</strong>patibility easy when using the Force.<strong>com</strong> platform.Each new <strong>Database</strong>.<strong>com</strong> release consists of two <strong>com</strong>ponents:• A new release of platform software that resides on salesforce.<strong>com</strong> systems• A new version of the <strong>API</strong>For example, the Spring '07 release included <strong>API</strong> version 9.0 and the Summer '07 release included <strong>API</strong> version 10.0.3
Change language