Settings

Configure proxy, logging, notifications, and license settings.

The Settings dialog is the central place to configure how SFDC File Exporter connects to the internet, what information it records, how it notifies you, and which license it runs under. All changes take effect after clicking Save — except on the License tab, where activation happens immediately when you click Activate.

Opening the Settings Dialog

1
From the main menu

In the application menu bar, click File and then select Settings from the dropdown.

2
From the toolbar

Click the Settings icon (gear icon) in the main toolbar. The Settings dialog opens to the last active tab.

3
Choose a tab

The dialog contains four tabs: Proxy Configuration, Miscellaneous, Notifications, and License. Click any tab to navigate to it.

All settings are saved per user profile on the local machine. Changes made in one session persist across restarts.

Proxy Configuration Tab 1

If your network routes outbound traffic through a proxy server, configure it here. When a proxy is enabled, all Salesforce API calls and OAuth flows are routed through the specified server.

1
Enable Proxy

Check the Enable Proxy checkbox to activate proxy routing. When unchecked, the application connects directly to Salesforce and the fields below are ignored.

2
Enter the Proxy Host

Enter the hostname or IP address of your proxy server in the Proxy Host field. For example: proxy.company.com or 192.168.1.10.

3
Enter the Proxy Port

Enter the port your proxy server listens on in the Proxy Port field. Common values are 8080, 3128, or 80. The field accepts numbers only.

4
Proxy credentials (optional)

If your proxy requires authentication, enter your Proxy Username and Proxy Password. Leave both fields blank if the proxy is unauthenticated.

5
Save

Click Save to apply the proxy settings. The new configuration takes effect on the next API call or login attempt.

Field Required Example
Enable Proxy Checkbox toggle
Proxy Host Yes, when proxy is enabled proxy.company.com
Proxy Port Yes, when proxy is enabled 8080
Proxy Username No jsmith
Proxy Password No ••••••••
The proxy password is stored encrypted in the local configuration file. It is never transmitted in plain text.
If you enable the proxy but leave the host or port blank, login and export operations will fail with a connection error. Verify proxy details with your network administrator before saving.

Miscellaneous Tab 2

Controls two independent features: detailed application logging and job history tracking for scheduled exports.

Logging

1
Enable Detailed Logging

Check Enable Detailed Logging to turn on verbose application logs. When enabled, the application records each API request, response status, file download event, and any errors encountered during export operations.

2
Access the Logs tab

Once logging is enabled and settings are saved, a Logs tab appears on the main dashboard. Click it to review the current log output in real time.

3
Clear logs

Inside the Logs tab, use the Clear Logs button to remove the current log output from the display. This does not disable logging — new entries will continue to appear as operations run.

Detailed logging is useful when diagnosing connectivity issues or unexpected export failures. For everyday use, you can leave it disabled to keep the dashboard uncluttered.
Log output is held in memory for the current session only and is not written to a log file on disk. Closing the application clears all logged entries.

Job History

1
Enable Job History Tracking

Check Enable Job History Tracking to record the outcome of each scheduled export run. When enabled, completed and failed runs are listed under the History subtab inside each scheduled job on the Scheduled Jobs tab.

2
Review run history

Navigate to the Scheduled Jobs tab on the dashboard, then open a job and select the History subtab to see a list of past runs, their timestamps, and their success or failure status.

3
Delete all run history

Use the Delete All History button on the History subtab to permanently remove every recorded run for that job. This action cannot be undone.

Job history gives you a quick audit trail to confirm that overnight or early-morning scheduled exports completed successfully without needing to check the exported folder manually.
Deletion is permanent. Deleting run history removes all records for the selected job and cannot be recovered. Export records you need for auditing or compliance purposes before deleting.

Notifications Tab 3

Configure how SFDC File Exporter alerts you when an export finishes or fails. Notifications can be sent as desktop system alerts, as email messages, or both.

Desktop Notifications

1
Notify on completed exports

Check Desktop notification on export completed to receive a system notification when an export job finishes successfully. The notification shows the job name and the number of files downloaded.

2
Notify on failed exports

Check Desktop notification on export failed to be alerted when an export job encounters an error and stops. The notification includes a brief description of the failure reason.

Desktop notifications rely on the operating system notification center. On Windows, ensure that notifications for SFDC File Exporter are not blocked in System Settings → Notifications.

Email Notifications

1
Notify on completed exports

Check Email notification on export completed to receive an email summary when an export finishes successfully. The email includes the job name, file count, and destination folder path.

2
Notify on failed exports

Check Email notification on export failed to receive an email when an export job fails. The email includes the error details to help you diagnose the problem quickly.

3
Save

Click Save after selecting your notification preferences. The new settings apply to all future export runs, including scheduled ones.

Email notification delivery depends on the email address associated with your license. Ensure it is current and accessible. Check your spam folder if notifications do not arrive within a few minutes of a completed run.

License Tab 4

Enter and activate your SFDC File Exporter product license key. Activation connects to the license server to verify and register the key against your machine. No Salesforce credentials are required for this step.

The Save button is hidden on the License tab. Clicking Activate applies the license immediately — there is no separate save step. Other tabs still require clicking Save before their changes take effect.
1
Open the License tab

Open the Settings dialog and click the License tab. The current license status is shown at the top of the tab — either the active license details or a prompt indicating that no license is active.

2
Enter your product key

Paste or type your product license key into the License Key field. The key is provided in the purchase confirmation email sent to the address used at checkout.

3
Click Activate

Click the Activate button. The application contacts the license server, verifies the key, and registers the current machine. A confirmation message appears immediately if activation succeeds.

4
Verify the status

After successful activation, the tab displays your license plan, the registered email address, and the expiry date. No restart is required — the full feature set becomes available right away.

Each license key is tied to one machine. If you need to move your license to a new computer, contact support@sfdcfileexporter.com to request a transfer.
Looking for a more detailed walkthrough of the activation process, including what to do if activation fails? See the License Activation documentation page.