Skip to content

guoyu07/AwareIM-resources

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

495 Commits

Kendo-UI

Kendo-UI

 
 

Signature

Signature

 
 

README.md

README.md

 
 

Repository files navigation

Aware IM Developer Resources

Aware IM is a rapid application development tool that lets you create powerful aesthetically appealing web applications quickly. Here you'll find a growing list of Aware IM developer tools, tips, news and resources.

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

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.

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), overwites 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 complate.

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.6 - For Aware IM v6.0+ - Mar 5, 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
      • 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.
            • Rename the extracted ecj-4.x.jarto ecj-4.4.jar found in the Tomcat/lib folder
          • 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.
    • Tomcat 9 Documentation.
    • Tomcat 9 Changelog.

  • Tomcat 8.5.x - For Aware IM v6.0+ - Feb 6, 2018. Latest version Tomcat v8.5.28 - Tomcat 8.5 requires Java SE 7 or later.

  • Tomcat 8.0.x - For Aware IM v6.0-v8.0 - Feb 07, 2018. Latest version Tomcat v8.0.50 - Tomcat 8.0 requires Java SE 7 or later.

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

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

  • Java SE Development Kit (JDK)

  • JavaMail - JavaMail 1.6.1 - February 12, 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 working version of ActiveMQ is 5.12.1.

    • Vulnerabilities - Apache ActiveMQ 5.12.1 and older versions.
      • Vulnerability Details : CVE-2015-5254 - Apache ActiveMQ 5.x before 5.13.0 does not restrict the classes that can be serialized in the broker, which allows remote attackers to execute arbitrary code via a crafted serialized Java Message Service (JMS) ObjectMessage object.
      • Vulnerability Details : CVE-2014-3612 - The LDAPLoginModule implementation in the Java Authentication and Authorization Service (JAAS) in Apache ActiveMQ 5.x before 5.10.1 allows remote attackers to bypass authentication by logging in with an empty password and valid username, which triggers an unauthenticated bind. NOTE: this identifier has been SPLIT per ADT2 due to different vulnerability types. See CVE-2015-6524 for the use of wildcard operators in usernames.
    • Issues
      • ObjectMessage - Changes starting with versions 5.12.2 and 5.13.0 causing issues with the Aware IM server.
        • Aware IM Server Output testing ActiveMQ v5.15.0:
          • ERROR: org.openadaptor.adaptor.jms.JMSListener - onMessage: JMSException: [javax.jms.JMSException: Failed to build body from content. Serializable class not available to broker. Reason: java.lang.ClassNotFoundException: Forbidden class org.openadaptor.dataobjects.SimpleDataObject! This class is not trusted to be serialized as ObjectMessage payload. Please take a look at http://activemq.apache.org/objectmessage.html for more information on how to configure trusted classes. [java.lang.ClassNotFoundException: Forbidden class org.openadaptor.dataobjects.SimpleDataObject! This class is not trusted to be serialized as ObjectMessage payload. Please take a look at http://activemq.apache.org/objectmessage.html for more information on how to configure trusted classes.]]
    • Releases:
      • 5.15.3 Release - 2018. ObjectMessage error. Java 8 Required.
      • 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.34. 64-bit Windows versions of the Java Service Wrapper are not currently being made available in the Community Edition.

Databases

  • MySQL
    • MySQL Community Server
    • MySQL Connectors - ❕UPDATE HIGHLY RECOMMENDED❕

      By default, a very old version of Connector/J JDBC driver (3.1.12 rel. 30/11/2005) is bundled with the Aware IM installation. JDBC driver communicates with MySQL servers.

      • ✔️ Connector/J 5.1.x - Latest version v5.1.45, 30 November 2017. 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 Server
            1. Download platform independent version
            2. Extract the files and rename mysql-connector-java-x.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.0.0 - 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
    • Signature Pad v2.3.2 - Sep, 2017. Untested.
    • ✔️ 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

Integrating with Aware IM

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

    • Prerequisite Microsoft Visual C++ 2015 Redistributable Update 3 - Download and install first.
    • Download wkhtmltopdf Windows (MSVC) - v0.12.4 released on November 22, 2016 for Windows, Linux and OS X.
    • 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

About

Growing list of Aware IM developer tools, tips, news and resources.

github.com/RennurApps/AwareIM-resources

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

No packages published

Languages