Upload and Download from the BA Repository

Overview

Uploading and downloading from the BA Repository is done with the User Console or the command line interface. The ability to upload and download assumes that you have already created a data source, that data content exists to be pushed, and defines permissions for the repository.

Uploading and downloading from the BA Repository is done with the User Console or the command line interface. The ability to upload and download assumes that you have already created a data source, that data content exists to be pushed, and defines permissions for the repository.

For uploading, any starting location can be selected. Permission settings are inherited through the folder structure if the destination location has existing permission settings. It is advisable to keep existing security settings as defaults for the upload. Uploading more than one file or folder requires the files to be zipped before beginning the upload.

For downloading, you are able to select the destination location for the downloaded file or folder. The download process always creates a .zip file that includes a manifest file along with the downloaded content. The manifest file contains the collection of permissions settings for the downloaded files and folders and is found in the root directory of the .zip file.

Supported File Types

Hidden File Types

These are the supported file types and artifacts for uploading and downloading from the BA Repository.

These are the file types that are hidden by default in the BA Repository.

Reporting (.prpt, .prpti, .xml)

Analyzer (.xanalyzer)

Dashboards (.xdash)

Solution Files (.xaction, .locale)

Web (.html, .htm)

Reporting (.xml)

Solution Files (.properties)

Graphics (.png, .jpg, .gif, .svg)

Upload Folders and Files

The User Console can be used to upload files and folders to the BA Repository. A quick word about manifests: when a user downloads content out of the repository, a manifest file is created within the zip file which contains the permission and ownership information about the file.

For Retain permission on upload file, the file permission contained in the uploaded zip (exportManifest.xml) will be the permission applied the repository. If the file doesn't have an entry in the exportManifest.xml for the permission, then it will use the default permission, which is inherit. This is equivalent to the command line switch, --permission=true.

For Set Owner based on uploaded file, the owner found in the uploaded zip (exportManifest.xml) will be the owner of the file in the repository. If the file doesn't have an entry in the exportManifest.xml for the Owner, then it will set the Owner to the user who is uploading the zip. This equivalent to the command line switch, --retainOwnership=true.

These steps walk you through uploading to the repository with the User Console.

The upload process runs and the results are displayed in the command interface. If an argument is required for successful upload and has not been provided, the missing requirement is displayed in the command interface. The Command Line Arguments Reference has a list of available command line arguments for uploading.

Download Folders and Files

Downloading folders and files can be done through the User Console or through the command line interface. The download process always creates a .zip file that includes a manifest file along with the downloaded content. The manifest file is a collection of the permissions settings for the downloaded files and folders and is found in the root directory of the .zip file.

The download process runs and the results are displayed in the command interface. The file is saved as a .zip file with the download manifest located in the top level of the file. If an argument is required for successful download and has not been provided, the missing requirement is displayed in the command interface. The Command Line Arguments Reference has a list of available command line arguments for downloading.

Response Code Definitions

Here is a list of response codes for the import-export.bat script.

Response Code

Definition

1

Publish to server failed.

2

General publish error.

3

Publish successful.

5

Authentication to the publish server failed. Username or password is incorrect.

6

Datasource publish failed.

7

XMLA catalog already exists.

8

Schema already exists.

9

Content about to be published already exists.

10

Error publishing to the server due to prohibited symbols in the name of the content.