Working with Analytics projects
Analytics projects provide a way to group and organize all the tables and processing associated with a data analysis project. You can create as many Analytics projects as you need. The data analysis completed in Analytics is recorded in the command log in the Analytics project from the moment a project is created.
Create a new Analytics project
When you create a new project, a best practice to create a new Windows folder for the project, and maintain a one-to-one relation between Analytics projects and Windows folders. Use the Windows folder, and subfolders as required, to store:
- The Analytics project file (.acl) and all associated files, such as index files (.inx)
- Source data files
- Analytics data files (.fil)
- Results files produced from analysis performed in Analytics
You can create a new project from within Analytics, or from the ACL for Windows main screen.

Note
The combined length of the Analytics project path and the project name, including the file extension (.acl), cannot exceed 259 characters.
Create a new project from Analytics
- From the Analytics main menu, select .
- In the Save New Project As dialog
box, select a folder to save the project in, enter a file name,
and click Save.
The new project is created and the Data Definition Wizard opens. You can proceed through the wizard to create a new Analytics table in the new project, or click Cancel if you do not want to create a table.
Create a new project from ACL for Windows
- In the ACL for Windows main screen, click New Analytic Project.
- In the Save As dialog box,
select a folder to save the project in, enter a file name, and click Save.
The new project is created and opened in Analytics.
Open an existing Analytics project
When you open an existing Analytics project a new session is created, and all commands processed by Analytics are recorded in the log.
You can open an existing project from within Analytics, or from the ACL for Windows main screen.

Open an existing project from Analytics
- From the Analytics main menu, select .
- In the Project dialog box,
navigate to an Analytics project file (.acl), select the file,
and click Open.
The project opens in Analytics. If another project is open in Analytics, you will be prompted to save any changes to that project, and it will be closed before the selected project is opened.
Open an existing project from ACL for Windows
- In the ACL for Windows main screen, click Open Analytic Project, or select an Analytics project (.acl) under Recent Analytics Files.
- If you clicked Open Analytic Project,
navigate to an Analytics project file (.acl), select the file,
and click Open.
The project opens in Analytics.
Save an Analytics project
The first time you save an Analytics project, you need to specify the filename and location. You can save the latest version of the project in the same location using the Save Project menu command. If you want to save a copy of the project, use the Save Project As menu command and choose a different filename and location.

- Do one of the following:
If you want to save the current version of the project select
.If you want to save the current version of the project with a different name, select Save Project As dialog box and click Save.
, and then enter the new filename and choose the location in theIf you select this option, the project is saved with the new name, but the new project is not opened in Analytics.
- If there are any project items that have been modified since the project was last saved, you will be prompted to save them. Click OK in the confirmation dialog box(es).
View Analytics project properties
You can view a number of properties associated with an Analytics project, and quickly navigate to the folder containing the project.

- Right-click the Analytics project in the Overview tab
in the Navigator.
The Analytics project is the top-level entry in the treeview.
- Select Properties.
- In the Project Properties dialog
box, click on the following tabs to view or modify project properties:
General – This tab displays the basic properties of the project file: the file name, the file location, the last modification date and time, and the physical size of the project file.
You can click Open file location to navigate directly to the folder containing the Analytics project file (.acl).
Notes – This tab displays any notes associated with the project. You can modify existing notes or add new notes. For more information, see Add or edit Analytics project notes.
Views – This tab displays all the views in the project, using the form view name[table layout name]. You can maintain the views in the project from this tab. For more information, see Working with views.
- Click OK to close the dialog box and save any changes you have made.
Copy a project item from another Analytics project
You can copy Analytics project items into your current project from any Analytics project on your computer or on an accessible network drive.
You can copy multiple project items simultaneously if they are of the same type – for example, you could copy multiple scripts simultaneously. If you want to copy items of different types – for example, scripts and tables – you need to repeat the procedure below for each item type.
If you want to import a project item that exists as a separate file outside an Analytics project, see Import a project item.

- Open the project that will contain the copied item or items.
- In the Overview tab of the Navigator,
right-click the Analytics project entry, or a project folder, and
select where Project Item
Type is one of the following options:TableViewScriptWorkspace
- In the Locate Project File dialog box, locate and select the Analytics project you want to copy the project items from and click Open.
- In the Import dialog box, complete
any of the following tasks to add project items to the To project_name list:Double-click an individual project item.Ctrl+click multiple project items and then click the right-arrow button.Click Add All to add all the project items.
You can remove project items from the To project_name list by double-clicking an individual project item, by using Ctrl+click to select multiple project items and then clicking the left-arrow button, or by clicking Clear All.
- Click OK to copy the project item
or items into the current project.
If an item with the same name already exists in the project, the copied item is given an incrementing numeric suffix.
Import a project item
You can import Analytics project items that exist as separate files outside an Analytics project – for example, an Analytics script saved as an .aclscript file, or a table layout saved as a .layout file. You can import only one project item at a time.
If you want to import a project item from another Analytics project, see Copy a project item from another Analytics project.

- In the Overview tab of
the Navigator, right-click the Analytics project
entry and select where Project
Item Type is one of the following options:TableViewScriptWorkspace
- In the Project dialog box, locate
and select the appropriate file type and click Open.
File types and project items correspond as follows:
File extension Project item .layout table .rpt view .aclscript script .wsp workspace - Click OK in the confirmation dialog
box.
The project item is imported into the current project. If an item of the same type, with the same name, already exists in the project, the imported item is given an incrementing numeric suffix.
Export a project item
You can export Analytics project items as separate files saved outside the Analytics project – for example, an Analytics script can be saved as an .aclscript file, and a table layout can be saved as a .layout file. Project items exported as separate files can later be imported into any Analytics project. You can export only one project item at a time.
Project items and file types correspond as follows:
Project item | File extension |
---|---|
table | .layout |
view | .rpt |
script | .aclscript |
workspace | .wsp |

Note
Limit the item name to 64 alphanumeric characters, not including the file extension, to ensure that the name is not truncated when the item is imported back into Analytics.
The name can include the underscore character ( _ ), but do not use any other special characters, or any spaces, or start the name with a number. Special characters, spaces, and a leading number are all replaced by the underscore character when the item is imported.
Export a table layout, a script, or a workspace
- In the Overview tab of the Navigator, right-click the item and select Export Project Item.
- In the Save As dialog box, choose a location to save the item, rename the item if required, and click Save.
-
Click OK in the confirmation dialog box.
The project item is exported to the location you specified.
Export a view
- Open the table associated with the view.
- In the Overview tab of the Navigator, right-click the table and select .
- Select the view, and click Export.
- In the Save As dialog box, choose a location to save the view, rename the view if required, and click Save.
-
Click OK in the confirmation dialog box.
The view is exported to the location you specified.