Growing list of Aware IM developer tools, tips, news and resources.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Aug 10, 2018
Kendo-UI Added files via upload Apr 7, 2016
Signature Delete signature_pad_2.2.0.js Aug 21, 2018
README.md Update README.md Oct 16, 2018

README.md

Aware IM Developer Resources

Aware IM is a rapid application development tool that lets you create powerful aesthetically appealing web applications quickly. Aware IM developer tools, tips, news and resources.

Software

Written in 100% Java programming language. Aware IM is based on the plethora of Java technologies such as J2EE application server, JDBC, JMS, JSP/servlets technology, web services etc. These are robust technologies that have been proven in the industry.

  • Currently v8.1 build 2477 - 9 Oct, 2018.
    • Roadmap
      • Version 8.2
        • Multi-developer mode
        • Debugger
        • SAML support (Single Sign On framework)
        • Custom HTML forms
        • Kanban boards
    • Latest Improvements in version 8.1
      • 2675 - Save Form option for the Start Process operation
      • 2468 - NEXT_DAY_OF_WEEK and PREV_DAY_OF_WEEK functions
      • 2467 - Ability to use tag expressions in the URL of a REST service
    • Recent Improvements in version 8.1
      • 2464 - READ_TEXT_FILE function
      • 2464 - URL_ENCODE, URL_DECODE functions
      • 2464 - Ability to disallow "Add record" functionality when tabbing from last row during inline editing using Advanced Scripts for standard query (parser.m_doNotAddNewOnTab=true)
      • 2460 - DOWNLOAD DOCUMENT action
      • 2454 - Microsoft Graph added to the list of OAuth providers
      • 2454 - All exe's are digitally signed
    • 8.1 Release Improvements
      • Tomcat 8.5
      • EXEC_STRING action
      • EVAL_STRING function
      • Support of HTML text in reports: <<Object.HTMLAttribute,html>>
      • LOG action (put record in the rule log)
      • LOG CONTEXT action
      • COMMIT TRANSACTION action
      • Transaction isolation level for processes
      • Search Script command now also searches HTML
      • Space elements vertically and horizontally in Report Designer
      • Support for "last modified date" in a business space version
      • Option to not delete a message on the server when handling incoming emails
      • "Display paging bar only if necessary" property for grids
      • Vertical column headers in grids
      • "Max file size" property for document and picture attributes
      • "Allowed extensions" property for document and picture attributes
      • Ability to enter dates using masked text input
      • In a query with inline editing and default operation - if a cell is not editable, the default operation is invoked
      • Ability to specify section name in ENTER NEW, EDIT and VIEW actions: ENTER NEW Obj USING Main SECTION Main
      • It is now possible to include shortcuts into editable attributes for calendars (default pop-up form). They are edited as drop downs (similar to inline editing of shortcuts in standard queries)
      • Borders between multi-attribute cells are displayed in the form designer
      • Objects put in the Context by an ordered query (FIND ... ORDER BY) maintain their order when processed
      • Ability to sort attributes in a BO by Name, Type and Required
      • Ability to save a form when a focus is lost
    • 8.1 New Features
      • Consuming REST services (with OAuth support)
      • "Dynamic" columns for queries and references - perform calculations on the fly
      • Picture attributes support storage in file system. If storage happens to be inside web application directory, images are displayed using links to their storage, rather than generated again
      • New Kendo UI library
      • Ability to add Calendar widget to the HTML of a content panel in a VP
      • Support for embedded spreadsheets
      • New Jasper Reports Library
      • support for position types of all elements
      • ability to insert page break anywhere
      • support for text rotation
      • justified alignment for text
      • support for borders for text and images
      • transparency support for text and rectangles
      • line spacing improvements, indentation support for text
      • Table Element
      • Business space version comparison
      • Office Online Integration

Integrations, custom components, connectors and plugins

  • Any application offering an API for developers makes it possible to integrate with Aware IM by writing a plugin.
    • Business Intelligence
      • JasperReports® Server - Self-service Reporting and Analysis Server.
      • Power BI Interactive Data Visualization - Microsoft Power BI
  • Out-of-the-box Aware IM 8.1
    • Office Online Integration
    • Jasper Reports Library

