Colin's Notes

In response to: I am wondering.. Domino as LDAP with WebSphere Portal..

How to create LDAP Hierarchical Groups in Notes In my experience, LDAP browsers or integration tools will require a Base DN (for example, your Organization name). So to get the Notes groups to be visible you need to name them with the organization name. (Notes does not require this or do this for you). So instead of creating a group named Accounting, (cn=Accounting) you would name it Accounting/MYORG (o=MYORG, cn=Accounting). If you want to create groups in multiple Organizations just name them this way in the Group document in the Notes address book. Group name: Accounting/MYORG Group name: Accounting/MYORGTWO Let me know if you have additional questions. Colin

Using Domino Designer Release 8.0.2, I created a Java Library by importing a WSDL
produced by Deltek's Costpoint Web Integration Console (BEA Weblogic). (See attached sample)
However, the resulting Java code would not compile. I received 12 errors including:

• illegal start of type
• <identifier expected>
• '{' expected.

For example,

com_deltek_enterprise_system_serverapi_remoteapi_integration\MethodResponse.java:1 <identifier expected> package .com_deltek_enterprise_system_serverapi_remoteapi_integration; com_deltek_enterprise_system_serverapi_remoteapi_integration\MethodResponse.java:5 illegal start of type private .com_deltek_enterprise_system_serverapi_remoteapi_integration.Message[] message;

Seeing the period character preceding the namespace I thought, that's strange, I'll just remove those periods.
So I did a Search and Replace for ".com" and replaced it with "com".
Ran Compile All and got a "Successful compile" message.
Clicked Save and an error box pop-up saying: "The requested operation failed".

The Java Library would not save, not wanting to loose my work, I exported all the Java code.
I'm thinking, all I really need is the source code, so I'll just create a new Java Library and add the source code to the Project.

Then I created an agent to call the web service. Added the Shared Java Library to the project and manually added all the source files.
The agent complies just fine, but when the agent runs it throws this error:
lotus.domino.axis.InternalException: lotus.domino.axis.ConfigurationException: No engine configuration file - aborting!

What? What configuration file?
I found a couple of people who have posted the same question, but no one had posted an explanation. I found some posts that describe how Axis uses a client-config.wsdd (WSDD - Web Services Deployment Descriptor) file so set about to identify the contents and a method to include one in my project. However, time is now getting critical, my simple web service consumer that should have taken one day to develop, is now taking several days. In exasperation, I opened an IBM Support PMR.

Fortunately, I got hooked up with Oscar I Hernandez and Michael Maroney on the IBM Lotus Technical Support - Application Development Team. They were able to reproduce my errors. They explained that when you import the WSDL file some additional files are created as part of the Java Library. If you open the Design Document Infobox and look on the Fields tab of the Java Library element, you should see three $FILE items. The third one has a File Name of %%webserviceresource%%.jar. Look at this with Notespeek and you'll find references like:

lotus_domino_ws_WSDL EmployeeEmployeeService.wsdd lotus_domino_ws_WebService.properties employee.EmployeeServiceSoapBindingStub.digest

So now we know where the engine configuration file is - it's attached to the Java Library design note, but only when you can save the Library created by importing the WSDL.

In this case, the work around was to make a local copy of the WSDL file, fix the namespaces, and then import it into a new Java Library, and save the Library. We made the following changes to the WSDL:

Line 2 From: targetNamespace="http://www.deltek.com/enterprise/integration/ws/employee" To: targetNamespace="employee" Line 14 From: targetNamespace="java:com.deltek.enterprise.system.serverapi.remoteapi.integration" To: targetNamespace="employee" Line 18 From: xmlns:java="java:com.deltek.enterprise.system.serverapi.remoteapi.integration" To: xmlns:java="employee" Line 35 From: targetNamespace="http://www.deltek.com/enterprise/integration/ws/employee" To: targetNamespace="employee" Line 48 From: xmlns:java="java:com.deltek.enterprise.system.serverapi.remoteapi.integration" To: xmlns:java="employee"

I'm hoping to work with our Deltek consultant to identify how we can change this web service so it will produce a valid WSDL with a set of namespaces that can be converted to Java classes using standard tools like WSDL2Java.

May all your WSDL's be well formed!
Colin

