> For the complete documentation index, see [llms.txt](https://docs.primeur.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.primeur.com/panorama-2.0.1/cards/transfer-cards/protocol-download-upload.md).

# Protocol Download/Upload

The **Protocol Download/Upload** card compares the number of transfers or the size (in bytes) of the transfers downloaded and uploaded. Each protocol has a color assigned and a legend is available on the right of the graph.

For detailed instructions on how to create this card, refer to [Create a Card](/panorama-2.0.1/cards/create-a-card.md).

By default, no protocol is selected and the graph is empty. To have data shown, click the ![](/files/e8t4eRrw2rWJ8L4AdPPS) chip on the top right corner, next to the 3-dot button and select **one protocol** in the window that appears. The graph will be updated and will show data as in the following figure.

<figure><img src="/files/C9qNdAjsgObOq5Ly90Gk" alt="" width="563"><figcaption></figcaption></figure>

If you hover over a bar, a tooltip will appear showing the number of transfers or the bytes downloaded and uploaded on the protocol. In the following figure, the tooltip shows data relevant to the month of March.

<figure><img src="/files/Tty29f2YX4pxsYz0XMV6" alt="" width="309"><figcaption></figcaption></figure>

Clicking an empty cell in the graph drills down into a more detailed time period. For example, if the initial view shows an entire year, clicking an empty cell for the month of **February** updates the graph to display the **days** in that month. Clicking a specific **day** then displays the **hours** of that day, and so on, down to the **single‑minute** level.

As shown in the following figure, the graph showing single months now shows the single days of the month of February.

<figure><img src="/files/NEhK8nuOQAxmAM1fmFLl" alt="" width="563"><figcaption></figcaption></figure>

To return to the previous view, use the <img src="/files/7yxSjKN4RWUyiBeF1t8K" alt="" data-size="line"> back arrow located just below the card name. It can be clicked repeatedly to navigate step‑by‑step back through the time levels, up to the **Year** view.

<figure><img src="/files/qqwYcLAtONHVUe66Sd4V" alt="" width="209"><figcaption></figcaption></figure>

The options of the dropdown list can be used to update the graph to a different period. E.g., another month of the year, another day of the month, and so on.&#x20;

{% hint style="info" %}
To drill down into a more detailed time period, you must select an **empty cell** in the graph. If you click a **colored column**, the system will not drill down; instead, it will open the [Transfers window](#transfers-window) described below.
{% endhint %}

The **Protocols Comparator** card is equipped with a toolbar that allows you to:

* <img src="https://files.readme.io/b53abda-image.png" alt="" data-size="line"> switch from number of transfers (Count) to number of bytes uploaded or downloaded, as shown here below.

<figure><img src="/files/c8Apow6g6QaSliToQGHU" alt="" width="563"><figcaption></figcaption></figure>

* <img src="https://files.readme.io/2e92e44-image.png" alt="" data-size="line"> switch transfer mode. You can see all transfers, where Data One is client (it engages with another entity to retrieve and deliver files), or server (it receives files from partners or makes files accessible for other entities).
* <img src="/files/gJtk19vIwLpdcpKXf9DR" alt="" data-size="line"> chip to select the protocol for which you want to see the data.

## Card menu options <a href="#card-menu-options" id="card-menu-options"></a>

Clicking the 3 dots button in the upper right corner of the card, the following options will appear.

<figure><img src="/files/iDyI16IswT3M1eAyloLa" alt=""><figcaption></figcaption></figure>

### Filter

This option allows you to use filters to refine the data displayed on the card:

* **Filename**: Enter the name of the file for which you want to see the download and upload of transfers or bytes on the selected protocol. The specified string will be searched in all filenames, i.e. writing march will return all filenames that contain march anywhere in the filename. The graph will list all flows containing the filename or string entered.
* **Outcome**: select SUCCESS, FAILURE or ERROR. Once the filter is applied, the card will display only the results that match the selected criterion.
* **System type**: Select the system or application that generated the monitored events and sent them to DataWatcher, either directly or through a DWAgent. This option identifies the source platform responsible for originating the events.
* **Source**: If you want to see all the transfers downloaded and uploaded for the selected protocol on a specific source, enter the name of the source in this field.
* **Destination**: If you want to see all the transfers downloaded and uploaded for the selected protocol on a specific destination, enter the name of the destination in this field.
* **Source Queue**: If you want to see all the transfers downloaded and uploaded for the selected protocol on a specific source queue, enter the name of the queue in this field.
* **Destination Queue**: If you want to see all the transfers downloaded and uploaded for a specific destination queue, enter the name of the queue in this field.

If a filter is applied, the funnel icon appears in the upper right corner to indicate that the results shown are a subset of the total. Clicking the funnel icon, all applied filters will be listed. To open the **Filters** window and edit them directly, click the pencil icon.

Filters are also useful when multiple cards of the same type need to be applied to different elements. An example is the need for 3 cards, one for successful flows, one for failed flows, and one for error flows.

You **can add as many cards of the same type as you need**. They cannot be renamed but can be distinguished by the sequential number that appears at the end of the card name.

### Export CSV

This option allows you to export the list of results immediately or schedule an automatic export as a **zipped .csv file**.

<figure><img src="/files/JwSWRaW1wu8ErpXU6X64" alt="" width="384"><figcaption></figcaption></figure>

#### Export tab

This option performs a one‑time export:

1. Select the **time range** of the data to be exported. The time range displayed is the global dashboard time range shown at the top-right of the application: ![](/files/CxvKzFZKKbMFTBvB6zxv)
   * Adjust the **From** and **To** dates by clicking the calendar, selecting a new date, and clicking **APPLY**.
2. Any active filters are displayed.
   * To remove all filters, click **Reset**. In this case, only the selected **Period** is applied.
3. Optionally, enable **email notification** to be informed when the export is completed. To receive email notifications, the following conditions must be met:
   * The [Mail Sender](/panorama-2.0.1/setup-and-configuration/plugins-configuration/mail-sender.md) plugin is configured.
   * The [user's email address](/panorama-2.0.1/setup-and-configuration/users-and-roles-setup/manage-users.md) is specified in the **Email** field.

#### Schedule export tab

This option automatically exports data on a recurring basis.

1. Choose the export frequency by selecting **Daily**, **Weekly**, or **Monthly** in the **Scheduling type** field.
2. Any active filters are displayed.
   * To remove all filters, click **Reset**. In this case, only the selected **Period** is applied.
3. Optionally, enable email notification to be informed when the export is completed.&#x20;
   * Enter a valid email address and click the **+** button to confirm.

### Export HTML

Export or schedule the export of the list of results in .html format, including the image of the graph or not. The same options as the **Export CSV** menu are applied.

<figure><img src="/files/tsaPWdR1SDrs8XpQLRUU" alt="" width="383"><figcaption></figcaption></figure>

### Table view

This option opens the **Transfers** window, showing a drill-down of the items in the card.&#x20;

{% hint style="info" %}
Any filters applied to the card are automatically applied to the **Transfers** window.
{% endhint %}

<figure><img src="/files/Ra4n4lHqOSloEodMdPul" alt="" width="563"><figcaption></figcaption></figure>

#### Transfers window

The **Transfers** window is a drill‑down view that allows you to explore the data behind a card in detail. It opens when you click a bar in the histogram or when you select **Table view** from the 3‑dots menu.&#x20;

The information shown in the popup corresponds **exactly** to the data used to generate the graph. This means that:

* any **active filters** (such as date range, protocol, etc.) apply both to the graph and to the popup details.
* the popup lists **only** the transfers represented by the selected bar, with no additional aggregation.

Even if you switch from **Count** to **Bytes**, the **Transfers** popup always displays the detailed list of transfers based on the **number of files (count)**.

In the **Transfers** window:

* The **Export** button at the top-left allows you to export **only the list currently displayed**.
* **Transfers details** such as Filename, Source, Destination, Direction, Date, Size and many others are available.
* **Columns** can be configured by clicking the ![](https://docs.primeur.com/~gitbook/image?url=https%3A%2F%2F2045400606-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FFouPOWj5S0ya9f5bCSIe%252Fuploads%252FgXShIqLGn4sj5Hc3aDPg%252Fimage.png%3Falt%3Dmedia%26token%3Da2375d1f-385d-4a25-a840-80c75e9fa2cd\&width=48\&dpr=3\&quality=100\&sign=79678f29\&sv=2) icon on the top-right corner. Columns cannot be sorted but the list can be exported in CSV format.
* A **search edit box** can be used to filter results by filename.
* A **toolbar** allows you to easily navigate through results.

### Color

This option allows you to select a different color for the external border of the card.&#x20;

Click the **Reset** button to restore default settings.

<figure><img src="/files/Pwzm3N72lmr45ekB2WtJ" alt="" width="254"><figcaption></figcaption></figure>

### Remove

This option allows you to remove the card. Note that the card will be removed without any further prompting.

## Export data

You can export data in several ways:

* **From the card menu**, by selecting **Export CSV** or **Table view**:
  * **Export CSV** exports the full dataset for the selected time range. Any applied filters will be shown in the **Filters** section.
  * **Table view** opens a drill‑down view; using **Export** from there exports only the data currently displayed, including any applied filters, shown in the **Filters** section.
* **From the Flows window**, by clicking **Export**.
  * Only the currently visible dataset is exported. Any applied filters will be shown in the **Filters** section.

In all cases:

* The **time range** can be adjusted in the **Period** section.
* Applied filters are shown in the **Filters** section.
* To export the entire dataset without filters, click the ![](/files/8pVz3r95CdlJqYLE3qla) chip.

<figure><img src="/files/bi8p4754VNWL8Vnwzyad" alt="" width="255"><figcaption></figcaption></figure>