Developer Community

Operating System

  • Windows
  • Mac
  • Linux

Apache Tomcat

Disclaimer: Use this information and instructions at your own risk. There is no support provided for any of the updates performed outside of default Aware IM installation.

Caution: Installing Aware IM update (Setup.exe), overwrites and resets Tomcat & JDK folders back to default. In fact, all files are replaced during update. Always keep all new and amended files incl. images separately and copy+paste them back once the install is complete.

Tomcat 8.5.24 32bit is the default version packaged in the Aware IM 8.1+ server installation.

Tomcat 8.0.14 32bit is the default version packaged in the Aware IM 6.0-8.0 server installation.

Tomcat 6.0.35 32bit is the default version packaged in the Aware IM 5.9 server installation.

  • Tomcat 9.0.12 - For Aware IM v6.0+ - 4 Sep, 2018. Tomcat 9 is designed to run on Java SE 8 or later.

    • ✔️ Download Tomcat v9 - Awareim v6.0+ - 64bit recommended. Manual Install. Tested and working. Don't forget to copy the latest version of tools.jar to the C:\Awareim\Tomcat\lib folder to replace the old one.
      • Migrating to v9.0.x
      • Security
        • Important fixes
          • 9.0.10 Information Disclosure CVE-2018-8037
          • 9.0.8 A bug in the UTF-8 decoder can lead to DoS CVE-2018-1336
          • 9.0.5 Security constraint annotations applied too late CVE-2018-1305
          • 9.0.5 Security constraints mapped to context root are ignored CVE-2018-1304
          • 9.0.1 Remote Code Execution CVE-2017-12617
      • Installation with Aware IM
        • Windows Based Systems
          • IMPORTANT:
            • Ensure any prior modification of existing web.xml and server.xml configurations are not overwritten with the new version. There are configuration changes in the latest version of Tomcat relating to those two files.
          • Installation Steps - Stop the Aware IM server before updating Tomcat. Do not delete your current C:\AwareIM\Tomcat folder.
            1. Extract the archive and open the folder.
            2. Open the extracted Tomcat folder.
            3. Select all files and folders and press Crl+c to copy
            4. Open you AwareIM installation Tomcat folder C:\AwareIM\Tomcat
            5. Press Ctrl+v to paste and replace all files and folders.
            6. If you have updated Java JDK (see below), copy the latest version of tools.jar to the C:\Awareim\Tomcat\lib folder to replace the old one.
            7. Rename or delete ROOT folder - This is optional. You can use this folder to store your own favicon.ico, error pages and other HTML/CSS/JS home page files.
            8. Check that there is only one ecj-4.x.jar file in the Tomcat/lib folder.
    • Tomcat 9 Documentation.
    • Tomcat 9 Changelog.
  • Tomcat 8.5.x - For Aware IM v6.0+ - 4 Sep, 2018. Latest release is Tomcat v8.5.34 (Aware IM bundled version 8.5.24) - Tomcat 8.5 requires Java SE 7 or later.

  • Tomcat 8.0.x - For Aware IM v6.0-v8.0 - Jun 29, 2018. Latest release is Tomcat v8.0.53 - Tomcat 8.0 requires Java SE 7 or later.

  • Tomcat 6 (archived) - For Aware IM v5.9 Only - Apr 2 2017 Final version Tomcat 6.0.53

  • Tomcat SSL/TLS Configuration HOW-TO - Tomcat documentation.

  • Java SE Development Kit (JDK)

    • Version 8, Update 181 (JDK 1.8.0_181-b13) - July 17, 2018. Download and install. 64bit JDK recommended.
    • Version 10 - April 17, 2018. As it stands, the key changes in JDK 10 make it incompatible with all versions of Aware IM.
      • tools.jar has been removed
    • Version bundled with Aware IM:
      • Aware IM v8.0+ - JVM Version: 1.8.0_91-b15
  • JavaMail - JavaMail 1.6.2 - August 30, 2018 Final Release. Platform-independent and protocol-independent framework to build mail and messaging applications.

  • Apache ActiveMQ™ - The most popular and powerful open source messaging and Integration Patterns server.

    ActiveMQ replaced JBoss since Aware IM version 5.8. Aware IM installs ActiveMQ 5.8.0 (06/02/2013) as part of its core server library.

    Latest version of ActiveMQ that works with Aware IM is 5.12.1. Latest release is 5.15.6 (Sep 2018).

    • Issues - Refer to the Issues tab.
    • Releases:
      • 5.15.6 Release - Sep 2018. Inconsistent vector internals error. Java 8 required.
        • Change Log
          • This release enables ActiveMQ client TLS hostname validation by default which can cause a client connection failure for server certificates that do not match the server hostname. Please refer to SSL Transport Reference for configuration and AMQ-7047 for more information.
          • This release affects applications using ObjectMessages.
        • Aware IM 8.1
          • Configurator won't start
          • Browser won't load the app
      • 5.12.1 Release - 👍 Tested and working with Tomcat 6, 8 & 9.
        • Installation
          • Extract, rename activemq-all-x.xx.x.jar to activemq-all-5.8.0.jar and replace the one in C:\AwareIM\Tomcat\lib
      • 5.8.0 Release - Default version packaged with the server installation.
  • Java Service Wrapper - - 32bit v3.5.35. 64-bit Windows versions of the Java Service Wrapper are not currently being made available in the Community Edition.

