Use File Viewer Plugin to create logic that lets users to open remote or app resource files. In Android users select an app to open the file. iOS provides a native preview for supported file types.
See Adding plugins to learn how to install and reference a plugin in your OutSystems apps, and how to install a demo app.
File Viewer Plugin can open:
- File from the app resources. The plugin can access the resources path to load the file that's part of the app static content. See Working with app resources
- Remote file. The plugin downloads the file to the app sandbox and then opens the file.
Viewing files in Android and iOS
To let users view files in the mobile apps, create logic with the action OpenDocument. You need to supply a path to a local file in the FilePath property or to a remote file in the URL property.
If you want to open a file from the app resources see Working with app resources.
For an example of how to use the plugin check the demo app or refer to the example in this document.
For opening media files in the iOS apps, use the action PreviewMediaContent from FileViewerPlugin > iOSOnly. This action lets apps handle the media files better by opening them in a media player.
Working with app resources
Here is how to add a file as a resource and open the file with the plugin.
In Service Studio, go to the Data tab.
Right-click the Resources folder and select Import resources. A file dialog opens, where you can select the file you want to add as a resource.
Select the file you added under Resources, and:
resourcesin the Target Directory property. Note that this value must be
resourcesand you can't change it.
- Select Deploy to Target Directory in the Deploy Action list.
In the OpenDocument action enter
"resources\<file name>"in the FilePath property. For example, if you add sample.pdf to Resources, the value of FilePath is
The plugin can access only resources you deploy in the resources path. This is a security limitation by design. Limiting access of the plugin prevents accidental access to the resources of the app.
Example of using File Viewer Plugin
Here is an example of how to use File Viewer Plugin.
A good practice is to check if the plugin is available to the app, and report an error if it's not. You can check the plugin availability by using the CheckPlugin action and checking the value of the CheckPlugin.IsAvailable boolean (1).
When you confirm the plugin is available, use the OpenDocument (2) action to ask the operating system to view the file. The action accepts either a URL for remote files or FilePath for a file from the app resources (3).
More information about parts of the plugin.
Here is the reference of the actions you can use from the File Plugin. File Plugin uses a Cordova plugin, and for more information check out File-Viewer-Plugin.
|CheckPlugin||Checks if the plugin is available in the app.|
|OpenDocument||Opens a remote file or a file from the app resources.|
|PreviewMediaContent||iOS only. Action to preview media content.|