Working with ACL projects

ACL projects are the highest level of organization in ACL, and they store all of the information associated with a data analysis project. In order to use ACL for any analysis tasks, you need to determine whether you want to create a new project or use an existing project before you start working. In ACL, the project you are working with is displayed in the Overview tab in the Navigator and the contents of the log are displayed in the Log tab. The main ACL project file (.ACL) stores most of the project information, but a set of additional files store particular types of information about the project, such as the log or indexes.

Navigator: Overview tab

ACL projects contain a number of different project item types that you can view and work with in the Navigator.

Table 1 lists and describes the icons that identify ACL project items in the Navigator treeview.

Table 1. Icons displayed in the Navigator


Item type



An ACL table, which consists of two parts: a table layout and an associated data source.

The table layout contains information about how to display the data, such as record length and field names. The data source is a file or data set (e.g., database table) that contains the content of the table. The data source exists outside the ACL project.

Server Table

A table with a table layout that resides locally in ACL, and an associated data source on an ACL Server. The table layout connects to the data source using a database profile and/or server profile.


A series of ACLScript commands that can be run from within the ACL project.

Server Script

An ACLScript file (.aclscript, formerly .bat) that is located on an ACL Server.


An ACL project item that contains one or more field definitions that have been saved for reuse with other tables.


The top-level entry in the treeview is the ACL project. Projects are stored in physical files with a .ACL file extension.


A record of the commands issued when working with the ACL project.


A folder inside the ACL project. These folders exist only in the ACL project file (.ACL). They are not physically created as Windows folders.

Navigator: Log tab

Table 2 illustrates and explains the various icons that identify entries in the Log tab in the Navigator.

Table 2. Icons displayed in the Log tab


Item type



A group of log sessions within a specific date range.

Session entry

Individual sessions indicated by date and time. Sessions are created whenever you open the project, or when you create a session manually.

Command successful

Identifies a command completed successfully.

Command failed

Identifies a command that failed.

ACL project files

The following file types are used to record information for ACL projects. When you back up or archive a project, you must ensure that you copy all of the files to restore the complete project.

Four additional file types can be created from an ACL project, or imported into an ACL project. These file types are not required by the project, however you may want to include them in any backup process.

ACL analysis app files

Analysis apps are bundled sets of ACL analytics. Analytics are regular ACL scripts written using the ACLScript language, with the addition of an analytic header that allows the script to run in AX Client, AX Web Client, or the Analysis App window. Analytics are created and tested in ACL and in order to be run in the Analysis App window they must be packaged and saved outside ACL as an analysis app package with an .aclapp file extension. When the .aclapp file is opened in the Analysis App window it is automatically installed as an analysis app file with an .aclx file extension.

For more information, see Working with analysis apps, or the ACL Analytic Developer Guide.

(C) 2015 ACL Services Ltd. All Rights Reserved.