Propagation of Properties 

Use

This report allows you to propagate the existing properties of a resource (document or folder) 1:1 to other folders and their contents or to individual documents.

 

Prerequisites

 

We recommend creating a file in advance, assigning the required properties to it, and using this file as a template.

 

Features

You can use this report to perform the following operations:

●      Assign new properties

●      Overwrite existing properties with new properties

●      Delete existing properties

 

The properties are always copied with their values.

You cannot overwrite or delete write-protected properties, such as File Size or Last Changed By.

 

You can configure the following settings for this report.

Scope tab

Parameter	Description
Location	Specifies the folders whose resources you want to apply the report to. For example, /documents/myfiles
Maximum Results	The system terminates the search when it has found the corresponding number of items. The entry -1 signifies all items.

 

Parameters tab

Parameter	Description
No Recursion (Only direct child items)	If this parameter is activated, the properties are propagated only to the items (resources and folders) directly in the selected target folder and to the target folder itself. If this parameter is deactivated, the properties are propagated to all resources in all subfolders for the selected target folder (Location).

 

Commands tab

Parameter	Description
Propagate Properties	You use this command to propagate the properties of a normal resource (folder or document) to other resources.   You have to specify the following parameters:   Property Template Resource: Path and name of the resource that is used as the template, for example, /documents/pdf/myfile.txt.   Properties for Propagation: Comma-separated list of the properties that are to be propagated. In the case of predefined properties, specify the unique ID. For example: cm_owner In the case of custom properties, specify a combination of namespace and property name: {namespace}custompropertyname For example: {http://sapportals.com/xmlns/cm/custom}myproperty   Overwrite Existing Properties: If this parameter is activated, the report overwrites existing properties and their values with the properties and values in the template.
Delete Properties	You use this command to delete the properties defined below for the resources. Properties To Delete: Comma-separated list of the properties that are to be deleted. In the case of predefined properties, specify the unique ID. For example: cm_owner In the case of custom properties, specify a combination of namespace and property name: {namespace}custompropertyname For example: {http://sapportals.com/xmlns/cm/custom}myproperty

 

Activities

To propagate or delete properties and their values or a large scale, proceed as follows:

...

       1.      Launch the report. In the portal, choose Content Administration ® KM Content ® Toolbox ® Reports ® Mass Operations ® Propagation of Properties.

       2.      Choose Start and specify a name for the report.

       3.      On the Scope tab, you choose the target, this is generally a folder containing resources to which you want to propagate the properties in the template.

       4.      On the Parameters tab, select the required parameters.

       5.      Go to the Commands tab and choose the required operation (Propagate or Delete). Enter the required template and the properties to be propagated or deleted.

       6.      To run the report, click Start.

The results contain a summary of the executed operations.

 

Example

You want to propagate the Archived = true custom property to all documents in the /documents/archive/pdf directory.

The document /documents/archived.txt containing the Archived = true custom property already exists. You use this document as the template.

To implement the activity, enter the following information in the report:

Location = /documents/archive/pdf

No Recursion (Only direct child items) = not selected

Property Template = /documents/archived.txt

Properties for Propagation = {http://sapportals.com/xmlns/cm/custom}Archived

Overwrite Existing Properties = not selected

Choose Start to run the report.