Configure CORS in Amazon S3 or Microsoft Azure

Bulk download requires a Cross-Origin Resource Sharing (CORS) rule that allows your NetSuite domain to read files from your storage provider. Bulk download won't work until this rule is in place.

Amazon S3

Add the following CORS rule to the S3 bucket used with eXtendFiles. Replace yournetsuitesubdomain with your NetSuite account domain.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "HEAD"],
    "AllowedOrigins": [https://yournetsuitesubdomain.app.netsuite.com"],
    "ExposeHeaders": ["Content-Type"]
  }
]

Note: If you're using multiple buckets, add the rule to each S3 bucket in use by eXtendFiles.

Microsoft Azure

Azure CORS rules are configured in the Azure portal. Open the storage account used by eXtendFiles, go to Resource sharing (CORS), and add a rule on the Blob service tab with the following values:

• Allowed origins: your NetSuite domain, in the format https://yournetsuitesubdomain.app.netsuite.com
  
• Allowed methods: GET, HEAD
  
• Allowed headers: *
  
• Exposed headers: Content-Type
  
• Max age: 1800
  

If you also use Direct Upload

If you use eXtendFiles Direct Upload (Configure eXtendFiles for Direct Upload to Microsoft Azure / Configure eXtendFiles for Direct Upload to Amazon S3), create a separate rule for each feature instead of combining them into a single CORS rule. Separate rules keep the permission scope for each feature as small as possible.

The S3 example below uses one rule for direct upload and one rule for bulk download.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["PUT"],
    "AllowedOrigins": ["https://YoureXtendFileSubdomain.cf.suitextend.net"],
    "ExposeHeaders": ["ETag"]
  },
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "HEAD"],
    "AllowedOrigins": ["https://yournetsuitesubdomain.app.netsuite.com"],
    "ExposeHeaders": ["Content-Type"]
  }
]

Configuration

The Inline HTML Field you select controls where the Bulk Download eXtendFiles button displays on the form. How that field is set depends on whether the record type also uses the eXtendFiles Inline Link List Display.

• Bulk download only: The button displays in the inline HTML field you select.
  
• Bulk download and inline link list: The Inline HTML Field is auto-sourced from the inline link list configuration for that record type. You can also select the field manually.
  
• If bulk download and inline link list share the same field: The button and the inline file list display together in the same field.
  
• Different fields selected: If you select an inline HTML field for bulk download that differs from the one used by the inline link list, the button and the inline file list display in their respective fields.
  

Troubleshooting

If the eXtendFiles Configuration page shows a validation error when saving your Bulk Download configuration, review the Suitelet deployment used by the feature.

"Suitelet deployment not found for Bulk Download"

This error means eXtendFiles couldn't find a Suitelet deployment with the required deployment ID:customdeploy_extend_files_bulk_download

To resolve this issue:

1. In NetSuite, go to Customization → Scripting → Scripts.
   
2. Open the eXtendFiles Suitelet script.
   
3. Confirm that a deployment exists with the following ID:
   
   • ID: customdeploy_extend_files_bulk_download
     
4. If the deployment doesn't exist, create a new deployment using the steps in Deploy the Suitelet script.
   

"Suitelet not deployed for Bulk Download"

This error means the required Suitelet deployment exists, but the deployment isn't enabled.

To resolve this issue:

1. Open the eXtendFiles Suitelet script deployment with the ID customdeploy_extend_files_bulk_download.
   
2. Check the Deployed checkbox on the script deployment.
   
3. Save the deployment.
   

"Suitelet deployment doesn't have roles or employees configured for Bulk Download"

This error means the Suitelet deployment doesn't have an audience configured. The deployment must be available to at least one role or employee.

To resolve this issue:

1. Open the eXtendFiles Suitelet script deployment with the ID customdeploy_extend_files_bulk_download.
   
2. On the Audience tab, configure one of the following:
   
   • All Roles
     
   • All Employees
     
   • One or more selected roles
     
   • One or more selected employees
     
3. Save the deployment.
   

Recommended setting: Set the Suitelet deployment audience to All Internal Roles.

Q: Do I need to configure the Inline Link List Display to use bulk download?

A: No. Bulk download works whether or not the inline link list is configured for the record type. If both are configured, the button and the file list display in the same field.