Java API

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):

• Standard Java classes, to create custom business logic that models your organization's environment
• JSP Pages, which can invoke Java APIs

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:

• Getting Started with the Java API
• Java API Cheatsheet
• System Object Types
• Java Code in the Developer Suite
• Java API javadocs

Learn more about web services and programming:

• Java Programming Language
• Java Tutorial

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.

3.1 Record Handling

3.1.1 Objects

Handle records in standard Objects:

• addRecord
• updateRecord
• changeOwnerShipInfo
• deleteRecord
• getRecord
• getRecordCount
• searchRecords
• replaceTemplateVariables
• execSQL

Learn more: Java_API:Record_Handling

3.1.2 Composite Objects

Operate on records in Composite Objects:

• getRecordCount
• getRecord
• searchRecords

Learn more: Working with Composite Objects

3.1.3 Tenant Data Sharing

Handle records in Objects shared using Tenant Data Sharing Policies:

• addRecord
• updateRecord
• deleteRecord
• searchRecords
• getRecord

Learn more: Tenant_Data_Sharing_Policies#Using the JAVA API to Access Shared Data

3.1.4 Data Import

Import CSV data into Objects

• getMappingProfiles
• importData

Learn more: Java_API:Data Import

3.2 Relay

To do social networking.

• Groups

  • getSocialGroup
  • addSocialGroup
  • updateSocialGroup
  • deleteSocialGroup
  • searchSocialGroups

• Messages

  • addSocialFeed (post a msg)
  • getSocialFeed (get msg)
  • deleteSocialFeed (delete msg)
  • searchSocialFeeds (search msgs)

• Message Voting

  • getSocialVotes
  • socialVote

• Following Feeds

  • socialFollow
  • socialUnfollow
  • getSocialFollowers
  • getSocialFollowing

• Notifications

  • getSocialNotificationsCount
  • getSocialNotificationsList
  • setAllSocialNotificationsRead

3.3 Email

• sendEmail
• sendEmailUsingTemplate

Learn more:

• Java_API:Email_and_Document_Management

3.4 Document Management

• generateDocument
• getDocument(id)
• getDocumentByTitle("title")

Learn more:

• Java_API:Email_and_Document_Management

(For document generation. For document access, use the links to the javadocs, above.)

• Java Code Samples#Managing Files

3.5 Transaction Management

Provides the ability to Rollback transactions to a SavePoint

• addSavePoint
• doesSavePointExist
• getAllSavePoints
• rollback
• rollbackToSavePoint
• removeSavePoint

Learn more: Java_API:Transaction_Management

3.6 Support Classes and Objects

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

• Functions class
• Logger class

---

• HttpConnection class
• Parameters class
• ParametersIterator class
• Result class
• SearchContext class

---

• request object - used in Pages
• TenantContext Object

Learn more: Java_API:Support_Classes_and_Objects

3.7 Localization Functions

Use these functions to convert between Database Formats and localized User Formats.

• formatCurrency
• formatNumber
• formatPercent
• parseCurrency
• parseNumber
• parsePercent
• validateCurrency
• validateNumber
• validatePercent

Learn more: Localization

3.8 Utility Functions

Logger functions:

• info
• warn
• error
• fatal

General-purpose operations.

• getEnv
• getParametersInstance
• getTimezonesUtility
• getTimezoneUtility
• getLoggedInUserInfo
• setTargetPage
• showMessage
• sleep
• throwError
• translateToken

---

• getServiceName
• getServiceDomainURL

Learn more: Utility functions

3.9 Customization APIs

Use these Provisional APIs give to manage metadata for program entities.

• Object Metadata
• Field Metadata

  • Enumerated Fields
  • Global Picklists

Learn more: Customize

3.10 Status

Check status of scheduled jobs.

• getStatus

Learn more: getStatus

4 Identifying Objects and Records

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 System Objects and Custom Objects.
• objectID: This identifier is a human-readable name for System Objects (e.g. "cases"), but for Custom Objects, it is a computer-generated string with no humanly-interpretable semantic value (e.g. 123qwe456rty).

See also:

• Session Identifier - session identifier
• Record Id - record id

To find an object type identifier:

1. Click > Customization > Objects
2. In the Display Title column, find the object you're looking for.
3. The Object Name column has the identifier you need.

Alternatively:

1. Go to > Customization > Objects > {object}
2. Click Properties
3. The object name appears at the top of the page

Note: For objects that are not listed, see the System Objects page. The Object Name is typically used as the identifier, because it is human-readable for both System Objects and Custom Objects. Object ID can be used, as well, but it is human-readable only for System Objects.