File upload
Use the upload file method and UploadFileCompletedEvent to monitor and control
file uploads in web presentation engine sessions. Understand constraints and browser
behavior for secure file management.
IMPORTANT:
File upload overwrites files with duplicate names and extensions in
the target folder.
Overview
Use the Upload file method to trigger file uploads in a web presentation engine
session. Attach the method to a UI event, such as a MouseClick event, and specify
the output folder path for the uploaded file. The UploadFileCompletedEvent triggers
when the upload completes, providing the operation ID, result code, and file path.
Use these arguments to handle upload results, display status, or process the
uploaded file in the application.
For more information, see:
Constraints
File upload operations include several constraints for security and consistency:
- File upload is allowed only to theProjectFilesfolder and its subfolders, except for theNetSolutionandPKIfolders.
- Maximum upload size is 50 MB per file.
- File upload overwrites files with duplicate names and extensions in the target folder.
- File upload is granted only with read and write permissions; execution permission is not allowed.
- File upload must comply with the allowed local source policy.
- A warning dialog displays during deployment if the Upload file method is present, reminding to validate uploaded content for security.
- By default, only users who are signed in can upload files.
IMPORTANT:
FactoryTalk Optix
does not guarantee that uploaded
files are free from malicious content. You must validate the uploaded files before
using them in the project.Web browsers
The web browser controls file selection and upload parameters.
FactoryTalk Optix Applications
only initiates
and detects when file upload starts.File upload is not supported for the native presentation engine. If attempted, a
warning displays in the log.
For specific information about supported web browsers, see
FactoryTalk Optix Release Notes
.file upload
upload file method
UploadFileCompleted event
web presentation engine
UI Session
security
upload constraints
FactoryTalk Optix
session monitoring
Provide Feedback