Show TOC

PCD NameLocate this document in the navigation structure

Use

Each object in the PCD is referred to by its PCD name, which is the full path to the object through the PCD tree structure. For example, the following PCD name,

portal_content/myFolder/stocks

points to a PCD object called stocks , which is in a folder called myFolder , which is in the top-level folder portal_content .

Atomic Name

The atomic name of a PCD object is the name of the object, without the entire path.

In the example above, the name stocks is the object's atomic name, which must be unique within the folder that contains the object (in this case, myFolder ).

Information on defining a namespace prefix for the atomic name of a PCD object: How Are Portal Objects Named and Identified?

PCD Prefix

The PCD name sometimes is written with the prefix pcd: , so that the above PCD name would be written:

pcd:portal_content/myFolder/stocks

When performing a PCD lookup, you can specify the PCD initial context in one of the following ways:

  • Set the Context.INITIAL_CONTEXT_FACTORY environment variable to IPcdContext.PCD_INITIAL_CONTEXT_FACTORY when creating an initial context.

  • When calling lookup() on an initial context, add the pcd: prefix to the PCD name of the object you are looking up.