Embed files

You can manually add file attachments to test objects (see chapter "Add attachments").

This chapter describes how to embed these files. Embedded files are files that you store directly in Tosca Commander.

For information on other file storage options and advantages/disadvantages, see chapter "File storage options".

If you use Tricentis File Service, you can't embed files.

Tricentis Tosca saves all file attachments to the Tricentis File Service database (see chapter "Store files on Tricentis File Service").

Embedding and test execution

Tricentis Tosca Commander can't use embedded files for test execution. It can, however, use customizations and SpecialExecutionTasks during execution if you embed them in a Module.

Embed files in Tosca Commander

To embed a file in Tosca Commander, follow the steps below:

  1. Drag and drop a file onto the test object, or use the context menu entry Attach file.

  2. In the subsequent Choose file type window, select Embedded.

  3. Click OK.

You can add multiple attachments. Tosca Commander adds the file(s) to the Attachments folder of the test object.

Embedded file attachment of a Module

Save a local copy

You can save a local copy of the file. To do so, right-click the attached file and select Save Copy to ... from the context menu.

Open and edit attached files

For information on how to open and edit embedded files, see chapter "Open and edit attached files".

Configure embedding

You can fine-tune embedding to your needs:

  • Change the allowed file size. By default, the maximum allowed file size for embedding is 1MB.

  • Add a warning message whenever users embed files of a certain size or larger. The message informs users that large files slow down the workspace over time. Additionally, it offers to create a file reference instead.

To configure embedding, follow the steps below:

  1. Open the TOSCACommander.exe.config file. By default, this file is located at %COMMANDER_HOME%.

  2. Go to the Tricentis.TCCore.Base.Properties.Settings section.

  3. To change the allowed file size, perform the following actions:

    • Paste the code below.

    • As the value, enter a positive integer to indicate the allowed file size in megabytes. For instance, to allow a maximum file size of 10 megabytes, enter 10.

Copy 
<setting name="MaxEmbeddedFileSize" serializeAs="String">
    <value></value>
</setting>

  1. To add the warning message, perform the following actions:

    • Paste the code below.

    • As the value, enter a positive integer to indicate when users should get a warning. For instance, to warn users whenever they embed files that are 5 megabytes or larger, enter 5.

Copy 
<setting name="EmbeddedFileSizeWarningLevel" serializeAs="String">
    <value></value>
</setting>

  1. Save and close the file.

Disable embedding

If you don't want to allow users to embed files, you can disable the functionality.

To disable embedding, follow the steps below:

  1. Open the TOSCACommander.exe.config file. By default, this file is located at %COMMANDER_HOME%.

  2. Go to the Tricentis.TCCore.Base.Properties.Settings section.

  3. Paste the following code:

Copy 
<setting name="MaxEmbeddedFileSize" serializeAs="String">
    <value>0</value>
</setting>

  1. Save and close the file.