Human Readable Change History

Stable Version 2.0.1 (O11)
Also available for 10, 8, 7
Published on 28 Jan by 
Created on 18 January 2013
Details
Create human-readable audits by simply supplying the changed record(s). Example: Name changed from 'John' to 'Peter' Age defined to '32' Country changed from 'England' to Portugal'
Read More

Feature List

- The DiffEntityDataToText is a component that uses the EntityDiff extensions 'To Compare' diferent records or multiple entities,

The novelty is the fact of the component create human readable  senteces based on the meta model id's in entities to specific labels.

Ex: instead of  "Country Changed from 3 to 4" -> "Country changed from Portugal to Spain"

This component is really useful to provide an out-of-the-box auditing mechanism for your application's core entities. It is an indispensable feature when having to comply to US' Sarbanes–Oxley Act (SOX).

Just consume the DiffEntityDataToText eSpace's RecordDifferences action in the save operations of your application, inputting both the record(s) before the change and after. Notice that you can input a single record or a set of records or structures.

RecordDifferences action:
- OriginalRecord (record or set of records)
- ChangedRecord (same as above)
- AttributesToIgnore (comma-separated list of entity attributes to ignore, like, most commonly, LastUpdateDate)
- EntityNameToTranslate (when a single entity record is provided, you must provide its entity name for the introspection)
- EntityLabelsList (as you don't specifiy anywhere the real-world label for entities, you must provide the translation here - in the format ENTITY:EntityLabel,ENTITY2:EntityLabel2)

- Locale (to use the correct translated strings) Setting the locale parameter no longer sets the locale for the entire application using the "Human Readable Change History" functionality.

The default language is english and can be changed only to "pt-PT".

Please only change the locale when you really want to because it has a negative influence on the performance.

As it uses the entity and structure attribute label property, be sure to define them correctly in Service Studio.

The action does not raise exceptions. It just logs them in the platform's Error Log.

System Requirements and Limitations
- OutSystems V7 or later;

Notice: This component takes advantage of private and undocumented Platform APIs, which can change without notice. As a result, this component may unexpectedly break as the Platform is upgraded. We advise proper testing to ensure that your applications continue to work as expected when upgrading/patching the Platform.

What’s new (2.0.1)

The locale parameter is not mandatory .

Setting the locale parameter no longer sets the locale for the entire application using the "Human Readable Change History" functionality.

The default language is english and can be changed only to "pt-PT".
Please only change the locale when you really want to because it has a negative influence on the performance.

The detailed description has been shorted because of an issue with OutSystems 11. After this has been fixed the full detail description will be placed again.

Reviews (0)
Category
Reporting, Components
Tags
Support Options
This component is not supported by OutSystems. You may use the discussion forums to leave suggestions or obtain best-effort support from the community, including from Johan den Ouden who created this component.
Dependencies
Human Readable Change History has no dependencies.
Requirements
Platform
11.0.0.200
Database
All
Stack
.NET
Component Consumers
See all 1 consumers
Weekly Downloads 
Related Components
Silk UI Web
OutSystems R&D
A fully responsive and beautiful UI framework that works within the OutSystems Platform. Build amazing looking applications, in a fraction of the time, which work perfectly across devices. Learn how to start using Silk UI and see the examples at silkui.outsystems.com . Obtain assistance on using Silk UI in our forums .
28573
Html2PdfConverter
Guilherme Pereira
Simple to use html to pdf/image converter. Based on wkhtmltopdf (https://wkhtmltopdf.org/)
6147
Multiple File Upload
Multi Uploaders
Allow you to upload multiple files in one upload form or using drag and drop functionality.
2777
More from Johan den Ouden
DBCleaner
Ricardo Silva
The component to help you keep your database neat and tidy.
3801
Twilio Connector
OutSystems MVPs
Twilio Connector allows your OutSystems Applications to use Twilio API to send messages and make voice calls.
1099
Clean Architecture Tool
J.
Architecture and full Entity Relation Diagrams, based on selected applications. Follows the 4 layer principle. You can create special groups of applications to see an even better diagram
390