Index: openacs-4/packages/acs-core-docs/www/object-identity.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/object-identity.adp,v diff -u -r1.1.2.3 -r1.1.2.4 --- openacs-4/packages/acs-core-docs/www/object-identity.adp 28 Sep 2015 07:54:20 -0000 1.1.2.3 +++ openacs-4/packages/acs-core-docs/www/object-identity.adp 9 Jun 2016 13:03:11 -0000 1.1.2.4 @@ -13,22 +13,22 @@

By Rafael H. Schloming

OpenACS docs are written by the named authors, and may be edited by -OpenACS documentation staff.

One of the major design features of OpenACS 5.7.0 is the +OpenACS documentation staff.

One of the major design features of OpenACS 5.9.0 is the explicit representation of object identity. The reason I say "explicit representation" is because the concept of object identity has been around forever. It is inherent to our problem domain. Consider the example of 3.x style scoping. The 3.x data models use the triple (user_id, group_id, scope) to identify -an object. In the 5.7.0 data +an object. In the 5.9.0 data model this object is explicitly represented by a single party_id.

Another good example of this is can be found in the user groups data model. The 3.x user groups data model contains another example of an implied identity. Every mapping between a user and a group could have an arbitrary number of attached values (user_group_member_fields, etc.). In this case it is the pair (group_id, user_id) that implicitly refers to -an object (the person's membership in a group). In the 5.7.0 data +an object (the person's membership in a group). In the 5.9.0 data model this object identity is made explicit by adding an integer primary key to the table that maps users to groups.

Coming from a purely relational world, this might seem slightly weird at first. The pair (group_id, user_id) is sufficient to