- Robust file / Document Management.
- Full Text search, Metadata search or both.
- Workflow Management.
It is good to understand a little about the product before you embark on any programming using that product, so I recommend that you spend sometime using Livelink to get to know how it works and get used to the way in which it does things, this will greatly aid any development that you attempt. Livelink is written in C++ and that is why it is enterprise scalable. It works with any major HTTP (Web) server and any has a choice of databases - including Oracle and SQL server.
OpenText uses an Object Oriented developer paradigm where the complexity of their code is replaced with simple re-usable classes, the most common way to interact with Livelink as a developer is using the Builder or SDK. The language of choice for any major livelink development will probably be OScript at present, although Java (J2EE) is gaining ground as a suitable alternative.
For example, when you issue a login to the Livelink system, it is nothing more than a form submission to a Livelink CGI executable, ISAPI DLL or JSP Container on a HTTP server. Once received by Livelink, the call is transferred to an Object Space called webll and a corresponding request handler called GetLogin. The Livelink server then uses the concept of a "Virtual Machine" - called the Ospace Virtual Machine - and translates the call into commands to other parts of the system and the database.
The SDK / Builder, when installed on a Livelink server provides a way of examining the contents of the system, a limited app server and a debugger. LAPI is merely gives external visibility of the API’s in the code Livelink code. The language that you use to build you LAPI application in could be anything from .Net to Java or even C/C++, as all that changes is the way you connect to the Livelink instance, the functions and their parameters remain constant regardless of language used. Therefore, you don't need to be proficient at OScript to work with Livelink.
To start developing with LAPI, you need a fully working Livelink instance, onto which you have installed the LAPI module and the Livelink Builder, and a database for your Livelink instance to use. If you want to use Java for your LAPI development, you will also need to add the path to the LAPI's bin directory to your classpath.
Now that we are ready to start LAPI development - for which we will be using a text editor - such as NotePad, TextPad or VI. We will create a simple LAPI program in Java, which we will call TestAddDocument.java, which can be found here. Lets go though the code and see what each part does :
import com.opentext.api.*;
public class TestAddDocument
{
private static String Server = "localhost";
private static int Port = 2099;
private static String DFT = "";
private static String User = "Admin";
private static String Pass = "cafadmin";
- The IP address / Name of the server.
- The Port on which the Livelink instance is listening.
- A connection object.
- A User Name with which you want to connect to the specified Livelink instance.
- The Pasword for the provided User Name.
public static void main (String [] args)
{
try
{
//variables
LLSession session;
LAPI_DOCUMENTS doc;
LLValue entInfo= new LLValue();
LLValue objInfo = new LLValue();
LLValue verInfo = new LLValue();
session = new LLSession (Server, Port, DFT, User, Pass);
doc = new LAPI_DOCUMENTS (session);
int volumeID,objectID,objID;
String objName, FilePath;
if(doc.AccessEnterpriseWS(entInfo) != 0)
{
System.out.println("AccessEnterpriseWS Failed.");
return;
}
else
{
volumeID = entInfo.toInteger("VolumeID");
objectID = entInfo.toInteger("ID");
System.out.println("Enterprise Volume"+volumeID+"Enterprise ObjID"+objectID);
}
objID = 41613;
objName = "New Document";
FilePath = "C:\\temp\\AddDocument.java";
if (doc.AddDocument(volumeID, objID, objName, FilePath, objInfo, verInfo) == 0)
{
System.out.println("This version's name is"+verInfo.toString("Name"));
System.out.println("This version's created at "+objInfo.toDate("CreateDate"));
System.out.println("This objects id is"+verInfo.toInteger("NodeID"));
System.out.println("Document Added Successfully");
}
else
{
System.out.println("Failed to Add Document");
//Error Checking
System.out.println("Status Code: " + session.getStatus());
System.out.println("Api Error: " + session.getApiError());
System.out.println("Error Message: " + session.getErrMsg());
System.out.println("Status Message: " + session.getStatusMessage());
}
}
catch (Throwable e)
{
System.err.println(e.getMessage());
e.printStackTrace (System.err);
}
public int AddDocument(
int parentVolID,
int parentID,
String name,
String filePath,
LLValue objectInfo,
LLValue versionInfo
)
}//main ends
}//class ends
