Importing folder items

Import Analytics projects and related files into AX Server into a target folder to add content to the Working directory or Library. Once you import an Analytics project, it becomes an analysis app and you can schedule or run any analytic scripts it contains.

Note

To import items, you must have Full permissions for the destination folder.

When you import an Analytics project from a previous version, the project items are automatically converted to the currently installed version. Any exported items are part of a currently installed version project.

How importing works

To add content to AX Server, you must import it from your local computer or a network location into a target folder in the Library or Working directory using AX Client. You can import:

  • an entire Analytics project (.acl file) containing one or more analytics
  • a packaged analysis app (.aclapp file) containing an Analytics project and associated interpretations
  • tables or data files (.fil files)
  • related files

For information about importing analysis apps and Analytics projects, see Importing and exporting analytics.

Project item types and destination sub-folders

When you import a project into a target folder, project items are imported into specific sub-folders:

Sub-folder Item(s) Notes
Analysis Apps
  • Analytics project
  • analytic scripts
  • sub-scripts

The Analytics project must contain one or more analytic scripts.

To import related files along with your project, you must select the project and each file using Ctrl+click.

Note

If you import a non-Unicode Analytics project or analysis app into a Unicode AX Server instance, it is converted to Unicode. However, if you import a Unicode Analytics project or analysis app into a non-Unicode AX Server instance, an error occurs. For help converting a Unicode project to non-Unicode before importing, contact Support.

Data project tables

Once a project with tables is imported, the tables no longer maintain a programmatic association with the project.

All tables in the project are copied to the Data sub-folder. You can also import any source .fil data files associated with the tables, and the Properties tab identifies whether or not the source data was imported with the table.

Note

When importing an Analytics project or analysis app, imported tables overwrite identically named tables in the destination folder’s Data sub-folder. If an imported table has an associated source data file, the overwritten table’s data file is also overwritten.

Related Files files of any type supported by your operating system and allowed by the Analytics Exchange file extension whitelist

Project log files are not imported with the project. To import a log file into the Related Files sub-folder, you must select it along with the project.

The maximum related file size is 2 GB.

Import a folder item

  1. In the Server Explorer, select the destination folder and then from the menu, select File > Import.
  2. In the Select Files to Import dialog box, select the item(s) you want to import and click Open.

    Note

    To import related items such as .xlsx or .csv files simultaneously with an Analytics project, use Ctrl+click to select the project file and the related files.

  3. In the Select the Import Destination dialog box, select the destination folder and do the following:
    • For Analytics project, analysis app, or table imports, select whether or not to Import source data files (.fil files).
    • Optional. To overwrite linked tables in the destination folder with imported standalone or shared tables of the same name, select Overwrite linked tables with standalone tables.

      Leave this deselected to exclude standalone or shared tables of the same name as a linked table from the import.

    • If you selected the Results sub-folder as the destination, click Next and select the files to import.
  4. Click Import.

    If an item already exists in the import destination, click Yes in the Replace dialog box to overwrite the item, or No to cancel the import of that particular item.

    Note

    The overwriting of identically named tables and data files occurs whether or not the Replace dialog box appears. The Replace dialog box appears in the event of identically named projects. It does not appear in the event of identically named tables imported with uniquely named projects.

Analytics Exchange 14.1 Client Help