Skip to content

Send Encrypted Offline Store Files to The Server

This feature allows a developer to asynchronously upload the encrypted offline store files, for example xxx.udb and xxx.rq.udb, and a temporary encryption key, to an SAP Cloud Platform or SAP Cloud Platform server to assist in troubleshooting issues.

Only users who get the temporary key can open the offline store files and the encryption key being used on the device remains undisclosed.

You must have sufficient disk space on the device to ensure that the offline store files can be successfully uploaded to the server.

Sample Code

The following example illustrates how to send the offline store files to the server.

public void sendEncryptedStore( OfflineODataProvider provider)throws ODataException
// ----------------------------------------------------------------------------
{
  provider.add( this, new OfflineODataDefiningQuery( "req1", "Customers", false ));
  provider.open( this );
  String newEncryptedKey = "default";

  provider.sendEncryptedStore( this, newEncryptedKey );
  • Note: The newEncryptedKey parameter is case sensitive and cannot contain leading or trailing spaces or semicolons.

When the Application Is Connecting to an SAP Cloud Platform (Neo) Server

Before consuming the sendEncryptedStore function, the offline store files upload policy feature needs to be enabled. For information on enabling the offline store files upload policy feature, see Defining Client Offline Store Upload Policy.

Downloading Uploaded Offline Store Files From an SAP Cloud Platform (Neo) Server

Once the sendEncryptedStore function has been successfully consumed, the offline store files will be uploaded to the server. For information on downloading uploaded files for later investigation, see Managing Client Database Uploads.

When an Application Is Connecting to an SAP Cloud Platform (Cloud Foundry) Server

Before consuming the sendEncryptedStore function, the offline store files upload policy feature needs to be enabled. For information on enabling the offline store files upload policy feature, see Defining Offline Settings for Applications.

Downloading an Uploaded Offline Store Files From an SAP Cloud Platform (Cloud Foundry) Server

Once the sendEncryptedStore function has been successfully consumed, the offline store files will be uploaded to the server. See steps 6 and 7 in Defining Offline Settings for Applications for information on how to download uploaded files for later investigation.


Last update: August 12, 2020