Although this describes the steps required on Windows it should basically work on Linux and Mac too.

First you need to create a local keystore file, it contains your private key and you add to it your registered certificate. Fortunately AwareIM comes with Java environment.

changit is a standard password expected by Tomcat and unless you want to tell Tomcat explicitly that the password is different, I would stick with this one. It creates file . keystore in your home directory, in my case it was C:\Documents and Settings\Administrator.

Next you need to adjust Tomcat settings. Open file server.xml in AwareIM\Tomcat\conf directory and remove comment tags around the element on SSL connector

Needless to mention that AwareIM should not be running. That is all you need to use secure connection on https://www.yourserver.com:8443/AwareIM/. You do not have to get a certificate signed by a recognised CA if your site is not for external customers who may be scared away by the browser’s security message it displays if a certificate is not signed.

If you do need a signed certificate you have to create a certificate request. Use you private key in the .keystore file to create a request and run this line:

You have to enter certain information like names and contacts in your organisation. For most CA’s you need to enter your site URL as the name. Check your CA instructions for details.

Some CA’s send only one certificate which makes the process slightly easier while many send you the web certificate and require you to download a root or chain certificate. You need to load both certificates to the same .keystore file that you used to create the certificate request. Be aware that some CA’s send certificates as text and you need to convert them to binaries with openSSL; check openssl.org and find a link to an installation package.

You have to load a root (chain) certificate to the keystore first:

Then do the web certificate with

Restart AwareIM and it should work on https://www.yourserver.com:8443/AwareIM/…

For example you can run a process that says

FIND BOExample WHERE BOExample.Attribute1=’Yes’
UPDATE BOExample

This is a simple process that causes rules attached to BOExample to execute.
For example such a rule could contain:

BOExample.Attribut2=CURRENT_TIMESTAMP

What’s happening is  a SQL statement like

UPDATE BOExample SET Attribute2=CURRENT_DATE WHERE Attribute1=’Yes’

OK, 3 lines of AwareIM code compared to 1 SQL statement. But let’s take a look on how we could manage this in MS-Access code. (I just typed the code here – so I don’t know if the syntax is 100% correct)

set rs=currentdb.openrecordset(“select * from BOExample where Attribute1=’Yes’)
do until rs.eof
rs.edit
rs!Attribute2=current_timestamp
rs.update
rs.movenext
loop

You might ask what Access code has to do with AwareIM – well I’d like to explain AwareIM’s execution context based on a quite common and easy understandable language…

FIND BOExample …. does what set rs = currentdb… / do until rs.eof does. It finds all desired records and puts all of them into the context. Afterwards it executes UPDATE BOExample for every BOExample in context. Just like my do/loop construction above. Calling UPDATE BOExample triggers the execution of the rules attached to BOExample. This rule now has it’s own execution context with only 1 instance in it.

Now let’s assume that we don’t want a simple assignment of CURRENT_TIMESTAMP to Attribute1. Now we want to find data from some other Business Object. Our rule could read like

FIND BOTest WHERE BOTest.Attribute1 = ‘abc’
BOExample.Attribute2=BOTest.Attribute2

When the rule gets executed then there’s the 1 instance of BOExample in it’s context. Now we find a BOTest and this BOTest also gets put into the context. Afterwards it gets assigned to BOExample

One drawback of this approach ist that the rule doesn’t only get executed when the process gets called. It also gets executed every time BOExample is updated. Either by user interaction or by some other Process that modifies BOExample.

Well, so I change the process to:

FIND BOExample WHERE BOExample.Attribute1=’Yes’

FIND BOTest WHERE BOTest.Attribute1 = ‘abc’
BOExample.Attribute2=BOTest.Attribute2

If you think that we’re now done then you are wrong ! The process above will modify only the first BOExample ! Why ? Read on….

FIND BOExample places several instances into the context. After that AwareIM starts to call FIND BOTest for every BOExample, but FIND BOTest destroys the context created from FIND BOExample !
In case you are a little bit familiar with coding in Access then take a look at the following code:

set rs=currentdb.openrecordset(“select * from BOExample where Attribute1=’Yes’)
do until rs.eof
set rs=currentdb.openrecordset(“select * from BOTest where Attribute1=’abc’)
do until rs.eof
rs.edit
rs!Attribute2=rs!Attribute2
rs.update
rs.movenext
loop
loop

This code won’t work too ! If you take a close look then you’ll note that I’ve assigned the variable rs twice. The second “select * from ….” gets assigned to the same variable and destroys the previous content. In Access it would be easy to solve. I’d just change it to

