How to add a document to Livelink using webservices

RajaneeshJM · Aug 26, 2014

Hi,

I am writing a Java program to add a document to Livelink using webservices. I am using the DocumentManagement webservice. Below is the uploadFile method which accepts DocumentManagement dm as a parameter

private static void uploadFile(DocumentManagement dm, String admToken) {
String name = "TestLivelink.docx";
String comment = "Uploaded through the Web Service";
boolean advancedVersionControl = true;
Metadata metadata = null;
int parentID = 2000;
String contextId;

String filePath = "E:/Livelink/TestUpload/TestLivelink.docx";

try{
File file = new File(filePath);
Attachment atch = new Attachment();
atch.setContents(getByteArray(file));
atch.setFileName(file.getName());
atch.setFileSize(file.getTotalSpace());
atch.setCreatedDate(getXMLGregorianCalendar(new Date(file.lastModified())));
atch.setModifiedDate(getXMLGregorianCalendar(new Date(file.lastModified())));

Node node = dm.createDocument(parentID, name, comment, true, metadata, atch);
System.out.println("node id:"+node.getID());
}catch(Exception e){
System.out.println("Error:"+e.getMessage());
}
}

On execution I encounter the below exception

javax.xml.ws.soap.SOAPFaultException: Error adding version to 'TestRJM.docx'. Error reading data stream from version. [E682033159]

Request you to help me resolve the issue.

Regards
Rajaneesh JM

appnair · Aug 26, 2014

Hi Rajneesh from your posting it is not very clear how the livelink setup is .If you take a step back you should understand that the API (WS) is basically
a conduit into the web application called livelink a.k.a contentserver.So initial trouble shooting should be

1)Is the same file accessible through livelink URL can you add it
2)Can you download SOAPUI and do some simple tests like getting a session
3)is the file large enough so you may have to use a different mechanism(you must have heard MTOM,http ,ContentService). It is in the javadocs of the wsapi.

If the tests rule out your livelink you should do this on the livelink server

Debug=2
[options]
WantLogs=true
WantLAPILogs=true

put that in opentext.ini and re-stsrt and re-attempt.If the problem now is livelink you will see why livelink is complaining in the thread logs.

Your code ppears to be how someone would do that with a java client,but since it is a SOAP fault I suspect something else is at fault.

Well, if I called the wrong number, why did you answer the phone?
James Thurber, New Yorker cartoon caption, June 5, 1937
Certified OT Developer,Livelink ECM Champion 2008,Livelink ECM Champion 2010

http://www.tek-tips.com/faqs.cfm?fid=2884

http://www.linkedin.com/in/appunair

http://www.livelink.in

RajaneeshJM · Aug 26, 2014

Hi Appnair,

Livelink CS10SP2Update 11 is installed on Windows machine using IIS. The webservices are installed on Apache Tomcat.

I am able to add the document using Add Item -> Document option in a different folder in Livelink.

Also I have verified the Authentication from the Java Client using simple sout's. Authentication is successful and also I am able to list the nodes using DocumentManagement service

The file size is only 14kb.

As suggested by you, I have modified opentext.ini and added the below lines at the end of the file. But I could not notice any logs under <OpenTextHome>\logs folder. Is there any particular file I should look at?

Debug=2
[options]
WantLogs=true
WantLAPILogs=true

In the Apache Tomcat server, I have observed the below logs in les-services.log

Livelink error occurred
Status: 903101
Error Code: DocMan.NodeCreationError
Error Message: Error adding version to 'TestLivelink.docx'. Error reading data stream from version. [E682033159]
ApiError: Error reading data stream from version.

Please help me resolve this issue.

Thanks in advance

appnair · Aug 27, 2014

There should have been a key called Debug in opentext.ini it happens in the first 100 lines
Then there should be a section called [options] that is where you would have put the
values if they do not exist.

If you do that and re-start your /logs directory would start showing thread<1-n>.out logs connect<1-n>.out logs
If a lapi or webuser command is received then the input and output is recorded in thread logs and dtabase calls are recorded in connect logs
see how I have made my opentext.ini only relevant sections shown.If the error is sreported in tomcat logs but you cannot find anything corresponding in livelink logs then the
call has not made it to livelink

[general]
version=20
LLIndexRequiresLogin=FALSE
LLIndexHTMLFile=llindex.html
DefaultRH=enterprise.home
DefaultContentRH=Enterprise.Home
Debug=2
Port=2099
Server=localhost

