How to create a dm_document with specifying labels?

GlenLantz

This question was asked by me in older discussion https://community.emc.com/message/539714#539714; but I still want to discuss it again

I am using DFS; Documentum Developer Edition 6.6. I want to create a dm_document with my labels (in addition to standard “1.0”, “CURRENT”, provided by Documentum Server). Can I do this using only one DFS call? :

1. I have found out that I can set property 'r_version_label' as {'MyLabel'} and called the Create
   

However, I have been told this is dangerous way of using DFS: I should not specify the 'r_version_label' myself.  What can you say about this?

1. Without the setting 'r_version_label' myself, I can reach this goal by the following sequence;
   

-       Call Create method;

-       Call Checkout method

-       Call Checkin method (specifying the labels I want)

This will be ‘safe’ solution; but apparently slow L - 3 DFS calls instead of just 1.

Any advises?

XdctmX

You can modify r_version_label.

From CS fundamentals -

r_version_label attribute

Version labels are recorded in the r_version_label attribute defined for the dm_sysobject object type. This is a repeating attribute. The first index position (r_version_label[0]) is reserved for an object’s numeric version label. The remaining positions are used for storing symbolic labels.

Symbolic version labels

A symbolic version label is either system- or user-defined. Using symbolic version labels lets you provide labels that are meaningful to applications and the work environment. Symbolic labels are stored starting in the second position (r_version_label[1]) in the r_version_label attribute. To define a symbolic label, simply define it in the argument list when you check in or save the document.

An alternative way to define a symbolic label is to use an IDfSysObject.mark method. A mark method assigns one or more symbolic labels to any version of a document. For example, you can use a mark method, in conjunction with an unmark method, to move a symbolic label from one document version to another.

A document can have any number of symbolic version labels. Symbolic labels are case sensitive and must be unique within a version tree.