set rs=currentdb.openrecordset(“select * from BOExample where Attribute1=’Yes’)
do until rs.eof
set rs2=currentdb.openrecordset(“select * from BOTest where Attribute1=’abc’)
do until rs2.eof
rs.edit
rs!Attribute2=rs2!Attribute2
rs.update
rs.movenext
loop
loop

I only changed the second set rs=… to set rs2=…
In AwareIM it’s a little bit more tricky.

Process1

FIND BOExample WHERE BOExample.Attribute1=’Yes’
Process2

Process2 with BOExample defined as process input

FIND BOTest WHERE BOTest.Attribute1 = ‘abc’
BOExample.Attribute2=BOTest.Attribute2

Now I have 2 processes. The first finds the desired BOExamples and puts them into the context. For every instance in context it executes Process2 and passes the current instance of BOExample over to Process2. That’s why we need BOExample as input for Process2. Since there’s now only one instance of BOExample in the context of Process2 finding instances of BOTest doesn’t destroy the other instances in context.

I hope that I could shed some light on how AwareIM forms its context. Please feel free to register yourself on this site and post comments.

• I’ve created 2 Business Objects called Object1 and Object2 as usually.
• The magic comes from a 3rd Object called InlineEdit. This Object contains a dummy field and the fields Object1 an Object2. Object1|2 are defined as PEER and Multiple Allowed.
• InlineEdit contains 2 forms. Again Object1 and Object2 containing only 1 field with the respective object. This is the place where inline editing is activated.

• Because Object1|2 don’t know anything about their parent it’s up to us to tell the parent about its children. (And I don’t want to tell the children about their parent because this should work without changing the database structure when used on existing solutions).
• A rule in Object1|2 says
  FIND InlineEdit WHERE InlineEdit.Dummy=1
  INSERT Object1 IN InlineEdit.Object1
  InlineEdit contains 1 record that gets created by a initailization process. And all added Object1|2 get added to this one.
• Since the standard “Delete” operation would only remove the items from the list I’ve created a process DeleteObject1|2 that’s responsible for actually deleting the objects.
• Editing Object1|2 is done by the process EditObject1|2 that contains
  FIND InlineEdit WHERE InlineEdit.Dummy=1
  VIEW InlineEdit USING Object1
  and brings up the form defined in object InlineEdit.

A .bsv file of the above is available here.

The following solution has been tested (and used successfully) against another MySQL database but I don’t see any reason why this shouldn’t work with the other supported DBMS like MS-SQL, Derby or any other ODBC DB.

1. Create the Business Object with all required attributes in AwareIM where you want to store your data after importing. Lets call this BODestination
2. Create a new Business Object (lets call it BOexternal) and choose “Database: existing external” from the Persistence Drop Down.  The button [Settings] now brings you to a window where you can specify the desired database connection. From this table you’ll be importing the data.
3. Once you have established the connection you can hit  [Discover attributes] and the fields from your database table should be published as attributes of your BOexternal.
4. Now create a Process that executes:
   FIND ALL BOexternal UPDATE BOexternal
   This process doesn’t make any changes to your data but allows the following rule to be executed.
5. Attach a rule to BOexternal
   CREATE BODestination WITH
   BODestination.Attribute1=BOexternal.Attribut1
   BODestination.Attribute2=BOexternal.Attribut2
   and so on.

That’s it. Now start the process from Step 4 and all your data will be moved from BOexternal to BODestination

If you should use this approach then please don’t try this on any valuable productive data but use a backup copy !
I am not responsible for any data loss or damage that might occur !

It doesn’t contain detailed descriptions on how to use a function. There’s only the name, an example of usage and somethimes a short note. The data comes from the AwareIM Help System.

PDF-Version OpenOffice Version

Scenario

• We have about 2000 customer records in a MSSql database that are required in a AwareIM solution. Updates don’t happen very often (almost never) but a few customers might be added every day.
• So the plan is to export the data from the MSSql server using a scheduled task and to import them into AwareIM by a process that gets called by the user when required.

Problems

1. AwareIM’s IMPORT function doesn’t support adding AND updating data from the same file (correct me if I’m wrong)
2. We need to do some field assignments like Customer.Name1 to Customer.Company
3. AwareIM needs the header in the form Table.Field which causes troubles to Microsoft Software because they don’t like periods in field names at all.

The MSSql Server Part

dataexport.cmd (gets executed every 15 minutes)

“C:\Programs\Microsoft SQL Server\80\Tools\Binn\DTSRun” /~Z0x7A……54134EFA
cd \data\export
type header.txt > dataexport.txt
type data.txt >> dataexport.txt
pscp -pw xxxxx dataexport.txt admin@appsrv.local:awareim/importexport/dataexport.txt

