Packaging analysis apps for use in the Analysis App window

To allow other users to run analytic scripts in the Analysis App window, package an Analytics project into an analysis app (an .aclapp file).

Note

If at least one script in an Analytics project contains an analytic header, the project can be packaged as an analysis app.

Before packaging an analysis app make sure you validate the analytic header of each analytic script in the Analytics project.

Distributing a packaged analysis app to users

Use a packaged analysis app (.aclapp) to distribute a project to users. Users extract an .aclx file from the packaged analysis app and open the contents in the Analysis App window.

In the Analysis App window, users can run the analytic scripts and create interpretations based on tables and output results.

Include existing interpretations

To include the interpretations from an existing analysis app (.aclx), you merge the Analytics project with the existing .aclx file during the creation of the packaged analysis app (.aclapp).

Note

When you use an existing analysis app (.aclx file), the contents of the Analytics project take precedence. If there are scripts or tables in the .aclx file that no longer exist in the .acl file, they are not included in the resulting packaged analysis app (.aclapp file).

File size limitation

To use a packaged analysis app successfully, you must ensure that the sum of all file sizes included in the package does not exceed 800 MB before packaging the analysis app. If the prepackaged files exceed this combined size, data files may be corrupted when unpacking the analysis app.

Package a new analysis app

  1. In Analytics, right-click the project entry in the Overview tab of the Navigator and select Package Analysis App.

    The Analytics project is the top-level folder in the tree view.

  2. In the Select Tables dialog box, do the following:
    1. If you want to include one or more of the project tables and associated data files in the analysis app, select the table(s) and the data file(s) to include.

      Note

      Generally you should include only static tables and data files that are required by one or more of the analytic scripts in the analysis app, such as a master vendor table, or a list of merchant category codes.

    2. Click To and navigate to the location where you want to save the packaged analysis app.
    3. In the Save As dialog box, enter a File name with the .aclapp file extension and click Save.
    4. Click OK.

Result the packaged analysis app is saved to the location you specified. Other users can retrieve the packaged analysis app from this location, or you can distribute it by email, or by other appropriate method.

Package an analysis app with existing interpretations

  1. Ensure that the following files are in the same folder on your computer, and that they have the same name:
    • the Analytics project file (.acl)
    • the analysis app file (.aclx) containing the existing interpretations that you want to include

  2. In Analytics, right-click the project entry in the Overview tab of the Navigator and select Package Analysis App.

    The Analytics project is the top-level folder in the tree view.

  3. In the Select Tables dialog box, do the following:
    1. If you want to include one or more of the project tables and associated data files in the analysis app, select the table(s) and the data file(s) to include.

      Note

      Generally you should include only static tables and data files that are required by one or more of the analytic scripts in the analysis app, such as a master vendor table, or a list of merchant category codes.

    2. Optional. To include the interpretations from the existing analysis app, select Include Interpretations.

      Interpretations that are associated with tables or scripts that do not exist in the new package are not included.

    3. Click To and navigate to the location where you want to save the packaged analysis app.
    4. In the Save As dialog box, enter a File name with the .aclapp file extension and click Save.
    5. Click OK.

Result the packaged analysis app is saved to the location you specified. Other users can retrieve the packaged analysis app from this location, or you can distribute it by email, or by other appropriate method.