Propagation of Properties
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.
We recommend creating a file in advance, assigning the required properties to it, and using this file as a template.
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. This parameter must be activated to propagate Boolean properties. |
|
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 |
To propagate or delete properties and their values on a large scale, proceed as follows:
- Launch the report. In the portal, choose Content Administration → KM Content → Toolbox → Reports → Mass Operations → Propagation of Properties.
- Choose Start and specify a name for the report.
- On the Scope tab, choose the target. This is generally a folder containing resources to which you want to propagate the properties in the template.
- On the Parameters tab, select the required parameters.Note
You have to activate the Overwrite Existing Properties parameter for Boolean properties to be propagated.
- 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.
- To run the report, click Start.
The results contain a summary of the executed operations.
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.