|
AR System Java API | |||||||||
| PREV NEXT | FRAMES NO FRAMES | |||||||||
See:
Description
| Packages | |
|---|---|
| com.bmc.arsys.api | |
The Java API is a collection of classes, interfaces, and relationships that provide full client functionality like the AR System C API in a style consistent with typical Java programming techniques. Like the C API, the Java API is forward and backward compatible with other versions of AR System. See the Integration Guide for information about setting up to use the Java API.
For product related issues or questions, contact Customer Support by e-mail at customer_support@remedy.com.
For questions or comments about this documentation, e-mail us at .
Consistent with object-oriented design, the AR System Java API represents AR System server objects as Java objects. Classes are defined for forms, fields, menus, active link, filter, escalations, and all other objects in an AR System application. Entry objects represent entries (requests) so your Java client can manipulate AR System data as well as definitions.
The following paragraphs summarize the key classes and types of classes in the API. Follow the links for details.
The ARServerUser object represents the connection between your Java client program and the AR System server. It include session information such as user name, password, and server. A typical program starts by creating an ARServerUser object with user name, password, server name, and the like. Using the ARServerUser instance methods, it logs in to the AR System server; creates, gets, searches for, updates, and deletes server objects; and log out. A call to a get method returns a server object, a call to a getList (search) methods return a list of object identities (for example, names for forms or IDs for fields), and a call to a getListObjects method returns a list of objects.
The Java API includes classes for all server objects: Form, Field, View, ActiveLink, Escalation, Filter, Container, Menu, Entry, and SupportFile. The Form, Field, Container, and Menu classes have subclasses to represent specialized types, for example, RegularForm, IntegerField, ApplicationContainer, and SqlMenu.
The ARServerUser create methods create these objects. The get and getListObjects methods return them. Each set method takes a server object parameter that specifies which object the server should update. For example, the ARServerUser method setField takes a Field parameter.
Objects in the AR System Java API are cloneable. The clone() method performs a deep copy of the object. A deep copy is a copy of an object that contains the complete encapsulated data of the original object, allowing it to be used independently of the original Java object. Of course, if the original Java object represents an AR System server object, the clone represent the same object.
Errors are modeled through the ARException class. All error messages that are returned by the server are thrown as an ARException in the Java API.
The following classes are added in release 7.6.03:
The following methods are added in release 7.6.03:
| Method | Description |
void exportDefToFile(List, boolean, String, int, WorkflowLockInfo, String, boolean, int) |
Exports the specified structure from the server to a file in ARSystem def or xml format. |
void exportDefToFile(List<StructItemInfo>, boolean, WorkflowLockInfo, String, boolean, int) |
Exports the specified structure from the server to a file in ARSystem def or xml format. |
void exportDefToFile(List<StructItemInfo>, boolean, String, boolean, int) |
Exports the specified structure from the server to a file in ARSystem def or xml format. |
void exportDefToFile(List<StructItemInfo>, boolean, String, int, WorkflowLockInfo, String, boolean) |
Exports the specified structure from the server to a file in ARSystem def or xml format. |
List<Escalation> getListEscalationObjects(List<String>, long, EscalationCriteria) |
Returns detailed information for all (accessible) Escalation objects that match the given criteria. |
List<View> getListViewObjects(String, long, int[], ViewCriteria) |
Returns the detailed information of all (accessible) View objects that match with the given crteria. |
| ValidateFormCacheInfo getValidateFormCache(String, Timestamp, Timestamp, Timestamp) | The call provides the schema change information that can be used by Java API clients to validate it's local cache for given form. |
Entry setGetEntry(String, String, Entry, Timestamp, int, int[]) |
Updates an the given entry in ARSystem server and fetch the entry back. |
void setMultiLastStatus(List<StatusInfo>, List<StatusInfo>) |
Sets the list of last multi operation status list. |
BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, and logos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are the property of their respective owners.
DB2 is a registered trademark of International Business Machines Corporation.
IBM is a registered trademark of International Business Machines Corporation.
ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.
Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.
Oracle is a registered trademark of Oracle Corporation.
UNIX is a registered trademark of The Open Group.
BMC Software considers information included in this documentation to be proprietary and confidential. Your use of this information is subject to the terms and conditions of the applicable End User License Agreement for the product and the proprietary and restricted rights notices included in this documentation.
|
AR System Java API | |||||||||
| PREV NEXT | FRAMES NO FRAMES | |||||||||