[options]
maxRightsString=250
MaxOpenSessions=100
wantByteServing=FALSE
wantLogs=TRUE
wantLapiLogs=true
wantSecureCookies=TRUE
wantTimings=TRUE
wantVerbose=TRUE
wantWeb=TRUE
WantSummaryTimings=TRUE
EnableAgents=TRUE
EnableAgentsTrace=FALSE
EnableAgentsTestAll=FALSE
EnableNotification=TRUE
wantSearch=TRUE
wantSearchLogs=FALSE
wantHTMLView=TRUE
ObjectRankEnabled=TRUE
categoryNumToUpgrade=5
errorMessageWantDebugInfo=FALSE
wantIcons=TRUE
WantDirectFetch=false
cacheControlHeader=false
EFSCopyBufferSize=524288
RunWithoutLogin=TRUE

Well, if I called the wrong number, why did you answer the phone?
James Thurber, New Yorker cartoon caption, June 5, 1937
Certified OT Developer,Livelink ECM Champion 2008,Livelink ECM Champion 2010

http://www.tek-tips.com/faqs.cfm?fid=2884

http://www.linkedin.com/in/appunair

http://www.livelink.in

RajaneeshJM · Aug 27, 2014

ocumentManagement.CreateDocument()' Timing: 2.953 2.965 2.953
08/27/2014 17:12:11 [2854839551] Done with Request on socket 0000000013C1E260

Regards
Rajaneesh JM

appnair · Aug 27, 2014

is this variable in your code
String filePath = "E:/Livelink/TestUpload/TestLivelink.docx";

readable by the livelink server from looking at your code it looks like
you are saying hey livelink server read thge stream that originates in the E drive
is livelink and the client api on the same machine?

verify what the atch variable has before you ares ending the request.

I have nothing further to comment as you say this same code works in another part of your livelink

If I had time I could try your code too busy

Try OT support if you can't fix it by doing some common sense tests

Well, if I called the wrong number, why did you answer the phone?
James Thurber, New Yorker cartoon caption, June 5, 1937
Certified OT Developer,Livelink ECM Champion 2008,Livelink ECM Champion 2010

http://www.tek-tips.com/faqs.cfm?fid=2884

http://www.linkedin.com/in/appunair

http://www.livelink.in

RajaneeshJM · Aug 31, 2014

Hi AppNair,

My livelink and client are in two different machines. The path mentioned in the filePath variable String filePath = "E:/Livelink/TestUpload/TestLivelink.docx"; is available in the client. The program is being executed from the client machine.

I tried executing the program by providing the path available in the server machine. Even then the result is the same.

I observed one thing from the logs. FilePath only mentions the name of the file and not the path. Does Livelink has a default folder where it expects the file to be placed? Please help me resolve the issue

Processing Request on socket 0000000013C1E260
08/27/2014 17:12:09
08/27/2014 17:12:09 Wed Aug 27 17:12:09 2014
08/27/2014 17:12:09 Arguments = 'A<1,?,''advancedVersionControl''=false,''comment''=''Uploaded through the Web Service'',''fileAtts''=A<1,?,''CreatedD
08/27/2014 17:12:09 FileAttributes = 'A<1,?,''CreatedDate''=D/2014/8/26:11:6:31,''Creator''=?,''DataForkSize''=L217789231104,''FileName''=''TestLivelink.do
08/27/2014 17:12:09 FilePath = 'TestLivelink.docx'
08/27/2014 17:12:09 ServiceMethod = 'CreateDocument'
08/27/2014 17:12:09 ServiceName = 'DocumentManagement'

Regards
Rajaneesh JM

appnair · Sep 1, 2014

Can you tell me one thing do you have access to knowledge.opentext.com so I can point to standard official code as a client programmer you do not have to worry about livelink specifics all you have to make sure is and I keep repeating this and you completely ignore me again

1)can you open up a web browser on your client machine and upload the file if it works your WS API call should work provided you have the same parameters meaning file is the same the location in livelink is the same

What you are getting into is unwanted debugging for what since in my mind you have not told me or this forum simple debugging / common sense ways of looking at a somewhat easy problem

Once again the API has to follow the same business rules in however the DMS is configured to perform

Well, if I called the wrong number, why did you answer the phone?
James Thurber, New Yorker cartoon caption, June 5, 1937
Certified OT Developer,Livelink ECM Champion 2008,Livelink ECM Champion 2010

http://www.tek-tips.com/faqs.cfm?fid=2884

http://www.linkedin.com/in/appunair

http://www.livelink.in

RajaneeshJM · Sep 1, 2014

Hi AppNair,

I have access to knowledge.opentext.com. As mentioned earlier, I am able to upload the document to livelink when connected thru a web browser. The exception is encountered only when adding a document using webservices

Regards
Rajaneesh JM

appnair · Sep 2, 2014

Go to this link

https://knowledge.opentext.com/know...ll&objId=45500683&objAction=browse&viewType=1

Select the first Graphic that says 'Using CWS'

use the Java sample

https://knowledge.opentext.com/know...ll&objId=45500683&objAction=browse&viewType=1

