Download Manager Widget

The Download Manager widget enables users to access and manage exported files in a central location. For more information about this feature, see Download Manager.

Download Manager filters the files displayed based on user ID and client ID. To save the exports for a certain end user and then list them in your Download Manager instance, set the same values for the user ID and client ID properties in all the widgets from where you will run the exports. If you do not define a user ID and client ID for a widget, all exports performed using the widget will not be accessible from Download Manager.

Embeddable Script

<!-- Tag -->
<qrvey-download-manager settings="config"></qrvey-download-manager>

<!-- Config -->
<script>
    var config = {
        apiKey: "<YOUR_PRIVATE_API_KEY>",
        domain: "<DOMAIN>",
        clientId: "<CLIENT_ID>"
    };
</script>

<!-- Launcher -->
<script type="text/javascript" src="https://<WIDGETS_URL>/qrvey_download_manager/qrvey-download-manager/qrvey-download-manager.js?2023-12-26T15:16:09.665Z"></script>
<script type="module" src="https://<WIDGETS_URL>/qrvey_download_manager/qrvey-download-manager/qrvey-download-manager.esm.js?2023-12-26T15:16:09.665Z"></script>
<script> window.config = config</script>

Configuration Object

The following table lists the properties associated with this widget.

Property	Value	Required
apiKey	String, Your organization’s unique API key required to access the Qrvey platform.	Required, if qvToken is not provided.
qvToken	String, Encrypted token used for secure authentication.	Required, if apiKey is not provided.
domain	String, The base URL of your Qrvey instance.	Required
userId	String, The ID of the Qrvey Composer user account accessing this feature. Alternatively, you can specify the user ID in a Qrvey session cookie. To save the exports for a certain end user and then list them in your Download Manager instance, set the same values for the user ID and client ID properties in all the widgets from where you will run the exports.	Optional
clientId	String, The client ID, or unique identifier, of the tenant end user working with the Download Manager. If authenticating with a qvToken, pas this into the token for authentication.	Required
i18n	Object, Defines the language to be displayed in the static text of the widget as well as the dataset columns. Please see The i18n Object for details.	Optional
showModalButton	Boolean, If set to true, displays the Download Manager as a download button, which opens the download manager as a modal on click. Defaults to false.	Optional
widgetView	String, determines how the component is displayed. The default setting is modal, in which the component is displayed as a popup window. If set to table, the component is displayed as a page.	Optional

The i18n Object

For more information, see Internationalization, Step by Step.

Property	Value	Required
lang	String, The language the language to use for the UI. Example: "es",	Required
locale	String, The locale code to use for date and number formatting. Example: "es-ES",	Optional

Open Download Manager Modal

The Download Manager widget provides an exposed method that enables you to trigger the modal from any other element in your page. For example:

<qrvey-download-manager settings="downloadManagerConfig"></qrvey-download-manager>

Access the method using a query selector. For example:

function openmodal () {
const el = document.querySelector('qrvey-download-manager');
el.openDownloadManager();
}

Then create a button and execute your function. For example:

<button onclick="openmodal()">Open Modal</button>