Author/Owner Preservation
- Andrea Harvey
- Lindsey Byers (Deactivated)
On This Page
Overview
The preserve item authorship/ownership feature allows for files being copied/synced/or migrated to maintain their original author/owner information. In order to preserve authorship, both the source platform connector and the destination platform connector must support this feature (see: Platform Comparison).
While DryvIQ will automatically attempt to map users based on various rules, such as name and actual ID, it is also possible to map specific users from one platform to another. This is useful when a user no longer exists or when a users name, email, or other identifiable information is different from one platform to the next.
The Preserve Destination root folder authorship option allows you to preserve authorship for the root folder. Note that authorship will only be preserved if DryvIQ creates the root folder on the destination as part of the transfer. If the root folder already exists on the destination, the authorship from the source will not be preserved on the destination. Instead, authorship on the destination will be whoever created the root folder on the destination.
Author/Owner Preservation Tracking
DryvIQ tracks associations between items and user mappings, similar to permission tracking. Users who created or modified the item or its versions (when applicable) will be displayed on the User mapping tab of the job page. For author/owner preservation tracking to work, the job audit level must be set to at least "Info" (the default level for the DryvIQ user-interface). See Logs | Installer, Application, and Job for more information on log levels.
Configuration Using the REST API
Author/Owner Preservation options include:
true
false
The parameters to note in this example are preserve_owners, preserve_destination_root_owner, permissions, and account_map.
POST {{url}}v1/jobs |
{
"name":"Basic job with Author Preservation",
"kind": "transfer",
"transfer": {
"audit_level": "trace",
"transfer_type": "copy",
"preserve_owners": true,
"preserve_destination_root_owner": true,
"permissions": {
"policy": "add",
"links": false,
"failures": "exceptions"
},
"account_map": {
"id": "{{account_map_id}}",
"type": "account_map"
},
"source": {
"connection": { "id": "{{cloudSource_connectionID}}" },
"target": {
"path": "/sourcePath"
}
},
"destination": {
"connection": { "id": "{{cloudDestination_connectionID}}" },
"target": {
"path": "/destinationPath"
}
},
"simulation_mode": false
},
"schedule": {
"mode": "manual"
},
"stop_policy": {
"on_success": 5,
"on_failure": 5,
"on_execute": 25
},
"category": {
"name": "Report | Author Preservation Example"
}
} |