So, you can add and apply your own validation classes to the model. You just need to refer to your custom class in the Style validation annotation of the property. First, copy the validation class itself into the correct folder of your Workbench project. That’s also the trickiest part within the LiveCycle Modeler (compared to doing this for the Flash Builder modeler). The FB modeler generates the code into your Flex project folder and you can easily find it, but Workbench doesn’t generate the code in the directory where all your other projects are located (on Vista/Win7 that is C:\Users\username\Workbench ES2\). I am not exactly sure why, but I think because the model generated classes are mostly temp files that don’t have to be checked into the server (downside is that you need to backup modifications of custom classes yourself).

That ‘temp’ folder that stores all model generated classes is much deeper on your disk drive. On my system it’s C:\Users\username\AppData\Roaming\Adobe\LiveCycle\ES2\Guides\generated\. Here you find subfolders structured per LiveCycle application. For your project, find the folder where the generated myModel.as and myModel.swf files are located. Consider this folder the ‘root’ that is used by the compiler, so this is where yoy copy your custom validator classes to.

The last step is to define the style validation annotations within the property. Basically you’d define your property like this:

<property type=”string”>
<style>
<validation>
<annotation name=”ActionScriptValidator”>
<item name=”ValidatorClass”>mx.validators.SocialSecurityValidator</item>
<item name=”allowedFormatChars”>”-()”</item>
</annotation>
</validation>
</style>
</property>

The ValidatorClass item defines the class path, and in this case the ‘allowedFormatChars’ is one of the parameters that is used by that class. Now make sure that Workbench recompiles your class (just move an entity a few pixels, save and the recompile will hapen). Now your custom validator class is compiled into the model itself and you are ready to use the related properties within your guide!

ps: Workbench will inform you on compilation errors if you made errors in your class.

Failed on ‘Verifying JBoss for Adobe LiveCycle ES service is installed’
Windows turnkey service JBoss for Adobe LiveCycle ES does not exist

When checking in the Windows Service Panel, indeed there is no such service defined, even though the installer should have created it. I have not been able to replicate this issue, but it happened to me at a customer site and by searching Google it seems that others have run into it as well.

Prescription:
The Google search results tells us that some people forget to set the Java_Home system variable and that you should be using the right version of the JDK. However, this did not seem to be the problem in this case.

Through the install documentation you can find the steps needed to re-create the JBoss for Adobe LiveCycle ES service (page 62). You can use those to try and create the service ‘manually’. For our install, the problem seemed to be in the [LC_INSTALL_ROOT]\jboss\InstallJBossService.bat script file. Somehow the username / password did not seem to work, whatever we tried it failed. Well, sort off: strangely enought the command prompt output first mentions that there was an error, though still reports that the script was executed succesfully. Still no service created though.

The solution was too simple to come up with: just remove the username / password parameters from the script and execute it. This time the script did not fail and as expected created the service for us. Next thing to do is go into the service panel, select the ‘JBoss for Adobe LiveCycle’ service, right click to go to it’s Properties and in the Log On tab specify Log In As This Account. Then specify the username password (in my case “.\administrator” and the password), click OK and you are done.

Now run the LiveCycle Configuration Manager again and most likely it won’t fail anymore cause of the missing service. This seemed to have overcome our issue.

Tip to stay healthy:
When installing the turnkey solution, it is highly recommended to keep the right documentation at hand: Installing and Deploying LiveCycle® ES Using Turnkey.

Did you run into this issue as well? Please let us know if this worked for you or if you have additional tips for our readers.

Prescription:
It is recommended to point these administrators to the Adobe AIR Administrator’s Guide which covers enterprise deployment and configuration of Adobe AIR.

We have found that not all desktop administrators are aware of the ability to ‘lock down’ the Adobe AIR runtime when deployed within their organization. They tend to think that once Adobe AIR has been deployed on the desktop, that all users can just install any application which has the potential to harm local resources. The guide covers most of these concerns (and if not, let us know!) and should help administrators to better identify and limit the risks involved, for example by only allowing trusted applications to run within their firewalls.

