Ist die Schnittstelle instabil (wird also oft geändert), dann muss ich zusehen, dass der Service, den ich in meinem Programm aufrufe, so globale Informationen wie möglich übergeben bekommt, damit ich möglichst alle in Zukunft nötigen Daten nachladen kann.

Ein konkretes Beispiel: ich übergeben die Vertrags-Id und nicht nur die Vertragsposition-Id, die eigentlich im Augenblick ausreichende Informationen liefern würde.

Im BPM- und Integrations-Umfeld trifft man immer wieder auf folgendes Problem:

I have been very silent on my blog lately. So some updates what I do currently...

Currently I implement a BPM solution for a customer of Software AG with CAF (Component Application Framework). The CAF applications runtime environment is the myWebmethods server of Software AG. It can use an webMethods Integration Server as well easily. Everything is tightly integration in their development IDE called "Designer".

Every project that uses the webMethods Integration Server has the problem to document the code. The webMethods Developer has a function to generate HTML documentation for a single flow.
That looks nice but when you need to generate documentation for a whole package then this is obviously not the best choice.

Software AG provides a nice package called WmDoc in the samples area. This allows to make the documentation browsable with a webbrowser. The nice thing is that your documentation is never outdated as it is automatically regenerated when you browse to a service.