Compare your code vs OT code.If the OT code works then chase why your code does not...

Well, if I called the wrong number, why did you answer the phone?
James Thurber, New Yorker cartoon caption, June 5, 1937
Certified OT Developer,Livelink ECM Champion 2008,Livelink ECM Champion 2010

http://www.tek-tips.com/faqs.cfm?fid=2884

http://www.linkedin.com/in/appunair

http://www.livelink.in

RajaneeshJM · Sep 2, 2014

Thanks AppNair.

I will try this link.

Meanwhile, note that I am using CS10.0.0 SP2 Update 11 and the link which you provided is for CS10.5

Hope this version change is not a concern.

Regards
Rajaneesh JM

appnair · Sep 2, 2014

Not as far as I know.All the webservices api is doing is giving you proxies.So long as you are downloading the proxies from a livelink server
that you want to program against you wont have a problem.Suppose OT introduces a new command and puts them only in livelink 10.5(which usually they won't)
if you make your code in 10.5 and try it against 971 or 10 just like that you may run into difficulty.As soon as the IDE is allowed to download the proxies
it will basically mark those calls in red and refuse to compile because for it to work the only way is to understand the code that is in that livelink.
I keep saying this to all upcoming livelink client programmers whether in lapi or wsapi.You are just using a programming language to do something in livelink.It still has to follow livelink business rules which can vary form customer to customer.It has allowed me to be successful once I realized that .
It also does not hurt to understand the flow
User doing a upload using webgui(client browser and livelink server is two entities)
user authenticates,cookie written to browser,user uploads file using File control tag,file is deposited in livelink servers configured area(usually web server temp). This area is basically a place accessible by the livelink service user. Livelink creates the node,and adds the version to the configure storage provider usually a file store accesisible by the livelink service user.If you look the client browser has access to the webserver temp that is how web uploads happen in any application be it streaming or file.
User doing a upload using livelink web services or lapi(client code and livelink server are two entities)
user authenticates,cookie given to client that is your auth token,user uploads file using code ,file is streamed again(lots of ways as explained in the java docs that could go wrong if not done correctly)the wsapi client talks to livelink on the lapi port & server configured in the Web.Config,most usually the CWS server and the livelink server is the same so that localhost:2099 can work) .Note the problems you are having could stem from file permission etc.If I were to look at it closely I would put fiddler of filemon or something that kind,but I would most certainly try OT code and simple things first

Well, if I called the wrong number, why did you answer the phone?
James Thurber, New Yorker cartoon caption, June 5, 1937
Certified OT Developer,Livelink ECM Champion 2008,Livelink ECM Champion 2010

http://www.tek-tips.com/faqs.cfm?fid=2884

http://www.linkedin.com/in/appunair

http://www.livelink.in

RajaneeshJM · Sep 2, 2014

Hi AppNair,

Thanks a lot for your support.

I am able to upload a document using webservices. The link provided by you helped me identify the thing(simple as you say) which I was missing.

Thanks again.

Regards
Rajaneesh JM

appnair · Sep 2, 2014

so what was it ?can you be kind enough to the community and help some other person who is in the same boat.That is how community sites work.You just don't get help and just vanish You are supposed to pay it forward

Well, if I called the wrong number, why did you answer the phone?
James Thurber, New Yorker cartoon caption, June 5, 1937
Certified OT Developer,Livelink ECM Champion 2008,Livelink ECM Champion 2010

http://www.tek-tips.com/faqs.cfm?fid=2884

http://www.linkedin.com/in/appunair

http://www.livelink.in

RajaneeshJM · Sep 2, 2014

You are right AppNair. Here is the sample program. Few extra headers [Method getFileAttsElementHeader] are required when using the uploadContent method available in ContentService.

Earlier, I was trying the createDocument method from DocumentManagement service. In the new logic I am using the createDocumentContext method from DocumentManagement. Using the contextID returned from the method, an instance of ContentService is obtained and then the uploadContent method is used to upload the document. Although I could not identify the reason for failure of createDocument method, I don't mind using the new logic. Atleast I have a solution to upload a document using webservices.

private static void uploadFile(DocumentManagement dm, String admToken) {
String name = "TestLivelink.docx";
String comment = "Uploaded through the Web Service";
boolean advancedVersionControl = false;
int parentID = 2000; //ID of Enterprise Workspace
String contextId;
String filePath = "E:/Livelink/TestUpload/"+name;

try{
File file = new File(filePath);
if(!file.exists()){
System.out.println("File does not exist at "+filePath);
return;
}

contextId = dm.createDocumentContext(parentID, file.getName(), comment, advancedVersionControl, null);
System.out.println("ContextId is "+contextId);

FileAtts fileAtts = new FileAtts();
fileAtts.setCreatedDate(getXMLGregorianCalendar(new Date(file.lastModified())));
fileAtts.setFileName(file.getName());
fileAtts.setFileSize(file.length());
fileAtts.setModifiedDate(getXMLGregorianCalendar(new Date(file.lastModified())));

ContentService contentService = getContentService(admToken, contextId, fileAtts);
String objectID = contentService.uploadContent(new DataHandler(new FileDataSource(file)));
System.out.println("uploaded object Id:"+objectID);

Node node = dm.getNode(Integer.parseInt(objectID));
System.out.println("Node id is:"+node.getID());
}catch(Exception e){
System.out.println("Upload Failed "+e.getMessage());
}
}

