Skip to content

Working With Offline Stores

End users can securely upload local database files from a supported device to the server for analysis.

Send Decrypted Offline Stores to the Server

A device’s offline store may be useful for troubleshooting issues in some cases. This feature provides the ability to send the decrypted offline store to the server.

This means that users can open the offline store files without an encryption key and the encryption key being used on the devices remains undisclosed.

Use the following API to send a decrypted offline store to the server:

func SendStore(provider: OfflineODataProvider) -> Void
{

    provider.sendStore( completionHandler: { ( _ error: OfflineODataError? ) -> Void in
        if let error = error {
            printError(error, &errorMessage )
            okay = false
        } else {
            printMessage("The Offline store has been sent successfully.")
        }
    } )

}

When an Application Is Connecting to an SAP Cloud Platform (NEO) Back End

Before consuming the sendStore function, the offline store upload policy feature needs to be enabled.

For information on enabling the offline store upload policy feature, see Defining Client Offline Store Upload Policy.

Downloading an Uploaded Store on an SAP Cloud Platform Mobile Services (NEO) Back End

Before consuming the sendStore function, the offline store upload policy feature needs to be enabled.

For information on enabling the offline store upload policy feature, see Managing Client Database Uploads.

When an application is connecting to an SAP Cloud Platform Mobile Services (Cloud Foundry) back end

Before consuming the sendStore function, the offline store upload policy feature needs to be enabled.

For information on enabling the offline store upload policy feature, see Defining Offline Settings for Applications.

Once the sendStore function is successfully consumed, the offline store files will be uploaded to the server.

See Procedure 8 on the following help page for information on how to download uploaded files for later investigation: Defining Offline Settings for Applications.

Send Encrypted Offline Stores to the Server

A device’s offline store may be useful for troubleshooting issues in some cases. This feature provides the functionality to upload the offline store and a temporary encryption key to the server.

This means that only users who get the temporary key can open the offline store files and the encryption key being used on devices remains undisclosed.

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

func SendEncyptedStore( _newEncryptionKey: String,_ provider:OfflineODataProvider ) -> Void
{
    provider.sendEncryptedStore( newEncryptionKey:newEncryptionKey, completionHandler: { ( _ error: OfflineODataError? ) -> Void in
        if let error = error {
            printError(error, &errorMessage )
        } else {
            printMessage("The Offline store has been sent successfully.")
        }
    } )

}

Note

The newEncryptionKey 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 upload policy feature needs to be enabled.

For information on enabling the offline store upload policy feature, see Defining Client Offline Store Upload Policy.

Download an uploaded store from an SAP Cloud Platform (Neo) server

Once the sendEncryptedStore function is 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 upload policy feature needs to be enabled.

For information on enabling the offline store upload policy feature, see Defining Offline Settings for Applications.

Downloading an uploaded offline store 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 Procedure 8 on the following help page for information on how to download uploaded files for later investigation: Defining Offline Settings for Applications.


Last update: October 30, 2020