Applies to Riva On-Premise 2.4.42 or higher.
The behaviour described in this paragraph is the same as in previous releases. Before a sync, various Riva settings are used to determine where to store the transaction metadata, in one or more subfolders of the Riva\Transactions folder. If any of those settings were changed since the last sync, the calculated subfolders could be wrong. If the metadata from the previous sync is not found where it was expected to be, it would be better not to sync, because attempting to sync in those conditions might have unintended results.
Riva 2.4.44 or Higher
By default, the system is configured to prevent the sync from executing when any transaction metadata is not found where expected. When transaction metadata is not found in the expected subfolders of the Riva\Transactions folder, an error is issued and the sync stops.
In Riva 2.4.44 or higher, after some preparatory steps, it is possible to make legitimate changes to the location of any transaction metadata.
Riva 2.4.42 and Riva 2.4.43
The system is not configured by default to prevent the sync when the transactions data is missing, but it is possible — and recommended — to configure Riva to prevent the sync from executing when any transaction metadata is not found where expected. If you follow our recommendation, when transaction metadata is not found in the expected subfolders of the Riva\Transactions folder, the error "Mismatched policy transaction folder" is issued and the sync stops.
In Riva 2.4.42 or 2.4.43, if you want to prevent the sync when a metadata folder is not found, follow this procedure.
To detect when transaction metadata has been misplaced and prevent the sync in that case:
-
Apply the following advanced option to the sync policy:
Sync.Crm.GlobalSyncDestinationRegistry.RegisterTransactionsFolder = True (In Riva 2.4.42 and 2.4.43, the default is False. In Riva 2.4.44 or higher, the default is True: that is why in 2.4.44 or higher, the sync is prevented by default when the transaction data is missing from its expected location )
Riva 2.4.42 or Higher: Making Legitimate Changes to the Location of Any Transactions Metadata
The location of some transaction metadata legitimately needs to change when, for example, a user is moved from one sync policy to another. If the sync has been prevented from occurring when some transaction metadata cannot be found and you need to change the location of any transaction data, action is required on your part; otherwise, the sync stops when the user is moved from one sync policy to another.
To temporarily prevent the sync from stopping if you want to change the location of any transaction data:
-
Disable the policy.
-
Apply the following advanced option to the sync policy:
Sync.Crm.GlobalSyncDestinationRegistry.RegisterTransactionsFolder.ReInit = True (The default is False.)
-
Make the Riva configuration changes that cause a change of location of some transaction data.
-
Enable the policy.
-
Wait for one sync cycle to take place.
-
Disable the policy.
-
Locate the option you applied in Step 2 and do one of the following:
-
Set the option to False, or
-
Remove the option.
-
-
Enable the policy.
If the transactions metadata is not found in the expected location, the sync stops.