public static XMLGregorianCalendar getXMLGregorianCalendar(Date date) throws Exception{
XMLGregorianCalendar xmlCalender=null;
GregorianCalendar calender = new GregorianCalendar();
calender.setTime(date);
xmlCalender = DatatypeFactory.newInstance().newXMLGregorianCalendar(calender);
return xmlCalender;
}

private static ContentService getContentService(String authToken, String contextID, FileAtts fileAtts) throws Exception{
URL url = null;
URL baseUrl = ContentService_Service.class.getResource(".");
if(".NET".equals(NET_OR_JAVA)){
url = new URL(baseUrl, NET_WSDL_LOCATION + "ContentService.svc?wsdl");
} else if("JAVA".equals(NET_OR_JAVA)){
url = new URL(baseUrl, JAVA_WSDL_LOCATION + "ContentService?wsdl");
}
ContentService_Service contentService = new ContentService_Service(url, new QName(CORE_NAMESPACE, "ContentService"));
ContentService endpoint = contentService.getBasicHttpBindingContentService(new MTOMFeature());
OTAuthentication otAuth = new OTAuthentication();
otAuth.setAuthenticationToken(authToken);
setSoapHeader((WSBindingProvider) endpoint, otAuth, contextID, fileAtts);
return endpoint;
}

public static void setSoapHeader(WSBindingProvider bindingProvider, OTAuthentication otAuth, String contextID, FileAtts fileAtts) throws Exception{
List<Header> headers = new ArrayList<Header>();
SOAPMessage message = MessageFactory.newInstance().createMessage();
SOAPPart part = message.getSOAPPart();
SOAPEnvelope envelope = part.getEnvelope();
SOAPHeader header = envelope.getHeader();
headers.add(getOTAuthenticationHeader(header, otAuth));
if(!"".equals(contextID)){
headers.add(getContentIDElementHeader(header, contextID));
}
if(fileAtts != null){
headers.add(getFileAttsElementHeader(header, fileAtts));
}
bindingProvider.setOutboundHeaders(headers);
}

public static Header getContentIDElementHeader (SOAPHeader header, String contextID) throws Exception{
SOAPHeaderElement contextIDElement;
contextIDElement = header.addHeaderElement(new QName(CORE_NAMESPACE, "contextID"));
contextIDElement.addTextNode(contextID);
return Headers.create(contextIDElement);
}

public static Header getFileAttsElementHeader (SOAPHeader header, FileAtts fileAtts) throws Exception{
SOAPHeaderElement fileAttsElement;
fileAttsElement = header.addHeaderElement(new QName(CORE_NAMESPACE, "fileAtts"));
SOAPElement createdDateElement = fileAttsElement.addChildElement(new QName(CORE_NAMESPACE, "CreatedDate"));
createdDateElement.addTextNode(fileAtts.getCreatedDate().toString());
SOAPElement modifiedDateElement = fileAttsElement.addChildElement(new QName(CORE_NAMESPACE, "ModifiedDate"));
modifiedDateElement.addTextNode(fileAtts.getModifiedDate().toString());
SOAPElement fileSizeElement = fileAttsElement.addChildElement(new QName(CORE_NAMESPACE, "FileSize"));
fileSizeElement.addTextNode(fileAtts.getFileSize().toString());
SOAPElement fileNameElement = fileAttsElement.addChildElement(new QName(CORE_NAMESPACE, "FileName"));
fileNameElement.addTextNode(fileAtts.getFileName());
return Headers.create(fileAttsElement);
}

Tek-Tips is the largest IT community on the Internet today!

Members share and learn making Tek-Tips Forums the best source of peer-reviewed technical information on the Internet!

How to add a document to Livelink using webservices

RajaneeshJM

Programmer

appnair

Programmer

RajaneeshJM

Programmer

appnair

Programmer

RajaneeshJM

Programmer

appnair

Programmer

RajaneeshJM

Programmer

appnair

Programmer

RajaneeshJM

Programmer

appnair

Programmer

RajaneeshJM

Programmer

appnair

Programmer

RajaneeshJM

Programmer

appnair

Programmer

RajaneeshJM

Programmer

Similar threads

Part and Inventory Search

Sponsor