Progress Spark Toolkit
The Progress Spark Toolkit is a CCS-compliant reference implementation from Progress meant to aid in creating an ABL application which provides RESTful API's for microservices. This repository primarily contains ABL artifacts and was built specifically for the Progress Application Server for OpenEdge to provide the back-end (server-side) support for exposing ABL logic via HTTP/HTTP.
Latest Release: v4.3.0 (September 2018) for OE 11.7.3
OpenEdge 11.7.3 or later is required, with the current toolkit release being compiled on version 11.7.3 and utilizing several product improvements available. Some new features appearing in the 4.3.0 release utilize code available in the (forthcoming) 11.7.4 release, and are provided automatically in the Spark.pl for this release.
- Apache Ant 1.9.x+ (now included with OE 11.7+ at DLC/ant)
- Progress Compile Tools, aka. "PCT" (now included with OE 11.7.3 at DLC/pct/PCT.jar)
As previously mentioned, the Progress Spark Toolkit library is intended for use with the Progress Application Server for OpenEdge (PASOE) as the target for deployment of applications. As such, projects utilizing the framework are expected to be of type "ABL Web App" and deployed to a PAS instance with the exposed Data Services.
- Copy the
/dist/Spark.pllibrary to your project's AppServer directory.
- Add the procedure library to the PROPATH of your project.
- At deployment, copy any PL's into the
CATALINA_BASE/openedgefolder of your PAS instance.
- Add the procedure libraries to the PROPATH of your server instance.
- Copy the .json and .cp files from the
/cfg/folder to a new
- If intending to utilize OERealm security, copy the
CCS Note 1: If using 11.7.0-11.7.2 you will need to include the
/dist/Ccs.pl along side the
Spark.pl mentioned above. This is due to a minor typo in 11.7.2's initial inclusion of the CCS classes, which prevented one toolkit class from compiling correctly. This has since been corrected as of the SP3 release.
CCS Note 2: The product-provided CCS r-code is located in the
DLC/gui/OpenEdge.BusinessLogic.pl library. Source code is not included within the product-bundled PL file, but does exist within Spark-Toolkit repository in the
Contributions / Changes
This repository should be ready to use as-is within Progress Developer Studio for OpenEdge by importing as an existing project from the
/src/ directory. At this time the contribution model allows fixes from any interested party, subject to accepting the contribution agreement upon check-in of changes. Please see the
CONTRIBUTING.md file for more information. Pull requests may still be reviewed prior to acceptance.
Builds / Distribution
To create an updated distribution of the PL libraries, utilize the "ant" program from within the
/src/ directory. Running "ant" without options will display basic usage instructions. For example, to build the
Spark.pl file you would use the target
build_spark_pl which requires a variable
version to be set. The following command would produce a new version of the PL in the
/dist/ folder, reflecting the version "4.3.0":
ant build_spark_pl -Dversion=4.3.0
Please view the "docs" folder to view various forms of documentation for the available code (ABLDuck and PCTDoc). These formats can be re-generated using the same "ant" script as noted above for builds according to the usage instructions. Supplemental guides and supporting resources may be found in this directory as well.