Databases

Database Connectors

  • MySQL Connectors - UPDATE TO VERSION 8.x HIGHLY RECOMMENDED

    From version 8.1 build 2461 onwards, Aware IM uses Connector/J JDBC driver version 5.1.46. JDBC driver communicates with MySQL servers.

    Prior to Aware IM version 8.1 build 2461, a very old version of Connector/J JDBC driver (3.1.12 rel. 30/11/2005) is bundled with the Aware IM installation.

    • Connector/J Versions and what MySQL and Java JDK Versions they suppor.

    • ✔️ Connector/J 8.0.x - Latest version v8.0.12, 27 Jul 2018. It supports MySQL 5.5, 5.6, 5.7, and 8.0. It supports the JDBC 4.2 specification. It is a MySQL driver for the Java 8 platform. For Java 7 or earlier, use Connector/J 5.1 instead.

      • Installation (Aware IM 8.1+)
        • Application Server
          1. Download platform independent version
          2. Extract the files and rename mysql-connector-java-8.x.xx-bin.jar to mysql-connector-java-5.1.46-bin.jar
          3. Copy and replace the existing file in C:\AwareIM\Tomcat\lib
          4. Restart AwareIM Server Control Panel
    • ✔️ Connector/J 5.1.x - Latest version v5.1.47, 17 August 2018. Suitable for use with MySQL server versions 5.5, 5.6, and 5.7. It supports the Java Database Connectivity (JDBC) 4.2 API. MySQL Connector/J is the official JDBC driver for MySQL.

      • Download - Download the latest Platform Independent version.
      • Changes and Release Notes
      • Aware IM Forum post
      • Installation (Aware IM 8.0 and under)
        • Application Server
          1. Download platform independent version
          2. Extract the files and rename mysql-connector-java-5.x.xx-bin.jar to mysql-connector-java-3.1.12-bin.jar
          3. Copy and replace the existing file in C:\AwareIM\Tomcat\lib
          4. Restart AwareIM Server Control Panel

End-to-End Solutions

  • Telerik Platform - Complete cross-platform solution to design, build, deploy, manage, and measure all your mobile apps.

Web Application Framework - HTML5/JS Framework

Mobile Web Framework

