Get an image from Infor Document Archive with Java

For my project to get M3 picking lists in Google Glass, I had to learn how to retrieve in Java an image that is stored in Infor Document Archive. The technique is probably well explained and documented somewhere, but I don’t work with Document Archive so I didn’t know where to start. So as a starting point, I used one of the Java examples built-in Document Archive 10.1.x, and from there I adapted the code for the older Document Archive 10.0.x. I share my results here with you in case you too need to retrieve resources in Java from Document Archive and don’t know where to start. I will later use that code in my Infor Grid application to insert the picture of the item in the picking list in Glass.

Built-in examples

Document Archive 10.1.x is built-in with some examples in Java to connect to the server and retrieve resources. I compiled that code and it ran out of the box. I then used it as a basis to adapt the code to the older Document Archive 10.0.x for which I couldn’t find built-in examples. I will show you the code for both versions. I will also show how to encode the bytes to Base64 as I might need it later for the Google Glass Mirror API.

2

Code for Document Archive 10.1.x

Here is the Java source code for Document Archive 10.1.x:

import java.io.FileOutputStream;
import java.io.InputStream;
import com.infor.daf.icp.CMItem;
import com.infor.daf.icp.CMResource;
import com.infor.daf.icp.Connection;
import com.infor.daf.icp.SearchQueries;
import com.infor.daf.icp.SearchQuery;
import com.infor.daf.icp.Connection.AuthenticationMode;
import org.apache.commons.codec.binary.Base64;

public class Test {
	public static void main(String[] args) {
		try {
			String baseUrl = "https://hostname:26108/ca/";
			String username = "JOHNDOE";
			String password = "*******";
			String query = "/M3_ITEM_IMAGE[@M3_ITNO = \"ACME\"]";
			Connection conn = new Connection(baseUrl, username, password, AuthenticationMode.BASIC);
			conn.connect();
			CMItem item = CMItem.search(conn, new SearchQueries(new SearchQuery(query)));
			for(CMResource res : item.getResources().values()) {
				// to file
				FileOutputStream fos = new FileOutputStream(res.getFilename());
				InputStream is = res.getUrlStream();
				CMResource.streamData(is, fos, true);
				// to URL
				System.out.println(res.getUrl().toString());
				// to Base64
				byte[] bytes = CMResource.createByteArray(res.getUrlStream());
				System.out.println(new String(Base64.encodeBase64(bytes)));
			}
			conn.disconnect();
		} catch(Exception e) {
			e.printStackTrace();
		}
	}
}

Find the Java library for Document Archive 10.1.x, icp.jar, and the required open source libraries httpclient, httpcore, commons-logging, commons-codec, and jaxen:

<LifeCycle>\<host>\grid\<grid>\grids\<grid>\applications\DocumentArchiveCM\lib\

3

Compile and run the code with:

javac -extdirs . Test.java
java -cp icp.jar;httpclient-4.3.2.jar;httpcore-4.3.1.jar;commons-logging-1.1.1.jar;commons-codec-1.6.jar;jaxen.jar;. Test

The application will connect to Document Archive, will search the image by query, will retrieve the resource and will save it to a file, for example to JPEG.

The application will also show the URL to the resource, for example:

https://hostname:26108/ca/api/resources/93+3+ICM8+icmnlsdb13+M3_ITEM_IMAGE59+26+A1001001A14F13A20952E6009918+A14F13A20952E600991+14+1027?$token=aHR0cDov&#8230;

The application will also show the Base64-encoded bytes of the resource.

Code for Document Archive 10.0.x

Here is the Java source code for the older Document Archive 10.0.x. It is very similar to the newer code above, the package names are different (intentia instead of infor) and some methods are older. I had to decompile icp.jar to learn and adapt the code.

import java.io.FileOutputStream;
import java.io.InputStream;
import java.util.Iterator;
import org.apache.commons.codec.binary.Base64;
import com.intentia.icp.common.CMItem;
import com.intentia.icp.common.CMResource;
import com.intentia.icp.common.Connection;

public class Test {
	public static void main(String[] args) {
		try {
			String baseUrl = "https://hostname:25194/ca/";
			String username = "JOHNDOE";
			String password = "*******";
			String query = "/ESA_ItemImage[@ESA_ItemNumber = \"ACME\"]";
			Connection conn = new Connection(baseUrl, username, password);
			conn.setAuthMode(Connection.BASIC);
			conn.connect();
			CMItem item = CMItem.search(conn, query);
			Iterator it = item.getResources().iterator();
			while (it.hasNext()) {
				CMResource res = (CMResource)it.next();
				// to XML
				System.out.println(res);
				// to file
				if (res.getEntityName().equals("ICMBASE")) {
					InputStream is = res.retrieveResource(conn);
					FileOutputStream fos = new FileOutputStream(res.getOrgFileName());
					CMResource.streamData(is, fos);
					// to Base64
					byte[] bytes = CMResource.createByteArray(res.retrieveResource(conn));
					System.out.println(new String(Base64.encodeBase64(bytes)));
				}
			}
			conn.disconnect();
		} catch(Exception e) {
			e.printStackTrace();
		}
	}
}

Find the Java library for Document Archive 10.0.x, icp.jar, and the required open source libraries httpclient, httpcore, commons-logging, commons-codec, jaxen, and commons-io:

<LifeCycle>\<host>\grid\<grid>\grids\<grid>\applications\DocumentArchiveCM\lib\

3

Compile and run the code with:

javac -extdirs . Test.java
java -cp icp.jar;jaxen-1.1.1.jar;httpclient-4.2.2.jar;httpcore-4.2.2.jar;commons-io-2.4.jar;commons-logging-1.1.1.jar;commons-codec-1.7.jar;. Test

The application will connect to Document Archive, will search the image by query, will retrieve the resource and will save it to a file, for example to JPEG.

The application will also show the XML of the resource, for example:

<?xml version="1.0" encoding="UTF-16" standalone="no"?>
<res>
    <pid>85 3 ICM8 icmnlsdb7 ICMBASE58 26 A1001001A14F20A45344I4341718 A14F20A45344I434171 13 300</pid>
    <id>A1001001A14F20A45344I43417</id>
    <compId>A14F20A45344I43417</compId>
    <version>1</version>
    <entityName>ICMBASE</entityName>
    <type>0</type>
    <acl>
        <name>defaultACL</name>
    </acl>
</res>

The application will also show the Base64-encoded bytes of the resource.

 

That’s it. If you liked this, please click Like, leave me your thoughts in the comments below, and share your solutions by writing posts.

Also, please join the campaign and sign the petition to Infor so they make more of their source code available such that we can all learn more and make better solutions.

 

Thank you.

 

How to get an item image from Document Archive

Today I will illustrate how to get an item image from Infor Document Archive.

For that, I will use Document Archive Client to add an item image with the item number (ITNO) as an attribute, and I will retrieve the item image using the Document Archive REST API. I will do the illustration with two servers on different version numbers, one server running Document Archive version 10.0.2.4.28 and the other server running version 10.1.0.0.93.

I will later use these steps for my Google Glass project to display in Glass the item image of each picking line.

Document Archive Client in Smart Office

If you have Document Archive installed in your Grid, you will find the Document Archive Client in the Smart Office Navigator widget:
3_

Document Archive web interface

Document Archive has a web interface at /ca/index.html.

Document Archive 10.0.x will simply return the version number:
1

Document Archive 10.1.x has a much richer web interface with a web client, an admin client, a mobile client, a Ming.le part, management pages, and an API overview:
0.10.2

The path /ca/impl/connection/information will return the API version number:
2

How to add an item image

To add an item image to Document Archive:

  1. Select Add Document > Item Image
  2. Drop an image file
  3. Set Status to Approved
  4. Enter an Item Number (ITNO)
  5. Click Save

4

How to search for an item image

To search for an Item Image by item number (ITNO):

  1. Select Attribute Search
  2. Set Document Type to Item Image
  3. Set Attribute to Item Number
  4. Set Operator to =
  5. Enter the item number in Value
  6. Click Search

5

Document Archive Client will return a list of possible matches, and for each match it will return the image converted into different sizes like original, preview, and thumbnail.

HTTP Requests and query

When I intercept those steps in Fiddler, I see four HTTP Requests, starting with the query:
10

The server with Document Archive 10.0.x used the query /ESA_ItemImage[@ESA_ItemNumber = “ACME”], and the other server with Document Archive 10.1.x used the query /M3_ITEM_IMAGE[@M3_ITNO = “ACME”]. I’m not fully familiar with how Document Archive is configured, so I don’t know if the query is based on the version number or if somebody did a manual configuration. So check what the query is on your server.

From the query, the server returns a list of matches, and for each match it gives the PID of the document and a list of resources with URLs to the item image in various sizes: original, preview, and thumbnail.

I’m only interested in the original item image, that’s entityName=ICMBASE. The PID would be given by the following XPath on the API response:

//res[entityName='ICMBASE']/pid/text()

Document Archive REST API

Document Archive has a REST API that we can access from http://host:port/ca .

The path /ca/application.wadl will return the Web Application Description Language (WADL) of the API:
6

Also, Document Archive 10.1.x has a richer API, and a really well polished award-winning documentation and playground:
5_

Search an item image with the REST API

There are several API available to get the item image.

To determine which API accepts query as an input parameter, use the following XPath on the application.wadl:

//param[contains(@name, 'query')]

To determine which API returns binary data (image bytes) as output, use the following XPath:

//representation[contains(@mediaType, 'application/octet-stream')]

By trial and error, I determined I could get the item image in only one request with the following API, the parameter $query properly URL-encoded, and HTTP Basic Authentication:

/ca/api/items/search/item/resource/stream?$query=...

3.3

Errors

It wasn’t easy. I ran into a lot of errors which I still don’t understand and which I didn’t fully document. Here are a few bits and pieces I noted:

  • Unfortunately, the WADL doesn’t mention the input parameter QK_xquery for the searchItems.jsp API, therefore there may be more undocumented API that also accept QK_xquery as an input parameter; to be tested.
  • In some of my tests the server threw HTTP 401 Unauthorized which led me to believe the user/password was wrong. It turns out the Grid session provider didn’t allow HTTP and only allowed HTTPS. Very misleading error message.
  • I got a lot of cryptic prolog errors: “Parsing error: Invalid input data: Content is not allowed in prolog. org.xml.sax.SAXParseException”. It seems to be a bug in Document Archive for POST methods and the workaround is to manually change the HTTP Request header to Content-Type: text/plain.
  • I got a lot of inexplicable java.lang.NullPointerException even with the correct input parameters.
  • I got a lot of inexplicable HTTP/1.1 500 Internal Server Error even with the correct input parameters.

 

That was quick overview of how to add an item image by item number (ITNO) in Document Archive, and how to retrieve it with the REST API.

That’s it! Please comment, like, share, follow, enjoy, author. Thank you.