# What you see on the screen

The **Download Job** page displays the list of active and scheduled download jobs in the network configuration inventory. The following table outlines the available action icons and their descriptions.

**Download Jobs Details** | Basic Details

<table data-header-hidden><thead><tr><th width="161"></th><th width="217"></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/ Example</strong></td></tr><tr><td>Search</td><td>Search for the required download job.</td><td>Search by device credentials, asset ID, name, etc., to quickly locate a specific download job.</td></tr><tr><td>Filter</td><td>Apply a filter based on field conditions.</td><td>Filters can be applied to various fields, including IP address, device credentials, vendor, status, and configuration type. Conditions include equals, contains, etc.</td></tr><tr><td>Date Range</td><td>Filter download jobs by a specified time frame.</td><td>Select time ranges such as the current hour, last 30 minutes, last hour, etc., to narrow down job history.</td></tr><tr><td>Go to Assets</td><td>Navigate to the asset module homepage.</td><td>Redirects to the IT Assets module to manually add or manage devices and download jobs.</td></tr><tr><td>Download Results</td><td>View the results of download jobs.</td><td>Opens a pop-up displaying the status and outcome of configuration downloads, including device name, IP address, status (success/failure), and error logs.</td></tr><tr><td>Column Selection</td><td>Customize the columns shown on the page.</td><td>It allows users to modify which columns appear in the table by dragging and dropping them from 'Available' to 'Selected'. Columns can also be rearranged or frozen.</td></tr><tr><td>Export</td><td>Export download job data to a CSV file.</td><td>Download a CSV file containing details of all download jobs for offline use.</td></tr><tr><td>Bulk CSV Update</td><td>Edit multiple download jobs at once via CSV.</td><td><p>Follow the steps outlined below to complete the import successfully:</p><ul><li>Download the sample CSV template to ensure proper data structure.</li><li>Enter the required information into the CSV file accurately.</li><li>Upload the completed CSV file and click "Next."</li><li>Review the system’s column mapping, adjust if necessary, and click "Import."</li></ul></td></tr><tr><td>Import from CSV</td><td>Add download jobs in bulk via CSV.</td><td><p>Upload a CSV file with the respective fields, then review and import the jobs after verifying the data.</p><p><br><strong>Import from CSV File</strong></p><ul><li>Download the CSV file (excel sheet) and enter the respective fields in the sheet. </li><li>Upload the same edited CSV file.</li><li>Click <strong>Next</strong> -> <strong>Import</strong> -> <strong>Proceed with Valid Records.</strong></li></ul></td></tr><tr><td><strong>Column Details</strong></td><td></td><td></td></tr><tr><td>Summary Card</td><td>Click any field to view detailed information.</td><td><p>This displays a summary of the download job, including the name, IP address, configuration profile, and associated device credentials.</p><p><br><strong>Example:</strong> Error in making a connection to the device. Verify the connection commands in the Configuration Profile are valid and check the Download Job Audit for finding the invalid command</p></td></tr><tr><td>Device Credential</td><td>View-only field, no actions.</td><td>Displays the device credentials associated with the download job.</td></tr><tr><td>Status</td><td>View-only field, no actions.</td><td>Indicates the operational status of the download job.</td></tr><tr><td>Running Configuration</td><td>Click to view the running configuration.</td><td><p>The pop-up window displays the current running configuration, including the download date and time. Search and export options (.txt) are available.</p><p>(Where Device Connection and Download Commands are maintained)</p><p><strong>Example:</strong> Download Time: Dec 23, 2024, 12:10 PM (V33).</p></td></tr><tr><td>Startup Configuration</td><td>Click to view the start-up configuration.</td><td><p>The pop-up window displays the current start-up configuration, including the download date and time. Search and export options (.txt) are available.</p><p>(Where Device Connection and Download Commands are maintained)</p><p><strong>Example:</strong> Download Time: Dec 23, 2024, 12:10 PM (V25).</p></td></tr><tr><td>Agent</td><td>View-only field, no actions.</td><td>Displays the agent name, IP address, and vendor details associated with the download job.</td></tr><tr><td>Next Action Time</td><td>View-only field, no actions.</td><td>Displays the scheduled time for the next action associated with the download job.</td></tr><tr><td>Last Action Time</td><td>View-only field, no actions.</td><td>Displays the timestamp of the last action performed on the download job.</td></tr></tbody></table>

