Show TOC Start of Content Area

Function documentation Basic Operations Locate the document in its SAP Library structure

Use

Similarly to file systems, the repository framework provides basic operations to manipulate resources. It supports the creation, deletion, copying, moving, and renaming of resources.

Features

In detail, the operations for manipulating resources work as follows:

     Creation

Creates new resources. New resources are always created in a collection. The collection becomes the parent of the new resource and the resource becomes the child of the collection.

     Copying

Copies resources to another RID. In the process, the data of the original resource is duplicated for the new resource with a new RID.

     Deletion

Deletes resources. After deletion, the content and metadata are no longer accessible. If code still references the resources and tries to use them, the repository framework raises an error.

     Renaming

Changes the name of resources. This means that the name part of the RID changes, but not the parent child relationship. The resource remains in the same parent collection.

     Moving

Changes the position of the resource within the hierarchy. This means that the path part of the RID changes, but not the name part.

Moving and Renaming

From a client’s perspective, renaming and moving can appear identical because both operations change the RID of the resource in question. However, from a repository’s perspective they are different because different parts of the RID are changed; for rename the name part, for move the path part.

A significant difference between renaming or moving and copying is related to the unique ID of resources. A copy operation creates a new resource with a new ID, whereas a rename or move operation does not change the unique ID.

From an object-oriented point of view, moving only changes a business object’s place in the hierarchy, while copying creates a new instance of a business object and releases the old business object’s instance. Although moving a resource is faster than copying and deleting, it is slower than renaming because additional steps have to be taken, especially if a resource is moved from one repository to another.

See also:

Creating Resources

Retrieving Resources

 

End of Content Area