You can decrease ambiguity for testers by providing screen shots and sample files. Inserting files gives testers a reference point to compare what they are seeing on the VM to a specific screenshot or use a file for some other reason so they may interact with it. 

Inserting screenshots or files to a test step

There are a few ways to upload a file into a Rainforest test. This article shows how to do it via the Rainforest app UI. See here on how to do it via the CLI. 

Embedding files 

  1. Ensure the test step is in edit mode. If not, click the pencil to edit the step.
  2. Drag a file from your file location onto the text field. You will see a + symbol when hovering over the text field.
  3. Once you drop the file, the file will be given a file number and enclosed by double braces {{}}.
  4. Click Save. The file name will convert into a gray box.

This will give testers a direct download link of the file provided! 

Provide a URL to the file

  1. Insert a step that links to the file on the hosting service
  2. Provide instructions to either download or use screenshot

     Open a new tab and go to [URL]
     Were you able to compare the image / download the file?

Preview screenshot and download 

When a non-image file (.csv, .doc, .txt, etc.) is embedded, it will auto-format as a downloadable file {{,x)}} instead of a screenshot {{file.screenshot(x,x)}}. In the Test Edit view, the file will be clickable and will download directly from the test step.

Force image files to be downloadable files:

By default, images files (.jpeg, .png, .gif) are auto-formatted as a screenshot. If you wish for the tester to download the image, modify the file name in the text box.

Cannot force a downloadable file to be an image file.  
Cannot force an image file to be downloadable via a URL.

  1. Embed the file(s)and provide clear instructions what to do with those files.
  2. Make the file downloadable, {{ file.screenshot(x,x) }}, by:
    replacing "screenshot" with "download",
    adding a comma and space,
    adding a name (can be anything but best to include original file type as well such as .png, jpg)

Image  {{ file.screenshot(177510, nKcjvM) }}
Downloadable {{, nKcjvM, file.png) }}

Did this answer your question?