**Action Icons** | Download Jobs

<table data-header-hidden><thead><tr><th width="159.4000244140625"></th><th width="256.4000244140625"></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/ Example</strong></td></tr><tr><td>Edit</td><td>Modify an existing download job.</td><td>Update job details like configuration, connection, download, retry, and other details.</td></tr><tr><td>Delete</td><td>Click to remove a download job from the list.</td><td>Deletes the selected download job from the system.</td></tr><tr><td>Download Now</td><td>Initiate an immediate configuration download.</td><td>Select a job and click the download icon to download the device configurations immediately.</td></tr><tr><td>View Result</td><td>View the results of the executed download job.</td><td>Displays detailed results of the configuration download, including status and timestamps.</td></tr><tr><td>View Audit</td><td>Review the audit trail for the executed job.</td><td>Displays a log of actions taken during the download process, including user actions and system changes.</td></tr><tr><td>Change Agent</td><td>Change the agent used for the download process.</td><td>It allows users to select a different agent from the list to monitor or fetch the device configuration during the download.</td></tr><tr><td>Configuration Details</td><td>View the configuration details of the download job.</td><td><p>Displays detailed configuration data, including:</p><ul><li><p>Download Job Summary</p><ul><li>Device Credential</li><li>Configuration Profile</li><li>Connection Protocol</li><li>Download Status</li><li>Agent</li><li>Status</li><li>Download start time</li><li>Download end time</li><li>Next download time</li><li>Inventory download protocol</li><li>Startup configuration download protocol</li><li>Running Configuration download protocol</li></ul></li><li><p>Configuration details</p><ul><li>Baseline Running</li><li>Current Running</li><li>Current Startup</li><li>Baseline Startup</li><li>Previous v/s Current running</li><li>Previous v/s Current Start-Up</li><li>Baseline v/s Current running</li><li>Baseline v/s Current Start-Up</li></ul></li></ul></td></tr><tr><td>Resync Agent</td><td>Resynchronize the agent associated with the job.</td><td>Synchronizes the download job with the assigned agent to prepare it for the configuration download.</td></tr></tbody></table>

**View Result** | Action Icons

It summarizes configuration retrieval jobs from network devices like routers, switches, and firewalls. It displays key details such as the job status (success or failure), device information (IP addresses and versions), and timestamps for initiating and completing the download.

The following table outlines the available action icons and their descriptions:

<table data-header-hidden><thead><tr><th width="146.5999755859375"></th><th width="195.20001220703125"></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/ Example</strong></td></tr><tr><td>Search</td><td>Search for the required download job result.</td><td>Search by IP Address to locate a specific download job quickly.</td></tr><tr><td>Filter</td><td>Apply a filter based on field conditions.</td><td>Filters can be applied to various fields, including IP address, Configuration Type, Download Triggered From, and Download Status. Conditions include equals, contains, etc.</td></tr><tr><td>Date Range</td><td>Filter download job results by a specified time frame.</td><td>Select time ranges such as the current hour, last 30 minutes, last hour, etc., to narrow down job history.</td></tr><tr><td>Export</td><td>Export download job result data to a CSV file.</td><td>Download a CSV file containing details of all download jobs for offline use.</td></tr><tr><td><strong>Column Details</strong></td><td></td><td></td></tr><tr><td>Version</td><td>Click to re-direct to the comparison data</td><td>Displays the version name or number for the respective result.</td></tr><tr><td>Configuration</td><td>Click to open the configuration type linked</td><td>In the pop-up window, display the type. Search and export options (.txt) are available. Example: Configuration Type: start-up (Configuration: Dec 21, 2024, 08:12 PM (-NA-))</td></tr><tr><td>IP Address</td><td>View-only field: no actions can be taken</td><td>Displays the IP address of the device from which the configuration was downloaded.</td></tr><tr><td>Configuration Type</td><td>View-only field: no actions can be taken</td><td>Indicates whether the configuration is a running or start-up configuration.</td></tr><tr><td>Status</td><td>View-only field: no actions can be taken</td><td>Displays the current status of the download job, such as success, failure, or pending.</td></tr><tr><td>Download Triggered From</td><td>View-only field: no actions can be taken</td><td>Indicates the origin of the download trigger, whether it was manual, scheduled, or automatic.</td></tr><tr><td>Agent</td><td>View-only field: no actions can be taken</td><td>It displays the name of the agent who facilitated the download process, along with its IP address and vendor details.</td></tr><tr><td>Actions</td><td></td><td></td></tr><tr><td>Baseline</td><td>View-only field: no actions can be taken</td><td>Allows users to flag the selected jobs as standard or reference configuration.</td></tr></tbody></table>

