Version: eXtendFiles 1.7.0 with Amazon S3, Google Cloud Storage, Microsoft Azure Blob Storage, Oracle Object Storage
Audience: Administrator
Overview
eXtendFiles, along with a compatible storage provider, allows you to upload files to different folders within your backend file storage. Users can then choose their desired folder when uploading files through eXtendFiles.
Configuration
Step 1: Script Deployment Configuration
The folder upload feature requires two script deployments. Check if these already exist before creating new ones.
Deploy User Event Script
- eXtendFiles User Event
- Navigate to Customization → Scripting → Scripts
- Find and open the script titled eXtendFiles User Event
- Click Deploy Script
- Configure the deployment with these settings:
Applies To: eXtendFiles - Folder Information
Status: Released
Audience: All Roles
- Navigate to Customization → Scripting → Scripts
Deploy Client Script
- eXtendFiles Client Script
- Navigate to Customization → Scripting → Scripts
- Find and open the script titled eXtendFiles Client Script
- Configure the deployment with these settings:
Applies To: eXtendFiles - Folder Information
Status: Released
Audience: All Roles
- Navigate to Customization → Scripting → Scripts
Step 2: Workflow Configuration
Enable the included workflow "eXtendFiles - Folder Information [S]" by setting it to "Released" status. This workflow prevents configuration modifications to protect your configuration
Step 3: Record Configuration
Create Folder Information Records
- Navigate to Customization → Lists, Records, & Fields
- Find the eXtendFiles - Folder Information custom record and create a new record
- Set up the eXtendFiles - Folder Information record with these fields:
- Name: Enter a descriptive name that users will see when selecting this folder
- Folder ID: Specify the folder path in your storage
- Example 1: For a simple folder use
folderA/{uuid}
- Example 2: For nested folders, use
folderA/folderB/{uuid}
- Example 1: For a simple folder use
- Bucket: Select your storage bucket from the dropdown. Note: The bucket dropdown shows only buckets configured in the eXtendFiles configuration page
- Region: (Auto-populated based on bucket)
- Store: (Auto-populated based on bucket)
- Name: Enter a descriptive name that users will see when selecting this folder
Important Notes:
- Folders will be automatically created in your storage if they don't exist upon file upload
- After creation, you can only edit the record name - other changes require creating a new record
- It is recommended to use
{uuid}
as a subfolder to prevent the overwriting of existing files when a file with the same name and extension is uploaded in the same folder. See Saving Files in UUID-based folders in eXtendFiles for more details.
Enable Folder Sharing Rules (Optional)
If you want to allow only certain roles or employees to access certain folders, configure Configure Folder Sharing Rule in eXtendFiles.
Configuration Checklist
- User Event Script deployed
- Client Script deployed
- Workflow set to Released status
- Folder Information record created
- Folder Sharing Rules enabled in eXtendFiles Configuration (optional)
Troubleshooting
- If eXtendFiles - Folder Information fields are locked during edit: This is normal - the workflow prevents modifications to protect your configuration
- If you need to change settings: Create a new record instead of modifying existing ones
- If folders aren't appearing: Verify your bucket configuration in the eXtendFiles Configuration