Difference between revisions of "Java API"

From LongJump Support Wiki
imported>Aeric
imported>Aeric
 
(34 intermediate revisions by the same user not shown)
Line 14: Line 14:
::* [[Java API Cheatsheet]]
::* [[Java API Cheatsheet]]
::* [[Developer_Suite#Java_Code|Java Code in the Developer Suite]]
::* [[Developer_Suite#Java_Code|Java Code in the Developer Suite]]
::* Java API [{{DOCHOST}}/javadocs javadocs]


:''Learn more about web services and programming:''
:''Learn more about web services and programming:''
Line 36: Line 37:
* [[Java API:Record_Handling#searchRecords|<tt>searchRecords</tt>]]
* [[Java API:Record_Handling#searchRecords|<tt>searchRecords</tt>]]
* [[Java API:Record_Handling#replaceTemplateVariables|<tt>replaceTemplateVariables</tt>]]
* [[Java API:Record_Handling#replaceTemplateVariables|<tt>replaceTemplateVariables</tt>]]
* [[Java API:Record_Handling#execSQL|<tt>execSQL</tt>]]


|-
|-
Line 52: Line 54:
* [[Java API:Record_Handling#getWorkflowActionList|<tt>getWorkflowActionList</tt>]]
* [[Java API:Record_Handling#getWorkflowActionList|<tt>getWorkflowActionList</tt>]]
* [[Java API:Record_Handling#getWFOwners|<tt>getWFOwners</tt>]]
* [[Java API:Record_Handling#getWFOwners|<tt>getWFOwners</tt>]]
|-id="relay"
|[[Relay]]
To do social networking.
|
* Groups
** [[Java_API:Relay#getSocialGroup|<tt>getSocialGroup</tt>]]
** [[Java_API:Relay#addSocialGroup|<tt>addSocialGroup</tt>]]
** [[Java_API:Relay#updateSocialGroup|<tt>updateSocialGroup</tt>]]
** [[Java_API:Relay#deleteSocialGroup|<tt>deleteSocialGroup</tt>]]
** [[Java_API:Relay#searchSocialGroups|<tt>searchSocialGroups</tt>]]
* Messages
** [[Java_API:Relay#addSocialFeed|<tt>addSocialFeed</tt>]] (post a msg)
** [[Java_API:Relay#getSocialFeed|<tt>getSocialFeed</tt>]] (get msg)
** [[Java_API:Relay#deleteSocialFeed|<tt>deleteSocialFeed</tt>]] (delete msg)
** [[Java_API:Relay#searchSocialFeeds|<tt>searchSocialFeeds</tt>]] (search msgs)
* Message Voting
** [[Java_API:Relay#getSocialVotes|<tt>getSocialVotes</tt>]]
** [[Java_API:Relay#socialVote|<tt>socialVote</tt>]]
* Following Feeds
** [[Java_API:Relay#socialFollow|<tt>socialFollow</tt>]]
** [[Java_API:Relay#socialUnFollow|<tt>socialUnfollow</tt>]]
** [[Java_API:Relay#getSocialFollowers|<tt>getSocialFollowers</tt>]]
** [[Java_API:Relay#getSocialFollowing|<tt>getSocialFollowing</tt>]]
* Notifications
** [[Java_API:Relay#getSocialNotificationsCount|<tt>getSocialNotificationsCount</tt>]] 
** [[Java_API:Relay#getSocialNotificationsList|<tt>getSocialNotificationsList</tt>]] 
** [[Java_API:Relay#setAllSocialNotificationsRead|<tt>setAllSocialNotificationsRead</tt>]] 


|-
|-
Line 79: Line 113:
* [[Java API:Email_and_Document_Management#sendEmail|<tt>sendEmail</tt>]]
* [[Java API:Email_and_Document_Management#sendEmail|<tt>sendEmail</tt>]]
* [[Java API:Email_and_Document_Management#sendEmailUsingTemplate|<tt>sendEmailUsingTemplate</tt>]]
* [[Java API:Email_and_Document_Management#sendEmailUsingTemplate|<tt>sendEmailUsingTemplate</tt>]]
<hr>
* [[Java API:Email_and_Document_Management#generateDocument|<tt>generateDocument</tt>]]
* [[Java API:Email_and_Document_Management#generateDocument|<tt>generateDocument</tt>]]
* [[Java_API_Cheatsheet#getDocument|<tt>getDocument("id")</tt>]]
* [[Java_API_Cheatsheet#getDocumentByTitle|<tt>getDocumentByTitle("title")</tt>]]
<hr>
* [[Java_API_Cheatsheet#Email_Handler_APIs|<tt>EmailHandler</tt> APIs]]
|-
|-
|[[Java_API:Event_and_Task_Management|Event and Task Management]]
|[[Java_API:Event_and_Task_Management|Event and Task Management]]
Line 96: Line 136:
|
|
*[[Java_API:Transaction_Management#addSavePoint|<tt>addSavePoint</tt>]]
*[[Java_API:Transaction_Management#addSavePoint|<tt>addSavePoint</tt>]]
*[[Java_API:Transaction_Management#rollbackToSavePoint|<tt>rollbackToSavePoint</tt>]]
*[[Java_API:Transaction_Management#doesSavePointExist|<tt>doesSavePointExist</tt>]]
*[[Java_API:Transaction_Management#doesSavePointExist|<tt>doesSavePointExist</tt>]]
*[[Java_API:Transaction_Management#getAllSavePoints|<tt>getAllSavePoints</tt>]]
*[[Java_API:Transaction_Management#rollback|<tt>rollback</tt>]]
*[[Java_API:Transaction_Management#rollback|<tt>rollback</tt>]]
*[[Java_API:Transaction_Management#rollbackToSavePoint|<tt>rollbackToSavePoint</tt>]]
*[[Java_API:Transaction_Management#removeSavePoint|<tt>removeSavePoint</tt>]]
*[[Java_API:Transaction_Management#removeSavePoint|<tt>removeSavePoint</tt>]]
*[[Java_API:Transaction_Management#getAllSavePoints|<tt>getAllSavePoints</tt>]]
|-
|-
|[[Java_API:Support_Classes_and_Objects|Support Classes and Objects]]  
|[[Java_API:Support_Classes_and_Objects|Support Classes and Objects]]  
Use these support classes and objects when you work with the Java API
Use these support classes and objects when you work with the Java API
|
|
* [{{DOCHOST}}/javadocs/com/platform/api/Functions.html Functions] class
* [[Java_API:Support_Classes_and_Objects#HttpConnection_Class|<tt>HttpConnection</tt> class]]
* [[Java_API:Support_Classes_and_Objects#HttpConnection_Class|<tt>HttpConnection</tt> class]]
* [[Java_API:Support_Classes_and_Objects#Parameters_Class|<tt>Parameters</tt> class]]
* [[Java_API:Support_Classes_and_Objects#Parameters_Class|<tt>Parameters</tt> class]]
Line 111: Line 152:
* [[Java_API:Support_Classes_and_Objects#SearchContext_Class|<tt>SearchContext</tt> class]]
* [[Java_API:Support_Classes_and_Objects#SearchContext_Class|<tt>SearchContext</tt> class]]
<hr>
<hr>
* [[Java_API:Support_Classes_and_Objects#functionParams_Object|<tt>functionParams</tt> object]]
* [[Java_API:Support_Classes_and_Objects#request_Object|<tt>request</tt> object]] - [[Page]]
* [[Java_API:Support_Classes_and_Objects#request_Object|<tt>request</tt> object]] - [[Page]]
* [[Java_API:Support_Classes_and_Objects#requestParams_Object|<tt>requestParams</tt> object]] - [[Data Policies|Data Policy]]
* [[Java_API:Support_Classes_and_Objects#requestParams_Object|<tt>requestParams</tt> object]] - [[Data Policies|Data Policy]]
* [[Java_API:Support_Classes_and_Objects#TenantContext_Object|<tt>TenantContext Object</tt>]]
* [[Java_API:Support_Classes_and_Objects#TenantContext_Object|<tt>TenantContext Object</tt>]]
|-
|-
|[[Java API:Utility|Utility]]
|[[Java API:Utility|Utility]]
Provides APIs to perform general-purpose operations
Provides APIs to perform general-purpose operations
|
|
* [[Java_API:Utility#debug|<tt>debug</tt>]]
* [[Java_API:Utility#debug|<tt>debug</tt>]] - <span style="color:red;">'''''Deprecated'''''</span><br>Use Logger class. (See [[Debug Log]])
* [[Java_API:Utility#exec|<tt>exec</tt>]]
* [[Java_API:Utility#getEnv|<tt>getEnv</tt>]]
* [[Java_API:Utility#getEnv|<tt>getEnv</tt>]]
* [[Java_API:Utility#getParametersInstance|<tt>getParametersInstance</tt>]]
* [[Java_API:Utility#getParametersInstance|<tt>getParametersInstance</tt>]]
Line 127: Line 167:
* [[Java_API:Utility#getLoggedInUserInfo|<tt>getLoggedInUserInfo</tt>]]
* [[Java_API:Utility#getLoggedInUserInfo|<tt>getLoggedInUserInfo</tt>]]
* [[Java_API:Utility#setTargetPage |<tt>setTargetPage </tt>]]
* [[Java_API:Utility#setTargetPage |<tt>setTargetPage </tt>]]
* [[Java_API:Utility#showMessage |<tt>showMessage </tt>]]
* [[Java_API:Utility#showMessage |<tt>showMessage</tt>]]
* [[Java_API:Utility#sleep |<tt>sleep</tt>]]
* [[Java_API:Utility#throwError|<tt>throwError</tt>]]
* [[Java_API:Utility#throwError|<tt>throwError</tt>]]
* [[Java_API:Utility#translateToken|<tt>translateToken</tt>]]
* [[Java_API:Utility#translateToken|<tt>translateToken</tt>]]
|-
<hr>
|'''GUI'''
* [{{DOCHOST}}/javadocs/com/platform/api/utility/ServiceConfiguration.html#getServiceName() <tt>getServiceName</tt>]
APIs for GUI components
* [{{DOCHOST}}/javadocs/com/platform/api/utility/ServiceConfiguration.html#getServiceDomainURL() <tt>getServiceDomainURL</tt>]
|
*[[Java_API:Enumerated_Fields|Enumerated Fields]]
**[[Java_API:Enumerated_Fields#Retrieving_Field_Metadata|Retrieving Field Metadata]]  
**[[Java_API:Enumerated_Fields#Adding_a_Picklist|Adding a Picklist]]
**[[Java_API:Enumerated_Fields#Updating_a_Picklist|Updating a Picklist]]
**[[Java_API:Enumerated_Fields#Define_Mapping_for_a_Dependent_Picklist|Define Mapping for a Dependent Picklist]]
*[[Java_API:Global_Picklists|Global Picklists]]
**[[Java_API:Global_Picklists#|Adding a Global Picklist]]
**[[Java_API:Global_Picklists#|Searching for Global Picklists]]
**[[Java_API:Global_Picklists#|Getting a Global Picklist]]
**[[Java_API:Global_Picklists#|Updating a Global Picklist]]
**[[Java_API:Global_Picklists#|Deleting a Global Picklist]]


|-
|-
Line 151: Line 180:
|
|
*[[Java_API:Customize#Object_Metadata|Object Metadata]]
*[[Java_API:Customize#Object_Metadata|Object Metadata]]
*[[Java_API:Customize#Field_Metadata|Field Metadata]]  
*[[Java_API:Customize#Field_Metadata|Field Metadata]]
*[[Java_API:Customize#Form_Metadata|Form Metadata]]
**[[Java_API:Enumerated_Fields|Enumerated Fields]]
*[[Java_API:Customize#Package_Metadata|Package Metadata]]
**[[Java_API:Global_Picklists|Global Picklists]]
<!--*[[Java_API:Customize#Form_Metadata|Form Metadata]]-->


|-
|-

Latest revision as of 20:20, 25 September 2013

The Java API is a set of built-in calls that are made to programmatically customize and extend the platform.

1 About the Java API

The following platform elements provide the ability to make Java API calls from the user interface (UI):

2 Prerequisites

You must know the Java programming language to make the Java API calls. This includes knowing the basic elements of Java such as conditional structures (if statement), looping structures (while and for loop statements), variable declaration and assignment, use of operators, variable naming conventions, debugging techniques, and so on.

Learn more about the platform:
Learn more about web services and programming:

3 Classes, Objects, and APIs

This table lists the APIs and links to detail pages. For a quick synopsis of syntax, see the Java API Cheatsheet.

Classes, Objects and APIs Detail
Record Handling

To handle records in Objects

Record Handling for Composite Objects

To operate on records in composite Object Relationships

Workflow Record Handling

To manage Workflows

Relay

To do social networking.

Record Handling for Tenant Data Sharing

To handle records in Objects shared using Tenant Data Sharing Policies

Data Import

Import CSV data into Objects

Email and Document Management

Provides APIs to manage Email and Documents



Event and Task Management

Provides APIs to create Appointments, Tasks and to Log Activities

Transaction Management

Provides the ability to Rollback transactions to a SavePoint

Support Classes and Objects

Use these support classes and objects when you work with the Java API


Utility

Provides APIs to perform general-purpose operations


Customize

These Provisional APIs give you the ability to manage metadata for program entities.

Status

API for checking status of scheduled jobs.

4 Identifying Objects and Records

Many of the API record handling calls require an {object} element identifier. To find the Object Type Identifier:


An object type identifier uniquely identifies an object type. It is used to specify object types in APIs.

There are two kinds of type identifiers:

  • objectName: This identifier is a human-readable name for both Built-in or CRM objects and Custom Objects.
  • objectID: This identifier is a human-readable name for Built-in or CRM objects (e.g. CASE), but for Custom Objects, it is a computer-generated string with no humanly-interpretable semantic value (e.g. 123qwe456rty).
See also:

4.1 Find the Object Type Identifier

To find the object type identifier for an object:

  1. Click Designer > Objects > {object}
  2. The Object Name is displayed at the top of the page.
    (To see the object ID, click the section-expansion (triangle) icon next to it. Sections-expand.gif)

Notepad.png

Note: The Object Name is typically used as the identifier, because it is human-readable for both Built-in or CRM objects and Custom Objects. Object ID can be used, as well, but it is only human-readable for Built-in or CRM objects.


5 Java API Library Reference

This section has moved to the Java API Cheatsheet.
(Please adjust your bookmarks!)