Why are Documentum Group Names all lowercase?

I was creating a script recently to load groups and users into at test repository.  I thought I had it all set up properly; however, I soon discovered that no matter what capitalization I used for group names, the content server converted the names to all lowercase.  This caused a problem in my script when, after creating a group named ‘Editors’, I tried to retrieve it to add members.  The Content Server couldn’t find it because it had converted the name to ‘editors’.  Hmmm.  Why does it do that, and does it only happen when using a script, or does DA exhibit this same behavior?

Well, unfortunately, DA does the same thing.  Look in your repository and you will see all group and role names are lowercase.  I still don’t know why, but be aware when you are working with groups and roles that this phenomenon is happening.  Lest you think that the DFC is exempt, you’re wrong, it does the same thing.  (I have bone to pick with the IDfGroup class, but that’s for another post).

Here is a snippet of the API script I was using.  You can see where the Content Server can’t find the ‘Editors’ group.  Just for fun, I modified the script to retrieve the ‘editors’ group a few lines later and it worked fine.

API> ### Editors ###
API> create,c,dm_group
...
12de75d18001f514
API> set,c,l,group_name
SET> Editors
...
OK
API> set,c,l,group_class
SET> group
...
OK
API> set,c,l,description
SET> Editors Group
...
OK
API> set,c,l,owner_name
SET> dm_dbo
...
OK
API> save,c,l
...
OK
API> ### UPDATING Editors Group ###
API> retrieve,c,dm_group where group_name = 'Editors'
...
[DM_API_E_NO_MATCH]error:  "There was no match in the docbase for the qualificat
ion: dm_group where group_name = 'Editors'"

API> ?,c,select users_names from dm_group where group_name = 'Editors'
users_names
--------------------------------
(0 rows affected)

API> ### UPDATING editors Group ###
API> retrieve,c,dm_group where group_name = 'editors'
...
12de75d18001f514
API> append,c,l,users_names
SET> Administrator
...
OK
API> save,c,l
...
OK
API> ?,c,select users_names from dm_group where group_name = 'editors'
users_names
--------------------------------
Administrator
(1 row affected)
Advertisements

About Scott
I have been implementing Documentum solutions since 1997. In 2005, I published a book about developing Documentum solutions for the Documentum Desktop Client (ISBN 0595339689). In 2010, I began this blog as a record of interesting and (hopefully) helpful bits of information related to Documentum, and as a creative outlet.

2 Responses to Why are Documentum Group Names all lowercase?

  1. Fabian Lee says:

    interesting post, Scott.

    I looked it up, and it’s by design. All group names must be lowercase because they can be referred to in the CREATE/ALTER group commands which does not force the user to use quotes. And the YACC script which controls the parsing of the commands coverts everything not enclosed in quotes to lowercase.

    Like

    • Scott says:

      Thanks for the explanation; at least now it is no longer a mystery. As integrators and developers we still need to be cognizant that it works this way.

      Like

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: