document.download - Fluid Topics - Latest

Integrate the Fluid Topics API

Category
Technical Notes
Audience
public
Version
Latest

This web application event occurs when a user selects the Download button in the portal to download an unstructured document or a map attachment.

Loading or saving an unstructured document or a map attachment in a browser's PDF viewer does not trigger a document.download event.

This event contains the following fields:

Field Description
document An object containing information about the downloaded document or map attachment.
    id The ID of the downloaded document or map attachment.
    metadata A list of metadata with the label and values of each key.
    mimeType The format of the downloaded document or map attachment.
    title The title of the downloaded document or map attachment.
    type The type of the downloaded content (for example, UNSTRUCTURED_DOCUMENT).
location Indicates where and how the document or map attachment was downloaded with the following fields:
    type Can be page when the document is downloaded from a page.
    value Contains more information about where the document was displayed. For example, when the type is page, the value can be viewer, meaning that the document was displayed in the Viewer page.

A table for the most common fields is in Analytics events.

Example:

[
   {
        "appName": "ft/turnkey-portal",
        "appVersion": "4.2.16",
        "contentLocale": "en-US",
        "datetime": 1698927610324,
        "id": "0300b6d8-91dd-4080-867e-e14d2991cbf2",
        "name": "document.download",
        "offline": false,
        "parameters": {
            "document": {
                "id": "~P4PYSpVD1CkBb7HvqnbHQ",
                "title": "design-export-examples.zip",
                "type": "MAP_ATTACHMENT",
                "metadata": [],
                "mimeType": "application/zip"
            },
            "location": {
                "type": "page",
                "value": "reader"
            }
        },
        "sessionId": "9e0825cb-531a-4ba0-b36a-d14689f2ba83",
        "tenantId": "1-stable",
        "uiLocale": "en-US",
        "user": {
            "groups": [],
            "id": "d554325-eef7-4850-93c1-cea73446582060",
            "roles": [
                "FEEDBACK_USER",
                "PRINT_USER",
                "RATING_USER"
            ]
        },
        "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36",
        "userIp": "192.168.2.3"
   }
]