The guide outlines how on Windows, IT administrators can apply configuration settings using registry keys to prevent installation of all AIR applications, how they can only prevent installation of untrusted AIR applications and how to disable automatic updates of the AIR runtime updates. The Adobe AIR runtime can also be silently installed, AIR based applications can be silently installed and End User License Agreements can be centrally suppressed by IT administrators (who accept the agreement on the users behalf.

Tips to stay healthy:
Adobe’s devnet has a dedicated section discussing Adobe AIR for IT administrators. It features articles on centrally distributing Adobe AIR in the enterprise and the Adobe AIR Security Whitepaper alongside the previously mentioned Adobe AIR Administrators Guide.

Not many people know that Adobe participates in quite some industry standards and supports their maturity/evolution such as BPMN, BPEL, BPDM and XPDL and that we are voting members of standard bodies such as OMG, OASIS and WFMC. Adobe is represented in all these standards bodies and actively participates in reviewing and authoring of these standards. We take a lot of that knowledge back into the decisions we make when developing our enterprise products, especially Adobe’s LiveCycle Enterprise Suite.

BPMN (Business Process Modelling Notation) is a specification for a couple of things:

• A graphical notation. E.g. How different activities are represented in a process diagram.
• Semantics of the graphical notation. E.g. What does it mean when you connect activities with a line.

From wikipedia:

The primary goal of BPMN is to provide a standard notation that is readily understandable by all business stakeholders. These business stakeholders include the business analysts who create and refine the processes, the technical developers responsible for implementing the processes, and the business managers who monitor and manage the processes. Consequently BPMN is intended to serve as common language to bridge the communication gap that frequently occurs between business process design and implementation.

Using the Process perspective in LiveCycle Workbench, one can visually create process maps that define and control your automated business processes. Since Workbench implements the main constructs for the graphical notation and the semantics of that notation as specified by BPMN, business analysts can create process diagrams using swimlanes, activities, events and associations following common modeling methodologies (we still have a gap to cover when it comes to modeling of Gateways).

To summarize: if you have been trained in BPMN, you will find it easy to model a process using LiveCycle Workbench.

If you want to read more on Adobe’s comments on BPEL and general standards, you should read this article on de LiveCycle DevNet:

ps: One should know that the current BPMN spec (v1.1) does not specify how a process diagram should be persisted by a modeling tool. There is no XML schema for example. However, there is another specification – XDPL – which does provide this and the BPMN v2 specification currently in review also has a defined schema for persistence. Since standards have not been defined or widely accepted, LiveCycle Workbench currently persist that process definition using custom XML for which Adobe has publish the XML Schema (which after installation can be found under the LiveCycle SDK/schema directory).

As Damon Cooper, Director of Engineering, wrote on his website:

With LiveCycle Data Services 2.6, you can create Adobe Flex applications that can deliver thousands of messages per second to thousands of end users simultaneously:

This document presents the results of software benchmark tests performed by Adobe engineers on my LiveCycle Data Services team and show how LiveCycle Data Services 2.6 can scale linearly and perform under load using various messaging scenarios that represent real-world situations. It provides a starting point for those who need to plan a hardware and software infrastructure that scales in a linear fashion to meet peak period demand.

You can download the Capacity Planning Guide for LiveCycle Data Services 2.6 from www.adobe.com/go/lcds26_cap_planning_guide.

Disease:
You are planning the architecture of your LCDS Messaging based application and you asked yourself the following questions:

• Is the order in which the messages are delivered to the clients always guaranteed, and does that depend on which channel you use?
• If you have many concurrent consumers/producers connected to your messaging destination, but the consumers/producers don’t generate a lot of messages, would that have more impact on the processor or the memory

Prescription:
DrLiveCycle checked back with the engineering specialists (Jeff Vroom and Mete Atamel helped the doctor with the right diagnose) and learned that the order of messages from server to client are currently only guaranteed when using the RTMP channel. A RTMP channel uses only a single TCP connection and therefore the message order is always guaranteed. The AMF/HTTP channels, on the other hand, may issue concurrent HTTP requests over multiple TCP connections and even though each TCP connection guarantees its message ordering, there’s no message order guaranteed across multiple TCP connections. So, currently the order is only guaranteed with RTMP channels.

So how about memory and CPU usage of low-active consumers? The answer is that an inactive consumer would just take up memory (there is the connection memory, session memory etc.). The only CPU load that an idle messaging client would take up is any load caused by polling, or the heart-beat style functionality that was put into the HTTP streaming channel.

Tips to stay healthy:
The polling overhead is fairly easy to compute based on your settings – how long does the request wait on both the client and the server. The streaming overhead is pretty low… periodically the server has to send some bytes back on the connection to keep it alive. The RTMP channels – when not using the RTMPT HTTP polling mode – don’t have any significant overhead.

Prescription:
Typically why a turnkey install won’t proceed from this point is due to a “Directory too deep for turnkey installation” error.  What this means is that the directory you are running the installer from (say, a network location such as \\SomeServer01\Software\Installations\, or a folder somewhere deep in My Documents and Settings – like your desktop folder) is too distant from the location you are trying to install to and LiveCycle and the path between them is too long for LiveCycle to use. So the solution is to choose for an install directory in e.g. your C:/ drive.

Tip to stay healthy:
LiveCycle can be installed ‘manually’ which allows you to deeply integrate it into applications (java application servers, databases etc) that have already been deployed in your environment. However, it means that there is a lot of configuration that you have to do yourself.

As a developer that is often not the first thing you want to have to bother about, especially not when you start learning what LiveCycle can do for you.  Or, you do not even have all the required software installed at all. In that case the Turnkey install option is a great trouble saver.

Adobe LiveCycle ES Updater 1 comes with Turnkey installers for JBoss, Websphere as well as Weblogic for both Windows and UNIX. As with most of the Adobe software there are trials available online, at www.adobe.com/go/lces_trial.

Prescription:
Some more background on this problem first; You probably know that a server in production will behave differently when interacting with a RIA than compared to serving traditional HTML apps that you have been building before.  This is mainly because UIs are not generated on the server any more. Though on the other side, there is probably increased data exchange between the client and server and most of all…. ideally you use the ActionScript Message Format (AMF) and Data Management cause it is easier to develop or faster on the client.  But how does it impact the server, can it handle the load and do traditional load testing tools still work?

Adobe currently hosts the LiveCycle Data Services Stress Testing Framework on Adobe Labs which addresses lots of these questions. The framework helps developers that use LiveCycle Data Services ES 2.6 to load test the server-side implementation of their LCDS applications. The page is stuffed with information on how to use the Framework so definitely spend some time going through all the details. The Data Services Stress Testing Framework is currently in beta form, but available for testing and evaluation. You can download and test the framework and we obviously hope you will provide us your feedback through the Adobe Labs page.

Tips to stay healthy:
The stress / load testing problem itself has been around for long, and many software vendors have created solutions to help web developers test their servers for large rollouts. However, most of these solutions are still based on the traditional HTML web metaphor and do not work well with AMF. Also, the Data Services Stress Testing Framework currently does not support BlazeDS or other AMF server implementations. Adobe is currently working with a number of testing tool vendors to implement all of the data transport protocols available in Flash. It seems that Borland’s SilkPerformer is one of the first to have AMF3 support. I have not worked with it myself and would love your feedback. Obviously if you know of other tools that are useful for load testing your Flex applications, feel free to leave a comment!

ps: I heard internally that we are working on a new Capacity Planning Guide for LiveCycle Data Services ES 2.6 whitepaper, but it has not yet been finalized. I assume it will be posted in the coming weeks on the LiveCycle Development Center so stay tuned.

UPDATE: You can download the Capacity Planning Guide for LiveCycle Data Services 2.6 from www.adobe.com/go/lcds26_cap_planning_guide.

Prescription:
In LiveCycle you can use XPath to write expressions to get access to document attributes and write those values into a process variable. The expression to get the filename would be:

getDocAttribute(/process_data/@doc_input, “basename”)

Tips to stay healthy:
The getDocAttribute function is documented on LiveDocs but it does not list all the string names for document attributes that you can retrieve (read on….). There is also a page on Document attributes for attachments and notes.

A really cool way to find out what attributes are available to you, is to use a new feature of LiveCycle Workbench named Record and Playback. This way you just Record a running process which takes a document as input parameter. Then during playback you can introspect that document variable and then Workbench will list all attribute variables available! When I did this in my processes I noticed that the available attributes depends on the document you submit (and it might explain why they are not documented) to just name a few; ‘Length’, ‘ContentType’, ‘Wsfilename’, ‘Basename’ and ‘file’.

[updated on 25th] Added the tip to use Workbench Record and Reply to find document attributes.

Together with this release there is also separate trial downloads available for updated releases of LiveCycle Designer ES and LiveCycle Data Services ES 2.6 (for those Flex developers that don’t dare to get their hands dirty on the rest of LiveCycle yet, hehe).

If you are new to LiveCycle I highly recommend the turn key option with the JBoss download, which is ideal for evaluation purposes. This will install the application server, database, and samples with just a few mouse clicks.

For an overview of new features in LiveCycle ES Update 1:

• New LiveCycle Data Services ES 2.6 features

• What’s new in Adobe LiveCycle Designer ES Update 1

• What’s new in LiveCycle ES Update 1

Installing the software is pretty straightforward, especially when you follow the steps listed in How to Get Started and choose the turn key installation. However, if you are having issues or need help evaluating specific parts of the LiveCycle Enterprise Suite, feel free to contact us for questions or even better… make an appointment for a free consult with DrLiveCycle.