# VirtualBox bind

With the **VirtualBox bind** trigger, the workflow process starts when a virtual box is associated to a file. A [Virtual Box](/data-mover-1.21/contracts/virtual-boxes.md) is a way to classify and tag files in Data Mover. &#x20;

For example, when a workflow template binds a virtual box to a file, an event is emitted and contracts having the **VirtualBox bind** trigger will start. This scenario can occur both with a mediation contract having the VirtualBox bind trigger, and with an output system workflow template where the user specifies in the contract the virtual box to be associated with the file.&#x20;

The **VirtualBox bind** trigger requires a virtual box.

**Execution Variable**

When executed, this trigger adds an execution variable named `file`, of type `FileDetail`. Its attributes are set based on the information sent from the event that initiated the trigger.&#x20;

For the **VirtualBox bind** trigger, Data Mover provides a set of **system workflow templates** that must be used in output contracts. You can find the complete list on the following page: [Workflow templates for output contracts → Trigger type: VirtualBox Bind](/data-mover-1.21/workflow-templates/system-workflow-templates/workflow-templates-for-output-contracts.md#trigger-type-virtual-box-bind).&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primeur.com/data-mover-1.21/workflow-templates/triggers/virtualbox-bind.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
