File¶

The File widget allows users to link to, upload, and (if supported) edit files.

Data Model¶

The File widget stores the file ID in the bound data model element. A Caption attribute is automatically created and populated with the file name for display purposes. To map the file name to a specific data model element, use the NameXPath property.

File Upload Sources¶

The File widget supports multiple data sources for uploading files or linking to existing files from various systems. These data sources are configured in the Host Administration Panel.

Desktop Upload¶

Users can upload files from their local file systems. Uploaded files are subject to security restrictions configured in the Host Administration Panel, such as allowed/denied file types. By default, executable files (e.g., .exe, .html) are disallowed unless explicitly permitted. Antivirus scanning is performed if configured.

Camera Upload¶

Files can be captured directly from a device's camera (including mobile devices). Uploaded images are stored without any automatic image processing.

Cloud Storage Integration (Google Drive, Office 365)¶

If configured, users can link files from Google Drive or Office 365 OneDrive. Only the file link is stored; the actual file content is not replicated within Emakin.

File Templates¶

The File widget supports file templates for creating new files based on pre-defined content. When a template is selected, a new copy is generated and associated with the form. File templates are specified through data source configuration; the Value field of the data source item represents the file ID, and Text represents the file name.

Template Data Sources Example¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

<File AllowEdit="True" XPath="MyFile">
    <DataSources>
        <ListItemDataSource TextFormat="" ValueFormat="" Enabled="True">
            <Items>
                <Item>
                    <Text><![CDATA[word]]></Text>
                    <Value><![CDATA[8ede8093-fb87-4f6a-85c0-4fca354f5af4]]></Value>
                </Item>
                <Item>
                    <Text><![CDATA[excel]]></Text>
                    <Value><![CDATA[b1a82c67-670d-411e-bc60-5483786ff41f]]></Value>
                </Item>
            </Items>
        </ListItemDataSource>
    </DataSources>
</File>

File Editing¶

Depending on configuration, the File widget may support in-place document editing using a WOPI-compatible editor, eliminating the need to download, edit, and re-upload files. Editor integration is managed in the Host Administration Panel. Set the AllowEditing property to false to disable editing functionality.