The "Results" of a run are the set of files that your code generates or modifies when it runs. You can view the results of a given run through the Runs tab of your project. Or you can view the latest results on the Results tab of your project.
By default, when your code finishes running, Domino will save its results (that is, any new files it produced) back into your project folder. This means those changes will be downloaded the next time you sync your project.
If your code generates large results that you don’t need to synchronize each time, you can set your project to save results to isolated "results branches." Your results will be accessible through the web interface (and permanently saved), but they won’t automatically be accessible to subsequent runs, or automatically downloaded to your computer.
You can control this behavior on your project’s settings page, under the "result behavior" section.
Download results from an isolated branch
You can download isolated results from the UI as well as the CLI.
From the UI, select the run from the runs page, and click view results. From there you can choose to download each results file.
With the CLI, you can use the domino download-results
command. For
details on usage syntax, run domino help download-results
.
If many files get changed during a run it might be difficult to navigate
or get a high level summary. To control which files should be rendered
as results, you can create a special file in your project folder called
.dominoresults
(note the leading period). If this file exists and has
entries, Domino will only render results that match patterns in the
file.
Include single files in the results dashboard
To include only specific files of interest, your '.dominoresults' file
must list the relative path to those, each on a new line. Use the
following example to display only histogram.pdf
and output.txt
files
located in the top level directory of the project.
histogram.pdf
output.txt
Use patterns with wildcard characters
Domino can use wildcards patterns in ".dominoresults". This allows you to specify groups of files you want to be displayed. The following example will limit the files to PDF documents in the top-level directory, all PNG files in a directory images and text files arbitrarily deep in sub-directories of the project.
*.pdf
results/*.png
**/*.txt