maestro
latest
false
  • Overview
    • Introduction to UiPath Maestro™
    • Requirements
    • Example scenarios
  • Process modeling
  • Process implementation
  • Process operations
  • Process monitoring
  • Process optimization
  • Reference information
UiPath logo, featuring letters U and I in white

Maestro user guide

Last updated Apr 30, 2025

Using files in Maestro

In UiPath Maestro™, files are managed through Data Fabric (previously called Data Service). Every time a file is downloaded from a source (such as an email attachment or a cloud storage provider), the file is uploaded to an entity in Data Fabric that supports file storage.

The file is then referenced using a Data Fabric reference, a triplet containing:

  • EntityName
  • RecordId
  • FieldName

This reference allows the file to be used anywhere in your agentic process.

Prerequisites

Before using files in Maestro, make sure that:

  • Data Fabric is enabled in your organization or tenant.
  • An entity with a file-supporting field is configured.

No additional fields are required beyond those automatically filled by Data Fabric, when a record is created.

Example use case

This example shows how to download a file from Box, and send it as an email attachment.

  1. Download the file
    • Configure a Send Task to run a Download File activity from the Box connector.
    • Select the file you want to download.
    • Set the File resource output using the Data Fabric editor. Choose the Entity and Field that support files.


    When executed, the activity will return a Data Fabric reference (EntityName, RecordId, FieldName) pointing to the new file record in Data Fabric.
  2. Send the file by email
    • Configure another Send Task using the Outlook connector's Send Email activity.
    • Attach the file by referencing the RecordId from the previous step in the Data Fabric editor.


After testing, you will find the RecordId available in the workflow variables.



You can also verify the file exists in the Data Fabric application by searching for the RecordId.

Important:
  • In Maestro, files are supported exclusevily through Data Fabric.
  • If a file already exists in Data Fabric, you can reuse it by adding its Data Fabric reference.
  • Prerequisites
  • Example use case

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2025 UiPath. All rights reserved.