Difference between revisions of "Data Replication (UBIK Client)"

Revision as of 10:18, 21 December 2017

The UBIK^® WinX client supports data replication mechanism so that users can create and maintain data more efficiently. For example, a user can quickly replicate a local branch and create multiple copies of it in other parts of the hierarchy.

Copy & paste

On way to replicate data is through the copy & paste mechanism. A typical use case is as the following.

Navigates to the branch that should be replicated;
Brings up the bottom app bar and press Copy;
Navigates to the destination where the branch should be replicated;
Brings up the bottom app bar and press Paste.

In principal, the usage is comparable to the copy & paste mechanisms in any other apps out there. However, there are some unique UBIK^® details worthing mentioning.

Regarding copy

When copying, an entire branch is involved. This includes

The branch root object and all its local children (direct or indirect);
- Queries, offline queries and all their children are ignored;
Files of all (in)direct child documents. However, there are exceptions to this, namely
- if a file download fails;
- if the app is in offline mode.
The data of the above mentioned objects: Display strings, user rights, etc.;
The properties of the above mentioned objects: Their values, user rights, validations, etc.;
- All data users can interact with (e.g. values, validations) will only be copied if the MetaProperty allows.

The Copy action is only available when the app initialization is complete and there is something to copy in the specified branch.

Validity of a copy: After triggering a copy, users can paste the same branch as many time as they want until

either users log out;
or another copy is triggered, which overrides the old copy;
or the copied branch is no longer available (E.g. deleted)

Regarding paste

When pasting, an entirely independent copy of the specified branch is created and added as a child of the destination object. The Paste action is only available when

The user has triggered a copy and it is still valid (see Hint|Validity of a copy);
And the destination object allows modification. In other words, it is not locked due to user rights, MRO status or scan status;
And the destination object allows the root of the copied branch as a child object. Namely the creation of the branch root's MetaClass should be allowed in the destination MetaClass. (See step 8).

It is possible that some children (directly/indirectly) under the branch root are not copied even though they are locally available. For example, if a branch root workpackage is configured in a way that clients are not allowed to create tasks underneath. The client cannot violate that rule and, therefore, will ignore these tasks during replication. A quick way to check whether that's the case on the client is to browse to e.g. that workpackage and see if it's possible to create a task.

Demo Videos

Copy & pasting a branch

Copy & pasting documents with files

When copy or paste is impossible

@@ Line 37: / Line 37: @@
 * And the destination object allows modification. In other words, it is not locked due to [[User_Rights|user rights]], [[MRO_Objects_(UBIK_WinX)#Organisational_Status|MRO status]] or [[SYSCLS_UNLOCK_BY_SCAN|scan status]];
 * And the destination object allows the root of the copied branch as a child object. Namely the creation of the branch root's [[MetaClass]] should be allowed in the destination MetaClass. (See [[HowTo:Create_a_new_MetaClassScope|step 8]]).
+{{Clear}}
+{{Attention|It is possible that some children (directly/indirectly) under the branch root are not copied even though they are locally available. For example, if a branch root workpackage is configured in a way that clients are not allowed to create tasks underneath. The client cannot violate that rule and, therefore, will ignore these tasks during replication. A quick way to check whether that's the case on the client is to browse to e.g. that workpackage and see if it's possible to create a task.}}
 == Demo Videos ==