**View Audit** | Action Icons

Displays a detailed log of activities related to a specific download job. It includes timestamps for when the job was initiated, modified, or completed. The audit log also captures configuration details such as the type of configuration downloaded (running or start-up), error logs, and any issues encountered during the process.

The following table outlines the available action icons and their descriptions:

<table data-header-hidden><thead><tr><th width="145"></th><th width="201.79998779296875"></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description</strong></td></tr><tr><td>Search</td><td>Search for the required download job.</td><td>Search by Message, date, etc., to quickly locate a specific download job.</td></tr><tr><td>Filter</td><td>Apply a filter based on field conditions.</td><td>Filters can be applied to various fields, including Message and Message Type. Conditions include equals, contains, etc.</td></tr><tr><td>Auto Refresh</td><td>Click to turn on the toggle to get the page automatically refreshed.</td><td>Enables real-time updates of the download audit log without needing a manual refresh.</td></tr><tr><td>Timestamp</td><td>View only field; no actions can be taken.</td><td><p>Displays the exact date and time when the download job activity occurred.</p><p><strong>Example:</strong> Dec 21, 2024 08:11:37 PM</p></td></tr><tr><td>Message Type</td><td>View only field; no actions can be taken.</td><td><p>Displays the type of message (e.g., success, error, warning) related to the job.</p><p><strong>Example:</strong> Audit, Running.</p></td></tr><tr><td>Message</td><td>View only field; no actions can be taken.</td><td><p>Shows detailed messages describing any issues that occurred during the download job.</p><p><strong>Example:</strong> Connection failed with Primary IP address: 10.0.5.58, Primary Device credential: Infraon Server evere$T using SSH connection protocol.</p></td></tr></tbody></table>

## **Bulk Actions**

Bulk action icons enable users to manage multiple download jobs at once efficiently. Users can perform bulk actions through the pop-up menu by selecting jobs with checkboxes.

Refer to the table below for detailed actions and their functionalities:

**Bulk Actions |** Action Icons

<table data-header-hidden><thead><tr><th width="145"></th><th width="221.800048828125"></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Actions</strong></td><td><strong>Description</strong></td></tr><tr><td>Delete</td><td>Click to delete selected download jobs</td><td>Removes the selected download jobs from the system.</td></tr><tr><td>Edit</td><td>Click to edit selected download jobs</td><td>Allows users to modify the details of the selected download jobs, such as configurations and settings.</td></tr><tr><td>Enable</td><td>Click to enable selected jobs</td><td>Activates the selected download jobs, allowing them to run based on their scheduled configurations.</td></tr><tr><td>Disable</td><td>Click to disable selected jobs</td><td>Temporarily deactivates the selected download jobs, preventing them from running until re-enabled.</td></tr><tr><td>Change Agent</td><td>Click to change the agent for selected jobs</td><td>Allows users to assign a different agent to manage the selected download jobs.</td></tr><tr><td>Download Now</td><td>Click to initiate an immediate download for selected jobs</td><td>Forces the selected download jobs to start instantly, overriding the scheduled time.</td></tr><tr><td>Resync Agent</td><td>Click to resync the agent for selected jobs</td><td>Re-establishes the connection between the selected download jobs and the agent, ensuring smooth operations.</td></tr></tbody></table>

## **MSP-Based Visibility**

