Running analytics in the Analysis App window

You can use the Analysis App window to run one or more analytics in an analysis app and output results. If an analytic requires input values such as table or field names, you are automatically prompted for the values. If input values from a previous run of an analytic are prefilled, you can accept the previous values, or provide updated values.

Only the most recent set of input values for an analytic is saved. Unlike analytics run on AX Server, you cannot save multiple sets of input values for an analytic in the Analysis App window.

To run an analytic in the Analysis App window:

  1. Open an analysis app by doing one of the following:

    Double-click an analysis app file with an .aclx extension.

    Double-click a packaged analysis app file with an .aclapp extension to first install the analysis app and then automatically open it.

    Double-click the desktop shortcut for ACL for Windows and select an analysis app (.aclx) under Recent Analytics Files, or select Open Analysis App, select .aclx or .aclapp from the file type drop-down list, navigate to an analysis app file or a packaged analysis app file, and double-click the file.

    To open a different analysis app if an analysis app is already open in the Analysis App window, click App  in the top right corner, select Open Analysis App, click Open an Analysis App in the center of the window, navigate to an analysis app file (.aclx) or a packaged analysis app file (.aclapp), and double-click the file.

  2. If you double-clicked a packaged analysis app file, in the Browse For Folder dialog box select a location to install the analysis app and click OK.

    The analysis app is installed in the location you specified and automatically opened in the Analysis App window.

  3. Do one of the following:

    If the analysis app contains a single analytic, click Run beside the name of the analytic.

    If the analysis app contains multiple analytics, review the analytics to see if they should be run in a specific order.

    Once you have confirmed the appropriate order, click Run beside the name of the analytic that should run first.

    Analytics arranged in sections should be run in the following order: Import Scripts, Preparation Scripts, Analysis Scripts. Within these individual sections, analytics may have been arranged in alphanumeric order by the analytic author, which implies running the analytics in the same order.

    Note

    Running analytics out of order will probably cause one or more of the analytics to fail.

  4. Do one of the following:

    If the Run button appears, click Run. The analytic does not require input values.

    If the Continue button appears, click Continue. The analytic requires input values.

    If no input values are required, the analytic runs. If the analytic runs successfully to completion, it displays a status of Succeeded. If the analytic does not run successfully to completion, it displays a status of Failed.

  5. If you clicked Continue, do one of the following:

    If previous input values are not prefilled, provide the input values in accordance with the prompts presented by the analytic, and click Continue after you have provided each value. When you have provided all the values, click Run.

    If previous input values are prefilled, click Run to accept the previous values, or click the names of individual parameters to update values selectively. Click Update after you have updated each value. When you have finished updating values, click Run.

    Note

    If multiple input values can be entered in a single field, press Enter after each value, so that each value is on a separate line – unless the analytic instructs you to do something else.

    The analytic runs. If the analytic runs successfully to completion, it displays a status of Succeeded. If the analytic does not run successfully to completion, it displays a status of Failed.

  6. If the analytic runs successfully, do one of the following:

    If the analytic produced a results table, click Open to view the table, or to create an interpretation or visualization of the results.

    If the analytic is part of an analytic sequence, run the next analytic in the sequence.

  7. If the analytic fails, and produces a log file (analytic_name.log), click Open to review the log.

    The log should include an entry, marked with a red X , that indicates why the analytic failed. You may be able to correct the error yourself, or you may need to refer the error to the analytic author for correction.