Establish Connectivity to Local Filesystem
This article describes how to fetch CSV, Excel, PDF and PNG/JPEG files from the Local Filesystem.
General instructions on establishing data sources based on plugins can be found in Create a New Plugin Data Source.
1. Access Admin > Collection & Storage > Data Sources
The list page containing all data sources available in the system opens.
Below the grid, click [+ New Data Source].
2. Select Data Source Type
- Select Other to configure a plugin-based connection profile
- Сhoose Local Filesystem from the drop-down list
- [Next Step]
3. Provide Required Parameters
Path: provide path to a folder. This folder can be located:
- On a Windows server. You should consider an RDP installation on this Windows machine. Plugin will have access to any folder under C:\Program Files (x86)\Metric Insights. Example of the path: C:\Program Files (x86)\Metric Insights\Data Processor\my_folder
Note: To fetch data from another folder, add this folder's path to the
access_dirs config parameter. There are two different ways of doing this. Try the UI-based approach first:
- From the UI:
- [+ New Plugin Parameter]
- Provide Plugin Parameter Values:
- Plugin: Local Filesystem
- Value: Enter the path(s) to the folder(s) from which you want to fetch data
- From the
- Connect to the Linux server via SSH
- Access the
- Access the
- Update the folders list:
update dp_config set access_dirs='<path(s) to the folder(s)>';
- On a Linux server where MI app is deployed:
- A default folder is /opt/mi/shared
- You can mount your Windows folder to Data Processor container directory /opt/mi/shared. Make sure the directory permissions are 755 and folder files permissions are 644. The owner of the directory under Data Processor container should be dataprocessor. If you choose to proceed with this option and face any difficulties, address your issues to [email protected]
Optionally, toggle on Enable On-Demand Element Creation and Enable Content Auto Synchronization.
4. Optional Parameters
CSV Delimiter: choose the delimiter character used in your CSV files
- "," is the default value
Files filter: collect only files that match the defined filters
- "*" can be used as a wildcard
Includes headers: choose whether to add default column headers to the CSV
- Accepts "true"/"false"
- "True" is the default value
5. Advanced Configuration
Advanced Configuration settings can be set to default values unless Data Source requires more precise tuning. For more details on how to proceed, refer to Advanced Data Source Configuration.
- [Test Connection] in the upper-right corner, this will also save your entries