Front-end Framework

  • Bootstrap - For Aware IM version 5.x & 6.x only; Aware IM 7.0 has bootstrap integrated as part of Kendo UI.
    • Bootstrap v4 - Currently v4.1.3 - Not tested with AwareIM 6.0 or below. Some v3 features dropped.
    • Bootstrap v3 - v3.3.7 (final).
      • Integrating with Aware IM
        • Manual configuration through Startup.html
        • disable legend style with /* */ brackets as it seems to be in conflict with the ExtJS style
          • /* legend { display: block; width: 100%; padding: 0; margin-bottom: 20px; font-size: 21px; line-height: inherit; color: #333; border: 0; border-bottom: 1px solid #e5e5e5; } */
    • LayoutIt! - Drag & drop layout builder
    • Huge list of bootstrap resources
    • Bootstrap Tutorial
  • Front-end Frameworks with comparison - Collection of best front-end frameworks
  • Front End Development Bookmarks - A huge list of frontend development resources collected over time.

Aware IM Internal Features

  • Electronic Signature Capture - For Aware IM 5.9+
    • Signature Pad - Implement and store electronic signatures out-of-the-box with Aware IM. HTML5 canvas based and works in all modern desktop and mobile browsers.
    • DEMO - Github
    • Signature Pad v3.0.0-beta.3 - (c) 2018 Szymon Nowak. Tested ok in 8.1.
    • ✔️ Signature Pad v1.5.3 - Tested and working in all versions 5.9+
    • Installation:
      • Get the desired version from here or here
      • Replace ../AwareIM/signature/signature_pad.js with the new version.
    • Options - Edit signature_pad.js found in C:\AwareIM\Tomcat\webapps\AwareIM\signature
      • dotSize - (float or function) Radius of a single dot.
      • minWidth - (float) Minimum width of a line. Defaults to 0.5.
      • maxWidth - (float) Maximum width of a line. Defaults to 2.5.
      • backgroundColor - (string) Color used to clear the background. Can be any color format accepted by context.fillStyle. Defaults to rgba(0,0,0,0) (transparent black).
        • I prefer a **white background "rgb(255,255,255)"** for the signatures since there are issues with transparent images in the Report Designer and PDF document export.
      • penColor - (string) Color used to draw the lines. Can be any color format accepted by context.fillStyle. Defaults to "black".
      • velocityFilterWeight - (float) Weight used to modify new velocity based on the previous velocity. Defaults to 0.7.
      • onBegin - (function) Callback when stroke begin.
      • onEnd - (function) Callback when stroke end.
    • Video Tutorial (approx. 3min) - from 00:38min
  • Social Logins

Hybrid Native Apps

  • Phonegap support

Extending Aware IM

  • wkhtmltopdf - Convert HTML to PDF using Webkit (QtWebKit)

    • Requires Microsoft Visual C++ 2015 Redistributable Update 3 - Download and install first.
    • Download wkhtmltopdf:
    • Install wkhtmltopdf
      • Windows
        • Extract *.exe file to a folder (you can use 7-Zip), copy+paste wkhtmltopdf folder to c:/AwareIM
    • github.com/wkhtmltopdf/ - wkhtmltopdf is a command line tools to render HTML into PDF using the QT Webkit rendering engine. These run entirely "headless" and do not require a display or display service.
    • Aware IM Process Rules
      • Step 1 - Export Aware IM HTML Document to a HTML file
        • EXPORT DOCUMENT 'Your HTML Document' TO FILE 'C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.html'
      • Step 2 - Convert exported HTML file to PDF
        • EXECUTE PROGRAM 'C:\AwareIM\wkhtmltopdf\bin\wkhtmltopdf.exe file:///C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.html C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.pdf'
      • Step 3 - Import PDF document to your myBO.DocumentPDF attribute
        • IMPORT DOCUMENT myBO.DocumentPDF FROM 'C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.pdf'
      • Optional - Delete exported HTML file
        • DELETE FILE 'C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.html'
  • Prince 11 - Convert your HTML documents to PDF.

    • Sample Documents - Dictionary, Invoices, Textbook, Scientific Journal, Product Catalogs, Brochure ...
  • Business Intelligence, Report Writer/Server

News

The creators of Kendo UI, Progress Software have been recognized by Gartner as a Leader in the 2017 Gartner Magic Quadrant for Mobile Application Development Platforms (MADP). Kendo UI is the HTML5/JS Framework that powers Aware IM created web and mobile apps. Read more