See this post for the explanation and workaround!

Explanation for "No engine configuration file - aborting!"

Using R8.02 Designer client I've created a Java Script Library by importing a WSDL. Then created an agent to call the web service. However, when the agent runs it fails and throws this error.

lotus.domino.axis.InternalException: lotus.domino.axis.ConfigurationException: lotus.domino.axis.ConfigurationException: No engine configuration file - aborting!

lotus.domino.axis.ConfigurationException: No engine configuration file - aborting!

at lotus.domino.axis.configuration.FileProvider.configureEngine(Unknown Source)

at lotus.domino.axis.AxisEngine.init(Unknown Source)

at lotus.domino.axis.AxisEngine.<init>(Unknown Source)

at lotus.domino.axis.client.Service.getAxisClient(Unknown Source)

at lotus.domino.axis.client.Service.<init>(Unknown Source)

at com.deltek.www.enterprise.integration.ws.employee.EmployeeServiceLocator.<init>(EmployeeServiceLocator.java:6)

at JavaAgent.NotesMain(JavaAgent.java:32)

at lotus.domino.AgentBase.runNotes(Unknown Source)

at lotus.domino.NotesThread.run(Unknown Source)

I've seen several posts asking for solutions, but none with answers I can apply to the Lotus Notes Designer environment.

I've created other agents that do not have this problem....and I've never found a client-config.wsdd file on my machine.

Could this be related to the format or structure of the WSDL?

Can anyone explain how to fix this?

Thanks,

Colin

Deltek's Costpoint Web Integration Service requires a security header in the SOAP request. This document explains how I identified the required header elements and coded the Java code to add them to my Lotus Notes Java agent.

We need to send new hire employee data from a hiring web site (Lotus Notes application) to Deltek's Costpoint Web server. The Costpoint Integration Tool allows you to generate a Web Service that supports data integration to the Oracle back-end. The integration tool is built on Oracle BEA Weblogic. I used Stubby to generate the Java classes from the WSDL and then used soapUI to do a simple test of the Web Service (named EmployeeWS).

"No Security header in message but required by policy."
When testing with soapUI, I received this error message. However, the classes did not include anything to support the required security header. Being a long time LotusScript coder, but rather new to Java and Web services I was stumped. Studying the WSDL I found this section:

Figure 1. Part of the WSDL file for the EmployeeWS service.

So I read the PDF file located at the URL referenced after "TokenType=" and found that I would need to add this security information to my SOAP Header.
Using soapUI again I tested with this header:

Figure 2. Part of the SOAP Envelope showing the correct Header.

This eliminated the "No security header..." error! But how do I add this to the SOAP Header in my Java agent?

Julian Robichaux's post explaining how to do this (Stubby - Adding SOAP Header Information to a Request) got me headed in the right direction but I still had some problems because of the two node levels. After some trial and error I came up with this java code to get the headers right - see the block marked in Red:

Figure 3. This java code produces the same SOAP header as shown in Figure 2 above.

Additional References

Using Security Assertion Markup Language (SAML) Tokens For Identity
http://e-docs.bea.com/wls/docs92/webserv/security.html#wp218056

Web Services Security UsernameToken Profile 1.0
OASIS Standard 200401, March 2004
http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0.pdf

I'm developing a web service consumer for Deltek's Costpoint ERP in a Notes R7 Java agent (thanks to Julian R. for Stubby!). The service requires a user name and password in the SOAP Header. Although I found a couple of posts that explained the basic approach (See: http://www.nsftools.com/stubby/SOAPHeaders.htm). I kept getting the error message, "No Security header in message but required by policy.". I suspected I had a simple mistake in my header, if only I could see the actual SOAP request being sent. Then I realized that if I could capture the network traffic going out of my network port, then I might be able to see the HTTP/XML request. Using Wireshark (http://www.wireshark.org/) I was able to find the Destination address (hostname or TCPIP address) of the web service. Right click on the Data element and copy the Printable text to the clipboard! Then it was easy to see where my header was malformed. A couple of caveats, the service runs on plain HTTP (not SSL) and I turned OFF network encryption on my Lotus Notes client's TCP Port, I'm runing the agent locally for testing. Hope this saves someone else some time debugging SOAP Requests!