| Table of Contents | ||
|---|---|---|
|
Version Information
OpenEdge Release | Version Information |
|---|---|
| 11.7.9, 11.7.10, 11.7.11, 11.7.12, 12.2.7, 12.4.1, 12.5 | Release 11.7 #70241@2022-04-26 |
Security Bulletin - log4j CVE-2021-44228
Further details: log4j CVE-2021-44228
OpenEdge 12.3 support!
We are pleased to announce that we are not aware of any issues using the SmartComponent Library on OpenEdge 12.3. We hereby declare OpenEdge 12.3 fully supported for the SmartComponent Library as of the release of November 24th 2020.
OpenEdge 12.2 support!
We are pleased to announce that we are not aware of any issues using the SmartComponent Library on OpenEdge 12.2. We hereby declare OpenEdge 12.2 fully supported for the SmartComponent Library as of the release of April 09th 2020.
.NET Framework Version 4.7
.NET 4.7 is not supported with OpenEdge 11.x, see: Is .NET 4.7 certified and supported for OpenEdge?
...
When using the .NET Framework 4.7, please make sure, you upgrade to OpenEdge 11.6.4 or OpenEdge 11.7.2 or later. Also, it may be required to recompile the application on a PC running .NET Framework 4.7 when applications are also executed on a PC with .NET Framework 4.7.
Introducing the SmartComponent Library developer forum
Got questions about using the SmartComponent Library? Wish to discuss feature requests with other users of the SmartComponent Library? To facilitate networking in the growing number of SmartComponent Library users and developers, we've added a developer forum on our new home-page. The developer forum can be found at: https://www.consultingwerk.com/support/forum
A login is required to participate in the forum. Don't be shy - create your account today!
Release Notes
Following the release of the OpenEdge 11.7 Release we have completed our testing of the SmartComponent Library on this release of Progress and are proud to announce formal support for the SmartComponent Library on OpenEdge 11.7 with the 2017-04-24 release of the SmartComponent Library. Generally we recommend customers on OpenEdge 11 to upgrade to OpenEdge 11.7 quickly. Starting the 2017-07-14 release we are supporting OpenEdge 11.7 Service Pack 1 (11.7.1).
...
With SCL-1113 we have modified the templates for SmartWindowForms and SmartTabFolderPages generated from the Business Entity Designer. We have removed the initialization of the viewer controls SmartTableIOState property (value was set to "NoDataSource" within the InitializeComponent method). Customers using their own set of templates should adopt the same fix to their templates.
OpenEdge 11.7.3 compatibility
During our tests on OpenEdge 11.7.3 we have experienced the following issues:
...
The issue has been resolved by Progress Software with hotfix 007 for OpenEdge 11.7.3.
OpenEdge 11.7.2 compatibility
During our tests on OpenEdge 11.7.2 we have experienced two issues:
...
from Progress Software for in OpenEdge 11.7.2.001 we further recommend all customers to apply this hotfix as well.
New Versions of Proparse .NET Assemblies (30 December 2018)
We have updated proparse with further enhancements in this release (see https://github.com/consultingwerk/proparse/releases/tag/4.0.1.1177). Please download the .NET Assemblies ZIP file from our ESD and replace the proparse.net.dll in your environment with the latest one. The new assembly reference is:
...
This version of proparse provides additional debug information when errors are thrown from proparse.net.dll.
New Version of the Consultingwerk.SmartComponents Assemly (09 January 2019)
To support the new SmartFilterControl and the "Filter" link between the SmartFilterControl/SmartDynamciFilterControl and a SmartBusinessEntityAdapter or SmartDatasetChildAdapter we have updated the Consultingwerk.SmartComponents.dll. The new Assembly reference is:
...
Customers need to update this Assembly in order to compile the latest releases of the SmartComponent Library.
Hybrid Realm now using IAuthenticationService
We've updated the SmartHybridRealm class used for http authentication to leverage the IAuthenticationService. It is therefor required that for AppServers requiring http Authentication (e.g. REST or Web) the correct IAuthenticationService implementation is registered (using service.xml files).
...
This is required as the Hydrid Realm Interface from Progress does not provide the domain name to the authentication method.
Web Handler overview
This is an overview of the web handlers supported by this release
defaultHandler=OpenEdge.Web.CompatibilityHandler
handler1=Consultingwerk.OERA.JsdoGenericService.WebHandler.CatalogWebHandler: /Catalog/{EntityName}
handler2=Consultingwerk.OERA.JsdoGenericService.WebHandler.CatalogsWebHandler: /Catalogs/{PackageName}
handler3=Consultingwerk.OERA.JsdoGenericService.WebHandler.CountWebHandler: /Resource/{EntityName}/count
handler4=Consultingwerk.OERA.JsdoGenericService.WebHandler.ResourceSubmitWebHandler: /Resource/{EntityName}/SubmitData
handler5=Consultingwerk.OERA.JsdoGenericService.WebHandler.InvokeMethodWebHandler: /Resource/{EntityName}/{MethodName}
handler6=Consultingwerk.OERA.JsdoGenericService.WebHandler.ResourceWebHandler: /Resource/{EntityName}
handler7=Consultingwerk.OERA.JsdoGenericService.WebHandler.BusinessServicesWebHandler: /BusinessServices/{OutputFormat}/{PackageName}
handler8=Consultingwerk.Web2.WebHandler.SmartMenuWebHandler: /SmartMenu/{MenuStructureId}
handler9=Consultingwerk.Web2.WebHandler.SmartMenuStructureWebHandler: /SmartMenuStructure
handler10=Consultingwerk.Web2.WebHandler.SmartRoutesWebHandler: /SmartRoutes
handler11=Consultingwerk.Web2.Services.SmartViewsHandler.SmartGridWebHandler: /SmartViews/Grid/{EntityName}/{ViewName}/{DetailTemplate}
handler12=Consultingwerk.Web2.Services.SmartViewsHandler.SmartGridWebHandler: /SmartViews/Grid/{EntityName}/{ViewName}
handler13=Consultingwerk.Web2.Services.SmartViewsHandler.SmartGridWebHandler: /SmartViews/Grid/{CustomViewName}
handler14=Consultingwerk.Web2.Services.SmartViewsHandler.SmartViewerWebHandler: /SmartViewer/Viewer/{EntityName}/{ViewName}
handler15=Consultingwerk.Web2.Services.SmartViewsHandler.SmartViewerWebHandler: /SmartViewer/Viewer/{ObjectName}
handler16=Consultingwerk.Web2.Services.SmartViewsHandler.SmartFormWebHandler: /SmartForm/{FormTemplate}/{EntityName}/{ViewName}
handler17=Consultingwerk.Web2.Services.SmartViewsHandler.SmartFormWebHandler: /SmartForm/{FormTemplate}/{ObjectName}
handler18=Consultingwerk.Web2.WebHandler.SmartMessageWebHandler: /SmartMessage/{MessageGroup}/{MessageNumber}
handler19=Consultingwerk.Web2.WebHandler.GetImageWebHandler: /Image/{FileName}
handler20=Consultingwerk.Web2.WebHandler.SmartValueListWebHandler: /ValueList/{ValueList}
handler21=Consultingwerk.Web2.WebHandler.SmartAttachmentsWebHandler: /Attachments/{Table}/{KeyValues}
handler22=Consultingwerk.Web2.WebHandler.SmartAttachmentWebHandler: /Attachment/{Guid}
handler23=Consultingwerk.Web2.WebHandler.SessionContextWebHandler: /SessionContext
handler24=Consultingwerk.Web2.WebHandler.ContextPropertiesWebHandler: /ContextProperties/{PropertyName}
handler25=Consultingwerk.Web2.WebHandler.ContextPropertiesWebHandler: /ContextProperties
handler26=Consultingwerk.Web2.WebHandler.SessionInfoWebHandler: /SessionInfo
handler27=Consultingwerk.Web2.WebHandler.FileSearchWebHandler: /FileSearch/{FileName}
handler28=Consultingwerk.Web2.WebHandler.ExecuteAblWebHandler: /ExecuteAbl
handler29=Consultingwerk.Web2.WebHandler.SmartLanguagesWebHandler: /Languages
handler30=Consultingwerk.OERA.RestResource.RestEntitiesWebHandler: /Entities
handler31=Consultingwerk.OERA.Swagger.SwaggerWebHandler: /Swagger/{EntityName}
handler32=Consultingwerk.OERA.Swagger.SwaggerRestEntitiesWebHandler: /SwaggerEntities/{OutputType}
handler33=Consultingwerk.Web2.WebHandler.SmartTokenSecurityCheckWebHandler: /TokenSecurityCheck/{ObjectName}
handler34=Consultingwerk.Web2.WebHandler.SmartTokenSecurityCheckWebHandler: /TokenSecurityCheck
handler35=Consultingwerk.Web2.WebHandler.SmartEntityTableMappingHandler: /EntityTableMapping/{EntityName}/{TableName}/{UiTypeCodes}
handler36=Consultingwerk.Web2.WebHandler.SmartTreeRootNodeWebHandler: /SmartViews/TreeRootNode/{rootnodeid}
handler37=Consultingwerk.Web2.WebHandler.SmartTreeChildNodesWebHandler: /SmartViews/TreeChildNodes/{parentnodeid}
handler38=Consultingwerk.Web2.WebHandler.SmartSecurityCheckWebHandler: /IsRestricted/{SecurityRealmCode}/{SecurityItemGuid}
handler39=Consultingwerk.Web2.WebHandler.SmartFieldSecurityCheckWebHandler: /RestrictedFields/{TableName}
handler40=Consultingwerk.Web2.WebHandler.GetImageNamesHandler: /ImageNames |
UTF-8 based deployments available
Starting August 14th 2016 we ship our source code also as UTF-8 encoded. The ZIP files ending with _utf8.zip contain the source code encoded with that code page. The source code in the remaining archives is still encoded in ISO8859-1. Also on Github there is a new branch containing the OpenEdge 11 based source code in UTF-8.
Related article (Progress K-Base): How to get Progress Developer Studio to save in UTF-8 encoding
New Feature Documentation
- Support for RESTful invocation of Business Task and Business Entity Methods
- Invalid Proparse code-page setting corrupts temp-table field labels during "Refresh from Include"
- Generic Factory Service
- Using Invokable Business Entity Methods with Dataset Model Classes
- Using the Business Entity method FetchDataByKeyTable
- PASOE management scripts
- Business Entity Designer Launcher
- Searching data using ROWID's within the SmartBusinessEntityAdapter
- Business Entity Count Method
- SmartFramework ERD Designer
- Changes to the SmartDB and SmartDB upgrade and migration utility
- How to implement dynamic initial values
- How do I control the amount of details provided for error messages caused by our web handler
- Using custom log entry types
- Strong-typed Query Support
- Swagger REST API Documentation for RESTful Services
- Swagger REST API Documention for JSDO Generic Service
- Scaffolding utility for common helper classes
- RESTful services
- JSON Configuration File Format
- Common Component Specification (CCS)
Download Link
http://esd.consultingwerkcloud.com/
https://github.com/consultingwerk/SmartComponentLibrary
Overview of included tickets
Bug
SCL-3645 Resolve issue in DatasetModel/TableModel with BufferCopy method an Enum properties
Description:
We have resolved an issue in the TableModel. During the BufferCopy method CHARACTER fields of the temp-table that have been mapped to Enum properties have not correctly been handled. This issue is now resolved.
SCL-3648 Error fetching user profile with large number of groups the user is member of
Description:
.
SCL-3651 ModelClassGenerator Business Entity Designer plugin failed when only generating the Dataset
Description:
We have resolved an issue in the ModelClassGeneratorPlugin causing a runtime error when the model is configured to only generate the Dataset and Temp-Table definitions but no Business Entity class.
SCL-3654 Fixed issues with TimeZonesService after German day-light-saving time switch
Description:
We have resolved issues with the TimeZonesService caused by summer-time zones.
SCL-3656 Rendering of DefaultToolbar as "Panel" on a MetaPanelContainer crashed the AVM
Description:
We have resolved a crash of the AVM when a DefaultToolbar on a MetaPanelContainer was rendered as a Panel.
SCL-3657 Fixed issue in RestServerSessionActivator issue when no Login company/domain provided
Description:
We have resolved an issue in the RestServerSessionActivator that could have caused a runtime error when no login company or domain was provided.
Improvement
SCL-2419 Implemented optional behavior for the SmartBusinessEntityAdapter to perform asynchronous AppServer calls for RetrieveData
Description:
We have implemented be ability to perform the initial RetrieveData request done by a SmartBusinessEntityAdapter instance using an asynchronous AppServer request. Requests made to retrieve additional batches are still performed synchronously.
The new behaviour is enabled by setting the RetrieveDataAsync property to true before calling into the RetrieveData method.
Around the asynchronous request the following new events are raised:
* AsyncRequestStarting
* AsyncRequestStarted
* AsyncRequestCompleted
SCL-3627 Add functionality for supporting MoveFolder to the FileHelper class
Description:
We have added two new method to the FileHelper class:
| No Format |
|---|
/**
* Purpose: Moves files from one path to a target directory
* Notes:
* @param pcSourcePath The source file path
* @param pcFileMask A comma-delimited list of file patterns to copy (e.g. *.xml,*.resx)
* @param pcTargetPath The directory to copy into
*/ |
and
| No Format |
|---|
/**
* Purpose: Moves files from one path to a target directory
* Notes:
* @param pcSourcePath The source file path
* @param pcFileMask A comma-delimited list of file patterns to copy (e.g. *.xml,*.resx)
* @param pcExcludeFiles A comma-delimited list of relative file names to exclude from copy
* @param pcTargetPath The directory to copy into
*/
METHOD PUBLIC STATIC VOID MoveFiles (pcSourcePath AS CHARACTER,
pcFileMask AS CHARACTER,
pcExcludeFiles AS CHARACTER,
pcTargetPath AS CHARACTER): |
The methods support moving files from one folder to another with an optional pattern for file-exclusions.
The method first performs a copy operation and then deletes copied files. When an error occurs the method tries to undo the partial operation.
SCL-3650 SmartRadDataBrowser now scrolls to selected row after FindRowWhere
Description:
We have now improved the SmartRadDataBrowser (Telerik) implementation to scroll to the selected row after a call to FindRowWhere.
SCL-3653 Added support for remote hosts to PasoeControlGuiForm
Description:
We have added support for remote hosts to the PASOE Control GUI.
SCL-3655 Added more properties to the Combo-Box in the Repository
Description:
We have added support for additional properties of the UltraComboEditor to the rendering routines of the repository. Those properties now support alternative behavior of the combo-box and value-list:
* https://www.infragistics.com/help/winforms/infragistics.win.ultrawineditors~infragistics.win.ultrawineditors.ultracomboeditor~dropdownstyle
* https://www.infragistics.com/help/winforms/infragistics.win~infragistics.win.dropdownstyle
* https://www.infragistics.com/help/winforms/infragistics.win.ultrawineditors~infragistics.win.ultrawineditors.ultracomboeditor~autocompletemode
* https://www.infragistics.com/help/winforms/infragistics.win~infragistics.win.autocompletemode
* https://www.infragistics.com/help/winforms/infragistics.win.ultrawineditors~infragistics.win.ultrawineditors.ultracomboeditor~autosuggestfiltermode
* https://www.infragistics.com/help/winforms/infragistics.win~infragistics.win.autosuggestfiltermode
SCL-3658 SmartViewerControl now stops recursion when replacing BindingSource at SmartViewerControl instances
Description:
As customers desired nesting SmartViewerControls inside other SmartViewerControls for layout reasons, we are now stopping the recursive calls of the RecurseReplaceBindingSource method when a nested SmartViewerControl is encountered.
SCL-3659 Integrated IDE API into Proparse Tree View Form
Description:
We have integrated the new IDE API into the Proparse Tree View Form. Using two buttons developers can open the source code opened in the Proparse Tree View Form now either in Visual Studio Code or Progress Developer Studio.
SCL-3660 Sample implementation of providing more user details into the client-principal on PASOE
Description:
The PASOE Hybrid Realm supports adding custom properties to the generated client-principal object. We have now added a reference implementation to the SmartHybridRealm class.
To enable this feature, set the OERealm.UserDetails.propertiesAttrName in oeablSecurity.properties like this:
| No Format |
|---|
OERealm.UserDetails.propertiesAttrName=SmartUserDetails |
This will caused the HybridRealm to call into the GetAttribute method of the SmartHybridRealm to query for a value of the given attribute name.
The method is expected to return a CHARACTER value with a JSON object with Name/Value pairs (JSON Attributes) that will be added as properties to the client-principal object.
SCL-3661 Reporting minimum/maximum/average memory of Agent sessions in scl-pasoe-agentsessions
Description:
We have added aggregates (min/max/avg) of the session memory to the output of the scl-pasoe-agentsessions script.
SCL-3663 Upgaded jquery used by class reference documentation
Description:
We have upgraded the JQuery version used by the class documentation templates to Version 3.6.0.
SCL-3664 Upgraded jquery used by SmartComponents Web
Description:
We have upgraded the JQuery version used by the SmartComponents Web to Version 3.6.0.
SCL-3665 Added Excel Export functionality to the Telemetry Viewer Form
Description:
We have enabled the export to Excel of the Telemetry Data visualized in the Telemetry Viewer.
SCL-3666 Implemented rendering support for asynchronous RetrieveData calls performed by the SmartBusinessEntityAdapter
Description:
We have implemented rendering support for the RetrieveDataAsync property of the SmartBusinessEntityAdapter (MetaDataSource) in the repository. This property enables asynchronous RetrieveData calls performed by the SmartBusinessEntityAdapter (SCL-2419).
SCL-3667 Fixed deserialization from JSON of FetchDataRequest with INamedQueryParameter
Description:
We have enabled the deserialization capability for the NamedQueryParameter class of the FetchDataRequest.
SCL-3669 Empty ContextDataset on SessionManager Reset
Description:
To avoid session management or context-switch issues caused by development of custom web-handler we are now emptying the context-dataset of the SessionManager at the end of every AppServer request.
New Feature
SCL-2523 Temp-Table monitoring API
Description:
The Consultingwerk.OERA.TempTableStatistics.TempTableStats class supports computing statistics about the usage of temp-tables in an ABL session. The class provides two methods with similar signature:
| No Format |
|---|
/**
* Purpose: Returns the temp-table statistics
* Notes:
* @param plCountRecords Logical value indicating if records should be counted
* @param ttTtInfo INPUT-OUTPUT The temp-table with the per temp-table statistics
* @return The temp-table statistics summary
*/
METHOD PUBLIC TempTableSummary GetStatistics (plCountRecords AS LOGICAL,
OUTPUT TABLE ttTtInfo): |
and
| No Format |
|---|
/**
* Purpose: Returns the temp-table statistics
* Notes: The variant computes the delta activity of the temp-tables since
* the last call into GetStatistics
* @param plCountRecords Logical value indicating if records should be counted
* @param ttTtInfo INPUT-OUTPUT The temp-table with the per temp-table statistics
* @return The temp-table statistics summary
*/
METHOD PUBLIC TempTableSummary GetStatistics (plCountRecords AS LOGICAL,
INPUT-OUTPUT TABLE ttTtInfo): |
The temp-table definition is based on the include file Consultingwerk/OERA/TempTableStatistics/ttTtInfo.i
The first variant of the method returns statistics about temp-table usage since the session has been started. The second variant of the method returns the statistics since the last request (based on the data in the passed in ttTtInfo temp-table.
The class Consultingwerk.OERA.TempTableStatistics.TempTableStatisticsMonitor can be loaded as a Service in an AppServer session (using the Consultingwerk/OERA/TempTableStatistics/services_temp-table_monitor.xml include file). The service reports details about temp-table statistics at the end of every AppServer request. While this provides useful insight for developers, it is not recommended to use this service in performance critical environments.
Temp-Table monitoring needs to be enabled using AppServer startup parameters similar to:
| No Format |
|---|
-ttbaseindex 1 -ttbasetable 1 -ttindexrangesize 32000 -tttablerangesize 32000 |
SCL-3615 Implemented viewer for Telemetry data
Description:
We have implemented a new tool to the SmartComponent Library Desktop that can be used to visualize the output of the PASOE Telemetry Service ( https://consultingwerk.atlassian.net/wiki/spaces/SCL/pages/1806958593/SmartComponent+Library+Telemetry+Service )
SCL-3631 Implemented Table and Index Range Information screen
Description:
We have implemented a new table and index range information tool to the SmartComponent Library desktop. The tool computes optimal values for the -*rangesize parameters to ensure all tables and indexes are setup for monitoring.
SCL-3649 Implemented Service to launch common IDE's
Description:
We have implemented a new service Interface Consultingwerk.Studio.IdeSupport.IIdeSupportService. This Interface defines methods to interoperate with common IDE’s. We have implemented this with support for either Progress Developer Studio or VS Code.
* Consultingwerk.Studio.IdeSupport.Pdsoe.PdsoeSupportService
* Consultingwerk.Studio.IdeSupport.VsCode.VsCodeSupportService
Both implementations support launching the IDE as well as opening files and navigating to them.
Both implementations try to locate a workspace based on the working directory of the session. Alternatively the workspace location can be provided through the Configuration Provider service (.applicationsettings):
* IdeSupport.Pdsoe.Workspace (folder
* IdeSupport.VsCode.Workspace (file)
Additional arguments when launching the IDE can be defined in .applicationsettings too:
* IdeSupport.Pdsoe.AdditionalArguments
* IdeSupport.VsCode.AdditionalArguments
Story
SCL-3647 Implemented Angular rendering support for grid's style property
Description:
We have implemented Angular rendering support for the new style property to support rendering the grid as a Kendo UI list view component. The rendering is based on the GridStyle property in the repository.
Task
SCL-3652 Added new Helper for DATA-SOURCE object handles
Description:
We have implemented a new Helper class Consultingwerk.Util.DataSourceHelper. The initial method in this class supports retrieving a source-buffer of a DATA-SOURCE object handle by it’s name.