When the MSP feature flag is enabled, all configuration-related dropdowns in Discovery, Add Download Job, Edit Download Job, CSV Import, and Bulk CSV Update respect MSP visibility and vendor mapping.

When MSP is disabled, dropdown values are displayed only for vendor, and no MSP validation is applied.

<table data-header-hidden><thead><tr><th width="149.20001220703125" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>MSP Status</strong></td><td valign="top"><strong>System Behavior</strong></td></tr><tr><td valign="top"><strong>Enabled</strong></td><td valign="top">The customer field is visible where applicable. Configuration profiles, credentials, secondary credentials, and agents are filtered based on MSP visibility and vendor.</td></tr><tr><td valign="top"><strong>Disabled</strong></td><td valign="top">The customer field is hidden. Configuration profiles are listed by vendor only. No MSP-based validation is applied.</td></tr></tbody></table>

### &#x20;**Configuration Download**

\
When the Configuration Download toggle is enabled:

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Label</strong></td><td valign="top"><strong>If Enabled</strong></td><td valign="top"><strong>If Disabled</strong></td></tr><tr><td valign="top"><strong>Configuration Download</strong></td><td valign="top"><p><strong>·</strong> The customer field is visible.</p><p><br><strong>·</strong> Configuration Profile dropdown lists profiles mapped to the selected Customer and Vendor.</p><p><br><strong>·</strong> Changing the customer clears the previously selected profile.</p></td><td valign="top"><p><strong>·</strong> Customer field is not visible.</p><p><br><strong>·</strong> Configuration Profile dropdown lists profiles based on the selected Vendor only.</p></td></tr></tbody></table>

### **Add Download Job**

The Add Download Job screen supports MSP-based visibility control. When MSP is enabled, dropdown values are dynamically filtered based on the selected asset’s MSP visibility and vendor mapping. When MSP is disabled, the screen follows standard vendor-based behavior without MSP validation.

#### When MSP is Enabled

<details>

<summary><strong>If the Selected Asset Has MSP Visibility</strong></summary>

In this case, all relevant dropdowns respect MSP visibility rules:

* **Configuration Profile**
  * Lists profiles mapped to:
    * Selected Asset MSP visibility
    * Selected Vendor
* **Device Credential**
  * Lists credentials mapped to the asset’s MSP visibility.
* **Secondary Device Credential**
  * Lists credentials mapped to the asset’s MSP visibility.
* **Agent**
  * Lists agents mapped to the asset’s MSP visibility.

</details>

<details>

<summary><strong>If the Selected Asset Does Not Have MSP Visibility</strong></summary>

When the asset is not associated with MSP visibility:

* **Configuration Profile**
  * Filtered by vendor only.
* **Device Credential**
  * All credentials are listed.
* **Secondary Device Credential**
  * All credentials are listed.
* **Agent**
  * All agents are listed.
* No MSP-related validation is applied.

</details>

#### When MSP is Disabled

When the MSP feature flag is turned off:

* All dropdowns operate in standard mode.
* The configuration profile is filtered by vendor only.
* Device Credential, Secondary Device Credential, and Agent are listed without MSP restrictions.
* No MSP validation is applied.

<figure><img src="https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FkRoEcqxUviRJrZz49bpj%2Funknown.png?alt=media&#x26;token=daa6d2d5-8529-4112-b632-5e9d6ecb93a4" alt=""><figcaption></figcaption></figure>

### **CSV Import & Bulk CSV Update**

When MSP is enabled, validation is applied during CSV Import and Bulk CSV Update operations for fields such as Configuration Profile, Agent ID, Device Credential, and Secondary Device Credential.

These validations are enforced only if the selected download job has MSP visibility. The system ensures that the uploaded values match the job’s MSP visibility scope; otherwise, validation errors are displayed.

If MSP is enabled but the selected job lacks MSP visibility, MSP-based validation is not applied. When MSP is disabled, no MSP-related validation is performed, and the import or bulk update process proceeds based on standard vendor-level rules.

<figure><img src="https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FnEyntoWcQWk3mDhkBGqh%2Funknown.png?alt=media&#x26;token=328dd685-dd97-4533-9c72-3fc0213ea6ec" alt=""><figcaption></figcaption></figure>