Human Readable Change History

Stable Version 2.0.2 (O11)
Also available for 10, 8, 7
Published on 8 Apr 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.2)

jQuery version changed to 1.8.3?

Reviews (0)
Category
Components, Reporting
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