1. Using the Data Export Wizard on or MSSql 7.0 server I created a package that writes the whole table to data.txt
2. Creating a scheduled task on the SQL server’s Enterprise Manager that starts this package worked but every scheduled run ended in an obscure error message telling me that a file can’t be found. So I used the command line from the scheduled task and put it into a .cmd file that executes fine using Windows’ own task scheduler %-)
3. As stated above the data file needs a header line in the form table.field that can’t be produced by Microsoft. So the export must only contain the data with no headers. The headers come from a manually created additional file called header.txt.
4. Copy could also be used to join these 2 files together but after that the last line contained a strange character that stopped AwareIM’s process. Type works fine…
5. pscp  is used to copy the file via SSH to our linux appsrv

The AwareIM Part

1. Create a table (or Business Object) dataimport that contains the same attributes than the data.txt
2. Now it’s time to create a process that:
3. Imports data.txt into dataimport
4. Activates a rule in dataimport that:
5. checks if the record is new in this case a new customer has to be created
6. checks if the record is changed in this case the customer gets updated
7. clears dataimport

That’s what the following process does

IMPORT dataimport FROM SystemSettings.importfile
FIND ALL dataimport
UPDATE dataimport

First it imports the data. After that it finds every record an executes an update on this record. And UPDATE causes the rules of dataimport to get active.

The rule of dataimport contains:

If NOT(EXISTS customer WHERE (customer.KHKID=Thisdataimport.ID)) Then
CREATE customer WITH customer.company=Thisdataimport.Name1,customer.KHKID=Thisdataimport.ID, …….

which checks if the current imported record already exists in customer. If not then the customer is created

If you say that the process could also be made like
IMPORT dataimport FROM SystemSettings.importfile WITH VALIDATION
then be warned ! On a P4 2,4GHz with 1 Gig Ram the whole process ran about 1 hour ! Whereas the solution shown above finished it’s work after about 30 seconds. And yes, the data is the same !

Simply replace …/AwareIM/Tomcat/webapps/AwareIM/index.html with the following.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<script language="JavaScript">
function doSubmit() {displayWindow = window.open('', "newWin","scrollbars=1,menubar=0,toolbar=0,resizable=1,location=0,status=0");
document.submitForm.submit();document.submitForm.reset();}
</script>
</head>
<body>
<div align="center">
<form name="submitForm" method="post" action="http://localhost:8080/AwareIM/logon.do?actionMethod=commit&amp;domain=CRM" target="newWin">&nbsp; Username<span>:</span> &nbsp;
<input name="username" size="17" type="text"><br>
<span>&nbsp;&nbsp;&nbsp;Password</span>:<span>&nbsp;</span>
<input name="password" size="17" type="password"><label></label><p> &nbsp;
<input name="button" value="Logon" onclick="doSubmit()" type="button"></p>
</form>
</div>
</body>
</html>

Also note that when running AwareIM on Linux the path names are case sensitive.

The above is a slightly modification from brad’s original posting on the AwareIM Forum

using MySQL “almost” works out of the box but not with MySQL 4.1 on linux

If you want to connect AwareIM to a MySQL database you have to make some adjustments to BASServer.props file in awareim/bin. This is well documented in the user’s guide.

But in case you have an MySQL 4.1 db (I don’t know if this applies to older versions too) then you need to add useServerPrepStmts=false to the 3 lines dealing with you MySQL connection.

DriverURL=jdbc:mysql://localhost/BASDB?user=root&password=idontremember&useServerPrepStmts=false
DriverTestURL=jdbc:mysql://localhost/BASDBTEST?user=root&password=idontremember&useServerPrepStmts=false
BootstrapURL=jdbc:mysql://localhost/?user=root&password=idontremember&useServerPrepStmts=false

This has also been discussed on the AwareIM Forum ]]> http://www.hiden.org/awareim/running-awareim-against-mysql-4-1/feed/ 0 http://www.hiden.org/awareim/awareims-session-timeout/ http://www.hiden.org/awareim/awareims-session-timeout/#comments Tue, 16 Jan 2007 17:38:27 +0000 admin http://hiserver/hiden.org/?p=66 Setting a longer session timeout value requires to change 2 files
These are $awareimroot$/bin/BASServer.props and $awareimroot$/Tomcat/webapps/AwareIM/webapp.props.
SessionTimeout is a value given in milliseconds. This means that
SessionTimeout=3600000
gives a timeout of 3600 seconds or 1 hour.

To avoid this go to
$AwareIMroot$/Tomcat/webapps/AwareIM/WEB-INF
open web.xml in any text editor
search for

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>

now change this to

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
</welcome-file-list>

In order to make these changes active you have to restart Tomcat.

Since the default index.html shows the message “Loading….Please Wait” it’s likely that you’d like to change this into a starting page for you application.