In this article
1: Overview
The File Library in Forsta Plus is a dedicated storage area for users and interviewers. It can be used to upload and store files, and to transfer files between interviewer devices and the platform.
2: Using Files Offline in the CAPI App
To make survey-related files available for offline use in the CAPI App, store them in one of the following File Library folders. These folders are downloaded during device synchronization:
<Company root>– Available to all CAPI users/CAPICommon– Shared with all CAPI users/<CAPI_UserName>– Available only to the specified CAPI user (e.g.,CAPI_johnw)/<ProjectId>– Available only to a specific project (e.g.,p1234567890)
Each company has its own dedicated File Library area. All Forsta Plus users within the same company can access all files stored in this shared space, regardless of who uploaded them.
To simplify file management and improve navigation, Forsta recommends that each user create a personal folder within the File Library to store their own files.
3: Downloading File Library Files Based on Assigned Respondents
The CAPI App supports downloading File Library files based on assigned respondents. This is useful when displaying custom content, such as images specific to each respondent.
Using this method reduces the need to download all files from shared folders like CAPICommon, allowing for faster syncs and more efficient storage use on interviewer devices.
To download specific File Library files based on assigned respondents, follow these steps:
Create a background variable in your survey using the following naming convention:
In the Respondent sample upload file, provide the full path to the target map image (see above).
Return to your survey, and reference the URL from the background variable to display the file.
__offline_file_[any text]”
This variable should point to the full URL of a File Library file. For example:
https://survey.euro.confirmit.com/isa/BDJPFRDMEYBPBKLVADAYFQCDAVIOEQJR/1023.jpg
Tip: Store the images in a folder that is not downloaded download by default. The root folder, CAPICommon and assigned project folders are downloaded by default.
3.1: Example
var mapURL = GetRespondentValue('__offline_file_map');
if(mapURL) {
var filename = mapURL.substring(mapURL.lastIndexOf('/') + 1);
f('mapfilename').set(filename);
}
<img
src="/isa/BDJPFRDMEYBPBKLVADAYFQCDAVIOEQJR/Somefolder/^f('mapfilename')^" width="437" height="407" />
As part of the CAPI sync, CAPI will loop through each project and assigned respondent.
For each background variable that matches the reserved prefix “__offline_file_” the app will then make a request to download that specific file only.