Human Readable Change History
Stable Version 2.0.0
Published on 23 Nov (3 weeks ago) by 
Created on 18 January 2013
Create human-readable audits by simply supplying the changed record(s).
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)

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.0)

Updated to OutSystems version 11.

Reviews (0)
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 Nuno Mestre who created this component.
Human Readable Change History has no dependencies.
Component Consumers
Human Readable Change History has no consumers.
Weekly Downloads 
Related Components
Fábio Fantato
Webblock to insert Comments, Attachments and ChangedStatus into your screens Version 5.0.0 - 26.Sept.2018
Simple Audit
Rafael Fantato
Simple Audit to identify differences between div contents with JS (XML, JSON or Simple Text content)
Audit System
André Siébra
Centralized log system for general use of applications using a REST API.
More from Nuno Mestre
Google Drive Connector
OutSystems R&D
Google Drive Connector allows your OutSystems Applications to use the Google Drive REST API to interact with your files.
Sérgio Oliveira
Survey, as the name implies, is an application to create and manage Surveys, which can be answered by a specified group of users or by everyone who access the application, including anonymous users.
A collection of reusable actions to help us stop reinventing the wheel.  Join the team and bring your own top reused actions to the community!